ФормаКлиентскогоПриложения.ВыбратьИзСписка (ClientApplicationForm.ChooseFromList)

ФормаКлиентскогоПриложения (ClientApplicationForm)

ВыбратьИзСписка (ChooseFromList)

Доступен, начиная с версии 8.2.

Синтаксис:

ВыбратьИзСписка(<СписокЗначений>, <ЭлементФормы>, <НачальноеЗначение>)

Параметры:

<СписокЗначений> (обязательный)

Тип: СписокЗначений.
Список значений, содержащий значения, из которых будет осуществляться выбор.

<ЭлементФормы> (необязательный)

Тип: ГруппаФормы, ТаблицаФормы, ПолеФормы, КнопкаФормы.
Элемент формы, около которого будет открыт выпадающий список. Для некоторых элементов выпадающий список будет показан около активной области.
Если не указан, то будет выбран активный элемент формы.
Примечание: В качестве этого параметра нельзя указывать кнопки, расположенные в командной панели или подменю.

<НачальноеЗначение> (необязательный)

Тип: Число, ЭлементСпискаЗначений.
Задает начальный элемент, который будет активным при открытии списка.
Если параметр не указан, в списке не будет выбрано начальное значение.

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

Тип: ЭлементСпискаЗначений, Неопределено.
Выбранный элемент списка или Неопределено, если пользователь отказался от выбора.

Описание:

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

Доступность:

Тонкий клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:

Если в списке значений указаны картинки, то они отображаются в выпадающем списке.
В веб-клиенте выбор осуществляется из списка, открываемого в отдельном окне.
Если для конфигурации свойство РежимИспользованияМодальности установлено в НеИспользовать, следует использовать метод ПоказатьВыборИзСписка.

Пример:

Список = Новый СписокЗначений;
Список.Добавить("Доставка");
Список.Добавить("Разгрузка");
Список.Добавить("Картинка",,,БиблиотекаКартинок.Картинка1);
Вид = ВыбратьИзСписка(Список, Элементы.Поле1);

См. также:

ФормаКлиентскогоПриложения, метод ВыбратьИзСпискаАсинх
ФормаКлиентскогоПриложения, метод ПоказатьВыборИзСписка

Использование в версии:

Доступен, начиная с версии 8.2.

Описание изменено в версии 8.3.18.

Методическая информация