Методы объекта Список Значений
ВыбратьЗначение
Открыть окно для интерактивного выбора значения из списка.
Синтаксис:
ВыбратьЗначение(<Значение>, <3аголовок>, <Позиция> , <Таймаут>, <Спосо6Выбора>)
Англоязычный синоним:
ChooseValue
Параметры:
<Значение> | Идентификатор переменной, куда помещается значение – результат выбора. |
<3аголовок> | Строковое выражение, значение которого отображается в заголовке диалогового окна. Может использоваться для подсказки пользователю. |
<Позиция> | Идентификатор переменной, куда помещается номер позиции выбранного значения в списке. |
<Таймаут> | Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя. |
<СпособВыбора> | Необязательный параметр. Числовое выражение, значение которого задает способ выбора значения:
|
Возвращаемое значение:
Число: 1 – если выбор произведен (нажата кнопка "ОК"); 0 – если выбор не призведен (нажата кнопка "ОТМЕНА"); -1 (минус единица) – закончилось время <Таймаут> ожидания отклика пользователя.
Описание:
Метод ВыбратьЗначение вызывает диалоговое окно для интерактивного выбора значения из заранее подготовленного списка. Возвращаемое числовое значение: 1 – если выбор произведен, 0 – если нет. Параметр <Значение> указывает на значение того элемента списка, на котором будет установлен курсор при открытии окна выбора. В этот же параметр возвращается выбранное значение. В параметр <Позиция> возвращается номер позиции выбранного значения в списке. Если выбор отменен, то значение параметров не меняются.
Данный метод может использоваться только для переменных созданных функцией СоздатьОбъект.
Пример:
Процедура ВыбратьКредит(ДокКредита) Список = СоздатьОбъект("СписокЗначений"); Рег = СоздатьОбъект("Регистр.ТоварныйКредит"); Per.УстановитьФильтр(Клиент, ); Per.ВыбратьИтоги(); Пока Per.ПолучитьИтог() = 1 Цикл Док = Рег.Документ; Список.ДобавитьЗначение(Док, "" + Док + " — Остаток = " + Рег.Долг); КонецЦикла; Если Список.ВыбратьЗначение(ВыбДок, "Выберите кредит") = 1 Тогда ДокКредита = ВыбДок; КонецЕсли; КонецПроцедуры