event.hasListener

イベントのリスナーが存在するかどうかを判定

構文

tf = event.hasListener(src,EventName)

説明

tf = event.hasListener(src,EventName) は、オブジェクト src にある指定のイベントにリスナーが存在する場合に true を返します。その他の場合は false を返します。src が配列の場合、event.hasListener は src と同じサイズの logical 配列を返します。

src のクラスは、指定されるイベントを定義するか、継承しなければなりません。src が異種混合配列である場合、指定されるイベントがその配列のクラスに存在しなければなりません。event.hasListener では、イベントが異種混合配列内の一部のオブジェクトによって定義されていますが、すべてのオブジェクトでは定義されていないため、そのリスナーを検出できません。

event.hasListener は、event.listener オブジェクトの Enabled プロパティの値に従います。リスナーの Enabled プロパティが false に設定されている場合、event.hasListener はそのリスナーについて false を返します。

例

すべて折りたたむ

リスナーが存在するかどうかの判定

オブジェクト src に MyEvent のリスナーが存在するかどうかを判定します。

tf = event.hasListener(src,'MyEvent');

tf が true の場合、イベント MyEvent の src に 1 つ以上のリスナーが付与されています。

入力引数

すべて折りたたむ

`src` — イベントソース
オブジェクト配列

イベントソース。スカラーまたはオブジェクトの配列として指定します。イベントソースは、リスナーが付与されているオブジェクトです。

`EventName` — イベント名
`char` 配列

イベント名。char 配列として指定します。

出力引数

すべて折りたたむ

`tf` — リスナーが存在する場合は `true`
`logical` 配列

指定されたオブジェクトの指定イベントにリスナーが存在する場合は true。リスナーが存在しない場合は false。

データ型: logical

制限

event.hasListener には、対象とするイベントの NotifyAccess が必要です。
event.hasListener は、事前定義されたプロパティイベント PreSet、PostSet、PreGet、PostGet では機能しません。
event.hasListener は、事前定義された動的プロパティイベント PropertyAdded および PropertyRemoved では機能しません。
event.hasListener はユーザー定義イベントのみで使用してください。