Открывает диалог выбора элемента из списка значений
Синтаксис
Метод ВыбратьЭлемент() имеет следующий синтаксис:
ВыбратьЭлемент([Заголовок=""], [Элемент=])
А также альтернативный англоязычный синтаксис:
ChooseItem([Заголовок=""], [Элемент=])
Параметры
Описание параметров метода ВыбратьЭлемент():
| Имя параметра* | Тип | Описание |
|---|---|---|
| Заголовок | Строка |
Заголовок окна выбора. Если параметр не указан, то используется стандартный заголовок. Значение по умолчанию: Пустая строка |
| Элемент | ЭлементСпискаЗначений |
Элемент, на который следует изначально спозиционировать список значений при открытии диалога выбора. Если значением параметра не является элемент списка значений, входящий в данный список, позиционирования не произойдет. |
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
ЭлементСпискаЗначений
Неопределено — если выбор не состоялся
Описание
Метод ВыбратьЭлемент() открывает диалоговое окно для интерактивного выбора одного из элементов списка значений. Если пользователь откажется от выбора, метод вернет Неопределено
Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | Клиент |
| 8.2 | Толстый клиент, Тонкий клиент |
| 8.3 | Толстый клиент, Тонкий клиент, Мобильный клиент, Мобильное приложение |
Пример использования
Пример кода с использованием метода ВыбратьЭлемент():
сз = Новый СписокЗначений; сз.Добавить(1, "Вариант 1"); сз.Добавить(2, "Вариант 2"); сз.Добавить(3, "Вариант 3"); ВыбЭлт = сз.ВыбратьЭлемент("Ваш выбор:"); Если НЕ ВыбЭлт = Неопределено Тогда Если ВыбЭлт.Значение = 1 Тогда //выбран пункт 1 ИначеЕсли ВыбЭлт.Значение = 2 Тогда //выбран пункт 2 Иначе //выбран пункт 3 КонецЕсли; КонецЕсли;