JDK-8165695 : Improve docs to clarify that input events may be consumed by Controls
  • Type: Bug
  • Component: javafx
  • Sub-Component: controls
  • Affected Version: 7,8,9
  • Priority: P5
  • Status: Open
  • Resolution: Unresolved
  • Submitted: 2016-09-08
  • Updated: 2018-09-05
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
tbdUnresolved
Related Reports
Relates :  
JDK-8163268 - TextArea consumes some of mouse events
Relates :  
JDK-8095998 - TreeTableView doesn't receive scroll event.
Description
The JavaFX event model is such that an Event is delivered to all listeners of the event unless consumed. In order for controls to properly function, most subclasses of Control will consume their input events once processed. We should improve the documentation to make it clear to an application developer that most controls do this, and as such, the application should not expect some events to be delivered to their handler when calling the onXxxxxx method.

See JDK-8095998 and JDK-8163268 for an example where the lack of clarity caused some confusion.