0

Метод ВыбратьИзМеню() в управляемой или обычной форме

Открывает меню для выбора значения из списка

Синтаксис

Метод ВыбратьИзМеню() имеет следующий синтаксис:

ЭлементСпискаЗначений ВыбратьИзМеню(СписокЗначений, [ЭлементФормы])

А также альтернативный англоязычный синтаксис:

ValueListElement ChooseFromMenu(ValueList, [FormElement])

Параметры

Описание параметров метода ВыбратьИзМеню():

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

Примечание: Если в списке значений указаны пометки или картинки, то они отображаются в меню.

ЭлементФормы (необязательный) ЭлементУправления Элемент управления формы, около которого будет открыт выпадающий список. Если не указан, то будет выбран активный элемент формы

Примечание: В качестве этого параметра нельзя указывать кнопки, расположенные в командной панели или подменю.

Жирным шрифтом выделены обязательные параметры

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

ЭлементСпискаЗначений — если пользователь выбрал значение
Неопределено — если пользователь отказался от выбора

Описание

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

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

Доступность

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

Пример использования

Пример кода с использованием метода ВыбратьИзМеню():

Процедура КнопкаВыбораНажатие(Элемент)
	
	СписокВыбора = Новый СписокЗначений;
	СписокВыбора.Добавить(0, "Вариант заполнения по умолчанию");
	СписокВыбора.Добавить(1, "Вариант заполнения 1");
	СписокВыбора.Добавить(2, "Вариант заполнения 2");
	
	//в качестве элемента указываем элемент, вызвавший событие
	ВыбЭлемент = ЭтаФорма.ВыбратьИзМеню(СписокВыбора, Элемент);
	Если ВыбЭлемент = Неопределено Тогда
		//подменяем пустой выбор на выбор по умолчанию
		ВыбЭлемент = СписокВыбора[0];
	КонецЕсли;
	
	Сообщить(ВыбЭлемент.Значение);
	
КонецПроцедуры

Читайте также:

  1. Метод ВыбратьИзСписка() в управляемой или обычной форме

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *