Дерево.
<tree tree-attributes>
[{<treeitem>
...
<treeitem/>}]
<tree/>
| Название | Тип | Описание |
|---|---|---|
| id | id_name | Уникальный, в рамках приложения, идентификатор объекта. Доступ к объекту с помощью AppScript выполняется через этот идентификатор. Если id не задан, то интерпретатор автоматически заполнит его некоторым случайным в момент запуска приложения. В этом случае appxml-программист лишается возможности обращаться к объекту. |
| Название | Тип | Описание |
|---|---|---|
| root-visible | boolean | Флаг видимости корневого узла дерева. |
| root-text | string | Пользовательский текст корневого узла дерева (т.е. то, что видит пользователь). |
| root-icon | path | Полное имя пиктограммы для корневого узла дерева. |
| fastfind-visible | boolean | Флаг видимости поля для «быстрого» поиска. |
| Название | Тип | Описание |
|---|---|---|
| add | Добавление новых узлов в дерево к корневому узлу. Синтаксис: add=»<position=nnn><treeitem text='new-item-1'/><treeitem text='new-item-2'/>…</>» |
|
| call-refresh | boolean | Вызов внутреннего метода обновления содержимого tree. Обычно это действие выполняется через тулбар tree и эмулирует событие onCreated. |
| focus | boolean | Команда передачи фокуса ввода в поле ввода. |
| remove | number | Команда удаления дочернего узла с порядковым номером «n» относительно текущего (для - относительно корня). |
| remove-all | boolean | Команда удаления всех дочерних узлов в дереве (для - относительно корня). |
| remove-by-id | node-id | Команда удаления узла с id=«node-id». |
| select-by-id | node-id | Команда установки узла с id=«node-id» текущим. |
| Название | Тип | Описание |
|---|---|---|
| refresh-visible | boolean | Флаг показа в заголовке дерева кнопки обновления содержимого. Кнопка обновления предназначена для предоставления пользователю возможности повторного вызова метода, указанного в onCreated. |
| selected-* | Семейство визуальных атрибутов (см. <label>) для текущего узла дерева (т.е. для узла, на котором стоит курсор). | |
| unselected-* | Семейство визуальных атрибутов (см. <label>) для прочих узлов дерева. | |
| selection-mode | single | sinterval | minterval | Управляет возможностью отметки узлов. |
| title | string | Заголовок объекта. Атрибут имеет силу только при создании объекта. Изменение значения атрибута после создания объекта не будет иметь эффекта. Имеет дополнительные атрибуты: title-before, title-after, title-visible. |
| Название | Тип | Описание |
|---|---|---|
| onCreated | code | Описание действий для события, возникающего единожды, после создания объекта. Правила описания см. (Описание событий в ApplicationXML). |
| onUnSelected | code | Описание действий для события, возникающего при смене выбора элемента из множества доступных (например, в выпадающем списке). При этом в java-метод передается ссылка на старый (бывший выбранным) узел. Правила описания см. (Описание событий в ApplicationXML). |
| onAction | code | Описание действий для события, типа, двойной щелчок мыши по объекту или нажатие Enter. Правила описания см. (Описание событий в ApplicationXML). |
| onClick | code | Описание действий для события, возникающего при щелчке мышью на объекте. Правила описания см. (Описание событий в ApplicationXML). |
| onMousePressed | code | Описание действий для события, возникающего после нажатия на левую кнопку мыши, не дожидаясь ее отпускания. Правила описания см. (Описание событий в ApplicationXML). |
| onMouseReleased | code | Описание действий для события, возникающего после отпускания нажатой левой кнопки мыши. Правила описания см. ( Описание событий в ApplicationXML). |
| onMouseOver | code | Описание действий для события, возникающего при наведении курсора мыши на объект. Правила описания см. (Описание событий в ApplicationXML). |
| onMouseOut | code | Описание действий для события, возникающего при выходе курсора мыши из зоны объекта. Правила описания см. (Описание событий в ApplicationXML). |
| Название | Тип | Описание |
|---|---|---|
| remove | number | Команда удаления дочернего узла с порядковым номером «n» относительно текущего (для - относительно корня). |
| remove-all | boolean | Команда удаления всех дочерних узлов в дереве (для - относительно корня). |
| add | Добавление новых узлов в дерево к корневому узлу. Синтаксис: add=»<><treeitem text='new-item-1'/><treeitem text='new-item-2'/>…</>» |
|
| expand | boolean | Команда раскрыть узел. |
| Название | Тип | Описание |
|---|---|---|
| onAction | code | Описание действий для события, типа, двойной щелчок мыши по объекту или нажатие Enter. Правила описания см. (Описание событий в ApplicationXML). |
| onSelected | code | Описание действий для события, возникающего при выборе элемента из множества доступных (например, в выпадающем списке). Правила описания см. (Описание событий в ApplicationXML). Часто onSelected является синонимом для onAction. |
| onDoubleClicked | code | Описание действий для события, возникающего при двойном нажатии на объекте. Правила описания см. (Описание событий в ApplicationXML). |
| onExpanded | code | Описание действий для события, возникающего при раскрытии узла дерева. Правила описания см. (Описание событий в ApplicationXML). |
| onCollapsed | code | Описание действий для события, возникающего при сворачивании узла дерева. Правила описания см. (Описание событий в ApplicationXML). |
| onUnSelected | code | Описание действий для события, возникающего при смене выбора элемента из множества доступных (например, в выпадающем списке). При этом в java-метод передается ссылка на старый (бывший выбранным) узел. Правила описания см. (Описание событий в ApplicationXML). |
| onBeforePopup | code | Описание действий для события, возникающего перед созданием контекстного меню. Правила описания см. (Описание событий в ApplicationXML). |
Поля в tree описываются с помощью тэга <treeitem>.
<tree id="treeMenu" width="200" expand="true" title="Главное меню">
<treeitem text="Home" icon="res:package.png">
<onaction>
msg('Событие onaction узла Home!');
</onaction>
</treeitem>
<treeitem text="item 1" icon="res:table.png">
<onaction>
msg('Событие onaction узла item 1!');
</onaction>
</treeitem>
<treeitem text="item 2" icon="res:package.png">
<onaction>
msg('Событие onaction узла item 2!');
</onaction>
</treeitem>
<treeitem text="item 3" icon="res:package.png">
<onaction>
msg('Событие onaction узла item 3!');
</onaction>
</treeitem>
</tree>