Про listbox

Свойства и поведение листбокса

Свойства листбокса:


Свойство show

Задает формат отображения элемента в выпадающем списке.
В качестве значения указывается поле в структуре элемента. Если необходимо
отображать несколько полей, то название полей обрамляются '%'. Пример:
show="%name% (%code%)"

Свойство editShow

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

Свойство query_value

Задает формат отображения элемента в запросе на сервер.
В качестве значения указывается поле в структуре элемента.

Свойство sortField

Определяет поле структуры по которому происходит сортировка списка

Свойство filterField

Определяет поле структуры по которому происходит фильтрация списка

Свойство unreal

Значения true | false
Добавляет в начало списка пустой элемент.

Свойство showFilter

Значения true | false
Если установлено, то в контестном меню появится пункт с помощью
которого можно задать фильтр для листбокса. Сейчас это регулярное
выражение которое применяется к полям filterField.
Элементы, поля filterField которых не удовлетворят
условию регулярного выражения не будут отображаться в листбоксе.
Сброс фильтра осуществляется заданием пустой строки.

Свойство useFilter

Значения регулярное выражение
С помощью этого свойства устанавливается фильтр для списка.

Свойство ignoreFilterCase

Значения true | false
Игнорировать или нет регистр при фильтрации.
По умолчанию false

Свойство cacheSize

По умолчанию cacheSize = 0
Определяет размер кеша выбранных значений.
Если cacheSize > 0, то все выбранные значения будут попадать в кеш.
Кеш представляет собой выделенную зону в самом начале выпадающего списка.
Кеш организован как стек (LIFO).

Свойство col

Имеет тоже значение, что и аналогичное свойство для элемента edit
Для редактируемого листбокса определяет количество колонок в редакторе.

Свойство listMode

Это свойство сейчас не используется.
Планировалось с помощью него задавать различные режимы поведения листбокса.
Сейчас реализован только один режим showPopup. Если он установлен, то
происходит следующее: при начале печати в редакторе список автоматически
выпадает и выделяется первый подходящий элемент.

Свойство invalidValues

Значения true | false
Указывает, можно ли в редакторе вводить не верные значения, т.е. те, которых
нет в списке.
Если будет введено некорректное значение, то листбокс будет ругаться
посредством красной рамочки вокруг редактора.

Свойство emptyValue

Значения true | false
Тоже, что и invalidValues только для пустых
значений.
Если будет введено некорректное значение, то листбокс будет ругаться
посредством красной рамочки вокруг редактора.
Назад