exponenta event banner

Типы событий

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

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

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

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

Событие

Свойство обратного вызова

Описание

Отмена асинхронной синхронизации

CancelAsyncFcn

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

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

Отмена асинхронных событий, возникающих в dagroup уровень объекта.

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

DataChangeFcn

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

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

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

Ошибка

ErrorFcn

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

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

События ошибки происходят в opcda уровень объекта клиента.

Читать асинхронно

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 уровень объекта.