ETrace.InsertPoints (Вставить точки в трассу)

Описание

Вставляет массив точек в таблицу данных трассы, начиная с заданного индекса.

Свойства

Пример

Рассмотрим работу блока на примере простой программы, которая обеспечивает добавление массивов ArrayX и ArrayY в таблицу данных объекта типа ETrace с отображением результата на графике.

Создадим глобальные переменные, необходимые для работы программы. Данные переменные мы будем использовать с привязкой к элементам управления интерфейса пользователя.

ETrace – переменная типа ETrace, в которую мы будем вставлять точки данных. ArrayX – массив точек X. ArrayY – массив точек Y Xpoints – массив значений X, в который будем считывать координаты всех точек по оси абсцисс из объекта типа ETrace. Ypoints – массив значений Y, в который будем считывать координаты всех точек по оси ординат из объекта типа ETrace. pointIndex – начальный индекс строки в таблице данных переменной ETrace, начиная с которого будут добавлены новые точки.

Создадим интерфейс пользователя. Нажмем правой кнопкой по заголовку программы и выберем пункт меню «Добавить новый элемент».

Выберем элемент «Панель управления» и введем имя элемента. Нажмем кнопку «Создать».

Добавим на панель управления следующие элементы: Ввод данных -> Числовой ввод; Интерактивные элементы -> Кнопка; Визуализация данных -> Декартова диаграмма.

Последовательно выберем каждый из добавленных элементов, в свойствах элементов введем соответствующие имена и выполним привязку значения к переменным следующим образом: Индекс точки: значение -> переменная pointIndex; Пример привязки элемента панели управления «Индекс точки» к переменной pointIndex показан на следующем рисунке.

Включим событие «Click» и введем имя в свойствах кнопки. Также в данном меню можно настроить другие свойства кнопки.

Нажмем правой кнопкой мыши по графику и выберем пункт меню «Настройка». Выполним настройку графика, как показано на следующем рисунке.

Перейдем на холст выполняемой программы. Действия программы будут происходить по нажатию пользователем на кнопку «Добавить точки». Для этого запуск программы должен начинаться с отображения дашборда. Добавим блок «ShowDashboard» и выберем созданную панель управления в меню настройки.

Блок обработки события свяжем с программным алгоритмом, обеспечивающим соответствующие манипуляции с переменной ETrace. Добавим на холст блок ETrace.InsertPoints.

В блоке Handler выберем созданное событие нажатия кнопки.

Следующий блок - ETrace.InsertPoints. Тут мы добавим значения массивов «XArray» и «YArray» в таблицу данных объекта типа ETrace начиная с номера строки, указанного в переменной pointIndex. В качестве входной переменной ETrace в блоке ETrace.InsertPoints укажем переменную «ETrace».

Выполнение манипуляций с объектом типа ETrace завершается обновлением графика на панели управления. Для этого применяется блок ETrace.GetPoints, который передает точки данных указанного трейса в два массива. Можно передать как все точки, так и указать начальный индекс, а также количество точек, которые необходимо передать в массивы. В нашем случае данные передаются в массивы Xpoints и Ypoints, которые также являются источником значений X, Y графика на панели управления.

После передачи данных из объекта типа ETrace в массив следует вызвать блок UpdateChart, который обеспечит отображение новых данных на графике пользовательского интерфейса. В свойствах блока выберем панель управления и график, который следует обновить.

Введем начальные значения для переменных «XArray» и «YArray», данные значения будут присвоены переменным при запуске программы и впоследствии мы передадим их в переменную ETrace. Выберем переменную в списке и перейдем в интерфейс редактирования начального значения посредством нажатия на кнопку редактирования в меню свойств переменной, как показано на следующем рисунке.

Нажмем правой кнопкой мыши по переменной ETrace и перейдем в интерфейс редактирования начального значения посредством нажатия на кнопку редактирования в меню свойств переменной, как показано на следующем рисунке, чтобы внести данные, которые будут храниться в данной переменной при запуске программы. Введем значения лимита, представленные на следующем рисунке.

Посмотрим, как работает пример.

Перейдем в меню "Контекст" для просмотра таблицы данных, которая хранится в переменной ETrace после выполнения программы, как показано на следующем рисунке.