event.hasListener

确定事件是否存在侦听程序

语法

tf = event.hasListener(src,EventName)

说明

如果 src 对象上存在指定事件的侦听程序，tf = event.hasListener(src,EventName) 将返回 true。否则，将返回 false。如果 src 是数组，event.hasListener 返回的逻辑数组大小与 src 相同。

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 关联一个或多个侦听程序。

输入参数

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

主题

• Determine If Event Has Listeners
• Event Attributes