Описание общих атрибутов
Здесь описаны атрибуты, имеющиеся и поддерживающиеся практически у всех визуальных тэгов (если иное не оговорено в явном виде).
| Название | Тип | Описание |
|---|---|---|
| id | id_name | Уникальный, в рамках приложения, идентификатор объекта. Доступ к объекту с помощью AppScript выполняется через этот идентификатор. Если id не задан, то интерпретатор автоматически заполнит его некоторым случайным в момент запуска приложения. В этом случае appxml-программист лишается возможности обращаться к объекту. |
| obj_coord | number | x=«n | +n | -n | old» - координата объекта по оси x (игнорируется для всех layout, кроме null). Явно задавать необязательно, даже при layout=null, т.к. контейнеры (окно, панель) самостоятельно добавляют объекты почти по принципу layout=flow. Отличие заключается в возможности использовать специальные значения и тем самым управлять расстояниями между объектами. n - принудительная установка объекта в координату х. После установки объекта «виртуальный курсор» переносится на следующее «виртуальное место», т.е. по оси х вправо на ширину добавленного объекта плюс значение gap-x (см. <panel>). +n, -n - измененить положение «виртуального курсора» по оси x на n пикселей вправо или влево соответственно. old - оставить координату прежней. Сделано для работы в паре с указанием y=«new». - координата объекта по оси y (игнорируется для всех layout, кроме null). Явно задавать необязательно, даже при layout=null, т.к. контейнеры (окно, панель) самостоятельно добавляют объекты почти по принципу layout=flow. Отличие заключается в возможности использовать специальные значения и тем самым управлять расстояниями между объектами. n - принудительная установка объекта в координату y. После установки объекта «виртуальный курсор» остается по оси y на предыдущем положении. +n, -n - измененить положение «виртуального курсора» по оси y на n пикселей вниз или вверх соответственно. new - переместить «виртуальный курсор» на следующую «виртуальную строку», т.е. по оси y вниз на высоту добавленного объекта плюс значение gap-y (см. <panel>). Спецзначения «new» и »+/-n» можно комбинировать, например, y=next+5. height=«n» - высота объекта width=«n» - ширина объекта |
| enable | boolean | Разрешение/запрещение возможности для пользователя взаимодействовать с объектом. |
| disable | boolean | Разрешение/запрещение возможности для пользователя взаимодействовать с объектом.(Синоним enable). |
| color | color-name | Цвет переднего плана объекта. Обычно имеется ввиду цвет текста. Т.е., например, для панели атрибут color не имеет смысла. |
| background-color | color-name | Цвет фона объекта |
| visible | boolean | Видимость объекта |
| hint | string | Всплывающая подсказка |
| border | compound | lowered | raised | outer | windows | title:title_string | empty | none | line-n,n,n,n:outer_color:inner_color | {color} | Тип визуальной границы объекта. Синонимы: raised и outer. line подразумевает линию толщины n вокруг объекта. |
| layout | border | flow | null | row:n | col:n | grid:N1xN2 | line | vline | Тип менеджера компоновки (в терминах Java). border расставляет поступающие объекты по местам top, left, right, bottom, center. Координаты (x, y) игнорируются. flow расставляет объекта в порядке их поступления (добавления) друг за другом. Координаты (x, y) игнорируются. null расставляет объекты в соответствии с их координатами (x, y). row создает строку из n ячеек и располагает объекты друг за другом слева направо в порядке их поступления (добавления). col создает колонку из n ячеек и располагает объекты друг за другом сверху вниз в порядке их поступления (добавления). grid:N1хN2 - раставляет объекты согласно координатной сетке. N1 - кол-во строк, N2 - кол-во колонок. line расположение объектов в горизонтальную строку. vline расположение объектов в вертикальную строку. Если объектами являются поля ввода, то при вертикальном расположении они выравниваются автоматически. |
| font-* | types | Cемейство атрибутов, управляющих шрифтом объекта. Поддерживаются следующие атрибуты: - font-name - имя шрифта. Поддерживается, вне зависимости от ОС, Serif, SansSerif, Monospaced, Dialog и DialogInput. Остальные - зависят от наличия в ОС. - font-bold="true | false" - жирный шрифт. - font-italic="true | false" - курсив. - font-underline="true | false" - подчеркивание. - font-color="color_name" - цвет шрифта. - font-size - размер шрифта (кегль). - font-shadow-distance=".." - расстояние до тени. - font-shadow=direction="nn | vertical | horizontal" - направление тени. - font-shadow-size="n" - размер тени. Поддерживается тэг <font> <font style-id="a" name=".." bold="true | false" italic="true | false" underline="true | false" color="nn" size=".." shadow-distance=".." shadow-direction="20 | vertical | horizontal" shadow-size="n"/> |
| align | left | center | right | Выравнивание текста по горизонтали |
| valign | top | middle | bottom | Выравнивание текста по вертикали |
| position | top | left | bottom | right | center | Месторасположение объекта в контейнере (панель, сплиттер, окно). Пустое значение эквивалентно значению «center». position поддерживается только внутри описания сложной структуры визуального объекта. При командном размещении (appxml:source:dest) position игнорируется, т.к. здесь положение регулируется dest.position. |
| value | value | Установка значения поля ввода. Если в процессе работы программы требуется изменить значение поля ввода программным способом, то делать это следует через данный атрибут.  Не путать с init-value! |
| cursor | default | hand | wait | Внешний вид курсора в пределах визуального объекта. Пустое значение эквивалентно значению «default». |
| save | string | save=«attr1, attr2, …» - сохранить значения указанного списка атрибутов |
| restore | string | restore=»[attr1, attr2, …]» - восстановить значения указанного списка атрибутов (или всех атрибутов, если список пуст) |
| validate | boolean | Перерисовка визуальной структуры объекта. Предполагается, что у appxml-программиста не будет возникать потребность в этом атрибуте. Сделано на всякий случай. |
| freeze-event | string | Замораживает (отключает) выполнение указанного события. |
| unfreeze-event | string | Размораживает (включает) выполнение указанного события. |
