From OpenSCADAWiki
Jump to: navigation, search
 
Line 13: Line 13:
 
|-
 
|-
 
| perm || Доступ || - ||
 
| perm || Доступ || - ||
Права доступу до віджету, у вигляді "'''{користувач}{групи}{інші}'''" плюс ознака наслідування, що вмикає наслідування власника та його прав від вищестоящого віджету.<br/>
+
Права доступу до віджету у вигляді "'''{користувач}{групи}{інші}'''" вісімкового числа на кшталт "0664-RWRWR_", плюс ознака наслідування вмикає наслідування власника і його прав від вищестоячого віджету.<br/>
 
Де "'''користувач'''", "'''групи'''" та "'''інші'''" це:
 
Де "'''користувач'''", "'''групи'''" та "'''інші'''" це:
* "__" — немає доступу;
+
* "__" (0) — немає доступу;
* "R_" — тільки читання;
+
* "R_" (4) — тільки читання;
* "RW" — читання та запис.<br/>
+
* "RW" (6) — читання та запис.<br/>
По замовченню 01000 — наслідування.
+
По замовченню у 01000 — наслідування.
 
|-
 
|-
 
| root || Корінь || 1 || Ідентифікатор віджету-примітиву (базового елементу), який лежить у основі образу візуалізації віджету.
 
| root || Корінь || 1 || Ідентифікатор віджету-примітиву (базового елементу), який лежить у основі образу візуалізації віджету.

Latest revision as of 20:47, 4 May 2025

Information about message (contribute)
This message has no documentation. If you know where or how this message is used, you can help other translators by adding documentation to this message.
Message definition (Sub-projects/VCA)
'''Table.''' The common set of properties/attributes in the widget
{| class="wikitable"
|-
! Identifier !! Name !! Number !! Value
|-
| id || Identifier || - || Identifier of the element. The attribute is read-only, designed to provide information on the ID of the element.
|-
| path || Path || - || Path to the widget. The attribute is read-only and designed to provide full information about the element location.
|-
| parent || Parent || - || Path to the parent widget. The attribute is read-only and designed to provide information about the ancestor location which the widget is inherited from.
|-
| owner || Owner || - || The widget owner and group in the view "'''{owner}:{group[,group1,groupN]}'''", by default the "root:UI". 
|-
| perm || Permission || - ||
Permission to the widget in the view "'''{user}{group}{other}'''" of octal number like to "0664-RWRWR_", plus the inheritance flag enables the inheritance for owner and its permissions from the upper widget.<br/>
Where "'''user'''", "'''group'''" and "'''other'''" is:
* "__" (0) — no access;
* "R_" (4) — read-only;
* "RW" (6) — read and write.<br/>
By default that is in 01000 — inheritance.
|-
| root || Root || 1 || Identifier of the widget-primitive (basic element) which underlies the widget visualization shape.
|-
| name || Name || - || Name of the element. Accessible to modification the element name. 
|-
| dscr || Description || - || Description of the element. Text field of the brief description. 
|-
| en || Enabled || 5 || The state "Enabled" of the element. Disabled element is not shown in the execution mode. 
|-
| active || Active || 6 || The state "Active" of the element. Active element may receive focus in the execution mode, and thus receive keyboard and other events with their subsequent processing.
|-
| geomX || Geometry: x || 7 || Geometry, coordinate 'x' of the element position.
|-
| geomY || Geometry: y || 8 || Geometry, coordinate 'y' of the element position.
|-
| geomW || Geometry: width || 9 || Geometry, the width of the element.
|-
| geomH || Geometry: height || 10 || Geometry, the height of the element.
|-
| geomXsc || Geometry: x scale || 13 || Horizontally scale of the element. 
|-
| geomYsc || Geometry: y scale || 14 || Vertical scale of the element. 
|-
| geomZ || Geometry: z || 11 || Geometry, coordinate 'z' (level) of the element on the frame. Defines also the order to transfer the focus through active elements.
|-
| geomMargin || Geometry: margin || 12 || Geometry, the margins of the element. 
|-
| tipTool || Tip: tool || 15 || Text of a brief help or tip on this element. Realized usually as a tool tip, while keeping your mouse cursor over the element.
|-
| tipStatus || Tip: status || 16 ||
Text information on the status of the element or the guide to action over the element. Implemented usually in the form of a message in the status bar while keeping your mouse cursor over the element.
: * Modification the attribute from session of the root page will record the message in the status bar of the visualization window of the session. 
|-
| contextMenu || Context menu || 17 ||
Context menu in the strings list view: "'''{ItName}:{Signal}'''".<br/>
Where:
* "ItName" — name of the item;
* "Signal" — name of the signal, which forming at the selecting: "'''usr_{Signal}'''". 
|-
| evProc || Events processing || - ||
Attribute for storing of the script of the events processing for direct control of the user interface. Script is a list of commands to the visualization interface, generated at the event receipt (attribute '''event'''). Direct events processing to manage pages, in the view: "'''{event}:{evSrc}:{com}:{prm}'''". Where:
* "event" — waiting event;
* "evSrc" — event source;
* "com" — command of the session: open, next, prev;
* "prm" — command parameter, where used:
** ''pg_so'' — direct name of the desired page, with the prefix;
** ''1'' — name of the new page in a general way, without a prefix;
** ''*'' — the page is taken from the previous page name;
** ''$'' — indicates the place relative to which the page opens.<br/>
Examples:
* 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
|-
| colspan="4" | ''Additional attributes for items, placed into the project in the role of a page.'' 
|-
| pgOpen || Page: opened || - ||
Sign "The page is opened".
: * Modification from the session provides an immediate opening/closing the page, but for the pages type "Link" you must prefer of [[#UserAPI|the user API]] function uiCmd() using to the pages managing.
|-
| pgNoOpenProc || Page: process not opened || - || Sign "Execute the page, even if it is closed".
|-
| pgOpenSrc || Page: source of the opening || 3 ||
Full address of the page which has opened this one.
: * Writing/clearing the widget address, of the opening initiation, performs an immediate opening/closing the page. In the case of writing the address and on [[#DynLink|certain conditions]], the dynamic linking of the current widget to the initiator performs. But for the pages type "Link" you must prefer of [[#UserAPI|the user API]] function uiCmd() using to the pages managing.
|-
| pgGrp || Page: group || 4 || Group of the pages. EMPTY and the "main" group is meant of using this page as the Root-main page, so such ones will replace other Root-main pages; the "fl" group is meant of using in the "fly" windows which are suitable for multiple open and must not be traced for doubles; all other are meant for including to the containers-boxes or single opening, so they forced in checking for doubles when the last one will be opened and the previous ones be closed.
|-
| colspan="4" | ''Additional attributes of the execution mode — by the session.''<br/>(Virtual attributes are not available in the widget procedure)
|-
| event || Events || - || Special attribute of the collection of events of the widget in the list, which is divided by the new line. Access to the attribute is protected by a critical section in order to avoid loss of the events. The attribute is always available in the widget procedure.
|-
| load || Load || -1 || Virtual command of the group data download. 
|-
| focus || Focus || -2 || Special attribute of the indicating the fact of receiving the focus by an active widget. Attribute of the widget and of the included widgets is available in the widgets procedures.
|-
| perm || Permission || -3 || Virtual attribute of the rights of the active user to view and control the widget.
|}
Translation'''Таблиця.''' Загальний набір властивостей/атрибутів віджету
{| class="wikitable"
|-
! Ідентифікатор !! Ім'я !! Номер !! Значення
|-
| id || Ідентифікатор || - || Ідентифікатор елементу. Атрибут тільки для читання, прикликаний надати інформацію про ідентифікатор елементу.
|-
| path || Путь || - || Шлях до цього віджету. Атрибут тільки для читання та надання вичерпної інформації про розташування елементу.
|-
| parent || Батько || - || Шлях до батьківського віджету. Атрибут тільки для читання та надання інформації про розташування предку від якого успадковано віджет.
|-
| owner || Власник || - || Власник та групи віджету, у вигляді "'''{власник}:{группа[,группа2,группаN]}'''", по замовченню "root:UI".
|-
| perm || Доступ || - ||
Права доступу до віджету у вигляді "'''{користувач}{групи}{інші}'''" вісімкового числа на кшталт "0664-RWRWR_", плюс ознака наслідування вмикає наслідування власника і його прав від вищестоячого віджету.<br/>
Де "'''користувач'''", "'''групи'''" та "'''інші'''" це:
* "__" (0) — немає доступу;
* "R_" (4) — тільки читання;
* "RW" (6) — читання та запис.<br/>
По замовченню у 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}'''".<br/>
Де:
* "ItName" — ім'я елементу;
* "Signal" — ім'я сигналу, що формується при обрані: "'''usr_{Signal}'''". 
|-
| evProc || Обробка подій || - ||
Атрибут зберігання сценарію обробки подій безпосереднього управління користувацьким інтерфейсом. Сценарій представляє собою перелік команд інтерфейсу візуалізації, що генеруються при надходженні події (атрибут '''event'''). Пряма обробка подій для управління сторінками у вигляді: "'''{event}:{evSrc}:{com}:{prm}'''". Де:
* "event" — очікувана подія;
* "evSrc" — джерело події;
* "com" — команда сеансу: open, next, prev;
* "prm" — параметр команди, де використовується:
** pg_so — пряме ім'я бажаної сторінки, з префіксом;
** 1 — ім'я нової сторінки у загальному шляху, без префіксу;
** * — ім'я сторінки береться з ім'я попередньої сторінки;
** $ — вказує на місце, відносно якого відкривається сторінка.<br/>
Приклади:
* 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() [[#UserAPI|користувацького API]], для керування сторінками.
|-
| pgNoOpenProc || Сторінка: обробляти закритою || - || Ознака "Виконувати сторінку навіть якщо вона закрита". 
|-
| pgOpenSrc || Сторінка: джерело відкриття || 3 ||
Повня адреса сторінки, що відкрила дану. 
: * Запис/очищення адреси віджету (ініціатору відкриття), здійснює негайне відкриття/закриття сторінки. У випадку запису адреси, та виконання [[#DynLink|інших умов]], здійснюється динамічне зв'язування поточного віджету з ініціатором. Але для сторінок типу "Зв'язок" Ви маєте віддавати перевагу використанню функції uiCmd() [[#UserAPI|користувацького API]], для керування сторінками.
|-
| pgGrp || Сторінка: група || 4 || Група сторінок. ПОРОЖНЯ та "main" група передбачають використання цієї сторінки як Кореневу-основну сторінку, тож така буде замінювати інші Кореневі-головні сторінки; група "fl" призначена для використання у зовнішніх вікнах, які передбачено для багаторазового одночасного відкриття та які не мають відстежуватися на дублікати; решта передбачено для включення у контейнери-бокси або одноразового одночасного відкриття, тож вони примусово перевіряються на дублікати, коли останнє відкривається, а попередні закриваються.
|-
| colspan="4" | ''Додаткові атрибути режиму виконання — сеансу.''<br/>(Віртуальні атрибути не доступні у процедурі віджету)
|-
| event || Події || - || Спеціальний атрибут збору подій віджету у переліку, поділеному новим рядком. Доступ до атрибуту захищено критичною секцією для запобігання втрати подій. Атрибут завжди доступний у процедурі віджету.
|-
| load || Завантаження || -1 || Віртуальна команда групового завантаження даних.
|-
| focus || Фокус || -2 || Спеціальний атрибут індикації факту отримання фокусу, активним віджетом. Атрибут цього віджету та вкладених віджетів доступний у процедурах віджету.
|-
| perm || Доступ || -3 || Віртуальний атрибут прав активного користувача на перегляд та контроль над віджетом.
|}

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

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

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

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

По замовченню у 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 Віртуальний атрибут прав активного користувача на перегляд та контроль над віджетом.