Описание общих атрибутов

Здесь описаны атрибуты, имеющиеся и поддерживающиеся практически у всех визуальных тэгов (если иное не оговорено в явном виде).


Название Тип Описание
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=«n | +n | -n | 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 Размораживает (включает) выполнение указанного события.
 
intro/common_attributes.txt · Последние изменения: 19/01/2012 15:13 — admin
 
Recent changes RSS feed Valid XHTML 1.0 Valid CSS