Содержание:
- Что такое HTML-документ и форматированный документ
- Как программно добавить поля этих типов на управляемую форму в системе программ 1С
- Пример использования в общей форме в 1С
- Особенности и ограничения при работе в системе 1С
Платформа 1С:Предприятие 8 в режиме управляемого приложения предоставляет гибкие возможности для отображения и редактирования текстовой информации в различных форматах. Среди таких элементов — HTML-документ и ФорматированныйДокумент, которые позволяют отображать как разметку HTML, так и отформатированный текст, включая стили, таблицы, изображения и т.д.
В этой статье рассмотрим:
- ✅ Что такое HTML-документ и форматированный документ в управляемых формах
- ✅ Как программно добавить соответствующие поля на управляемую форму
- ✅ Как работать с их содержимым
Что такое HTML-документ и форматированный документ
HTML-документ (Тип: HTMLДокумент)
Позволяет выводить текст с использованием HTML-разметки. Удобен для отображения:
- Визуально оформленных уведомлений
- Ссылок, списков, заголовков
- Встраиваемых таблиц и даже CSS-стилей (в пределах поддержки платформы)
📌 Важно: HTML-документ — только для отображения. Пользователь не может редактировать HTML-код напрямую в форме.
Форматированный документ (Тип: ФорматированныйДокумент)
Поддерживает редактируемый текст с форматированием, включая:
- Шрифт, цвет, размер
- Таблицы, списки
- Изображения (вставка возможна)
- Выравнивание
Это аналог встроенного текстового редактора.
Как программно добавить поля этих типов на управляемую форму в системе программ 1С
📍 1. Подготовка формы
Откройте в конфигураторе нужный объект (например, документ, отчет или обработку) и создайте управляемую форму либо откройте существующую.
📍 2. Добавление реквизитов формы
Перейдите в модуль формы и добавьте новые реквизиты, которые будут хранить содержимое HTML или форматированного текста.
Для HTML-документа:
1C
КопироватьРедактировать
Перем МойHTML : HTMLДокумент;
Для форматированного документа:
1C
КопироватьРедактировать
Перем МойФорматированныйТекст : ФорматированныйДокумент;
📍 3. Инициализация реквизитов
В обработчике ПриОткрытии формы (или другой нужной точке) задайте значение этим реквизитам.
Пример: HTML
1C
КопироватьРедактировать
Процедура ПриОткрытии()
МойHTML = Новый HTMLДокумент;
МойHTML.УстановитьHTML(“
<h2 style=’color: navy;’>Добро пожаловать!</h2>
<p>Это пример <b>HTML-документа</b> в управляемой форме.</p>
<ul><li>Пункт 1</li><li>Пункт 2</li></ul>
“);
КонецПроцедуры
Пример: Форматированный документ
1C
КопироватьРедактировать
Процедура ПриОткрытии()
МойФорматированныйТекст = Новый ФорматированныйДокумент;
МойФорматированныйТекст.ДобавитьСтроку(“Это заголовок”);
МойФорматированныйТекст.УстановитьФормат(0, 0, Новый ОписаниеФормата(,”Жирный”,,”16″)); // Пример: жирный шрифт, размер 16
МойФорматированныйТекст.ДобавитьСтроку(“Это следующий абзац с обычным стилем.”);
КонецПроцедуры
📍 4. Добавление элементов на форму (вручную или программно)
Вариант 1: Через конструктор формы (рекомендуется)
1. Откройте форму в режиме «Форма» → «Реквизиты формы».
2. Убедитесь, что реквизиты МойHTML и МойФорматированныйТекст добавлены.
3. Перейдите во вкладку «Элементы формы».
4. Добавьте:
- Элемент типа Поле HTML-документа, связанный с МойHTML
- Элемент типа Поле форматированного документа, связанный с МойФорматированныйТекст
Вариант 2: Программное добавление (редко используется)
В управляемых формах не поддерживается полностью динамическое добавление элементов управления как в обычных. Поэтому предпочтительнее использовать предопределенные элементы на этапе конфигурации.
Пример использования в общей форме в 1С
1C
КопироватьРедактировать
Форма — ОбщаяФормаHTMLФорматированный
Реквизиты:
Перем МойHTML : HTMLДокумент;
Перем МойФорматированныйТекст : ФорматированныйДокумент;
Процедура ПриСозданииНаСервере()
// Инициализация HTML
МойHTML = Новый HTMLДокумент;
МойHTML.УстановитьHTML(“<h1>Новости</h1><p>Сегодня солнечно</p>”);
// Инициализация форматированного текста
МойФорматированныйТекст = Новый ФорматированныйДокумент;
МойФорматированныйТекст.ДобавитьСтроку(“Заголовок”);
МойФорматированныйТекст.УстановитьФормат(0, 0, Новый ОписаниеФормата(,”Жирный”));
МойФорматированныйТекст.ДобавитьСтроку(“Описание с форматированием.”);
КонецПроцедуры
Особенности и ограничения при работе в системе 1С
| Поле | Возможности | Ограничения |
| HTMLДокумент | Отображение HTML, списков, заголовков, ссылок | Не редактируется пользователем, ограниченная поддержка CSS |
| ФорматированныйДокумент | Редактирование текста, таблицы, стили, вставка изображений | Не поддерживает HTML, но можно экспортировать/импортировать RTF |
Добавление полей типа HTMLДокумент и ФорматированныйДокумент в управляемые формы позволяет существенно расширить визуальные возможности ваших интерфейсов. HTML-документ — идеален для отображения информативных блоков и ссылок, а форматированный документ — для ввода и хранения сложных текстов с форматированием.
Специалист компании ООО “Кодерлайн”,
Веселова Елена
Добавить комментарий