Функции обратного вызова таймера

Примечание

Выполнение функции обратного вызова может быть задержано, если коллбэк включает интенсивную центральным процессором задачу, такую как обновление фигуры.

Соединение команд с Событиями объекта - таймера

Объект - таймер поддерживает свойства, которые позволяют вам задать команды MATLAB^®, которые выполняются, когда таймер стреляет, и для других событий объекта - таймера, таких как запуск, остановка, или когда ошибка происходит. Они называются коллбэками. Чтобы сопоставить команды MATLAB с событием объекта - таймера, установите значение связанного свойства коллбэка объекта - таймера.

Следующая схема показывает, когда события имеют место во время выполнения объекта - таймера и дают имена свойств объекта - таймера, сопоставленных с каждым событием. Например, чтобы сопоставить команды MATLAB с событием запуска, присвойте значение свойству коллбэка StartFcn. Ошибочные коллбэки могут произойти в любое время.

События объекта - таймера и связанная функция обратного вызова

Создание функций обратного вызова

Когда период времени, заданный объектом - таймером, протекает, объект - таймер выполняет одну или несколько функций MATLAB вашего выбора. Можно задать функции непосредственно как значение свойства коллбэка. Можно также поместить команды в файл функции и задать функцию как значение свойства коллбэка.

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

Этот пример создает объект - таймер, который отображает приветствие после 5 секунд. Пример задает значение свойства коллбэка TimerFcn непосредственно, помещая команды в вектор символов.

t = timer('TimerFcn',@(x,y)disp('Hello World!'),'StartDelay',5);

Примечание

Когда вы задаете команды коллбэка непосредственно как значение свойства функции обратного вызова, команды оценены в рабочем пространстве MATLAB.

Помещение команд в функции обратного вызова

Вместо того, чтобы задать команды MATLAB непосредственно как значение свойства коллбэка, можно поместить команды в файл программы MATLAB и задать файл как значение свойства коллбэка.

Когда вы создаете функцию обратного вызова, первые два аргумента должны быть указателем на объект - таймер и структуру события. Структура события содержит два поля: Type и Data. Поле Type содержит вектор символов, который идентифицирует тип события, которое вызвало коллбэк. Значение этого поля может быть любым следующим: 'StartFcn', 'StopFcn', 'TimerFcn' или 'ErrorFcn'. Поле Data содержит время, которое имело место событие.

В дополнение к этим двум необходимым входным параметрам ваша функция обратного вызова может принять специализированные аргументы. Чтобы получить эти входные параметры, необходимо использовать массив ячеек при определении имени функции как значения свойства коллбэка. Для получения дополнительной информации смотрите Определение Значения Callback Function Properties.

Пример: Запись функции обратного вызова

Этот пример реализует простую функцию обратного вызова, которая отображает тип события, которое инициировало коллбэк и время, коллбэк произошел. Чтобы проиллюстрировать передающие специализированные аргументы, функция обратного вызова в качестве примера принимает как дополнительный аргумент вектор символов и включает этот текст в отображение вывод. Чтобы видеть эту функцию, используемую со свойством коллбэка, смотрите Определение Значения Callback Function Properties.

function my_callback_fcn(obj, event, text_arg)

txt1 = ' event occurred at ';
txt2 = text_arg;

event_type = event.Type;
event_time = datestr(event.Data.time);

msg = [event_type txt1 event_time];
disp(msg)
disp(txt2)

Определение значения Callback Function Properties

Вы сопоставляете функцию обратного вызова с определенным событием путем устанавливания значения соответствующего свойства коллбэка. Можно задать функцию обратного вызова как массив ячеек или указатель на функцию. Если ваша функция обратного вызова принимает дополнительные аргументы, необходимо использовать массив ячеек.

Следующая таблица показывает синтаксис для нескольких демонстрационных функций обратного вызова и описывает, как вы вызываете их.

Синтаксис функции обратного вызова	Как задать как значение свойства для объекта `t`
`function myfile(obj, event)`	`t.StartFcn = @myfile`
`function myfile`	`t.StartFcn = @(~,~)myfile`
`function myfile(obj, event, arg1, arg2)`	`t.StartFcn = {@myfile, 5, 6}`

Этот пример иллюстрирует несколько способов, без которых можно задать значение свойств функции обратного вызова объекта - таймера, некоторых с аргументами и некоторыми. Чтобы видеть код функции обратного вызова, my_callback_fcn, смотрите Пример: Запись функции обратного вызова:

Создайте объект - таймер.

t = timer('StartDelay', 4, 'Period', 4, 'TasksToExecute', 2, ...
          'ExecutionMode', 'fixedRate');

Задайте значение коллбэка StartFcn. Обратите внимание на то, что пример задает значение в массиве ячеек, потому что функция обратного вызова должна получить доступ к аргументам, переданным ему:
```
t.StartFcn = {@my_callback_fcn, 'My start message'};
```
Задайте значение коллбэка StopFcn. Снова, значение задано в массиве ячеек, потому что функция обратного вызова должна получить доступ к аргументам, переданным ему:
```
t.StopFcn = { @my_callback_fcn, 'My stop message'};
```
Задайте значение коллбэка TimerFcn. Пример задает команды MATLAB в векторе символов:
```
t.TimerFcn = @(x,y)disp('Hello World!');
```

Запустите объект - таймер:

start(t)

Пример выводит следующее.

StartFcn event occurred at 10-Mar-2004 17:16:59
My start message
Hello World!
Hello World!
StopFcn event occurred at 10-Mar-2004 17:16:59
My stop message

Удалите объект - таймер после того, как вы будете закончены с ним.
```
delete(t)
```

Смотрите также

timer

Документация