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 Ім'я шрифту, дивіться деталі.
Редактор тексту:
value Значення 21 Вміст редактору.
wordWrap Перенесення слів 22 Автоматичний перенесення тексту за словами.
confirm Підтверджувати 24 Включення режиму підтвердження.
font Шрифт 25 Ім'я шрифту, дивіться деталі.
Прапорець:
name Ім'я 26 Ім'я/мітка прапорця.
value Значення 21 Значення прапорця.
font Шрифт 25 Ім'я шрифту, дивіться деталі.
Кнопка:
name Ім'я 26 Ім'я-надпис на кнопці. Допустимі символи '\n' для можливості вводу багаторядних надписів.
value Значення 21

Значення, відрізняється для різних режимів:

  • "Стандарт" — параметри повтору подій при утримані {затримка}-{інтервал}, час у мілісекундах;
  • "Перемикач" — значення перемикача;
  • "Меню" — перелік адрес елементів меню виду /grp1/grp2/item1;
  • "Завантаження" — рядок опису {ШаблонФайлів}|{Заголовок}|{ФайлПоЗамовчТаЗав}|{ФайлMime} та вміст завантаженого файлу із наступного рядка. Шаблон файлів у вигляді "Зображення (*.png *.xpm *.jpg);;CSV-файл (*.csv)".
  • "Збереження" — рядок опису {ШаблонФайлів}|{Заголовок}|{ФайлПоЗамовч}|{ФайлMime} та вміст файлу до збереження із наступного рядка. Шаблон файлів як і вище.
img Зображення 22 Зображення на кнопці, дивіться деталі.
color Колір 23 Колір кнопки, дивіться деталі.
colorText Колір: текст 27 Колір тексту, дивіться деталі.
mode Режим 24

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

  • "Стандарт" — звичайна кнопка з можливістю повтору подій при утримані, параметри у "value";
  • "Перемикач" — кнопка з фіксацією, значення у "value";
  • "Меню" — відкриття меню за натиском, перелік елементів у "value";
  • "Завантаження" — організація користувацького завантаження невеликих файлів через інтерфейс візуалізації; за натиском кнопки, у цьому режимі, відкривається діалог вибору файлу завантаження, а вміст обраного файлу завантажується до атрибуту "value";
  • "Збереження" — організація користувацького збереження невеликих файлів через інтерфейс візуалізації; при запису вмісту файлу до атрибуту "value" користувачу буде відкрито діалог обрання/вказання файлу для збереження, після обрання, вміст атрибуту "value" збережеться до файлу, а "value" очиститься.
font Шрифт 25 Ім'я шрифту, дивіться деталі.
Список:
value Значення 21 Поточне значення списку.
items Елементи 22 Перелік елементів списку.
font Шрифт 25 Ім'я шрифту, дивіться деталі.
mult Множинний вибір 23 Дозволяти вибір множини елементів списку.
Вибір зі списку, Дерево:
value Значення 21 Поточне значення переліку.
items Елементи 22 Перелік елементів списку або ієрархічних елементів дерева у вигляді шляху "/{КАТ}/{КАТ}/{ЕЛЕМ}".
font Шрифт 25 Ім'я шрифту, дивіться деталі.
Таблиця:
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%); встановити у 0, щоб не показувати взагалі;
  • "edit" — можливість редагування (0 або 1) клітинок стовпчика, по замовченню — ні (0);
  • "color" — колір стовпчика, загалом, у вигляді ім'я кольору або його коду, дивіться деталі;
  • "colorText" — колір тексту стовпчика, загалом, у вигляді ім'я кольору або його коду, дивіться деталі;
  • "font" — шрифт тексту стовпчика, дивіться деталі;
  • "prec" — точність значень клітинок реального типу у стовпчику;
  • "sort" — сортування за даним стовпчиком [0 — по зростанню-типово; 1 — по убуванню];
  • "align" — вирівнювання стовпчика щодо: "left", "right" та "center".
"r" — Рядок значень, можливі атрибути тегів клітинок заголовку, для рядка загалом:
  • "color" — колір рядку, загалом, у вигляді ім'я кольору або його коду, дивіться деталі;
  • "colorText" — колір тексту рядка, загалом, у вигляді ім'я кольору або його коду, дивіться деталі;
  • "font" — шрифт тексту рядка, дивіться деталі;
  • "prec" — точність значень клітинок реального типу у рядку.
"s", "t", "i", "r", "b" — клітинки типів даних: "Рядок", "Текст", "Ціле", "Реальне" та "Логічне". Можливі атрибути:
  • "color" — колір клітинки, дивіться деталі;
  • "colorText" — колір тексту клітинки, у вигляді ім'я кольору або його коду, дивіться деталі;
  • "prec" — точність значень клітинки реального типу;
  • "font" — шрифт тексту клітинки, дивіться деталі;
  • "img" — зображення клітинки, дивіться деталі;
  • "edit" — можливість редагування (0 або 1) клітинки, по замовченню — немає (0);
  • "align" — вирівнювання клітинки щодо: "left", "right" та "center".
font Шрифт 25 Ім'я шрифту, дивіться деталі.
Слайдер та стрічка гортання:
value Значення 21 Положення слайдеру.
cfg Конфігурація 22 Конфігурація слайдеру у форматі: "{ВертОрієнт}:{Мінімум}:{Максимум}:{ОдинКрок}:{СторКрок}".

Де:

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