ETrace.Clear (Удалить точки из трассы)

Описание

Удаляет все точки из таблицы данных трассы.

Свойства

Пример

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

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

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

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

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

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

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

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

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

Свяжем стартовый узел программы с добавленным блоком «ShowDashboard», как показано на рисунке.

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

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

Следующим блоком идёт ETrace.Clear. В данном блоке необходимо просто выбрать переменную типа ETrace, из которой следует удалить все точки данных.

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

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

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

Запустим программу и посмотрим, как работает пример.

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