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