Это элемент управления, который позволяет выбирать из доступных вариантов. Поддерживает поиск и выбор нескольких вариантов.

Описание

Элемент управления Поле со списком позволяет выполнять поиск элементов, которые необходимо выбрать. Поиск выполняется на стороне сервера с помощью свойства SearchField, что не влияет на производительность при использовании больших источников данных.

Режим одиночного или множественного выбора настраивается с использованием свойства SelectMultiple.

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

Основные свойства

Items — источник данных, в котором можно выбрать элементы.

DefaultItems — элементы, выбранные изначально до взаимодействия с элементом управления.

SelectedItems — список выбранных элементов в результате действий пользователя.

SelectMultiple — позволяет определить, сколько элементов можно выбрать: один или несколько.

IsSearchable — позволяет определить, можно ли выполнять поиск элементов, прежде чем их выбрать.

Дополнительные свойства

BorderColor — цвет границы элемента управления.

BorderStyle — стиль границы элемента управления: Сплошная, Штриховая, Пунктирная или Отсутствует.

BorderThickness — толщина границы элемента управления.

Default — элемент, выбранный изначально до изменения пользователем в режиме одиночного выбора.

DisplayFields — список полей, отображаемый для каждого элемента, возвращенного в результате поиска. Это свойство проще всего настроить с помощью панели данных на вкладке параметров "Свойства".

DisplayMode — в зависимости от значения этого режима элемент управления разрешает пользователю вводить данные (Изменение), только отображает данные (Просмотр) или элемент вообще отключен (Отключено).

Height — расстояние между верхним и нижним краем элемента управления.

InputTextPlaceholder — пояснительный текст, который видят пользователи, если элементы не выбраны.

OnChange — поведение приложения, когда пользователь выбирает другой элемент.

OnNavigate — поведение приложения, когда пользователь щелкает элемент.

OnSelect — поведение приложения, когда пользователь щелкает элемент управления или касается его.

Visible определяет, отображается ли элемент управления или он скрыт.

Width — расстояние между левым и правым краем элемента управления.

X — расстояние между левым краем элемента управления и левым краем его родительского контейнера (или экрана, если родительского контейнера нет).

Y — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера (или экрана, если родительского контейнера нет).

Пример

  1. Добавьте элемент управления Поле со списком из вкладки "Вставка" в меню "Элементы управления".
  2. На вкладке параметров "Свойства" щелкните "Данные".
  3. Выберите ниже источник данных, макет и соответствующие свойства.
  4. На вкладке "Дополнительно" задайте свойство SelectMultiple.

    В вашем приложении появится активное поле со списком.

    Не знаете, как добавить и настроить элемент управления?