event.listener class

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

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

Описание

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

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

The 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