モジュール java.desktop
パッケージ java.beans

クラスEventSetDescriptor

java.lang.Object
java.beans.FeatureDescriptor
java.beans.EventSetDescriptor
public class EventSetDescriptor
extends FeatureDescriptor
EventSetDescriptorは、指定されたJava Beanがトリガーするイベントのグループを記述します。

指定されたイベント・グループは、すべて単一のイベント・リスナー・インタフェース上のメソッド呼び出しとして配信されます。イベント・リスナー・オブジェクトは、イベント・ソースから提供される登録メソッドの呼出しによって登録されます。

導入されたバージョン:
1.1

  • コンストラクタのサマリー

    コンストラクタ 
    コンストラクタ 説明
    EventSetDescriptor​(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String listenerMethodName)
    指定されたイベントfredが(1) FredListenerインタフェースの単一のメソッド呼び出しとして配信される、(2) FredEvent型の単一の引数をとる、(3) FredListenerをソース・コンポーネントのaddFredListenerメソッドの呼出しで登録しremoveFredListenerメソッドの呼出しで削除する、というもっとも単純な標準設計パターンに従うものとして、EventSetDescriptorを作成します。
    EventSetDescriptor​(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName)
    文字列名を使って、ゼロからEventSetDescriptorを作成します。
    EventSetDescriptor​(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName, String getListenerMethodName)
    このコンストラクタは、文字列名を使って、ゼロからEventSetDescriptorを作成します。
    EventSetDescriptor​(String eventSetName, Class<?> listenerType, MethodDescriptor[] listenerMethodDescriptors, Method addListenerMethod, Method removeListenerMethod)
    java.lang.reflect.MethodDescriptorおよびjava.lang.Classオブジェクトを使って、ゼロからEventSetDescriptorを作成します。
    EventSetDescriptor​(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod)
    java.lang.reflect.Methodおよびjava.lang.Classオブジェクトを使って、ゼロからEventSetDescriptorを作成します。
    EventSetDescriptor​(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod, Method getListenerMethod)
    このコンストラクタは、java.lang.reflect.Methodオブジェクトとjava.lang.Classオブジェクトを使って、ゼロからEventSetDescriptorを作成します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    Method getAddListenerMethod()
    イベント・リスナーの追加時に使用するメソッドを取得します。
    Method getGetListenerMethod()
    登録済みイベント・リスナーへのアクセスに使用するメソッドを取得します。
    MethodDescriptor[] getListenerMethodDescriptors()
    ターゲット・リスナー・インタフェースのMethodDescriptorを取得します。
    Method[] getListenerMethods()
    ターゲット・リスナー・インタフェースのメソッドを取得します。
    Class<?> getListenerType()
    ターゲット・インタフェースのClassオブジェクトを取得します。
    Method getRemoveListenerMethod()
    イベント・リスナーの削除時に使用するメソッドを取得します。
    boolean isInDefaultEventSet()
    イベント・セットが「デフォルト」セット内にあるかどうかを報告します。
    boolean isUnicast()
    通常、イベント・ソースはマルチキャストです。
    void setInDefaultEventSet​(boolean inDefaultEventSet)
    イベント・セットを「デフォルト」セット内にある(またはない)としてマークします。
    void setUnicast​(boolean unicast)
    イベント・セットをユニキャスト、または非ユニキャストとしてマークします。

    クラス java.beans.FeatureDescriptorで宣言されたメソッド

    attributeNames, getDisplayName, getName, getShortDescription, getValue, isExpert, isHidden, isPreferred, setDisplayName, setExpert, setHidden, setName, setPreferred, setShortDescription, setValue, toString

    クラス java.lang.Objectで宣言されたメソッド

    clone、equals、finalize、getClass、hashCode、notify、notifyAll、wait、wait、wait

  • コンストラクタの詳細

    • EventSetDescriptor

      public EventSetDescriptor​(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String listenerMethodName) throws IntrospectionException
      指定されたイベントfredが(1) FredListenerインタフェースの単一のメソッド呼び出しとして配信される、(2) FredEvent型の単一の引数をとる、(3) FredListenerをソース・コンポーネントのaddFredListenerメソッドの呼出しで登録しremoveFredListenerメソッドの呼出しで削除する、というもっとも単純な標準設計パターンに従うものとして、EventSetDescriptorを作成します。
      パラメータ:
      sourceClass - イベントをトリガーするクラス。
      eventSetName - イベントのプログラム名。 たとえば、fred。 通常、先頭の文字はアルファベットの小文字になる。
      listenerType - イベントの配信先となるターゲット・インタフェース。
      listenerMethodName - イベントがターゲット・リスナー・インタフェースに配信されたときに呼び出されるメソッド。
      例外:
      IntrospectionException - イントロスペクション中に例外が発生した場合。

    • EventSetDescriptor

      public EventSetDescriptor​(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName) throws IntrospectionException
      文字列名を使って、ゼロからEventSetDescriptorを作成します。
      パラメータ:
      sourceClass - イベントをトリガーするクラス。
      eventSetName - イベント・セットのプログラム名。 通常、先頭の文字はアルファベットの小文字になる。
      listenerType - イベントの配信先となるターゲット・インタフェースのクラス。
      listenerMethodNames - イベントがそのターゲット・リスナー・インタフェースに配信されたときに呼び出されるメソッドの名前。
      addListenerMethodName - イベント・リスナー・オブジェクトの登録に使用できるイベント・ソース上のメソッドの名前。
      removeListenerMethodName - イベント・リスナー・オブジェクトの登録解除に使用できるイベント・ソース上のメソッドの名前。
      例外:
      IntrospectionException - イントロスペクション中に例外が発生した場合。

    • EventSetDescriptor

      public EventSetDescriptor​(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName, String getListenerMethodName) throws IntrospectionException
      このコンストラクタは、文字列名を使って、ゼロからEventSetDescriptorを作成します。
      パラメータ:
      sourceClass - イベントをトリガーするクラス。
      eventSetName - イベント・セットのプログラム名。 通常、先頭の文字はアルファベットの小文字になる。
      listenerType - イベントの配信先となるターゲット・インタフェースのクラス。
      listenerMethodNames - イベントがそのターゲット・リスナー・インタフェースに配信されたときに呼び出されるメソッドの名前。
      addListenerMethodName - イベント・リスナー・オブジェクトの登録に使用できるイベント・ソース上のメソッドの名前。
      removeListenerMethodName - イベント・リスナー・オブジェクトの登録解除に使用できるイベント・ソース上のメソッドの名前。
      getListenerMethodName - イベント・リスナー・オブジェクトの配列へのアクセスに使用できるイベント・ソース上のメソッド。
      例外:
      IntrospectionException - イントロスペクション中に例外が発生した場合。
      導入されたバージョン:
      1.4

    • EventSetDescriptor

      public EventSetDescriptor​(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod) throws IntrospectionException
      java.lang.reflect.Methodおよびjava.lang.Classオブジェクトを使って、ゼロからEventSetDescriptorを作成します。
      パラメータ:
      eventSetName - イベント・セットのプログラム名。
      listenerType - リスナー・インタフェースのクラス。
      listenerMethods - ターゲット・リスナー内の個々のイベント処理メソッドについて記述するメソッド・オブジェクトの配列。
      addListenerMethod - イベント・リスナー・オブジェクトの登録に使用できるイベント・ソース上のメソッド。
      removeListenerMethod - イベント・リスナー・オブジェクトの登録解除に使用できるイベント・ソース上のメソッド。
      例外:
      IntrospectionException - イントロスペクション中に例外が発生した場合。

    • EventSetDescriptor

      public EventSetDescriptor​(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod, Method getListenerMethod) throws IntrospectionException
      このコンストラクタは、java.lang.reflect.Methodオブジェクトとjava.lang.Classオブジェクトを使って、ゼロからEventSetDescriptorを作成します。
      パラメータ:
      eventSetName - イベント・セットのプログラム名。
      listenerType - リスナー・インタフェースのクラス。
      listenerMethods - ターゲット・リスナー内の個々のイベント処理メソッドについて記述するメソッド・オブジェクトの配列。
      addListenerMethod - イベント・リスナー・オブジェクトの登録に使用できるイベント・ソース上のメソッド。
      removeListenerMethod - イベント・リスナー・オブジェクトの登録解除に使用できるイベント・ソース上のメソッド。
      getListenerMethod - イベント・リスナー・オブジェクトの配列へのアクセスに使用できるイベント・ソース上のメソッド。
      例外:
      IntrospectionException - イントロスペクション中に例外が発生した場合。
      導入されたバージョン:
      1.4

    • EventSetDescriptor

      public EventSetDescriptor​(String eventSetName, Class<?> listenerType, MethodDescriptor[] listenerMethodDescriptors, Method addListenerMethod, Method removeListenerMethod) throws IntrospectionException
      java.lang.reflect.MethodDescriptorおよびjava.lang.Classオブジェクトを使って、ゼロからEventSetDescriptorを作成します。
      パラメータ:
      eventSetName - イベント・セットのプログラム名。
      listenerType - リスナー・インタフェースのクラス。
      listenerMethodDescriptors - ターゲット・リスナー内の個々のイベント処理メソッドについて記述するMethodDescriptorオブジェクトの配列。
      addListenerMethod - イベント・リスナー・オブジェクトの登録に使用できるイベント・ソース上のメソッド。
      removeListenerMethod - イベント・リスナー・オブジェクトの登録解除に使用できるイベント・ソース上のメソッド。
      例外:
      IntrospectionException - イントロスペクション中に例外が発生した場合。

  • メソッドの詳細

    • getListenerType

      public Class<?> getListenerType()
      ターゲット・インタフェースのClassオブジェクトを取得します。
      戻り値:
      イベントがトリガーされたときに呼び出されるターゲット・インタフェースのClassオブジェクト。

    • getListenerMethods

      public Method[] getListenerMethods()
      ターゲット・リスナー・インタフェースのメソッドを取得します。
      戻り値:
      イベントがトリガーされたときに呼び出される、ターゲット・リスナー・インタフェース内のターゲット・メソッドのMethodオブジェクトの配列。

    • getListenerMethodDescriptors

      public MethodDescriptor[] getListenerMethodDescriptors()
      ターゲット・リスナー・インタフェースのMethodDescriptorを取得します。
      戻り値:
      イベントがトリガーされたときに呼び出される、ターゲット・リスナー・インタフェース内のターゲット・メソッドのMethodDescriptorオブジェクトの配列。

    • getAddListenerMethod

      public Method getAddListenerMethod()
      イベント・リスナーの追加時に使用するメソッドを取得します。
      戻り値:
      イベント・ソースのリスナーの登録に使用するメソッド。

    • getRemoveListenerMethod

      public Method getRemoveListenerMethod()
      イベント・リスナーの削除時に使用するメソッドを取得します。
      戻り値:
      イベント・ソースのリスナーの削除に使用するメソッド。

    • getGetListenerMethod

      public Method getGetListenerMethod()
      登録済みイベント・リスナーへのアクセスに使用するメソッドを取得します。
      戻り値:
      イベント・ソースのリスナーの配列にアクセスするとき使用するメソッド。存在しない場合はnull。
      導入されたバージョン:
      1.4

    • setUnicast

      public void setUnicast​(boolean unicast)
      イベント・セットをユニキャスト、または非ユニキャストとしてマークします。
      パラメータ:
      unicast - イベント・セットがユニキャストである場合はtrue。

    • isUnicast

      public boolean isUnicast()
      通常、イベント・ソースはマルチキャストです。 しかし、厳密にはユニキャストであるという例外もあります。
      戻り値:
      イベント・セットがユニキャストである場合はtrue。 デフォルトはfalseです。

    • setInDefaultEventSet

      public void setInDefaultEventSet​(boolean inDefaultEventSet)
      イベント・セットを「デフォルト」セット内にある(またはない)としてマークします。 デフォルトはtrueです。
      パラメータ:
      inDefaultEventSet - イベント・セットがデフォルトのセットである場合はtrue、それ以外の場合はfalse

    • isInDefaultEventSet

      public boolean isInDefaultEventSet()
      イベント・セットが「デフォルト」セット内にあるかどうかを報告します。
      戻り値:
      イベント・セットがデフォルトのセットである場合はtrue。 デフォルト値はtrueです。