KRVariables.pas
Типы данных
- TVarUpdateType – метод обновления значения переменной
- vutBefore – перед отправкой значения
- vutAfter – после отправки значения
- vutAftUpdate – после обновления. То есть после отправки запроса чтения и получения результата с текущим значением
- TVarType – тип значения переменной
- VT_BYTE – беззнаковый целочисленный байт
- VT_WORD – беззнаковое 16-битное целочисленное значение
- VT_DWORD – беззнаковое 32-битное целочисленное значение
- VT_SMALLINT – 16-битное целочисленное значение
- VT_INT – 32-битное целочисленное значение
- VT_SINGLE – 32-битное значение с плавающей точкой
- VT_STRING – строка
- VT_INT64 – 64-битное целочисленное значение
- VT_DOUBLE – 64-битное значение с плавающей точкой
- VT_UINT64 – беззнаковое 64-битное целочисленное значение
- TValUpdate – событие обновления значения
- Sender – указатель на TKRVariable
- Variable – обновленная переменная
Интерфейсы
Интерфейс IKRVarUp
IKRVarUp – интерфейс мониторинга за результатами запросов переменной
Методы интерфейса IKRVarUp
- VarUp – вызывается при положительном ответе от удаленного устройства на запрос получения текущего значения переменной
- AVar – переменная, значение которой обновилось
- VarErr – вызывается при ошибке выполнения запроса
- AVar – переменная, в которой возникла ошибка
Классы
Класс TKRVariable
Родительский класс TKRComponentCollectionItem
Интерфейсы: IKRCfgParam
TKRVariable – переменная удаленного устройства. Виртуальный класс
Свойства класса TKRVariable
- ErrorMsg – последнее сообщение об ошибке
- Error – код последней ошибки
- Value – значение переменной
- VarType – тип переменный TVarType
- Interval – интервал обновления значения в миллисекундах. Если установлено значение больше нуля, то будут отправляться запросы обновления с заданной периодичностью
- CfgInterval – конфигурационный параметр типа TKRIniCfgParam, для хранения значения свойства Interval
- CfgValue – конфигурационный параметр для сохранения значения переменной
- UpdateType – метод обновления значения переменной TVarUpdateType
- UpAftWrite – если опция включена, то после положительного ответа устройства на запрос записи, посылается запрос чтения
- UserError – включение пользовательской ошибки(симуляция ошибки)
- UserErrorMsg – сообщение об ошибке при включенной пользовательской ошибке
- ValUpdated – индикатор обновления значения. Только чтения. Значение актуально только когда свойство Interval равно нулю. При отправке запроса чтения с помощью метода UpdateValue сбрасывается в False, а после получения положительного ответа переходит в True
- WaitForUpdates – ожидание обновления значения. Актуально только когда Interval равен нулю. Если свойство включено, то после первого вызова метода UpdateValue, он будет повторно вызываться пока не будет получено значение переменной. То есть если по запросу чтения получена ошибка или не получено ни чего(таймаут), то запрос чтения будет отправляться повторно пока не придёт положительный ответ.
- ErrorCount – количество подряд пришедших ошибок для установки состояния переменной в ошибку. Например, если установить значение этому свойству 3, то одна или две подряд пришедшие ошибки не будут влиять на визуальные компоненты (например KRField цвет фона менять не будет) и событие OnError вызываться не будет
События класса TKRVariable
- OnValUpdated – событие вызывается после положительного ответа на запрос чтения значения с удаленного устройства
- OnError – вызывается если не удалось получить ответ от устройства или ответ содержит ошибку
- OnRuntimeError – вызывается при возникновении исключения в компоненте
Методы класса TKRVariable
- UpdateValue – посылает запрос чтения значения в удаленное устройство. Если свойство Interval больше нуля, то данный метод не работает
- AddMon – добавляет объект соответствующий интерфейсу IKRVarUp в список мониторинга для фиксирования результатов обработки запросов
- DelMon – удаляет объект из мониторинга
- AMon – объект, который будет удален
Класс TKRVariabels
Родительский класс TKRComponentCollection
TKRVariabels – коллекция переменных TKRVariable. Виртуальный класс
Свойства класса TKRVariabels
- ReactionTime – время реакции в миллисекундах. Минимальное значение 1. После получения результата запроса для синхронизации используется таймер. Время реакции – это время работы этого таймера.
Методы класса TKRVariabels
- updateAllVariabels – вызывает метод UpdateValue у всех переменных, которых интервал равен нулю
- updateAllWaitingVariabels – вызывает метод UpdateValue у всех переменных, которых включено свойство WaitForUpdates