モジュール 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です。