ELimits.GetPoints (Получить точки из лимита)
Описание
Возвращает заданное количество точек из таблицы данных лимита, начиная с указанного индекса.
Свойства
| Входной аргумент | Тип аргумента | Тип переменной | Описание |
|---|---|---|---|
| limits | Константа, Переменная, Выражение | ELimits | Лимит |
| all | Константа, Переменная, Выражение | Boolean | Получить все точки лимита |
| index | Константа, Переменная, Выражение | Int32 | Начальный индекс, с которого будет выполняться чтение точек лимита |
| count | Константа, Переменная, Выражение | Int32 | Количество точек лимита, которое необходимо считать |
| Выходной аргумент | Тип аргумента | Тип переменной | Описание |
|---|---|---|---|
| arrayX | Переменная | Double[] | Массив значений координат X |
| arrayMin | Переменная | Double[] | Массив значений нижнего предела лимита |
| arrayMax | Переменная | Double[] | Массив значений верхнего предела лимита |
Пример
Рассмотрим работу блока на примере простой программы, которая обеспечивает считывание пользовательских точек лимита в массивы и дальнейшее их отображение на графике.
Создадим глобальные переменные, необходимые для работы программы. Данные переменные мы будем использовать с привязкой к элементам управления интерфейса пользователя.
ELimit – переменная типа ELimits, из которой мы будем получать точки. Xpoints – массив точек X. YminPoints – массив минимальных значений лимита Ymin. YmaxPoints – массив максимальных значений лимита Ymax. pointIndex – начальный индекс чтения точек из массива данных лимита. pointsNum – количество считываемых точек.
Создадим интерфейс пользователя. Нажмем правой кнопкой по заголовку программы и выберем пункт меню «Добавить новый элемент».
Выберем элемент «Панель управления» и введем имя элемента. Нажмем кнопку «Создать»
Добавим на панель управления следующие элементы: Интерактивные элементы -> Кнопка; Визуализация данных -> Декартова диаграмма. Ввод данных -> Числовой ввод (2 элемента);
Последовательно выберем каждый из добавленных элементов, в свойствах элементов введем соответствующие имена и выполним привязку значения к переменным следующим образом: Индекс точки: значение -> переменная pointIndex; Количество точек: значение -> переменная pointsNum; Пример привязки элемента панели управления «Индекс точки» к переменной pointIndex показан на следующем рисунке.
Включим событие «Click» и введем имя в свойствах кнопки.
Нажмем правой кнопкой мыши по графику и выберем пункт меню «Настройка». Выполним настройку графика, как показано на следующем рисунке.
Перейдем на холст выполняемой программы. Действия программы будут происходить по нажатию пользователем на кнопку «Получить точки лимита». Для этого запуск программы должен начинаться с отображения дашборда, Добавим блок «ShowDashboard» и выберем созданную панель управления в меню настройки:
Блок обработки события свяжем с программным алгоритмом, обеспечивающим соответствующие манипуляции с переменной ELimit. Добавим на холст блок ELimits.GetPoints. В качестве входной переменной ELimits в блоке ELimits.GetPoints укажем переменную «ELimit».
В блоке Handler выберем созданное событие нажатия кнопки.
Следующий блок - ELimits.GetPoints. Здесь мы можем получить заданное количество точек pointsNum в массивы «Xpoints», «YminPoints» и «YmaxPoints» из переменной ELimit начиная с индекса, указанного в переменной pointIndex. В приведенном примере переменной All присвоено значение "True", в этом случае значения переменных pointsNum и pointIndex игнорируются, в вышеуказанные массивы будут переданы все точки из переменной ELimit. Массивы Xpoints, YminPoints и YmaxPoints, также являются источником значений X, Ymin и Ymax для графика на панели управления.
После передачи данных из лимита в массивы следует вызвать блок UpdateChart, который обеспечит отображение новых данных на графике пользовательского интерфейса. В свойствах выберем панель управления и график, который следует обновить.
Нажмем правой кнопкой мыши по переменной ELimit и выберем пункт меню «Редактировать начальное значение», как показано на следующем рисунке, чтобы внести данные, которые будут храниться в лимите при запуске программы.
Посмотрим, как работает пример.
Мы также можем просмотреть значения масивов «Xpoints», «YminPoints» и «YmaxPoints» после выполнения блока ELimits.GetPoints. Для этого перейдем в меню контекста и нажмем на кнопку просмотра значения переменной, как показано на следующем рисунке.
Значения массивов «Xpoints», «YminPoints» и «YmaxPoints» приведены на следующем рисунке.
