Открывает выпадающий список для выбора значения
Синтаксис
Метод ВыбратьИзСписка() имеет следующий синтаксис:
ЭлементСпискаЗначений ВыбратьИзСписка(СписокЗначений, [ЭлементФормы], [НачальноеЗначение])
А также альтернативный англоязычный синтаксис:
ValueListElement ChooseFromList(ValueList, [FormElement], [StartValue])
Параметры
Описание параметров метода ВыбратьИзСписка():
| Имя параметра* | Тип | Описание |
|---|---|---|
| СписокЗначений | СписокЗначений | Список значений, содержащий значения, из которых будет осуществляться выбор.
Примечание: Если в списке значений указаны картинки, то они отображаются в выпадающем списке. |
| ЭлементФормы | ГруппаФормы, ТаблицаФормы, ПолеФормы, КнопкаФормы | Элемент формы, около которого будет открыт выпадающий список. Если не указан, то будет выбран активный элемент формы. |
| НачальноеЗначение | Число, ЭлементСпискаЗначений | Задает начальный элемент, который будет активным по-умолчанию при открытии списка. |
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
| ЭлементСпискаЗначений | — если пользователь выбрал значение |
Неопределено |
— если пользователь отказался от выбора |
Описание
Метод ВыбратьИзСписка() Открывает выпадающий список для выбора значения из предложенного списка. Выпадающий список будет расположен около переданного элемента формы или около его активной области.
Внимание! В веб-клиенте выбор осуществляется из списка, открываемого в отдельном окне.
Внимание!! Если для конфигурации отключен режим использования модальности (свойство
РежимИспользованияМодальности установлено в НеИспользовать), следует использовать метод ПоказатьВыборИзСписка().Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | не поддерживается! |
| 8.2 | Толстый клиент, Тонкий клиент |
| 8.3 | Толстый клиент, Тонкий клиент, Мобильный клиент, Мобильное приложение |
Пример использования
Пример кода с использованием метода ВыбратьИзСписка():
&НаКлиенте Процедура СпособПолученияНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка) СписокВыбора = Новый СписокЗначений; СписокВыбора.Добавить("Самовывоз"); СписокВыбора.Добавить("Доставка"); //в качестве элемента указываем элемент, вызвавший событие ВыбЭлемент = ЭтаФорма.ВыбратьИзСписка(СписокВыбора, Элемент, 0); Если НЕ ВыбЭлемент = Неопределено Тогда СпособПолучения = ВыбЭлемент.Значение; КонецЕсли; СтандартнаяОбработка = Ложь; КонецПроцедуры
Читайте также:
Поделиться страницей в соц.сетях