Различия

Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.

tags:label [29/10/2020 16:32] (текущий)
Строка 1: Строка 1:
 +====== <label ... /> ======
 + 
 +''Статический текст. ''
 +----
  
 +===== Атрибуты =====
 + 
 +==== Основные атрибуты (R/W): ====
 +
 +^  Название  ^  Тип  ^  Описание  ^
 +|  **id**  |  [[intro:types#id_name]]  |Уникальный, в рамках приложения, идентификатор объекта. Доступ к объекту с помощью AppScript выполняется через этот идентификатор. \\ Если id не задан, то интерпретатор автоматически заполнит его некоторым случайным в момент запуска приложения. В этом случае appxml-программист лишается возможности обращаться к объекту.|  
 +
 +==== Визуальные атрибуты (R/W): ====
 +
 +^  Название  ^  Тип  ^  Описание  ^
 +|  **underline**  |  [[intro:types#boolean]]  |Флаг подчеркивания текста. По умолчанию, underline="false".|  
 +|  **gradient**  |  [[intro:types#boolean]]  |Установка градиента цвета для фона всего объекта. Поддерживаются дополнительные атрибуты: gradient-start="color_name", gradient-end="color-name", ''gradient-direction="horizontal | vertical"''|  
 +|  **icon**  |  [[intro:types#path]]  |Имя графического файла. Если имя начинается с "res:", это означает, что имеется ввиду файл из набора стандартных картинок внутри appxml.jar.|  
 +|  **icon-margin**  |  [[intro:types#number]]  |@icon-margin|  
 +|  **text-align**  | |@text-align|  
 +|  **text-valign**  |  |@text-valign|  
 +|  **margin**  |  [[intro:types#number]]  |Установка отступов, равных n вокруг объекта. Поддерживаются дополнительные атрибуты: margin-top, margin-left, margin-bottom, margin-right.|  
 +|  **orientation**  | |@orientation|  
 +|  **blink**  |  [[intro:types#boolean]]  |Включение режима мигания label.|  
 +|  **blink-timeout**  |  [[intro:types#number]]  |Период мигания в милисекундах. По умолчанию, 1000.|  
 +|  **moving**  |  [[intro:types#boolean]]  |Перемещение окна перемещением label. По умолчанию moving="true".|  
 +|  **field-***  | |Управление внешним видом value.|  
 +|  **field-margin-***  | |Управление отступом значения от текста.|  
 +|  **internalMargin-***  | [[intro:types#number]] | Семейство атрибутов для управления размещением объекта внутри другого объекта.|  
 +
 +
 +==== Атрибуты ввода (R/W): ====
 +
 +^  Название  ^  Тип  ^  Описание  ^
 +|  **required**  |  [[intro:types#boolean]]  |Атрибут контроля за обязательностью ввода значения в поле ввода. Если установлен, то при валидации значения (чтение значение атрибута valid) поле самостоятельно проверит заполненость и, в случае пустоты, выдаст соответствующее сообщение. \\ :!: **Важно!** При установке атрибута required, шрифт пользовательского текста изменится на жирный (bold). Это будет обращать внимание пользователя на важность поля ввода.|  
 +|  **value**  |  [[intro:types#string]]  |Эмулируется недоступное поле ввода.|  
 +|  **value-fn**  |  [[intro:types#string]]  |Описывается код вычисления значения. Вычисленное значение автоматически записывается в атрибут value. Вычисление инициируется командным атрибутом value-refresh данного объекта. \\ Используется при возникновении зависимости значения данного поля ввода от значения другого поля ввода. При этом другое поле ввода после изменения своего значения (событие onChanged) должно вызвать атрибут value-refresh данного поля ввода. Значение value данного поля ввода пересчитается и обновится. \\ Код вычисления значения должен возвращать значение через return.|  
 +|  **value-refresh**  |  [[intro:types#boolean]]  |Командный атрибут пересчета значения value на основе кода, описанного в атрибуте value-fn. При обращении к данному атрибуту (value-refresh="true") значение будет пересчитано и записано в атрибут value.|  
 +==== Атрибуты текстовой метки (R/W): ====
 +
 +^  Название  ^  Тип  ^  Описание  ^
 +|  **text**  |  [[intro:types#string]]  |Пользовательский текст. \\ Текст может содержать символ переноса строки '\n', а также может быть представленным в HTML-формате. \\ Если текст содержит спецсимволы ('<', '&' и другие, с точки зрения XML), то следует вместо атрибута text использовать одноименный тэг <text>, вложенный в текущий. Текст следует записать следующим образом (на примере описания тэга <string>): \\ <code>
 +<string id="name">
 +    <text>
 + <![CDATA[
 +    <html><font color="blue">User name</html>
 + ]]>
 +    </text>
 +</string>
 +</code>|
 +|  **text-position**  |  [[intro:types#position]]  |Расположение текста. Поддерживается значение "over" - расположение текста поверх картинки. |
 +
 +==== Атрибуты только для чтения (R/O): ====
 +
 +^  Название  ^  Тип  ^  Описание  ^
 +|  **empty**  |  [[intro:types#boolean]]  |Возвращает признак того, что поле пустое (т.е. "0", "" (пустая строка) или null)|  
 +
 +==== Командные атрибуты (W/O): ====
 +
 +^  Название  ^  Тип  ^  Описание  ^
 +|  **repaint**  |  [[intro:types#boolean]]  |Перерисовывает текст и пиктограмму.|  
 +
 +==== Событийные атрибуты (R/W): ====
 +
 +^  Название  ^  Тип  ^  Описание  ^
 +|  **onClick**  |  [[intro:types#code]]  |Описание действий для события, возникающего при щелчке мышью на объекте. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).|  
 +|  **onAction**  |  [[intro:types#code]]  |Описание действий для события, возникающего при щелчке мышью на объекте. Является синонимом метода onClick. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).|  
 +|  **onMouseOver**  |  [[intro:types#code]]  |Описание действий для события, возникающего при наведении курсора мыши на объект. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).|  
 +|  **onMouseOut**  |  [[intro:types#code]]  |Описание действий для события, возникающего при выходе курсора мыши из зоны объекта. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).|  
 +
 +
 +
 +===== Описание =====
 +
 +Статический текст. 
 +
 +===== Примеры =====
 +
 +Ссылка на страницу в Internet. 
 +<code>
 +<label  id="link" cursor="hand" text="http:\\desta.biz" font-size="10"  color="#000080" align="center">
 +     <onclick>
 +          execute(start http:\\desta.biz);
 +     </onclick>
 +</label>
 +</code>
 
tags/label.txt · Последние изменения: 29/10/2020 16:32 (внешнее изменение)
 
Recent changes RSS feed Valid XHTML 1.0 Valid CSS