モジュール 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)	EventSetDescriptorを作成します。これは、指定されたイベント"fred"が、インタフェースFredListenerの単一のメソッドに対するコールとして配信される(1)である、最も単純な標準設計パターンに従っていることを前提としています。(2)がFredEvent型の単一の引数、および(3)を持ち、FredListenerは、ソース・コンポーネントのaddFredListenerメソッドの呼出しに登録され、removeFredListenerメソッドの呼出しで削除される場合があります。
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

EventSetDescriptorを作成します。これは、指定されたイベント"fred"が、インタフェースFredListenerの単一のメソッドに対するコールとして配信される(1)である、最も単純な標準設計パターンに従っていることを前提としています。(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(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()

イベント・セットが「デフォルト」セット内にあるかどうかを報告します。

戻り値:

イベント・セットが"default"セットにある場合はtrue。 デフォルトはtrueです。