Инструментальная панель.
<toolbar toolbar-attributes>
[{<toolbaritem>
...
<toolbaritem/>}]
<toolbar/>
| Название | Тип | Описание |
|---|---|---|
| style | usual | button | Тип кнопок на панели. usual - обычные инструментальные кнопки, button - обычные неиструментальные кнопки. Основное отличие между ними - возможность для button указывать произвольную ширину кнопок. По умолчанию, style=«usual» |
| scale | number | Масштабирование пиктограммы кнопки. |
| icon-visible | boolean | Показать/скрыть пиктограмму. |
| hide-buttons | @hide-buttons | |
| flat | boolean | Разрешить/запретить плоские кнопки |
| moving | boolean | Перемещение окна перемещением toolbar. По умолчанию moving=«true». |
| mode | usual | radio | Регулирует поведение кнопок в тулбаре. При toolbar.mode=«radio» кнопки являются кнопками с состоянием и выбрана может быть только одна кнопка. |
| margin | number | Установка отступов, равных n вокруг объекта. |
| margin-* | number | Семейство атрибутов для установки отступов вокруг объекта. |
| position | string | Местоположение объекта в контейнере. Может принимать значения: top-toolbar, bottom-toolbar, left-toolbar, right-toolbar, top, left, bottom, right, center. Пример: <panel> <toolbar position="left-toolbar" /> </panel> |
| Название | Тип | Описание |
|---|---|---|
| remove-all | boolean | Команда удаления всех дочерних узлов в дереве (для - относительно корня). |
| Название | Тип | Описание |
|---|---|---|
| floatable | boolean | @floatable |
| Название | Тип | Описание |
|---|---|---|
| state | on | off | no | Установка соответствующего состояния для кнопки, поддерживающей состояния нажатости/отжатости. Чтобы сделать кнопку, поддерживающую состояния, нужно в первоначальном описании указать ее первичное состояние. Если оно не будет указано, то в последствии кнопка не будет поддерживать атрибут state. |
| scale | number | Масштабирование кнопки. |
| icon | path | Путь к пиктограмме на кнопке. |
| icon-visible | boolean | Показать/скрыть пиктограмму. |
| hotkey | Назначить «горячую» комбинацию клавиш кнопке для быстрого вызова функции. | |
| click | @click | |
| margin | number | Установка отступов, равных n вокруг объекта. |
| margin-* | number | Семейство атрибутов для установки отступов вокруг объекта. |
| Название | Тип | Описание |
|---|---|---|
| text | string | Пользовательский текст. Текст может содержать символ переноса строки '\n', а также может быть представленным в HTML-формате. Если текст содержит спецсимволы ('<', '&' и другие, с точки зрения XML), то следует вместо атрибута text использовать одноименный тэг <text>, вложенный в текущий. Текст следует записать следующим образом (на примере описания тэга <string>):
<string id="name">
<text>
<![CDATA[
<html><font color="blue">User name</html>
]]>
</text>
</string>
|
| text-position | position | Положение пользовательского текста. |
| Название | Тип | Описание |
|---|---|---|
| onEnable | code | Имя метода, вызываемого при переходе кнопки в состояние enable. Правила описания см. (Описание событий в ApplicationXML). |
| onDisable | code | Имя метода, вызываемого при переходе кнопки в состояние disable. Правила описания см. (Описание событий в ApplicationXML). |
| onAction | code | Описание действий для события, типа, двойной щелчок мыши по объекту или нажатие Enter. Правила описания см. (Описание событий в ApplicationXML). |
| onBeforeChangeState | code | Метод, срабатывающий перед сменой состояния кнопки (для кнопок с состоянием). Поддерживается возвращаемое значение true/false. Правила описания см. (Описание событий в ApplicationXML). |
| onChangedState | code | Метод, срабатывающий после смены состояния кнопки (для кнопок с состоянием). Правила описания см. (Описание событий в ApplicationXML). |
Тэг <toolbar> представляет собой обычный тулбар и поддерживается всеми тэгами с <panel>-атрибутами. Для использования <toolbar> достаточно сделать описание, вложенное в основной тэг. Кроме этого, основной тэг поддерживает атрибут toolbar, в котором можно указывать id тэга <toolbar>, описанного в секции <common>.
Кнопки в toolbar описываются с помощью тэга <toolbaritem>.
Существует возможность размещать в <toolbar> не только <toolbaritem>, а и любые другие визуальные объекты.
Добавлена поддержка списка для кнопок <toolbaritem>. При выборе из списка сразу срабатывает событие onAction.
<toolbaritem> <buttonitem text="..." icon="..." value="..." /> ... </toolbaritem>
<window toolbar="main_tb">
<toolbar id="main_tb">
<toolbaritem id="tb_1" text="New record"/>
</toolbar>
</window>