モジュール javafx.base
パッケージ javafx.event

インタフェースEventDispatchChain


  • public interface EventDispatchChain
    EventをディスパッチできるEventDispatcherオブジェクトのチェーンを表します。 イベントは、チェーン内の1つのEventDispatcherから次へと、チェーンの最後に到達するまで渡されることによってディスパッチされます。 チェーン内の各EventDispatcherは、イベント・パスおよびイベント自体に影響を及ぼすことができます。 チェーンは、通常、ルートからイベント・ターゲットへの親子階層に従い、発生したすべてのEventDispatcherオブジェクトをチェーンに追加することによって形成されます。
    導入されたバージョン:
    JavaFX 2.0

    • メソッドの詳細

      • append

        EventDispatchChain append​(EventDispatcher eventDispatcher)
        指定されたEventDispatcherをこのチェーンに追加します。 追加された要素を含むチェーンへの参照を返します。

        呼出し元は、このEventDispatchChainが変更されないと想定することも、返された値が呼出し後に異なるチェーンを参照すると想定することもできません。 これはすべて、EventDispatchChainの実装によって異なります。

        そのため、呼出しは常に次の形式で実行する必要があります。chain = chain.append(eventDispatcher);

        パラメータ:
        eventDispatcher - チェーンに追加するEventDispatcher
        戻り値:
        追加されたイベント・ディスパッチャを含むチェーン

      • prepend

        EventDispatchChain prepend​(EventDispatcher eventDispatcher)
        指定されたEventDispatcherをこのチェーンの先頭に追加します。 先頭に追加された要素を含むチェーンへの参照を返します。

        呼出し元は、このEventDispatchChainが変更されないと想定することも、返された値が呼出し後に異なるチェーンを参照すると想定することもできません。 これはすべて、EventDispatchChainの実装によって異なります。

        そのため、呼出しは常に次の形式で実行する必要があります。chain = chain.prepend(eventDispatcher);

        パラメータ:
        eventDispatcher - チェーンの先頭に追加するEventDispatcher
        戻り値:
        先頭に追加されたイベント・ディスパッチャを含むチェーン

      • dispatchEvent

        Event dispatchEvent​(Event event)
        指定されたイベントをこのEventDispatchChainを介してディスパッチします。 戻り値は、チェーンによって処理が実行された後のイベントを表します。 呼出し後に後続処理を実行する必要がある場合は、元のイベントではなく、戻り値が参照するイベントを使用する必要があります。 イベントがチェーンで完全に処理/消費された場合、戻り値はnullになり、そのイベントには後続処理を実行できません。
        パラメータ:
        event - ディスパッチするイベント
        戻り値:
        処理されたイベント、またはイベントが完全に処理/消費された場合は、null