<toolbar ... >

Инструментальная панель.


Синтаксис

<toolbar toolbar-attributes>
   [{<toolbaritem>
      ...
    <toolbaritem/>}]
<toolbar/>

Атрибуты Toolbar

Визуальные атрибуты (R/W):

Название Тип Описание
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>

Атрибуты текстовой метки (R/W):

Название Тип Описание
text-position position Положение пользовательского текста.
text-visible boolean text-visible реализован для объектов, имеющих пиктограмму.

Командные атрибуты (W/O):

Название Тип Описание
remove-all boolean Команда удаления всех дочерних узлов в дереве (для - относительно корня).

Прочие атрибуты (R/W):

Название Тип Описание
floatable boolean @floatable

Атрибуты Toolbaritem

Основные атрибуты (R/W):

Название Тип Описание
state on | off | no Установка соответствующего состояния для кнопки, поддерживающей состояния нажатости/отжатости. Чтобы сделать кнопку, поддерживающую состояния, нужно в первоначальном описании указать ее первичное состояние. Если оно не будет указано, то в последствии кнопка не будет поддерживать атрибут state.
scale number Масштабирование кнопки.
icon path Путь к пиктограмме на кнопке.
icon-visible boolean Показать/скрыть пиктограмму.
hotkey Назначить «горячую» комбинацию клавиш кнопке для быстрого вызова функции.
click @click
margin number Установка отступов, равных n вокруг объекта.
margin-* number Семейство атрибутов для установки отступов вокруг объекта.

Атрибуты текстовой метки (R/W):

Название Тип Описание
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 Положение пользовательского текста.

Событийные атрибуты (R/W):

Название Тип Описание
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>
 
tags/toolbar.txt · Последние изменения: 12/09/2011 08:03 — admin
 
Recent changes RSS feed Valid XHTML 1.0 Valid CSS