exponenta event banner

instrnotify

Определение уведомления для событий КИП

Синтаксис

instrnotify('Type', callback)
instrnotify({'P1', 'P2', ...}, 'Type', callback)
instrnotify(obj, 'Type', callback)
instrnotify(obj, {'P1', 'P2', ...}, 'Type', callback)
instrnotify('Type', callback, '-remove')
instrnotify(obj, 'Type', callback, '-remove')

Аргументы

'Type'

Тип события: ObjectCreated, ObjectDeleted, или PropertyChangedPostSet

callback

Вычисляемый дескриптор функции, символьный вектор или массив ячеек.

'P1', P2', ...

Любое количество имен свойств объекта.

obj

Объект прибора или объект группы устройств.

'-remove'

Аргумент для удаления указанного обратного вызова.

Описание

instrnotify('Type', callback) вычисляет выражение MATLAB ® ,callback, в рабочей области MATLAB при событии типа Type генерируется. Type может быть ObjectCreated, ObjectDeleted, или PropertyChangedPostSet.

Если Type является ObjectCreated, callback вычисляется каждый раз при создании объекта прибора или объекта группы устройств. Если Type является ObjectDeleted, callback оценивается каждый раз при удалении объекта прибора или объекта группы устройств. Если Type является PropertyChangedPostSet, callback оценивается каждый раз, когда свойство объекта прибора или группы устройств конфигурируется с помощью set.

callback может быть

  • Дескриптор функции

  • Вычисляемый вектор символов

  • Массив ячеек, содержащий функцию для вычисления в первой ячейке (дескриптор функции или имя функции) и дополнительные аргументы для передачи функции в последующих ячейках

callback вызывается функция с помощью

function(obj, event, [arg1, arg2,...])

где obj - объект инструмента или объект группы устройств, генерирующий событие. event - структура, содержащая информацию о сгенерированном событии. Если Type является ObjectCreated или ObjectDeleted, event содержит тип события. Если Type является PropertyChangedPostSet, event содержит тип события, настраиваемое свойство и новое значение свойства.

instrnotify({'P1', 'P2', ...}, 'Type', callback) вычисляет выражение MATLAB, callback, в рабочей области MATLAB при любом из указанных свойств, P1, P2, ... сконфигурированы. Type может быть только PropertyChangedPostSet.

instrnotify(obj, 'Type', callback) вычисляет выражение MATLAB, callback, в рабочей области MATLAB при событии типа Type для объекта obj, генерируется. obj может быть массивом объектов приборов или объектов группы устройств.

instrnotify(obj, {'P1', 'P2', ...}, 'Type', callback) вычисляет выражение MATLAB, callback, в рабочей области MATLAB при любом из указанных свойств, P1, P2, сконфигурированы для объекта obj.

instrnotify('Type', callback, '-remove') удаляет указанное callback типа Type.

instrnotify(obj, 'Type', callback, '-remove') удаляет указанное callback типа Type для объекта obj.

Примеры

instrnotify('PropertyChangedPostSet', @instrcallback);
g = gpib('mcc', 0, 5);
set(g, 'Name', 'mygpib');
fopen(g);
fclose(g);
instrnotify('PropertyChangedPostSet',@instrcallback,'-remove');

Совет

PropertyChangedPostSet события генерируются только в том случае, если свойство настроено на значение, отличное от значения свойства, настроенного в данный момент. Например, если объект GPIB Tag свойство настроено на 'myobject', a PropertyChangedPostSet событие не будет создано, если объект Tag в настоящее время свойство имеет значение 'myobject'. A PropertyChangedPostSet событие будет создано, если объект Tag свойство имеет значение 'myGPIBObject'.

Если obj указан и обратный вызов Type является ObjectCreated, обратный вызов не будет сгенерирован, поскольку obj уже создан.

Если Type является ObjectDeleted, недопустимый объект obj не передается в качестве первого входного аргумента в callback функция. Вместо этого в качестве первого входного аргумента передается пустая матрица.

Примечание

Чтобы получить список опций, которые можно использовать для функции, нажмите клавишу Tab после ввода функции в командной строке MATLAB. Список расширяется, и можно выполнить прокрутку для выбора свойства или значения. Сведения об использовании этой расширенной функции завершения вкладки см. в разделе Использование функции завершения вкладки для функций.

Представлен до R2006a