JavaTM 2 Platform
Std. Ed. v1.3

java.beans
クラス EventSetDescriptor

java.lang.Object
  |
  +--java.beans.FeatureDescriptor
        |
        +--java.beans.EventSetDescriptor

public class EventSetDescriptor
extends FeatureDescriptor

EventSetDescriptor は、指定された Java bean が発生させるイベントのグループを記述します。

指定されたイベントのグループは、単一のイベントリスナーインタフェースのメソッド呼び出しとして、すべて伝達されます。イベントリスナーオブジェクトは、イベントソースの登録メソッドの呼び出しにより登録できます。


コンストラクタの概要
EventSetDescriptor(Class sourceClass, String eventSetName, Class listenerType, String listenerMethodName)
          このコンストラクタは、次のようなもっとも単純な設計パターンに基づくことを前提にして EventSetDescriptor を作成します。
EventSetDescriptor(Class sourceClass, String eventSetName, Class listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName)
          文字列名を使って新しい 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, MethodDescriptor[] listenerMethodDescriptors, Method addListenerMethod, Method removeListenerMethod)
          java.lang.reflect.MethodDescriptor および java.lang.Class オブジェクトを使って新しい EventSetDescriptor を作成します。
 
メソッドの概要
 Method getAddListenerMethod()
          イベントリスナーの追加に使用するメソッドを取得します。
 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
 
クラス java.lang.Object から継承したメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

EventSetDescriptor

public EventSetDescriptor(Class sourceClass,
                          String eventSetName,
                          Class listenerType,
                          String listenerMethodName)
                   throws IntrospectionException
このコンストラクタは、次のようなもっとも単純な設計パターンに基づくことを前提にして EventSetDescriptor を作成します。つまり、名前付きイベント fred は、(1) インタフェース FredListener の単一メソッドの呼び出しとして伝達されること、(2) FredEvent 型の単一引数を持つこと、(3) FredListener は、ソースコンポーネントの addFredListener メソッドの呼び出しを使って登録でき、removeFredListener メソッドの呼び出しを使って削除できることです。
パラメータ:
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(String eventSetName,
                          Class listenerType,
                          Method[] listenerMethods,
                          Method addListenerMethod,
                          Method removeListenerMethod)
                   throws IntrospectionException
java.lang.reflect.Method および java.lang.Class オブジェクトを使って新しい EventSetDescriptor を作成します。
パラメータ:
eventSetName - イベントセットのプログラム名
listenerType - リスナーインタフェースのクラス
listenerMethods - ターゲットリスナー内の各イベント処理メソッドを記述する Method オブジェクトの配列
addListenerMethod - イベントリスナーオブジェクトを登録できるイベントソース上のメソッド
removeListenerMethod - イベントリスナーオブジェクトを登録解除できるイベントソース上のメソッド
例外:
IntrospectionException - 内部検査中に例外が発生した場合

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()
イベントリスナーの削除に使用するメソッドを取得します。
戻り値:
イベントソースでのリスナー削除に使うメソッド

setUnicast

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

isUnicast

public boolean isUnicast()
通常、イベントソースはマルチキャストです。ただし例外的に、完全なユニキャストのものもあります。
戻り値:
イベントセットがユニキャストの場合は true。デフォルトの値は false

setInDefaultEventSet

public void setInDefaultEventSet(boolean inDefaultEventSet)
「デフォルトの」 セットとして (またはデフォルトのセットでないとして) イベントセットをマークします。
パラメータ:
unicast - イベントセットがユニキャストの場合は true

isInDefaultEventSet

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

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.