Объектная модель > Основные механизмы > Dialogs – диалоги > CreateInputDialog – создать диалог с запросом параметров > AddSelect – выпадающий список

С помощью перегрузки метода AddSelect() можно добавить в диалог контрол «Выпадающий список».

Синтаксис

C#
public IDropDownDialogValue AddSelect(string title, bool isRequired, string defaultValue);

Параметры

title – заголовок контрола;

isRequired – признак того, что контрол является обязательным для заполнения;

defaultIndex – индекс значения по умолчанию;

defaultValue – значение по умолчанию. Можно выбирать значения типа string (строка).

Возвращаемое значение

Контрол «Выпадающий список» (IDropDownDialogValue).

IDropDownDialogValue

Методы

Имя	Описание
From(params string[] values)	Задать список допустимых значений. Параметр: values – список допустимых значений. Возвращаемое значение: контрол «Выпадающий список»
SetOnValueChanged()	Задать обработчик, который выполняется при изменении контрола
WithLabel(string label)	Установить текстовую метку для контрола. Параметр: label – текст метки. Возвращаемое значение: контрол «Выпадающий список»
WithPlaceholder(string text)	Добавить текст подсказки в контрол. Параметр: text – текст подсказки. Возвращаемое значение: контрол «Выпадающий список»

Свойства

Имя	Тип	Описание
IsEnabled	bool	Признак того, что контрол доступен
IsLabelVisible	bool	Признак того, что текстовая метка является видимой
IsRequired	bool	Признак того, что контрол обязателен для заполнения
IsVisible	bool	Признак того, что контрол является видимым
Value	string	Значение контрола
ValueIndex	int	Индекс выбранного значения

Пример 1. Выбор сущности из справочника «Пользователи»

// Значение по умолчанию должно быть пустым.
var user = dialog.AddSelect("Ответственный", true, Sungero.CoreEntities.Users.Null);

Пример 2. Выбор сущности из справочника «Пользователи» с ограничением

// Определить список допустимых значений на выбор с помощью метода From().
var user = dialog.AddSelect("Ответственный", true, Sungero.CoreEntities.Users.Null).From(user1, user2, user3);

Добавить контрол «Выпадающий список»

Добавить контрол «Выпадающий список»