класс event.listener

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

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

Описание

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

Используйте указатель метод notify, чтобы инициировать событие.

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

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

ConstructOnLoad

tRUE

HandleCompatible

tRUE

Для получения информации об атрибутах класса см. Атрибуты класса.

Создание

Описание

пример

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

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

Входные параметры

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

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

Имя события, заданное как литеральное имя события.

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

Свойства

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

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

Атрибуты:

GetAccess

общественность

SetAccess

общественность

GetObservable

tRUE

SetObservable

tRUE

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

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

Атрибуты:

GetAccess

общественность

SetAccess

общественность

GetObservable

tRUE

SetObservable

tRUE

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

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

Атрибуты:

GetAccess

общественность

SetAccess

общественность

GetObservable

tRUE

SetObservable

tRUE

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

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

Атрибуты:

GetAccess

общественность

SetAccess

общественность

GetObservable

tRUE

SetObservable

tRUE

Типы данных: логический

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

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

Атрибуты:

GetAccess

общественность

SetAccess

общественность

GetObservable

tRUE

SetObservable

tRUE

Типы данных: логический

Примеры

свернуть все

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

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

Больше о

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

Введенный в R2008a