Alpha.Community

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

Свойства

Выполняется операция (OperationInProgress)

Отображает статус выполнения какой-либо операции. Тип значения – уведомляющий bool.

Значение:

  • true – выполняется длительная операция, например, асинхронная операция запроса данных и последующая обработка списка полученных узлов с отрисовкой элементов дерева;
  • false – не выполняется никакая операция.

Вывод описания предпочтительнее имени (DescriptionPreferred)

Позволяет выбрать, что отображать в дереве: имя сигнала или его описание. Тип значения – уведомляющий bool.

Значение:

  • true – отображать описание сигнала (если не указано, то имя);
  • false – отображать имя сигнала.

pMouseRightClicked

Ссылка на команду, выполняемую при клике правой кнопкой мыши по узлу дерева.

Может использоваться, например, для вызова контекстного меню.

Показывать столбец атрибутов (ShowAttributesColumn)

Отображает столбец с иконками атрибутов сигнала справа от названия каждого сигнала в дереве. По иконкам можно понять, является ли сигнал источником событий, и ведется ли для него запись истории значений. Тип значения – уведомляющий bool.

Значение:

  • true – отображать столбец атрибутов;
  • false – не отображать столбец атрибутов.

При выборе значения true будут отображаться иконки атрибутов:

  • – ведется запись истории значений сигнала;
  • – сигнал является источником события.

Ссылка на источник (init_ApSource)

Здесь указывается сервер, дерево сигналов которого должно отображаться в ItemTree. Тип значения – ссылка на источник данных типа Источник AP.

Фильтр (init_Filter)

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

Чтобы настроить фильтрацию:

  1. В контекстном меню свойства выберите Указать объект. Если свойство Фильтр автоматически не развернулось, то разверните его.
  2. Для свойства фильтра Включен выберите true.
  3. Для свойства фильтра С историей значений или Источники событий выберите true, если в дереве необходимо отобразить такие сигналы. Если такие сигналы необходимо скрыть, то для соответствующего свойства фильтра выберите false.

Если для какого-либо узла все дочерние сигналы скрыты после фильтрации, то такой узел будет отображаться в дереве.

pDragStarted

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

Информация об узле представлена в виде значений следующих атрибутов:

  • tag – адрес сигнала;
  • dataType – тип данных;
  • isWritable – возможность изменения сигнала пользователем;
  • isHistorized – запись истории значений сигнала;
  • isEventSource – сигнал является источником события;
  • icon – путь к файлу иконки.

Атрибуты можно вызвать в коде обработчика события.

Пример использования атрибута сигнала в коде обработчика события:

var item_info = SignalTree.GetCurrentItemInfo();
var info = JSON.parse(item_info);
if(info.isWritable == true)
{
 LogView.AddMessage(1,"Новое значение может быть записано");
}
else
{
 LogView.AddMessage(3,"Невозможно записать новое значение");
}

В переменную item_info сохраняется набор значений атрибутов, предоставляемый функцией GetCurrentItemInfo(). В Журнал сообщений выводится сообщение о возможности изменения значения выбранного сигнала.

pDoubleClicked

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

Информация об узле представлена в виде значений следующих атрибутов:

  • tag – адрес сигнала;
  • dataType – тип данных;
  • isWritable – возможность изменения сигнала пользователем;
  • isHistorized – запись истории значений сигнала;
  • isEventSource – сигнал является источником события;
  • icon – путь к файлу иконки.

Атрибуты можно вызвать в коде обработчика события.

Пример использования атрибута сигнала в коде обработчика события:

var item_info = SignalTree.GetCurrentItemInfo();
var info = JSON.parse(item_info);
if(info.isWritable == true)
{
 LogView.AddMessage(1,"Новое значение может быть записано");
}
else
{
 LogView.AddMessage(3,"Невозможно записать новое значение");
}

В переменную item_info сохраняется набор значений атрибутов, предоставляемый функцией GetCurrentItemInfo(). В Журнал сообщений выводится сообщение о возможности изменения значения выбранного сигнала.