API change RT-19955: Configuring a PopupWindow so that it consumes the event used for hiding

[Lubomir Nerad]

Hi,

the http://javafx-jira.kenai.com/browse/RT-19955 requests to add a 
possibility to configure (on PopupWindow) whether the event, which 
caused an autohide enabled Popup to hide, should be consumed. The 
current behavior is such that if you do a mouse click in the Popup's 
owner window, the mouse press which hides the Popup is still delivered 
to the owner window and can trigger some additional UI response there. 
This behavior is quite non-standard and RT-19955 also proposes to 
consume events in this case by default.

I agree with the request. Initially I implemented it as 
"consumeAutoHidingMousePress" boolean property of PopupWindow. While 
that solves the problem described in RT-19955 and seems to me 
descriptive enough, it doesn't cover all events which can cause Popup to 
hide. In particular, an escape key press can also hide Popup and might 
or might not be consumed. I don't think it needs a separate 
configuration so I want to change the name of the added boolean property 
to cover both (and any other future) cases. Unfortunately the 
"consumeAutoHidingEvents" seems ambiguous to me and I can't think of a 
better name.

Do you think that "consumeAutoHidingEvents" would do? Do you have a 
better suggestion?

Thanks,
Lubo