1

Метод ВыбратьЗначение()

Метод предлагает пользователю выполнить интерактивный выбор одного значения из списка

Синтаксис

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

число ВыбратьЗначение(Значение, [Заголовок], [Позиция], [Таймаут], [СпособВыбора])

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

number ChooseValue(Value, [Title], [Position], [Timeout], [ChooseMethod])

Параметры

Описание параметров метода ВыбратьЗначение()

Имя параметра Тип Описание
Значение* Произвольный Имя ранее объявленной переменной, куда будет помещен результат выбора
Заголовок Строка Заголовок диалогового окна
Позиция Число Имя ранее объявленной переменной, куда будет помещена позиция выбранного значения
Таймаут Число Время ожидания реакции пользователя в секундах. По истечении указанного времени диалог ввода автоматически закрывается. Если значение равно 0 (нулю) или не указано, время ожидания не ограничено. Значение по умолчанию: 0
СпособВыбора Число Определяет способ отображения списка выбора

Возможные значения:
0 список значений будет представлен модальным диалоговым окном выбора;
1 список будет представлен в виде меню, подстроенным под текущий элемент на форме (или ячейку таблицы);
2 список будет представлен в виде списка, также подстроенным под текущий элемент на форме;
* — обязательный параметр

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

Число

Описание вариантов возвращаемых значений:

1 — выбор выполнен (нажата кнопка «ОК»)
0 — выбор не выполнен (окно закрыто крестиком или кнопкой «Отмена»)
-1 — наступил таймаут (истекло время ожидания)

Описание

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

Выбор из списка значений в режиме диалогового окна
Присвоив фактическому параметру СпособВыбора значение 1, можно настроить выбор из контекстного меню:
Выбор из списка в режиме контекстного меню
А если параметру СпособВыбора присвоить значение 2, можно настроить выбор из выпадающего списка:
Выбор значения из списка в режиме выпадающего списка

Внимание!
Метод ВыбратьЗначение() используется только для списка значений, созданного функцией СоздатьОбъект().
Внимание!
Поскольку метод ВыбратьЗначение() открывает диалог ввода в модальном режиме, избегайте ее использования в модуле проведения документов, а также в пределах открытой транзакции в многопользовательском режиме работы 1С:Предприятие 7.7

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

Пример кода с использованием метода ВыбратьЗначение()

Перем ВариантОплаты, ПозВыбора, Представление;
  
//инициируем список выбора
сз = СоздатьОбъект("СписокЗначений");
сз.ДобавитьЗначение(0, "Без оплаты");
сз.ДобавитьЗначение(1, "Наличными");
сз.ДобавитьЗначение(2, "Картой");
сз.ДобавитьЗначение(3, "Баллами");
   
//по умолчанию принимаем наличные
ВариантОплаты = 1;

Если сз.ВыбратьЗначение(ВариантОплаты, "Укажите способ оплаты", ПозВыбора) = 1 Тогда
    сз.ПолучитьЗначение(ПозВыбора, Представление);
    Сообщить("Выбран вариант оплаты: " + Представление);
КонецЕсли;

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

Объект СписокЗначений

Комментарии

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

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