From OpenSCADAWiki
Jump to: navigation, search

Таблица. Набор дополнительных свойств/атрибутов примитива "Элемент формы (FormEl)"

Идентификатор Имя Номер Значение
elType Тип элемента 20 Тип элемента, от значения которого зависит перечень дополнительных атрибутов:
  • Строка редактирования (0)
  • Редактор текста (1)
  • Флажок (2)
  • Кнопка (3)
  • Выбор из списка (ComboBox) (4)
  • Список (5)
  • Дерево (8)
  • Таблица (9)
  • Слайдер (6)
  • Полоса прокрутки (7)
Строка редактирования:
value Значение 21 Содержимое строки.
view Вид 22 Вид строки редактирования:
  • Текст (0)
  • Комбобокс (1)
  • Целое (2)
  • Вещественное (3)
  • Время (4)
  • Дата (5)
  • Дата и время (6)
  • Пароль (7)
cfg Конфигурация 23

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

Текст — конфигурация форматированного ввода по шаблону с параметрами (поддерживается только Qt в UI.Vision):
A — Необходим ASCII алфавитный символ, [A-Za-z].
a — Разрешён, но не обязателен, ASCII алфавитный символ.
N — Необходим ASCII алфавитно-цифровой символ, [A-Za-z0-9].
n — Разрешён, но не обязателен, ASCII алфавитно-цифровой символ.
X — Необходим любой символ.
x — Разрешён, но не обязателен, любой символ.
9 — Необходима ASCII цифра, [0-9].
0 — Разрешёна, но не обязательна, ASCII цифра.
D — Необходима ASCII цифра, [1-9].
d — Разрешёна, но не обязательна, ASCII цифра.
# — Разрешёны, но не обязательны, ASCII цифра или знаки плюс/минус.
H — Необходим символ шестнадцатеричного числа, [A-Fa-f0-9].
h — Разрешён, но не обязателен, символ шестнадцатеричного числа.
B — Необходим бинарный символ, [0-1].
b — Разрешён, но не обязателен, бинарный символ.
> — Все следующие алфавитные символы в верхнем регистре.
< — Все следующие алфавитные символы в нижнем регистре.
! — Выключение преобразования регистра.
\\ — Используйте в разделителях, для экранирования специальных символов, которые перечислены.
Комбобокс — список значений редактируемого комбо-бокса, по строкам.
Целое — значение целого числа в форме: "{Минимум}:{Максимум}:{ШагИзменения}:{Префикс}:{Суффикс}".
Вещественное — значение вещественного числа в форме: "{Минимум}:{Максимум}:{ШагИзменения}:{Префикс}:{Суффикс}:{ЗнаковПослеТочки}".
Время, Дата, Дата и время — формировать дату по шаблону с параметрами:
d — номер дня (1-31);
dd — номер дня (01-31);
ddd — сокращённое наименование дня ("Mon" ... "Sun");
dddd — полное наименование дня ("Monday" ... "Sunday");
M — номер месяца (1-12);
MM — номер месяца (01-12);
MMM — сокращённое имя месяца ("Jan" ... "Dec");
MMMM — полное имя месяца ("January" ... "December");
yy — последние две цифры года;
yyyy — год полностью;
h — час (0-23);
hh — час (00-23);
m — минуты (0-59);
mm — минуты (00-59);
s — секунды (0-59);
ss — секунды (00-59);
AP,ap — отображать AM/PM или am/pm.
confirm Подтверждать 24 Включение режима подтверждения.
font Шрифт 25

Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}", где:

  • "family" — семейство шрифта, для пробелов используйте символ '_', вроде: "Arial", "Courier", "Times_New_Roman";
  • "size" — размер шрифта в пикселях;
  • "bold" — усиление шрифта (0 или 1);
  • "italic" — наклонность шрифта (0 или 1);
  • "underline" — подчёркивание шрифта (0 или 1);
  • "strike" — перечёркивание шрифта (0 или 1).

Примеры:

  • "Arial 10 1 0 0 0" — Arial шрифт размером 10 пикселей и усиленный.
Редактор текста:
value Значение 21 Содержимое редактора.
wordWrap Перенос слов 22 Автоматический перенос текста по словам.
confirm Подтверждать 24 Включение режима подтверждения.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Флажок:
name Имя 26 Имя/метка флажка.
value Значение 21 Значение флажка.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Кнопка:
name Имя 26 Имя-надпись на кнопке. Допустимы символы '\n' для возможности ввода многострочных надписей.
value Значение 21

Значение, отличается для разных режимов:

  • "Стандарт" — параметры повтора событий при удержании {задержка}-{интервал}, время в миллисекундах;
  • "Переключатель" — значение переключателя;
  • "Меню" — список адресов элементов меню вида /grp1/grp2/item1;
  • "Загрузка" — строка описания {ШаблонФайлов}|{Заголовок}|{ФайлПоУмолчаниюИЗагр}|{ФайлMime} и содержимое загруженного файла. Шаблон файлов в виде "Изображение (*.png *.xpm *.jpg);;CSV-файл (*.csv)".
  • "Сохранение" — строка описания {ШаблонФайлов}|{Заголовок}|{ФайлПоУмолчанию}|{ФайлMime} и содержимое сохраняемого файла. Шаблон файлов как и выше.
img Изображение 22

Изображение на кнопке. Имя изображения в виде "[{src}:]{name}", где:

  • "src" — источник изображения:
    • file — прямо из локального файла по пути;
    • res — из таблицы ресурсов БД.
  • "name" — путь файла или идентификатор ресурса.

Примеры:

  • "res:backLogo" — из таблицы ресурсов БД для идентификатора "backLogo";
  • "backLogo" — как и предыдущий;
  • "file:/var/tmp/backLogo.png" — из локального файла по пути "/var/tmp/backLogo.png".
color Цвет 23

Цвет кнопки. Имя цвета в виде "{color}[-{alpha}]", где:

  • "color" — стандартное имя цвета или его числовое представление из трёх шестнадцатеричных чисел отдельных цветов "#RRGGBB";
  • "alpha" — уровень альфа-канала [0...255], где 0 — полностью прозрачный.

Примеры:

  • "red" — сплошной красный цвет;
  • "#FF0000" — сплошной красный цвет в цифровом коде;
  • "red-127" — полупрозрачный красный цвет.
colorText Цвет: текст 27 Цвет текста (детали выше).
mode Режим 24

Режим работы кнопки:

  • "Стандарт" — обычная кнопка с возможностью повтора событий при удержании, параметры в "value";
  • "Переключатель" — кнопка с фиксацией, значение в "value";
  • "Меню" — открытие меню по нажатию, перечень элементов в "value";
  • "Загрузка" — организация пользовательской загрузки небольших файлов через интерфейс визуализации; при нажатии кнопки, в этом режиме, открывается диалог выбора файла загрузки, а содержимое выбранного файла загружается в атрибут "value";
  • "Сохранение" — организация пользовательского сохранения небольших файлов через интерфейс визуализации; при записи содержимого файла в атрибут "value" пользователю будет открыт диалог выбора/указания файла для сохранения, после выбора, содержимое атрибута "value" сохранится в файл, а "value" очистится.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Список:
value Значение 21 Текущее значение списка.
items Элементы 22 Перечень элементов списка.
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
mult Множественный выбор 23 Разрешать выбор множества элементов списка.
Выбор из списка, Дерево:
value Значение 21 Текущее значение списка.
items Элементы 22 Перечень элементов списка или иерархических элементов дерева в виде пути "/{КАТ}/{КАТ}/{ЭЛЕМ}".
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Таблица:
set Значение установки 23 Значение редактирования ячейки таблицы с адресом в событии "ws_TableEdit_{colN}_{rowN}".
value Значение 21

Адрес выбранного элемента. Изменение сопровождается событием "ws_TableChangeSel". Формат адреса зависит от режима выбора таблицы:

  • "Ячейка" — адрес ячейки в формате "{row}:{col}".
  • "Строка", "Колонка" — номер строки-колонки или содержимое ячейки ключа строки-колонки, указанной атрибутом "keyID".
items Элементы 22

Структура и содержимое таблицы в виде XML: 

<tbl>
<h><s>{Заголовок1}</s><s>{Заголовок2}</s></h>
<r><s>{Ряд1Колонка1Строка}</s><i>{Ряд1Колонка2Целое}</i></r>
<r><b>{Ряд2Колонка1Логическое}</b><r>{Ряд2Колонка2Вещественное}</r></r>
</tbl>

Теги:

"tbl" — Таблица, свойства таблицы в целом:
  • "sel" — режим выбора-выделения элементов таблицы: "row" — по строкам, "col" — по колонкам, "cell" — ячейками (по умолчанию);
  • "keyID" — номер ключевой строки-колонки, для получения значения выбора;
  • "colsWdthFit" — подстраивать размер колонок, размер которых не фиксирован, под заполнение всей ширины таблицы;
  • "hHdrVis", "vHdrVis" — установка видимости горизонтального, вертикального заголовков;
  • "sortEn" — включение прямой сортировки по колонкам.
"h" — Строка заголовков, возможные атрибуты у тегов ячеек заголовка, для колонки в целом:
  • "width" — ширина колонки, в пикселях или процентах (10%);
  • "edit" — возможность редактирования (0 или 1) ячеек колонки, по умолчанию — нет (0);
  • "color" — цвет колонки, в целом, в виде имени цвета или его кода;
  • "colorText" — цвет текста колонки, в целом, в виде имени цвета или его кода;
  • "font" — шрифт текста колонки, в целом, в виде типовой строки OpenSCADA;
  • "prec" — точность значений ячеек вещественного типа в колонке;
  • "sort" — сортировка по данной колонке [0 — по возрастанию-типично; 1 — по убыванию];
  • "align" — выравнивание колонки на предмет: "left", "right" и "center".
"r" — Строка значений, возможные атрибуты у тегов ячеек заголовка, для колонки в целом:
  • "color" — цвет строки, в целом, в виде имени цвета или его кода;
  • "colorText" — цвет текста строки, в целом, в виде имени цвета или его кода;
  • "font" — шрифт текста строки, в целом, в виде типовой строки OpenSCADA;
  • "prec" — точность значений ячеек вещественного типа в строке.
"s", "t", "i", "r", "b" — ячейки типов данных: "Строка", "Текст", "Целое", "Вещественное" и "Логическое". Возможные атрибуты:
  • "color" — цвет ячейки;
  • "colorText" — цвет текста ячейки, в виде имени цвета или его кода;
  • "font" — шрифт текста ячейки, в виде типовой строки OpenSCADA;
  • "prec" — точность значений ячейки вещественного типа;
  • "img" — изображение ячейки, в виде "[{src}:]{name}", детали выше;
  • "edit" — возможность редактирования (0 или 1) ячейки, по умолчанию — нет (0);
  • "align" — выравнивание ячейки на предмет: "left", "right" и "center".
font Шрифт 25 Имя шрифта в виде "{family} {size} {bold} {italic} {underline} {strike}" (детали выше).
Слайдер и полоса прокрутки:
value Значение 21 Положение слайдера.
cfg Конфигурация 22

Конфигурация слайдера в формате: "{ВертОриент}:{Минимум}:{Максимум}:{ОдинШаг}:{СтрШаг}".
Где:

  • "ВертОриент" — признак вертикальной ориентации (0 или 1), по умолчанию ориентация горизонтальная;
  • "Минимум" — минимальное значение;
  • "Максимум" — максимальное значение;
  • "ОдинШаг" — размер одного шага;
  • "СтрШаг" — размер страничного шага.
Retrieved from "http://oscada.org/wiki/index.php?title=Translations:Sub-projects/VCA/149/ru&oldid=82362"