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 はユーザー定義イベントのみで使用してください。

バージョン履歴

R2016a で導入

参考

addlistener | notify

トピック

• イベントにリスナーがあるかどうかの判定
• イベントの属性