Типы событий

Программное обеспечение OPC Toolbox™ поддерживает несколько различных типов событий. Каждый тип события имеет связанное свойство объекта тулбокса, которое можно использовать, чтобы задать функцию, которая выполняется, когда событие имеет место.

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

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

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

Событие

Свойство коллбэка

Описание

Асинхронная отмена

CancelAsyncFcn

Тулбокс генерирует отмену асинхронное событие, когда асинхронная операция отменяется. Вы отменяете асинхронную операцию с помощью cancelasync функция.

Когда отмена, которую асинхронное событие имеет место, тулбокс, выполняет функцию, заданную CancelAsyncFcn свойство. По умолчанию тулбокс выполняет функцию обратного вызова по умолчанию для этого события, opccallback, который отображает информацию об отмене асинхронное событие в MATLAB® командная строка.

Асинхронные события отмены имеют место в dagroup уровень объектов.

Изменение данных

DataChangeFcn

Тулбокс генерирует событие изменения данных, когда сервер уведомляет тулбокс, что данные для группы изменились. Сервер уведомит тулбокс изменений данных только если Active группы свойство установлено в 'on' и Subscription свойство установлено в 'on'. Для получения дополнительной информации об управлении событиями изменения данных смотрите События Изменения Данных и Подписку.

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

События изменения данных имеют место в dagroup уровень объектов.

Ошибка

ErrorFcn

Тулбокс генерирует ошибочное событие, когда ошибка времени выполнения происходит, такие как ошибка преобразования типа данных или тайм-аут. Ошибки времени выполнения не включают ошибки настройки, такие как установка недопустимого значения свойства.

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

Ошибочные события имеют место в opcda уровень объекта клиента.

Readasync

ReadAsyncFcn

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

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

Читайте асинхронные события имеют место в dagroup уровень объектов.

Полученные записи

RecordsAcquiredFcn

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

То, когда записи получили событие, происходит, тулбокс выполняет функцию, заданную RecordsAcquiredFcn свойство.

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

Завершение работы

ShutDownFcn

Тулбокс генерирует событие завершения работы, когда Сервер OPC уведомляет клиент, что сервер собирается закрыться.

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

Завершите работу события имеют место в opcda уровень объекта клиента.

Запуск

StartFcn

Тулбокс генерирует событие запуска, когда объект запускается. Вы используете start функционируйте, чтобы запустить объект.

Примечание

Если ошибка происходит в функции обратного вызова запуска, объект не запускается.

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

Запустите события имеют место в dagroup уровень объектов.

Остановка

StopFcn

Тулбокс генерирует событие остановки, когда объект прекращает запускаться. Объект прекращает запускаться когда stop функция вызвана, или когда конкретное количество записей получено.

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

Остановитесь события имеют место в dagroup уровень объектов.

Таймер

TimerFcn

Тулбокс генерирует событие таймера, когда целочисленное кратное заданное количество времени истекает. Вы используете TimerPeriod свойство задать количество времени. Время измеряется относительно когда opcda объект клиента соединяется.

Примечание

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

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

События таймера имеют место в opcda уровень объекта клиента.

Запишите асинхронный

WriteAsyncFcn

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

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

Запишите, что асинхронные события имеют место в dagroup уровень объектов.