event.listener class

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

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

Описание

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

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

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

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

Атрибуты:

GetAccess
public
SetAccess
public
GetObservable
true
SetObservable
true

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

Примеры

свернуть все

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

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

Больше о

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

Введенный в R2008a
Для просмотра документации необходимо авторизоваться на сайте