Иллюстрированный самоучитель по языку системы 1С:Предприятие

Методы объекта Список Значений

ВыбратьЗначение

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

Синтаксис:

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

Англоязычный синоним:

ChooseValue

Параметры:

<Значение> Идентификатор переменной, куда помещается значение – результат выбора.
<3аголовок> Строковое выражение, значение которого отображается в заголовке диалогового окна. Может использоваться для подсказки пользователю.
<Позиция> Идентификатор переменной, куда помещается номер позиции выбранного значения в списке.
<Таймаут> Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя.
<СпособВыбора> Необязательный параметр. Числовое выражение, значение которого задает способ выбора значения:
  • 0 – в виде диалога;
  • 1 – выбор производится в виде меню, которое подстраивается по месту текущего элемента диалога или ячейки таблицы, откуда вызвано;
  • 2 – выбор маленьким списком (список похож на выбор значения перечисления), также привязанным к позиции элемента диалога.
Значение по умолчанию – 0.

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

Число: 1 – если выбор произведен (нажата кнопка "ОК"); 0 – если выбор не призведен (нажата кнопка "ОТМЕНА"); -1 (минус единица) – закончилось время <Таймаут> ожидания отклика пользователя.

Описание:

Метод ВыбратьЗначение вызывает диалоговое окно для интерактивного выбора значения из заранее подготовленного списка. Возвращаемое числовое значение: 1 – если выбор произведен, 0 – если нет. Параметр <Значение> указывает на значение того элемента списка, на котором будет установлен курсор при открытии окна выбора. В этот же параметр возвращается выбранное значение. В параметр <Позиция> возвращается номер позиции выбранного значения в списке. Если выбор отменен, то значение параметров не меняются.

Данный метод может использоваться только для переменных созданных функцией СоздатьОбъект.

Пример:

Процедура ВыбратьКредит(ДокКредита)

Список = СоздатьОбъект("СписокЗначений");

Рег = СоздатьОбъект("Регистр.ТоварныйКредит");

Per.УстановитьФильтр(Клиент, );

Per.ВыбратьИтоги();

Пока Per.ПолучитьИтог() = 1 Цикл

Док = Рег.Документ;

Список.ДобавитьЗначение(Док, "" + Док + " — Остаток = " + Рег.Долг);

КонецЦикла;

Если Список.ВыбратьЗначение(ВыбДок, "Выберите кредит") = 1 Тогда

ДокКредита = ВыбДок;

КонецЕсли;

КонецПроцедуры
Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.