exponenta event banner

класс event.listener

Пакет: событие

Класс, определяющий объекты прослушивателя

Описание

event.listener класс определяет объекты прослушивателя. Объекты прослушивателя реагируют на определенное событие, выполняя функцию обратного вызова при запуске события. Вы можете использовать event.listener для создания объекта прослушивателя. Кроме того, можно создавать прослушиватели с помощью маркера addlistener и listener методы.

Использовать маркер перемещения notify метод запуска события.

event.listener класс является handle класс.

Атрибуты класса

ConstructOnLoad
true
HandleCompatible
true

Сведения об атрибутах класса см. в разделе Атрибуты класса.

Создание

Описание

пример

eListener = event.listener(eventSource,eventName,callbackFcn) создает прослушиватель для указанного имени события на указанных исходных объектах и идентифицирует дескриптор функции для функции обратного вызова.

Если eventSource является массивом дескрипторов объектов, прослушиватель реагирует на именованное событие для любого из объектов в массиве.

Входные аргументы

развернуть все

Источник события, указанный как массив объектов-дескрипторов или массив ячеек дескрипторов объектов. Используйте массив ячеек, когда исходные объекты не могут сформировать массив, поскольку их классы различаются. Все исходные объекты должны определять указанное событие.

Имя события, указанное в качестве литерального имени события.

Функция обратного вызова, заданная дескриптором функции. Дополнительные сведения см. в разделе Синтаксис обратного вызова прослушивателя

Свойства

развернуть все

Объекты-источники событий, указанные как дескрипторы объектов, на которые отвечает этот прослушиватель при запуске события.

Атрибуты:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

Типы данных: handle object | cell array

Имя события, на которое отвечает прослушиватель при запуске на указанных исходных объектах.

Атрибуты:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

Типы данных: char | string

Обратный вызов события, указанный как дескриптор функции. Функция выполняется при запуске события.

Атрибуты:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

Типы данных: function_handle

Если Enabled имеет значение true (по умолчанию) обратный вызов выполняется при возникновении события. Чтобы отключить выполнение обратного вызова для этого прослушивателя, установите Enabled кому false.

Атрибуты:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

Типы данных: logical

Когда false (по умолчанию), прослушиватель не выполняет свой обратный вызов рекурсивно. Поэтому, если обратный вызов инициирует собственное событие, прослушиватель не отвечает снова.

Когда trueобратный вызов прослушивателя может вызвать то же событие, которое вызвало обратный вызов. Эта схема может привести к бесконечной рекурсии, которая заканчивается, когда предел рекурсии MATLAB ® в конечном итоге вызывает ошибку .

Атрибуты:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

Типы данных: logical

Примеры

свернуть все

Определение прослушивателя для события с именем EOL с функцией обратного вызова с именем EOLCallback инициируется для объекта в массиве textReader.

listenerHandle = event.listener(textReader,"EOL",@EOLCallback);

Подробнее

развернуть все

Представлен в R2008a