Синтаксис и применение Список значений в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
Список значений
Список значений
Список значений - это не сохраняемый в базе данных объект, который позволяет строить для решения интерфейсных задач динамические наборы значений и манипулировать ими (добавлять, редактировать, удалять элементы, сортировать). Он может быть наполнен значениями любого типа, т.е. в одном списке типы хранимых значений могут быть разными. Одним из примеров использования данного объекта может служить организация выбора конкретного документа из списка возможных документов, сформированного по сложному алгоритму.
Методическая информация
Практические примеры
Подготовить список способов доставки с представлениями
Значение для хранения отличается от подписи, которую видит пользователь.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Список создаётся в памяти.
Это подготовка данных выбора, а не вызов диалога.
Способы = Новый СписокЗначений;
Способы.Добавить("pickup", "Самовывоз");
Способы.Добавить("courier", "Курьер");
Способы.Добавить("post", "Почта");
Способы.СортироватьПоПредставлению();
Элемент = Способы.НайтиПоЗначению("pickup");
Если Элемент <> Неопределено Тогда
Элемент.Пометка = Истина;
Сообщить(Элемент.Представление);
Сообщить(Элемент.Значение);
КонецЕсли;
Значения = Способы.ВыгрузитьЗначения();
Сообщить(Значения.Количество());Разбор по шагам
Добавляем стабильные коды и пользовательские подписи.
Сортируем по подписям, а ищем по значению pickup.
Пометка хранится у элемента; ВыгрузитьЗначения возвращает только значения.
Как проверить результат
Вывод: Самовывоз; pickup; 3.
Неизвестный код в НайтиПоЗначению должен вернуть Неопределено.
Ожидаемый результат
Найдён Самовывоз, пометка установлена; массив содержит три кода.
На что обратить внимание
После сортировки не определяйте способ по старому индексу.
ВыгрузитьЗначения не сохраняет представления и пометки.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.