К статье
Практический материал

Другое · 5 мин

Как сделать список выбора на форме в 1С

Практически объясняем, как добавить и заполнить список выбора на форме 1С, задать значения, получить результат и избежать типичных ошибок при настройке управляемых форм.

Что такое список выбора на форме и где применяется

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

На управляемой форме список настраивается через свойства формы или элемента управления, а значения можно задать либо в конфигураторе вручную, либо программно при открытии формы. Важно различать статичный набор вариантов и динамический список, который зависит от данных в информационной базе.

Перед настройкой определите, будет ли список редактируемым, допустим ли пустой выбор и какое значение должно быть выбрано по умолчанию. Это влияет на способ заполнения и на проверку результата после выбора пользователем.

Порядок действий
  1. 1
    Откройте форму в конфигураторе и выберите элемент управления СписокВыбора
  2. 2
    Заполните свойство СписокВыбора вручную или создайте СписокЗначений в модуле формы
  3. 3
    Присвойте коллекцию свойству СписокВыбора перед открытием формы
  4. 4
    Проверьте, что значения отображаются и выбрано значение по умолчанию

Способы заполнения списка выбора

В конфигураторе можно вручную прописать пары «значение — представление» в свойстве элемента управления. Такой подход удобен, если набор вариантов не меняется и одинаков для всех пользователей.

Если варианты зависят от данных или заполняются условно, список создаётся программно в модуле формы на основе СпискаЗначений. Коллекция заполняется перед отображением формы и присваивается свойству СписокВыбора элемента.

1c
Элементы.МойСписок.СписокВыбора = Значения;

Программное заполнение и получение выбранного значения

В модуле формы можно очистить список, добавить значения и установить текущее выделение. Ниже приведён примерный однострочный фрагмент для понятия механизма, а не готовое решение для конкретной конфигурации.

Получить выбранное значение можно через свойство Значение того же элемента. Если список не множественный, свойство содержит одно значение или неопределённое, если пользователь ничего не выбрал.

Значение можно использовать в расчётах, записывать в реквизит объекта или передавать в отчёт. Перед использованием рекомендуется убедиться, что выбор не равен неопределённому значению.

Проверка результата и обработка события выбора

На форме можно обработать событие изменения значения или обработку выбора, чтобы сразу отреагировать на решение пользователя. Это полезно для автоматического заполнения связанных полей или блокировки недоступных действий.

Контрольные точки

Как проверить результат

Выбранное значение
Норма

Значение отличается от неопределённого и соответствует одному из пунктов списка

Тревожный признак

Значение неопределённое или отсутствует в списке допустимых вариантов

Если поле обязательное, пустой выбор должен вызывать сообщение и отмену записи. Не полагайтесь только на визуальное выделение в списке, так как пользователь может оставить значение по умолчанию случайно.

Проверку удобно вынести в отдельную функцию, которую вызывают перед записью и при попытке перехода к следующей странице формы. Это упрощает поддержку и тестирование.

Типичные ошибки
01
Путать СписокВыбора с табличным полем — разные элементы и свойства
02
Заполнять список каждый раз при открытии без очистки — дублирование значений
03
Не проверять пустой выбор перед записью — некорректные данные

Ограничения и частые ошибки

Не путайте СписокВыбора с табличным полем: у них разные свойства, события и способы заполнения. Попытка присвоить таблице значение списка приведёт к ошибке или некорректному отображению.

Не заполняйте список повторно при каждом открытии формы без очистки, иначе значения могут дублироваться. Также избегайте жёстко заданных строк без учёта языка интерфейса пользователя.

Сравнение вариантов

Список выбора

Подходит для короткого постоянного набора вариантов

Выбор из справочника

Подходит при большом или меняющемся наборе, требуется ссылка на объект

Альтернативы и когда использовать справочник вместо списка

Если вариантов много, они часто меняются или требуется ссылка на объект базы, лучше использовать выбор из справочника или перечисления. Список выбора подходит для короткого и относительно постоянного набора вариантов.

Выбор между способами зависит от того, нужно ли просто значение или полноценный объект с реквизитами. Для ссылок на номенклатуру, контрагентов или счета удобнее стандартный механизм выбора из справочника.

Итог

Что важно запомнить

Настройте тип элемента, заполните значения, получайте результат через Значение и обязательно проверяйте выбор перед записью.

Можно ли сделать список редактируемым?

В управляемых формах поведение зависит от свойств элемента и режима работы. Если редактирование разрешено, пользователь может вводить значение, не входящее в список; в этом случае нужна дополнительная проверка допустимости введённого текста.

Что делать, если список пуст при открытии формы?

Проверьте, заполняется ли коллекция перед отображением формы и не очищается ли она позже в коде. Убедитесь, что модуль формы компилируется без ошибок и элемент правильно связан со свойством СписокВыбора.

Как сохранить выбранное значение?

Считайте свойство Значение элемента и запишите его в реквизит объекта или переменную перед сохранением. Если значение неопределённое, отмените запись и покажите пользователю уведомление о необходимости выбора.

Нужен ли отдельный справочник для вариантов списка?

Не обязательно. Для короткого статического набора достаточно СпискаЗначений. Справочник оправдан, когда варианты хранятся в базе, редактируются пользователями или используются в нескольких формах.