Как добавить текст на форму 1С: надписи, поля и программное заполнение

Текст на форме в 1С появляется тремя основными способами: через статическую надпись (декорацию), через поле ввода, связанное с реквизитом объекта, и программно — из модуля формы. Выбор зависит от задачи: подсказка для пользователя, вывод реквизита документа или динамическое сообщение, которое меняется в зависимости от данных.

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

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

Откройте форму в конфигураторе и включите редактирование

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

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

Добавьте статический текст через декорацию «Надпись»

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

Порядок действий: в редакторе формы нажмите кнопку «Добавить» в командной панели дерева элементов. В окне выбора типа укажите «Декорация», вид — «Надпись». В свойствах элемента заполните «Заголовок» — это и есть отображаемый текст. Перетащите элемент в нужное место дерева: положение в дереве определяет положение на форме.

1. 1
   Откройте форму объекта в конфигураторе
2. 2
   Нажмите «Добавить» в дереве элементов формы
3. 3
   Выберите тип «Декорация», вид «Надпись»
4. 4
   В свойстве «Заголовок» введите нужный текст
5. 5
   Перетащите элемент в нужную группу формы
6. 6
   Сохраните и запустите режим предприятия для проверки

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

Форматированная строка в надписи

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

Добавьте редактируемое текстовое поле

Когда пользователь должен вводить текст (комментарий, примечание, произвольное описание), нужна не декорация, а поле ввода, связанное с реквизитом. Сначала создайте реквизит: в дереве объекта добавьте реквизит с типом «Строка» и нужной длиной (или неограниченной длиной) либо реквизит формы через вкладку «Реквизиты» редактора формы.

Затем перетащите реквизит из панели реквизитов в дерево элементов формы — платформа автоматически создаст поле ввода с отображением типа. Для многострочного ввода установите у поля свойство «МногострочныйРежим» в «Истина» и при необходимости «КнопкаВыпадающегоСписка» для истории ввода.

Выведите текст программно из модуля формы

Динамический текст — например, «Остаток на складе: 15 шт.» — формируется в модуле формы. Добавьте на форму декорацию-надпись, задайте ей имя (например, НадписьСтатус), а в модуле формы присвойте заголовок в нужном обработчике.

&НаКлиенте
Процедура ПриОткрытии(Отказ)
	Элементы.НадписьСтатус.Заголовок = "Данные загружены: " + Формат(ТекущаяДата(), "ДЛФ=D");
КонецПроцедуры

Частые точки вызова: обработчик ПриСозданииНаСервере для начального заполнения, ПриОткрытии для клиентских проверок, обработчики изменения полей — для обновления текста при редактировании данных. Помните о контексте: обращение к данным объекта из клиентской процедуры без серверного вызова может привести к ошибке передачи данных.

Если текст нужно формировать на сервере (запрос к базе), создайте серверную процедуру с директивой &НаСервере и вызывайте её из клиентской. Не выполняйте запросы в обработчиках, которые срабатывают при каждом вводе символа, — это замедлит работу формы.

Добавьте текст на форму без конфигуратора через расширение

Если конфигурация типовая и менять её нельзя, создайте расширение: «Конфигурация → Расширения конфигурации → Создать». В расширении добавьте заимствованную форму нужного объекта и измените её так же, как в основной конфигурации: добавьте надпись или поле.

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

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

После сохранения формы обновите конфигурацию базы данных (F7), если добавляли реквизиты, и запустите режим предприятия. Откройте форму и проверьте: текст отображается полностью, не перекрывает другие элементы, корректно ведёт себя при растягивании окна и в веб-клиенте, если он используется.

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

Частые вопросы