主要内容

本页翻译不是最新的。点击此处可查看最新英文版本。

event.hasListener

R2026a

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

描述

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

输入参数

全部折叠

事件源,指定为标量或对象数组。事件源是与侦听程序关联的对象。

事件名称,指定为 char 数组。

输出参量

全部折叠

如果指定对象的指定事件存在侦听程序,则为 true。如果不存在侦听程序,则为 false。

数据类型: logical

限制

  • event.hasListener 必须具有相关事件的 NotifyAccess。

  • event.hasListener 不适用于预定义的属性事件 PreSet、PostSet、PreGet 和 PostGet。

  • event.hasListener 不适用于预定义的动态属性事件 PropertyAdded 和 PropertyRemoved。

  • event.hasListener 只能用于用户定义的事件。

版本历史记录

在 R2016a 中推出