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

Другое · 8 мин

Получение значения поля формы в 1С: пошаговое руководство

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

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

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

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

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

Как получить значение через Элементы формы

Наиболее распространённый способ — обращение к коллекции Элементы формы из модуля формы. Код выглядит примерно так: программа берёт элемент по имени и читает его свойство Значение. Результат можно сохранить в переменную, использовать для проверок или передать дальше в вычисления.

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

Порядок действий
  1. 1
    Узнайте точное имя элемента формы в конструкторе или свойствах формы.
  2. 2
    Напишите обращение к Элементы формы по имени и прочитайте свойство Значение.
  3. 3
    Проверьте результат на неопределённость и соответствие ожидаемому типу.
  4. 4
    Убедитесь, что код выполняется в контексте открытой формы или форма передана параметром.

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

Чтение значения в обработчиках события

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

Поле доступно в Элементах формыЭлемент существует и имеет имя

Убедитесь, что элемент не удалён и не находится на недоступной вкладке

Код выполняется в модуле формыКонтекст текущей формы

Обращение к Элементам формы работает без дополнительных ссылок

Значение ещё не записано в объектПромежуточное состояние формы

Чтение из формы может отличаться от данных в базе

При изменении значения поля

Если обработчик привязан к событию «ПриИзменении» поля, в параметре передаётся сам элемент. Его свойство Значение содержит актуальное введённое пользователем значение. Это удобно для валидации: например, проверить, не введено ли отрицательное число, и показать сообщение.

При нажатии кнопки

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

Если обработчик находится в общем модуле или в модуле объекта, а не в модуле формы, прямого доступа к Элементам формы может не быть. Тогда форма передаётся в процедуру как параметр, и через неё уже обращаются к элементам. Без такой передачи код не сможет считать значение поля.

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

Чтение через Элементы формы

Подходит для кода внутри модуля формы; ограничен контекстом текущей формы.

Чтение через переданную форму как параметр

Подходит для общих модулей; требует явной передачи ссылки на форму.

Чтение реквизита объекта

Подходит для данных в базе; не отражает несохранённый ввод на форме.

Разница между формой объекта и формой списка

Форма объекта работает с одной записью: её поля привязаны к реквизитам объекта, и значение на форме часто дублирует данные в базе. Форма списка отображает множество записей, и понятие «значение поля» здесь относится к текущей строке или выделенному элементу списка.

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

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

Проверка результата и типичные ошибки

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

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

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

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

Поле имеет ожидаемое значение после ввода
Норма

Значение совпадает с введённым

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

Значение пустое, неопределённое или старое

Имя элемента существует в Элементы формы
Норма

Обращение проходит без ошибки

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

Ошибка выполнения при обращении к элементу

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

Когда обращаться к программисту

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

Типичные ошибки
01
Чтение значения поля до открытия формы или ввода данных — получите пустое или устаревшее значение.
02
Обращение к несуществующему имени элемента в коллекции Элементы формы — ошибка выполнения и остановка кода.
03
Смешивание значения поля формы с реквизитом объекта — программа работает со старыми данными, игнорируя текущий ввод.

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

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

Итог

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

Значение поля формы берут через Элементы формы по имени элемента в контексте открытой формы; проверяйте результат и не смешивайте поле формы с реквизитом объекта.

Часто задаваемые вопросы

Можно ли прочитать значение поля формы из обычного модуля приложения?

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

Что делать, если поле на форме пустое, но в объекте есть значение?

Это нормальная ситуация: поле формы и реквизит объекта — разные хранилища. Если пользователь ещё не ввёл данные или не сохранил их, на форме будет пусто, а в объекте — старое значение. Нужно ясно выбрать, откуда брать данные в зависимости от задачи.

Почему возникает ошибка при обращении к Элементы формы?

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

Нужно ли сохранять значение после чтения?

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

Различается ли порядок для формы списка и формы объекта?

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