Компоненты GUI для серии Intelligent

Компонент "Переключатель (Switch)" повторяет все существующие возможности кнопки с двумя состояниями, сочетает графику и текст. В режиме закраски сплошным цветом, пользователю доступна настройка визуального оформления .dis, изменяющая радиус закругления внешних углов.

С помощью компонента "Комбинированный список (ComboBox)", пользователь может создавать области страницы с горизонтальным или вертикальным выпадающим списком из двух и более выбираемых пунктов (значимых ячеек). Текущая актичная ячейка может быть определена по значениям атрибутов .txt (содержимое ячейки) и .val (номер ячейки). Комбинированный список обладает большим количеством настраиваемых атрибутов визуального оформления, включая возможность прокрутки ячеек, неуместившихся в зоне видимости списка:

• Текстовая строка содержимого ячейки (атрибут .txt);
• Максимальный размер памяти в байтах для текстовой строки (.txt_maxl);
• Отображение значка выпадающего списка (атрибут .up);
• Формирование выпадающего списка из ячеек с содержимым (атрибут .path). Каждая строка с текстовым содержимым, вводимая в многострочном поле атрибута .path, добавляет новую ячейку с инкрементированным порядковым номером.
• Максимальный размер памяти в байтах (.path_m) для содержимого в атрибуте .path;
• Направление для раскрытия/свёртывания списка: влево (.dir left), вправо (.dir right), вверх (.dir up) или вниз (.dir down);
• Количество ячеек 1-254 списка, видимых пользователю в пределах области прокрутки (.qty);
• Расстояние между ячейками 0-255 (.vvs0);
• Номер выбранной ячейки в списке (.val), нумерация начинается с 0;
• Настройка ширины/высоты ячеек списка (.hig). Значениями 16-255 регулируется высота ячейки при раскрытии списка вверх/вниз, или ширина ячейки при раскрытии списка влево/вправо;
• Исходное состояние списка: раскрыт (.down expansion) или свёрнут (.down contraction);
• Настройка стиля маркеров в области прокрутки (.mode): скрыты (no display), только треугольники (only display triangle), задний фон и треугольники (display background + trinagle);
• Настройка ширины/высоты маркеров в области прокрутки (.wid). Значениями 8-255 регулируется высота ячейки при раскрытии списка вверх/вниз, или ширина ячейки при раскрытии списка влево/вправо;
• Расстояние между маркерами области прокрутки и первой/последней ячейками (.vvs1);
• Инерционная сила (скорость) прокрутки (.ch) ячеек списка. Принимает значения от 0 до 32, 0 - безынерционная.

Значимые ячейки компонента "Циклично прокручиваемый список (TextSelect)" скрыть не возможно, они всегда остаются на виду. В остальном, гибко настраиваемый виджет TextSelect повторяет возможности компонента Combobox, отличаясь от него лишь стилем визуального оформления. Прокручивая зацикленный список касательными жестами вверх или вниз, пользователь может выбрать активную ячейку, которая всегда расположена в центре списка.

Компонент "Скользящий текст (SLText)" накладывает на страницу проекта слой с текстовой областью, содержимое которой от начала до конца может быть прокручено вертикальными касательными жестами. Боковая индикаторная полоса текущего местоположения (атрибут .left) может быть отключена (no dislpay), отображена постоянно (continuous display) или настроена на появление в момент касания/перемещения текста (operation time display). Атрибут .maxval_y не принимает значения. Он автоматически определяет и возвращает значение максимально возможного вертикального перемещения по оси Y (зависит от размера содержимого текстовой области). Текущее вертикальное смещение текста в области SLText от нулевой позиции определяется и задаётся значением атрибута .val_y.

Компонент "Логирование данных (DataRecord)" — всегда глобальная область отображения набора данных в табличной форме, с возможностью её горизонтальной или вертикальной прокрутки касательными жестами. Данные таблицы могут быть сохранены или загружены из файла, путь к которому указан в атрибуте .path (например, sd0/1.data). Если файл с указанным именем не найден, то автоматически создаётся новый файл сохранения, учитывающий текущие настройки таблицы (атрибут .mode allowed). Заданный размер памяти в байтах для одной записи или строки (.lenth) с ограничением по количеству возможных записей в таблице (.maxval) определяют конечный размер файла сохранения табличных данных на карте памяти SD. Новая запись с порядковым номером, большим чем разрешено в атрибуте .maxval, удаляет первую запись таблицы. Отклонение одного из текущих параметров таблицы (таких как длина записи, количество полей одной записи или общее количество записей, формат, и т.д.) от сохранённых в файле параметров таблицы, вызывает конфликт обращения к файлу данных. Для каждого существующего/привязанного файла логирования данных, текущие настройки и сохранённые параметры таблицы должны совпадать.

Записи в таблице могут состоять из 1-12 полей или столбцов (атрибут .dez). Ширина поля задаётся атрибутом .format. Значения ширины двух и более полей разделяется символом карет (^). Если параметр не задан, все столбцы выравниваются по одинаковой ширине. Атрибут .dir принимает текстовое значение с названием одного/нескольких заголовков таблицы, точно также перечисляемых через символ карет (^). Атрибут .order определяет порядок добавления новой записи: в начало таблицы (New data before) или в конец (New data after). Выбрав определённую запись, визуально выделяемую в момент касания сенсорной панели в области DataRecord, пользователь может считать порядковый номер записи в таблице (.val), и её строковое содержимое, состоящее из перечисления всех полей (.txt).

Компонент Логирование данных имеет четыре внутренние функции (четыре метода) управления записями в таблице:

• .insert(newtxt) — вносит новую запись в таблицу. Пример: data0.insert(val0.txt);
• .delete(pos, qty) — начиная с указанного порядкового номера pos в таблице, удаляет выбранное количество записей следующих друг за другом строк qty (id=5 qty=10 удалит подряд десять строк, начиная с пятой, т.е. с 5 по 14);
• .up(newtxt, pos) — присваивает табличной записи с порядковым номер pos новое текстовое содержимое из строковой переменной newtxt. Пример: data0.up(val0.txt,5);
• .clear() — очищает всю таблицу и файл, если привязан, от записей.

Успешно выполненные функции .insert(), .delete() и .up() возвращают логическое состояние 1.

Компонент "Файловый проводник (FileBrowser)" — простой страничный виджет, отображающий список файлов и папок для указанного в атрибуте .path пути. С помощью виджета Файловый проводник, пользователь может выводить в окне список файлов, отфильтрованных по ключевым маскам (по умолчанию, фильтр настроен на показ всего содержимого - *.*). В режиме мультифильтрации, ключевые маски должны быть разделены символом "|" в поле атрибута .filter (например, "*.txt|*.data"). Для формирования списка путей и файлов, виджету Файловый проводник требуется буфер памяти. Рекомендуемый размер выделяемой памяти, первоначально установленный в параметре .buffsize, составляет 32000 байт. Текущий путь содержится в атрибуте .dir, порядковый номер выбранного из списка файла находится в атрибуте .val, имя выбранного файла - в атрибуте .txt, количество добавленных в список файлов - в атрибуте .qty. Доступность папок вместе с их отображением в проводнике настраивается атрибутом .psta Yes или .psta No. Разрабатывая дизайн проекта, пользователь может позаимствовать стоковые иконки папок и файлов. Или заменить их на свои (в поле атрибута .vvs2), добавив необходимые изображения в графические ресурсы.

Компонент Файловый проводник наделён единственной внутренней функцией (методом) .up, выполняющей переход в предыдущий каталог. Функция .up не принимает параметры, и возвращает логическое состояние 1 при условии успешного выполнения. Пример: fbrowser0.up()

Компонент "Запись/чтение файла (FileStream)" — это невизуальный локальный системный компонент, предназначенный для работы с файлами. Встроенные функции FileStream позволяют разработчику HMI-проекта открывать файлы (.open), считатывать данные (.read) или записывать данные (.write) в файл, закрывать (.close) файл после выполнения операций, и выполнять поиск (.find) нужного содержимого в файле по ключевой фразе. Все функции возвращают логическую 1, если они выполнены успешно. Аналогичный ответ возвращает атрибут .en, если файл найден и открыт. Указатель текущего местоположения (атрибут .val) может принимать новое значение и возвращать текущее значение, перемещаясь под данным в процессе операций чтения-записи файла. В момент открытия файла, значение указателя сбрасывается в 0.

На одной странице HMI-проекта может располагаться до 16 компонентов "Область анимации (Gmov)", настроенных на однократное или циклично-повторяемое воспроизведение файлов в формате .gmov. Во внешнем редакторе GmovMaker, запускаемого из панели инструментов Nextion Editor, пользователь может создавать собственные файлы с анимационными изображениями. Поддерживаемый формат исходный графических файлов: *.jpg, *.bmp, *.png и *.gif. Компонент Область анимации позволяет вызывать код обработки события при касании сенсорной панели, её отпускания, или каждый раз после достижения финального кадра анимационной последовательности.

До шести компонентов "Видео (Video)" может одновременно размещаться на любой странице HMI-проекта. Задействованные в проекте видеофайлы могут храниться как в памяти экранного модуля Nextion (.from internal file), так и на карте microSD (.from external file). Внешний редактор VideoBox, доступный из панели инструментов, умеет конвертировать исходные пользовательские видео в формат Nextion .video. Атрибут .loop yes компонента Видео задаёт цикличный режим воспроизведения видео. Настраиваемый атрибут .en управляет состоянием компонента Видео (остановка, проигрывание или пауза). Автоматически вычисляемые значения общей продолжительности во времени и кадрах для привязанного видеофайла считываются из атрибутов .stim и .qty. Скорость воспроизведения в процентном соотношении и текущее положение во времени настраиваются атрибутами .dis и .tim.

Возможности управления невизуальным компонентом "Аудио (Audio)", с выбором места хранения звуковых ресурсов, схожи с предыдущим компонентом Видео. Экранные устройства Nextion поддерживают воспроизведение исключительно одноканального аудио, предварительно сконвертированного в формат Nextion .wav во внешнем редакторе VideoBox из панели инструментов. Оба компонента Аудио и Видео позволяют вызывать код обработки различных событий, в том числе при достижении окончания воспроизведения файла.

Компонент "Внешний рисунок (ExPicture)" добавляет на страницу область статичного изображения. Файл с изображением, преобразованным в формат Nextion .xi во внешнем редакторе PictureBox (с учётом ориентации дисплея), может храниться во внутренней памяти или на карте microSD.

Добавление новых компонентов на текущую страницу HMI-проекта выполняется очень легко — простой щелчок мыши в панели компонентов моментально переносит выбранный компонент на страницу, и ему сразу же присваивается индивидуальный идентификатор .id, равный количеству компонентов этой страницы. Все существующие компоненты текущей страницы, перечисленные в порядке возрастания .id, располагаются в раскрывающемся списке панели атрибутов.

Картинки для описываемых в руководстве редактора Nextion компонентов взяты из ознакомительно-демонстрационного HMI-проекта, созданного коллективом ООО "КомпактТул". Файл можно загрузить по представленной ссылке:

• NX8040P070_011_DemoHMI_v1.61.2NE.hmi (~32МБ)