<slider ... />

Поле ввода для ввода значения с помощью ползунка..


Синтаксис

<slider id
        text
        order (horizontal | vertical)
        min (default 0)
        max (default 10)
        value
        init-value
        tick-[visible (true|false) | 
              step (int) (java:setMinorTickSpacing) | 
              label-visible (true|false) | 
              label-step (int) (java:setMajorTickSpacing)| 
              snap (java:setSnapToTicks() (true|false)]
        onAction
>
	<ticklabel value="0"	name="Так же" />
	<ticklabel value="-25"	name="Хуже" />
	<ticklabel value="25"	name="Лучше" />
</slider>

Атрибуты

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

Название Тип Описание
id id_name Уникальный, в рамках приложения, идентификатор объекта. Доступ к объекту с помощью AppScript выполняется через этот идентификатор.
Если id не задан, то интерпретатор автоматически заполнит его некоторым случайным в момент запуска приложения. В этом случае appxml-программист лишается возможности обращаться к объекту.
db-field string Имя поля в SQL-запросе. Окно ввода, в котором описан SQL-запрос и в составе которого описывается поле ввода свяжет поле из запроса и поле ввода. Если поле ввода размещается не в окне ввода, а в другом окне, то связь должен обеспечивать appxml-программист самостоятельно, работая напрямую с <query> и атрибутом db-field.

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

Название Тип Описание
order horizontal | vertical Порядок расположения ticklabel. По умолчанию order=«horizontal»

Атрибуты ввода (R/W):

Название Тип Описание
init-value value Установка начального значения поля ввода. При записи в init-value флаг изменения changed сбрасывается в false. В дальнейшем, обращясь к атрибуту changed, можно определять изменял ли пользователь значение в поле ввода.
:!: Поддерживается «expr:»(Вычисление в expr выполняется при создании поля ввода. Актуально при редактировании в ячейках view.)
value value Установка значения поля ввода. Если в процессе работы программы требуется изменить значение поля ввода программным способом, то делать это следует через данный атрибут. :!: Не путать с init-value!
:!: Поддерживается «expr:»(Вычисление в expr выполняется при создании поля ввода. Актуально при редактировании в ячейках view.)
required boolean Атрибут контроля за обязательностью ввода значения в поле ввода. Если установлен, то при валидации значения (чтение значение атрибута valid) поле самостоятельно проверит заполненость и, в случае пустоты, выдаст соответствующее сообщение.
:!: Важно! При установке атрибута required, шрифт пользовательского текста изменится на жирный (bold). Это будет обращать внимание пользователя на важность поля ввода.
validate-fn string Атрибут для указания дополнительного программного кода, используемого для валидации значения поля ввода. При чтении значения атрибута valid указанный код будет вызван после внутренних проверок значения на валидность (например, если указан атрибут required). Правила написания кода валидации совпадают с правилами написания кода для событийных атрибутов. Код должен возвращать булевое значение true/false.
value-fn string Описывается код вычисления значения. Вычисленное значение автоматически записывается в атрибут value. Вычисление инициируется командным атрибутом value-refresh данного объекта.
Используется при возникновении зависимости значения данного поля ввода от значения другого поля ввода. При этом другое поле ввода после изменения своего значения (событие onChanged) должно вызвать атрибут value-refresh данного поля ввода. Значение value данного поля ввода пересчитается и обновится.
Код вычисления значения должен возвращать значение через return.
field-* visual-attrbutes Семейство визуальных атрибутов для управления внешним видом непосредственно поля ввода.
field-margin-* visual-attrbutes Семейство визуальных атрибутов для управления отступом значения от текста. :!: Работает только при text-position=«left\right».
min number Минимальное значение.
max 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 Положение пользовательского текста.
text-* visual-attrbutes Семейство визуальных атрибутов для управления внешним видом текстовой метки (пользовательским текстом).

Атрибуты tick (R/W):

Название Тип Описание
tick-visible boolean Флаг управления видимостью отметки.
tick-step number Шаг между отметками.
tick-label-visible boolean Флаг управления видимостью текста отметки.
tick-label-step number Шаг между текстом отметки.
tick-snap boolean

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

Название Тип Описание
onAction code Описание действий для события, возникающего при выборе значения.
Правила описания см. (Описание событий в ApplicationXML).

Описание

Поле ввода значения с помощью ползунка. Возвращает целое значение.

Примеры

<panel id="betterWorsePanel" background-color="lightGray">
	<panel layout="flow" align="center">
		<slider id="bwSlider" order="vertical" min="-50" max="50" init-value="0" height="100" tick-step="25" tick-label-step="25" tick-snap="false">
			<ticklabel value="50" name="Очень хорошо"/>
			<ticklabel value="25" name="Лучше"/>
			<ticklabel value="0" name="Также"/>
			<ticklabel value="-25" name="Хуже"/>
			<ticklabel value="-50" name="Очень плохо"/>
		</slider>
	</panel>
	<panel position="bottom" layout="flow" align="right">
		<button text="ENTER" width="100" height="20" internal-margin="1" margin="3">
			<onaction>
				println("VALUE = " + bwSlider.value);
			</onaction>
		</button>
	</panel>	
</panel>
 
tags/inputfields/slider.txt · Последние изменения: 19/01/2012 15:46 — admin
 
Recent changes RSS feed Valid XHTML 1.0 Valid CSS