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" — колір тексту клітинки, у вигляді ім'я кольору або його коду;
  • "prec" — точність значень клітинки реального типу;
  • "font" — шрифт тексту клітинки, у вигляді типового рядка OpenSCADA;
  • "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/uk&oldid=82354"