ELimits.InsertPoints
ELimits.InsertPoints - вставляет массивы точек (ArrayX, ArrayMin, ArrayMax) в таблицу данных объекта типа ELimits, начиная с заданной позиции Index.
Свойства
| Входной аргумент | Тип аргумента | Тип переменной | Описание |
|---|---|---|---|
| ELimits | Variable | ELimits | Объект типа ELimits |
| ArrayX | Variable | Double[] | Массив значений X |
| ArrayMin | Variable | Double[] | Массив значений нижнего предела лимита |
| ArrayMax | Variable | Double[] | Массив значений верхнего предела лимита |
| Index | Variable | Int | Начальный индекс строки в таблице данных переменной ELimits, начиная с которой будут добавлены новые точки |
Пример
Рассмотрим работу блока на примере простой программы, которая обеспечивает добавление пользовательских точек лимита с отображением данного лимита на графике.
Создадим глобальные переменные, необходимые для работы программы. Данные переменные мы будем использовать с привязкой к элементам управления интерфейса пользователя.
ELimit – переменная типа ELimits, в которую мы будем добавлять точки.
Xpoints – массив точек X.
YminPoints – массив минимальных значений лимита Ymin.
YmaxPoints – массив максимальных значений лимита Ymax.
pointIndex – начальный индекс точки в массиве данных лимита, начиная с которого будут добавлены новые точки данных лимита.
Создадим интерфейс пользователя. Нажмем правой кнопкой по заголовку программы и выберем пункт меню «Добавить новый элемент».

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

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

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

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

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

Блок обработки события свяжем с программным алгоритмом, обеспечивающим соответствующие манипуляции с переменной ELimit. Добавим на холст блок ELimits.InsertPoints. В качестве входной переменной ELimits в блоке ELimits.InsertPoints укажем переменную «ELimit».
В блоке Handler выберем созданное событие нажатия кнопки.
Следующим блоком идёт ELimits.InsertPoints. Тут мы добавим текущие значения «Xpoints», «YminPoints» и «YmaxPoints» в переменную ELimit начиная с индекса, указанного в переменной pointIndex.
Выполнение манипуляций с лимитом завершается обновлением графика на панели управления. Для этого применяется блок ELimits.GetPoints, который передает точки указанного лимита в три массива. Можно передать как все точки, так и указать начальный индекс, а также количество точек, которые необходимо передать в массив. В нашем случае данные передаются в массивы Xpoints, YminPoints и YmaxPoints, которые также являются источником значений X, Ymin и Ymax графика на панели управления.

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

Введем начальные значения для переменных «Xpoints», «YminPoints» и «YmaxPoints», данные значения будут присвоены массивам при запуске программы и впоследствии мы передадим их в переменную ELimit. Выберем переменную в списке и перейдем в интерфейс редактирования начального значения посредством нажатия на кнопку редактирования в меню свойств переменной, как показано на следующем рисунке.
Введем начальные значения массивов, данные значения будут применяться в качестве значений по умолчанию при запуске программы:
Нажмем правой кнопкой мыши по переменной ELimit и выберем пункт меню «Редактировать начальное значение», как показано на следующем рисунке, чтобы внести данные, которые будут храниться в лимите при запуске программы.

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