Метод предлагает пользователю выполнить интерактивный выбор одного значения из списка
Синтаксис
Метод ВыбратьЗначение()
имеет следующий синтаксис:
число ВыбратьЗначение(Значение, [Заголовок], [Позиция], [Таймаут], [СпособВыбора])
А также альтернативный англоязычный синтаксис:
number ChooseValue(Value, [Title], [Position], [Timeout], [ChooseMethod])
Параметры
Описание параметров метода ВыбратьЗначение()
Имя параметра | Тип | Описание | ||||||
---|---|---|---|---|---|---|---|---|
Значение* | Произвольный | Имя ранее объявленной переменной, куда будет помещен результат выбора | ||||||
Заголовок | Строка | Заголовок диалогового окна | ||||||
Позиция | Число | Имя ранее объявленной переменной, куда будет помещена позиция выбранного значения | ||||||
Таймаут | Число | Время ожидания реакции пользователя в секундах. По истечении указанного времени диалог ввода автоматически закрывается. Если значение равно 0 (нулю) или не указано, время ожидания не ограничено. Значение по умолчанию: 0 | ||||||
СпособВыбора | Число | Определяет способ отображения списка выбора.
|
||||||
* — обязательный параметр |
Возвращаемое значение
Число
Описание вариантов возвращаемых значений:
1 | — выбор выполнен (нажата кнопка «ОК») |
0 | — выбор не выполнен (окно закрыто крестиком или кнопкой «Отмена») |
-1 | — наступил таймаут (истекло время ожидания) |
Описание
Метод ВыбратьЗначение()
предлагает пользователю выполнить интерактивный выбор значения из заранее подготовленного списка значений. Значение, содержащееся в параметре Значение
будет выделено в списке выбора как текущее. В этот же параметр помещается результат выбора пользователя. По умолчанию выбор осуществляется из диалогового окна:
Присвоив фактическому параметру СпособВыбора
значение 1, можно настроить выбор из контекстного меню:
А если параметру СпособВыбора
присвоить значение 2, можно настроить выбор из выпадающего списка:
Метод
ВыбратьЗначение()
используется только для списка значений, созданного функцией СоздатьОбъект().Поскольку метод
ВыбратьЗначение()
открывает диалог ввода в модальном режиме, избегайте ее использования в модуле проведения документов, а также в пределах открытой транзакции в многопользовательском режиме работы 1С:Предприятие 7.7Пример использования
Пример кода с использованием метода ВыбратьЗначение()
Перем ВариантОплаты, ПозВыбора, Представление; //инициируем список выбора сз = СоздатьОбъект("СписокЗначений"); сз.ДобавитьЗначение(0, "Без оплаты"); сз.ДобавитьЗначение(1, "Наличными"); сз.ДобавитьЗначение(2, "Картой"); сз.ДобавитьЗначение(3, "Баллами"); //по умолчанию принимаем наличные ВариантОплаты = 1; Если сз.ВыбратьЗначение(ВариантОплаты, "Укажите способ оплаты", ПозВыбора) = 1 Тогда сз.ПолучитьЗначение(ПозВыбора, Представление); Сообщить("Выбран вариант оплаты: " + Представление); КонецЕсли;
Огромное спасибо!