マウスイベントが下層のNodeに拾われて困ります

Outline

Node.blocksMouse
Button.actionに書かずにonMouseClickedに書く
WidgetFXでの注意

Node.blocksMouse

いくつかのNodeが重なっているとき、例えばNodeのシーケンスが[a,b,c]のように（aが最下層）なっているとき、各Nodeがそれぞれマウスイベントを見張っているとしましょう。実例で言うとポップアップしたダイアログ上に配置されたボタンを想像してください。ここで c に拾わせたいマウスイベントを a や b が拾ってしまう現象の解決を書きます。

Node.blockMouseをtrueにするとマウスイベントが下層の a や b にまで伝わってしまうことを防御できます。デフォルトではfalseなので、基本すり抜けてしまいます。

例：

def c = MyNode{
  ...
  blockMouse:true
  ...
}

Button.actionに書かずにonMouseClickedに書く

javafx.scene.control.Button の話です。前述の解決策をしても、Button.actionはブロックされず下層に伝わります。 actionはマウスイベントではないのでブロックしないという理屈なのでしょうか。一方、リッスンしている側はマウスイベントとして検知します。なんとなく不思議な理屈ですが動きとしてはそうです。解決策としては、actionに書かずにonMouseClickedに書いてください。例えば、ダイアログを最前面に出すような場面では、ダイアログの最下層に敷いたRectangleのblockMouseをtrueにし、ダイアログに配置するButtonのactionに処理内容を書かずonMouseClickedに書きます。