From OpenSCADAWiki
Jump to: navigation, search

Таблиця. Загальний набір властивостей/атрибутів віджету

Ідентифікатор Ім'я Номер Значення
id Ідентифікатор - Ідентифікатор елементу. Атрибут тільки для читання, прикликаний надати інформацію про ідентифікатор елементу.
path Путь - Шлях до цього віджету. Атрибут тільки для читання та надання вичерпної інформації про розташування елементу.
parent Батько - Шлях до батьківського віджету. Атрибут тільки для читання та надання інформації про розташування предку від якого успадковано віджет.
owner Власник - Власник та групи віджету, у вигляді "{власник}:{группа[,группа2,группаN]}", по замовченню "root:UI".
perm Доступ -

Права доступу до віджету, у вигляді "{користувач}{групи}{інші}" плюс ознака наслідування, що вмикає наслідування власника та його прав від вищестоящого віджету.
Де "користувач", "групи" та "інші" це:

  • "__" — немає доступу;
  • "R_" — тільки читання;
  • "RW" — читання та запис.

По замовченню 01000 — наслідування.

root Корінь 1 Ідентифікатор віджету-примітиву (базового елементу), який лежить у основі образу візуалізації віджету.
name Ім'я - Ім'я елементу. Доступне до модифікації ім'я елементу.
dscr Опис - Опис елементу. Текстове поле короткого опису.
en Ввімкнено 5 Стан "Ввімкнено" елементу. Вимкнений елемент не відображається при виконані.
active Активний 6 Стан "Активний" елементу. Активний елемент може отримувати фокус при виконанні, тобто — отримувати клавіатурні та інші події з подальшою їх обробкою.
geomX Геометрія: x 7 Геометрія, координата 'x' положення елементу.
geomY Геометрія: y 8 Геометрія, координата 'y' положення елементу.
geomW Геометрія: ширина 9 Геометрія, ширина елементу.
geomH Геометрія: висота 10 Геометрія, висота елементу.
geomXsc Геометрія: x масштаб 13 Масштаб елемента по горизонталі.
geomYsc Геометрія: y масштаб 14 Масштаб елемента по вертикалі.
geomZ Геометрія: z 11 Геометрія, координата 'z' (рівень) елемента на кадрі. Також визначає порядок передачі фокусу між активними елементами.
geomMargin Геометрія: відступ 12 Геометрія, поля-відступи елементу.
tipTool Допомога: підказка 15 Текст короткої допомоги або підказки по даному елементу. Типово реалізується як спливаюча підказка, при утримані курсору миші над елементом.
tipStatus Допомога: стан 16

Текст інформації про стан елементу або рекомендації до дії над елементом. Типово реалізується у вигляді повідомлення у рядку статусу, при утримувані курсору миші над елементом.

* Модифікація даного атрибуту з сеансу кореневої сторінки здійснює запис повідомлення до рядку статусу вікна візуалізації сеансу.
contextMenu Контекстне меню 17

Контекстне меню у вигляді переліку рядків: "{ItName}:{Signal}".
Де:

  • "ItName" — ім'я елементу;
  • "Signal" — ім'я сигналу, що формується при обрані: "usr_{Signal}".
evProc Обробка подій -

Атрибут зберігання сценарію обробки подій безпосереднього управління користувацьким інтерфейсом. Сценарій представляє собою перелік команд інтерфейсу візуалізації, що генеруються при надходженні події (атрибут event). Пряма обробка подій для управління сторінками у вигляді: "{event}:{evSrc}:{com}:{prm}". Де:

  • "event" — очікувана подія;
  • "evSrc" — джерело події;
  • "com" — команда сеансу: open, next, prev;
  • "prm" — параметр команди, де використовується:
    • pg_so — пряме ім'я бажаної сторінки, з префіксом;
    • 1 — ім'я нової сторінки у загальному шляху, без префіксу;
    • * — ім'я сторінки береться з ім'я попередньої сторінки;
    • $ — вказує на місце, відносно якого відкривається сторінка.

Приклади:

  • ws_BtPress:/prev:prev:/pg_so/*/*/$
  • ws_BtPress:/next:next:/pg_so/*/*/$
  • ws_BtPress:/go_mn:open:/pg_so/*/mn/*
  • ws_BtPress:/go_graph:open:/pg_so/*/ggraph
Додаткові атрибути елементів, поміщених до проєкту у ролі сторінки.
pgOpen Сторінка: відкрита -

Ознака "Сторінка відкрита".

* Модифікація з сеансу здійснює негайне відкриття/закриття даної сторінки, та для сторінок типу "Зв'язок" Ви маєте віддавати перевагу використанню функції uiCmd() користувацького API, для керування сторінками.
pgNoOpenProc Сторінка: обробляти закритою - Ознака "Виконувати сторінку навіть якщо вона закрита".
pgOpenSrc Сторінка: джерело відкриття 3

Повня адреса сторінки, що відкрила дану.

* Запис/очищення адреси віджету (ініціатору відкриття), здійснює негайне відкриття/закриття сторінки. У випадку запису адреси, та виконання інших умов, здійснюється динамічне зв'язування поточного віджету з ініціатором. Але для сторінок типу "Зв'язок" Ви маєте віддавати перевагу використанню функції uiCmd() користувацького API, для керування сторінками.
pgGrp Сторінка: група 4 Група сторінок. ПОРОЖНЯ та "main" група передбачають використання цієї сторінки як Кореневу-основну сторінку, тож така буде замінювати інші Кореневі-головні сторінки; група "fl" призначена для використання у зовнішніх вікнах, які передбачено для багаторазового одночасного відкриття та які не мають відстежуватися на дублікати; решта передбачено для включення у контейнери-бокси або одноразового одночасного відкриття, тож вони примусово перевіряються на дублікати, коли останнє відкривається, а попередні закриваються.
Додаткові атрибути режиму виконання — сеансу.
(Віртуальні атрибути не доступні у процедурі віджету)
event Події - Спеціальний атрибут збору подій віджету у переліку, поділеному новим рядком. Доступ до атрибуту захищено критичною секцією для запобігання втрати подій. Атрибут завжди доступний у процедурі віджету.
load Завантаження -1 Віртуальна команда групового завантаження даних.
focus Фокус -2 Спеціальний атрибут індикації факту отримання фокусу, активним віджетом. Атрибут цього віджету та вкладених віджетів доступний у процедурах віджету.
perm Доступ -3 Віртуальний атрибут прав активного користувача на перегляд та контроль над віджетом.
Retrieved from "http://oscada.org/wiki/index.php?title=Translations:Sub-projects/VCA/143/uk&oldid=69586"