<list ... >

Поле ввода типа список. —-

Синтаксис

<list list-attributes>
   [{<listitem>
      ...
    <listitem/>}]
<list/>

Атрибуты List

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

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

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

Название Тип Описание
init-value value Установка начального значения поля ввода. При записи в init-value флаг изменения changed сбрасывается в false. В дальнейшем, обращясь к атрибуту changed, можно определять изменял ли пользователь значение в поле ввода.
:!: Поддерживается «expr:»(Вычисление в expr выполняется при создании поля ввода. Актуально при редактировании в ячейках view.)
value value Устанавливает текущей запись из списка, основываясь на значении атрибута «value» этой записи.
:!: Поддерживается «expr:»(Вычисление в expr выполняется при создании поля ввода. Актуально при редактировании в ячейках view.)
value-text string Устанавливает текущей запись из списка, основываясь на значении атрибута «name» этой записи.
value-fn string Описывается код вычисления значения. Вычисленное значение автоматически записывается в атрибут value. Вычисление инициируется командным атрибутом value-refresh данного объекта.
Используется при возникновении зависимости значения данного поля ввода от значения другого поля ввода. При этом другое поле ввода после изменения своего значения (событие onChanged) должно вызвать атрибут value-refresh данного поля ввода. Значение value данного поля ввода пересчитается и обновится.
Код вычисления значения должен возвращать значение через return.
field-* visual-attrbutes Семейство визуальных атрибутов для управления внешним видом непосредственно поля ввода.
field-margin-* visual-attrbutes Семейство визуальных атрибутов для управления отступом значения от текста. :!: Работает только при text-position=«left\right».

Атрибуты текстовой метки (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 Семейство визуальных атрибутов для управления внешним видом текстовой метки (пользовательским текстом).

Командные атрибуты (W/O):

Название Тип Описание
refresh boolean Oбновить данные.
value-refresh boolean Командный атрибут пересчета значения value на основе кода, описанного в атрибуте value-fn. При обращении к данному атрибуту (value-refresh=«true») значение будет пересчитано и записано в атрибут value.
remove all | true Удалить элемент списка.
current-row-by-id string Установка текущей записи по ее идентификатору (value)
current-row-by-name string Установка текущей записи по ее пользовательскому названию (text)
current-next boolean Установка текущей записью следующую, удовлетворяющую предыдущему значению current-row-by-name.

Атрибуты только для чтения (R/O):

Название Тип Описание
changed boolean Возвращает флаг изменения значения в поле ввода. Значение может быть изменено как «вручную» (пользователем), так и программным способом (через атрибут value).
empty boolean Возвращает признак того, что поле пустое (т.е. «0», »» (пустая строка) или null)
null boolean Возвращает признак того, что поле содержит значение null (несмотря на то, что визуально там нормальное пустое значение)
valid boolean Возвращает флаг валидности (корректности) значения. Значение проверяется полем самстоятельно, на основании ранее установленных атрибутов (например, required) и полученного кода в vaildate-fn.

Прочие атрибуты (R/W):

Название Тип Описание
id-field string id-field=«id_field_name»
name-field string name-field=«name_field_name»
sql string sql=«sql»
selection single | multi default: «single»
current-row ext-number current-row=«nn | +nn | -nn» - чтение/установка текущей записи по ее номеру либо на nn позиций вперед/назад

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

Название Тип Описание
onBeforeInit code Описание действий для события, возникающего перед установкой начального значения (атрибут init-value).
Правила описания см. (Описание событий в ApplicationXML).
onAfterInit code Описание действий для события, возникающего после установки начального значения (атрибут init-value).
Правила описания см. (Описание событий в ApplicationXML).
onChanged code Вызывается после каждого изменения пользователем поля ввода. При программном изменении значения (value) событие не генерируется.
Правила описания см. (Описание событий в ApplicationXML).
onEnter code Описание действий для события, возникающего при получении объектом фокуса.
Правила описания см. (Описание событий в ApplicationXML).
onExit code Описание действий для события, возникающего при потере объектом фокуса.
Правила описания см. (Описание событий в ApplicationXML).
onSelected code Описание действий для события, возникающего при выборе элемента из множества доступных (например, в выпадающем списке).
Правила описания см. (Описание событий в ApplicationXML).
Часто onSelected является синонимом для onAction.

Атрибуты Listitem

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

Название Тип Описание
text string Название элемента в списке, которое видит пользователь.
value string Внутреннее значение элемента в списке, невидимое для пользователя.
default boolean Флаг, устанавливающий значение по умолчанию. Одновременно может быть поднят только один флаг в группе элементов списка.

Описание

Список описывается с помощью тэга <list>. Елементы списка описываются с помощью тэгов <listitem>.

Так же есть поддержка динамической работы со списком <list>. Обращение к элементам списка - как к данным view: двумерный массив, колонки имеют зарезервированные имена: text, value, icon

// инициализация (массив хэш-массивов)
cb1.setData(["text" => "aaa", "value" => 1}, {"text" => "bbb", "value" => 2}, {"text" => "cccc", "value" => 3"}]);

// удаление 1-й записи
cb1.getDatastore().removeRow(0);
	
// добавление записи
cb1.getDatastore().addRow();
cb1[cb1.getDatastore().size() - 1]['text'] = "Hello" + (cb1.getDatastore().size() - 1);

// как вариант
cb1.getDatastore()[cb1.getDatastore().size() - 1]['text'] = "Hello" + (cb1.getDatastore().size() - 1);

Примеры

<list id="list_id" text="Список игрушек">
    <listitem name="Крокодил" value="1"/>
    <listitem name="Чебурашка" value="2"/>
    <listitem name="Поросенок" value="3" default="true"/>
    <listitem name="Кролик" value="4"/>
    <listitem name="Собака" value="5"/>
    <onchanged>
       println(this.value-text + ' - ' + this.value);
    </onchanged>
</list>	
 
tags/inputfields/list.txt · Последние изменения: 29/10/2020 16:33 (внешнее изменение)
 
Recent changes RSS feed Valid XHTML 1.0 Valid CSS