Alpha.Community

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

Передача данных между объектами

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

Вы можете передавать:

  • значения свойств объектов или отдельных элементов;

  • произвольный текст.

Переданные данные можно обработать на стороне объекта-получателя любым удобным способом. Один и тот же объект может выступать как отправителем, так и получателем.

Чтобы добавить объекту возможность передавать/принимать данные:

  1. Добавьте объекту дочерний элемент Перемещение.
  2. Разрешите отправку/прием данных с помощью свойств Активность переноса и Активность приема.

Указание изображения при переносе

Чтобы задать изображение, отображаемое рядом с курсором при перетаскивании, укажите путь к файлу в свойстве Изображение элемента Перемещение объекта-отправителя. Вы можете прописать путь вручную или выбрать файл через диалоговое окно, нажав кнопку ... рядом с полем ввода.

Если выбранный файл не находится в папке ресурсов проекта, он будет автоматически скопирован в эту папку.

Создание иллюзии перетаскивания

Чтобы создать иллюзию перетаскивания данных, используйте обработчики событий:

  • MousePress объекта-отправителя – для задания передаваемых данных;
  • OnDrop элемента Перемещение объекта-получателя – для обработки полученных данных.

Чтобы реализовать перетаскивание частей элемента Дерево, используйте обработчик события ItemPressed. В этом случае передаваемые данные также задаются в обработчике ItemPressed, а их обработка выполняется в обработчике OnDrop.

Для выполнения перетаскивания:

  1. Щелкните на объекте-отправителе и удерживайте кнопку мыши;
  2. Перетащите указатель на объект-получатель;
  3. Отпустите кнопку мыши – событие OnDrop обработает полученные данные.

Перед указанием передаваемых данных на стороне объекта-отправителя оцените объем и содержание передаваемых данных и выберите способ передачи.

Способы передачи данных между объектами:

Передача данных единым блоком

Если необходимо передать крупный фрагмент данных (например, произвольный текст), который требуется в полном объёме на стороне каждого объекта-получателя, используйте передачу данных единым блоком. Для передачи используйте функции SetText (SetHtml) элемента Перемещение на стороне объекта-отправителя и функции GetText (GetHtml) параметра data события OnDrop элемента Перемещение на стороне объекта-получателя.

Чтобы настроить передачу единого блока данных, выполните:

  1. Для объекта-отправителя и объекта-получателя добавьте дочерний элемент Перемещение.
  2. В обработчике события MousePress объекта-отправителя укажите передаваемые данные с помощью функции SetText (SetHtml) элемента Перемещение.

    //передать-теги-сигналов-датчика-P_01
    P_01.DragNDrop_1.SetText("P_01.Pressure.Value\nP_01.Pressure.Delta.Value\nRotationnP_01.Pressure.Speed:Value\nP_01.SensorQ.Q\nnP_01.SensorQ.Qdiff\nnP_01.SensorDensity.Density");
    SW_1.DragNDrop_1.DoDragDrop();

    //передать-высоту-прямоугольника
    DragNDrop_1.SetText(Str.ToString(Rectangle_1.Height));
    DragNDrop_1.DoDragDrop();
  3. Для запуска перемещения данных используйте функцию DoDragDrop элемента Перемещение. Вызывайте функцию сразу же после вызова функции SetText (SetHtml) (см. рисунок выше).
  4. В обработчике события OnDrop элемента Перемещение разрешите объекту-получателю принимать любой текстовый блок с помощью функции GetText (GetHtml) параметра data.

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

    //записывать текст, полученный от любого объекта, в поле ввода
    LineEdit_2.Text = data.GetText();

Передача данных частями

Если каждому из объектов-получателей нужна только определённая часть из всего передаваемого блока, либо вы хотите разбить блок данных на части перед отправкой, используйте функцию SetData элемента Перемещение на стороне объекта-отправителя. С помощью функции SetData каждой отдельной части можно присвоить тип (идентификатор). Типы позволяют ограничить объем принимаемых данных на объекте-получателе.

Используйте функцию AddAcceptedFormat элемента Перемещение, чтобы указать типы, разрешённые для приёма. При получении блока данных объект-получатель ориентируется на список разрешённых принимаемых типов и принимает только типы из списка. Для приёма типов на стороне объекта-получателя используйте функцию GetData параметра data события OnDrop элемента Перемещение.

Чтобы настроить передачу данных по частям, выполните:

  1. Для объекта-отправителя и объекта-получателя добавьте дочерний элемент Перемещение.
  2. В обработчике события MousePress объекта-отправителя укажите передаваемые данные с помощью функции SetData элемента Перемещение. Для каждой отдельной части используйте свою функцию SetData и присваивайте свой тип (идентификатор).

    Rectangle_1.Text_3.DragNDrop_out.SetData("value", Text_3.Text);
    Rectangle_1.Text_3.DragNDrop_out.SetData("width", Str.ToString(Text_3.Width));
    Rectangle_1.Text_3.DragNDrop_out.SetData("height", Str.ToString(Text_3.Height));
    Text_3.DragNDrop_out.DoDragDrop();
  3. Для запуска перемещения данных используйте функцию DoDragDrop элемента Перемещение. Вызывайте функцию сразу же после вызова функции SetData (см. рисунок выше).
  4. Составьте список разрешённых принимаемых типов для объекта-получателя с помощью функции AddAcceptedFormat элемента Перемещение. Необходимо, чтобы список был обработан перед сбросом данных на объект-получатель. К примеру, укажите список принимаемых типов в обработчике события Opened для формы.

    Rectangle_2.DragNDrop_in.AddAcceptedFormat("value");
    Rectangle_2.DragNDrop_in.AddAcceptedFormat("width");
    Rectangle_2.DragNDrop_in.AddAcceptedFormat("Height");
  5. В обработчике события OnDrop элемента Перемещение настройте обработку полученных типов с помощью функции GetData параметра data. Для каждого принимаемого типа используйте свою функцию GetData.

    TextEdit_1.Text = data.GetData("value");
    TextEdit_2.Text = data.GetData("width");
    TextEdit_3.Text = data.GetData("Height");

Передача бинарных данных

Если вы хотите передать блок бинарных данных, передавайте такие данные в виде массива. Имя массива и его размер указывайте с помощью функции SetDataSize. Для указания передаваемых данных используйте функцию SetDataAt элемента Перемещение на стороне объекта-отправителя. Для получения размера массива на стороне объекта-получателя используйте функцию GetDataSize параметра data события OnDrop элемента Перемещение. Для получения значений из массива используйте функцию GetDataSize параметра data события OnDrop элемента Перемещение.

Чтобы настроить передачу данных в виде массива, выполните:

  1. Для объекта-отправителя и объекта-получателя добавьте дочерний элемент Перемещение.
  2. В обработчике события MousePress объекта-отправителя укажите размер и имя массива с помощью функции SetDataSize. Укажите передаваемые данные с помощью функции SetDataAt элемента Перемещение. Для каждого элемента массива используйте свою функцию SetDataAt.

    Rectangle_1.DragNDrop_1.SetDataSize(Type,4);
    Rectangle_1.DragNDrop_1.SetDataAt(Type,0,State);
    Rectangle_1.DragNDrop_1.SetDataAt(Type,1,Energy);
    Rectangle_1.DragNDrop_1.SetDataAt(Type,2,Model);
    Rectangle_1.DragNDrop_1.SetDataAt(Type,3,Mode2);
    Rectangle_1.DragNDrop_1.DoDragDrop();
  3. Для запуска перемещения данных используйте функцию DoDragDrop элемента Перемещение. Вызывайте функцию сразу же после вызова функции SetData (см. рисунок выше).
  4. На стороне объекта-получателя в обработчике события OnDrop элемента Перемещение настройте обработку полученного массива с помощью функции GetDataAt параметра data. Для каждого элемента массива используйте свою функцию GetDataAt.

    State = data.GetDataAt(Type, 0) != 0 ? true : false;
    Energy = data.GetDataAt(Type, 1) != 0 ? true : false;
    Model = data.GetDataAt(Type, 2) != 0 ? true : false;
    Node2 = data.GetDataAt(Type, 3) != 0 ? true : false;

Как настроить передачу данных между объектами (Демо-проект)

Ниже приведён пример (скачать его можно здесь) настройки перетаскивания данных между объектами в проекте Alpha.HMI с использованием языка Alpha.Om.

В результате выполнения примера будет подготовлена форма с двумя текстовыми полями, между которыми можно перетаскивать данные:

  • В первом текстовом поле отображается имя тега Tank_Level.PV.
  • При щелчке левой кнопкой мыши на первом поле и перетаскивании курсора на второе поле (не отпуская кнопку мыши) происходит передача текстового значения.

  • Второе текстовое поле автоматически отображает переданное значение в формате Получен тег: Tank_Level.PV.

Подготовка объекта-отправителя

  1. Добавьте на форму текстовое поле, которое будет служить источником данных.
  2. В свойстве Текст текстового поля задайте значение Tank_Level.PV - это значение будет передаваться при перетаскивании.

  3. Добавьте к текстовому полю дочерний элемент Перемещение. Для этого в Структуре объекта правой кнопкой мыши щелкните на Text_1 → Создать. В мастере создания элементов выберите тип элемента Перемещение.


  4. Для элемента Перемещение включите активность переноса, установив свойство Активность переноса в значение true.

  5. Настройте обработчик события MousePress для текстового поля. Пример кода:

    // Передача имени тега
    DragDrop_1.SetText(Text_1.Text);
    DragDrop_1.DoDragDrop();

Подготовка объекта-получателя

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

  3. Для элемента Перемещение включите активность приема, установив свойство Активность приема в значение true.

  4. Настройте обработчик события OnDrop для элемента Перемещение второго текстового поля. Пример кода:

    // Получение переданного имени тега и его отображение
    receivedTag: string = data.GetText();
    Text_2.Text = "Получен тег: " + receivedTag;

Как передавать теги сигналов в Alpha.Trends

Ниже приведен пример подготовки любого объекта на мнемосхеме к перетаскиванию нескольких (или всех) его сигналов на трендовое поле встраиваемого компонента Alpha.Trends.

  1. Для объекта Pressure_4 добавлен дочерний элемент Перемещение.

  2. Для элемента Перемещение включена активность переноса (свойство Активность переноса).
  3. В обработчике события MousePress для объекта Pressure_4 указаны полные теги передаваемых сигналов. Для указания используется функция SetText элемента Перемещение. Для разделения тегов используются символы \r\n.

    Pressure_4.DragNDrop_1.SetText("KP_28.P_04.Pressure\r\nKP_28.P_04.PressureSpeed");
    Pressure_4.DragNDrop_1.DoDragDrop();
  4. После перетаскивания объекта на трендовое поле или легенду Alpha.Trends отображают графики указанных сигналов. Настройка обработки списка тегов в Alpha.Trends не требуется, такая функциональность уже заложена в приложение.