Панель - визуальная область, на которой можно размещать визуальные объекты.
<panel panel-attributes>
[прочие appxml-тэги]
<panel/>
| Название | Тип | Описание |
|---|---|---|
| id | id_name | Уникальный, в рамках приложения, идентификатор объекта. Доступ к объекту с помощью AppScript выполняется через этот идентификатор. Если id не задан, то интерпретатор автоматически заполнит его некоторым случайным в момент запуска приложения. В этом случае appxml-программист лишается возможности обращаться к объекту. |
| Название | Тип | Описание |
|---|---|---|
| align | left | right | center | Выравнивание объектов на панели. Атрибут действует только для layout=«flow». |
| gap | number | Установка расстояния между размещаемыми объектами внутри данного объекта. Данный объект выступаетв роли контейнера. |
| gradient | boolean | Установка градиента цвета для фона всего объекта. Поддерживаются дополнительные атрибуты: gradient-start=«color_name», gradient-end=«color-name», gradient-direction=«horizontal | vertical» |
| full-background-color | color-name | @full-background-color |
| margin | number | Установка отступов, равных n вокруг объекта. Поддерживаются дополнительные атрибуты: margin-top, margin-left, margin-bottom, margin-right. |
| stretch | boolean | Автоматическое принятие размеров под помещенные на нее компоненты. |
| moving | boolean | Перемещение окна перемещением panel. По умолчанию moving=«true». |
| x | number | Фактическое (вычисленное) значение (число) координаты X. |
| y | number | Фактическое (вычисленное) значение (число) координаты Y. |
| height | number | Фактическое (вычисленное) значение (число) высоты объекта. |
| width | number | Фактическое (вычисленное) значение (число) ширины объекта. Атрибут width поддерживает значение max в контейнере с layout=«null». Объект удлинятся максимально, ориентируясь на предыдущие объекты строками выше. Удобно при проектировании окон ввода. |
| oX | number | Заданное значение координаты Х. |
| oY | number | Заданное значение координаты Y. |
| oHeight | number | Заданное значение высоты объекта. |
| oWidth | number | Заданное значение ширины объекта. |
| Название | Тип | Описание |
|---|---|---|
| focus | boolean | Команда передачи фокуса ввода в поле ввода. |
| repaint | boolean | Перерисовка содержимого данного контейнера. |
| refresh | boolean | В отличие от repaint обновляет только границы панели. Т.е. если добавлен объект, а он не виден (и при этом не менялись вручную размеры панели), то нужно выполнить refresh. |
| revalidate | boolean | Команда пересчета размеров панели. Применяется редко, т.к. панель сама старается отслеживать свои размеры. |
| Название | Тип | Описание |
|---|---|---|
| h-gradient | boolean | Установка градиента цвета для фона заголовка объекта. Поддерживаются дополнительные атрибуты: h-gradient-start=«color_name», h-gradient-end=«color-name», h-gradient-direction=«horizontal | vertical» |
| h-margin | number | Установка отступов, равных n вокруг заголовка объекта. Поддерживаются дополнительные атрибуты: h-margin-top, h-margin-left, h-margin-bottom, h-margin-right. |
| h-visible | boolean | Флаг управления видимостью заголовка (header). |
| hCenter-* , hLeft-*, hRight-* | Заголовок панели делится на три части по горизонтали: левая (hLeft-*), центральная (hCenter-*) и правая (hRight-*). hCenter-*={<panel>-атрибуты} - семейство атрибутов для центральной части заголовка объекта. Поддерживаются все атрибуты <panel>. hLeft-*={<panel>-атрибуты} - семейство атрибутов для левой части заголовка объекта. Поддерживаются все атрибуты <panel>. hRight-*={<panel>-атрибуты} - семейство атрибутов для правой части заголовка объекта. Поддерживаются все атрибуты <panel>. |
|
| statusbar-visible | boolean | Управление видимостью статусбара для всех тэгов, поддерживающих атрибуты <panel> |
| title | string | Заголовок объекта. Атрибут имеет силу только при создании объекта. Изменение значения атрибута после создания объекта не будет иметь эффекта. Имеет дополнительные атрибуты:title-before, title-after, title-visible. |
| call-event-later | string | Вызов события по его имени для всех тэгов, поддерживающих атрибуты <panel> |
| Название | Тип | Описание |
|---|---|---|
| onKeyDown | code | Описание действий для события, возникающего при нажатии на клавишу, но до ее отпускания. Правила описания см. (Описание событий в ApplicationXML). |
| onKeyUp | code | Описание действий для события, возникающего при отпускании клавиши. Правила описания см. (Описание событий в ApplicationXML). |
| onKeyPressed | code | Описание действий для события, возникающего при нажатии на клавишу без учета фаз «нажатие/отпускание». Срабатывает после отпускания клавиши. Правила описания см. (Описание событий в ApplicationXML). |
| onCreated | code | Описание действий для события, возникающего единожды, после создания объекта. Правила описания см. (Описание событий в ApplicationXML). |
| onAction | code | Описание действий для события, возникающего после клика левой кнопки мышки по объекту. Правила описания см. (Описание событий в ApplicationXML). |
| onResized | code | Описание действий для события, возникающего после изменения размеров панели. Правила описания см. (Описание событий в ApplicationXML). |
| onMoved | code | Описание действий для события, возникающего после изменения координат панели. Правила описания см. (Описание событий в ApplicationXML). |
| onVisibled | code | Описание действий для события, возникающего после смены видимости панели на «true». Правила описания см. (Описание событий в ApplicationXML). |
| onHided | code | Описание действий для события, возникающего после смены видимости панели на «false». Правила описания см. (Описание событий в ApplicationXML). |
| onComponentAdded | code | Описание действий для события, возникающего после добавления какого-либо компонента на панель. Правила описания см. (Описание событий в ApplicationXML). |
| onComponentRemoved | code | Описание действий для события, возникающего после удаления какого-либо компонента с панели. Правила описания см. (Описание событий в ApplicationXML). |
Панель - визуальная область, на которой можно размещать визуальные объекты.
Поддерживает следующие области для расположения объектов:
- left,
- right,
- top,
- bottom,
- center,
- left-toolbar,
- right-toolbar,
- top-toolbar,
- bottom-toolbar,
- left-menu,
- right-menu,
- top-menu,
- bottom-menu.
В этих местах можно располагать любые визуальные объекты. Области *-toolbar рекомендуется использовать только под тулбары, а области *-menu – под меню.
<panel id="mainPanel" layout="border" position="center"
width="300" height="200" margin="2" border="line:red"
background-color="pink">
<panel layout="flow" position="left" width="50" border="line:blue" margin="1">
<label text="Я панель"/>
<label text="СЛЕВА"/>
</panel>
<panel layout="flow" position="top" height="50" border="line:blue" margin="1">
<label text="Я панель"/>
<label text="СВЕРХУ"/>
</panel>
<panel layout="flow" position="bottom" height="50" border="line:blue" margin="1">
<label text="Я панель"/>
<label text="СНИЗУ"/>
</panel>
<panel layout="flow" position="right" width="50" border="line:blue" margin="1">
<label text="Я панель"/>
<label text="СПРАВА"/>
</panel>
<panel layout="flow" align="center" margin="1" border="line:green">
<label icon="res:world.gif" margin-top="20"/>
</panel>
</panel>