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

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

ОтметитьЗначения

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

Синтаксис:

ОтметитьЗначения(<Значение>, <3аголовок>, <Позиция>, <Таймаут>)

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

CheckValues

Параметры:

<Значение> Идентификатор переменной, куда помещается значение – результат выбора.
<Загoлoвoк> Строковое выражение, значение которого отображается в заголовке диалогового окна. Может использоваться для подсказки пользователю.
<Пoзиция> Необязательный параметр. Идентификатор переменной, куда помещается номер позиции выбранного значения в списке.
<Tаймayт> Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя.

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

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

Описание:

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

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

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

Пример:

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

Перем ВыбДок;

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

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

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

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

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

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

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

КонецЦикла;

Список.ОтметитьЗначения(ВыбДок, "Выберите кредиты");

Возврат Список;

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