Получает форматированную строку. В результирующую форматированную строку помещаются только те картинки, которые заданы URL’ом на библиотеку картинок или на внешний ресурс. Остальные картинки игнорируются (целиком). Форматирование, не поддерживаемое форматированной строкой: Выравнивание; Отступы; Межстрочный интервал. игнорируется. Символы перевода строки и начала параграфа преобразуются в перевод строки. Элементы маркированных и нумерованных списков преобразуются в элементы разделенные переводом строк с символом ● или номером вначале.
Синтаксис
ПолучитьФорматированнуюСтроку()Полное описание, параметры и ограничения
ФорматированныйДокумент.ПолучитьФорматированнуюСтроку (FormattedDocument.GetFormattedString)
ФорматированныйДокумент (FormattedDocument)
ПолучитьФорматированнуюСтроку (GetFormattedString)
Доступен, начиная с версии 8.3.1.
Синтаксис:
ПолучитьФорматированнуюСтроку()
Возвращаемое значение:
Тип: ФорматированнаяСтрока.
Описание:
Получает форматированную строку.
В результирующую форматированную строку помещаются только те картинки, которые заданы URL’ом на библиотеку картинок или на внешний ресурс. Остальные картинки игнорируются (целиком).
Форматирование, не поддерживаемое форматированной строкой:
Выравнивание;
Отступы;
Межстрочный интервал.
игнорируется.
Символы перевода строки и начала параграфа преобразуются в перевод строки.
Элементы маркированных и нумерованных списков преобразуются в элементы разделенные переводом строк с символом ● или номером вначале.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.1.
Методическая информация
Практические примеры
Составить уведомление с жирным названием и цветной суммой
Считаем 3 × 250 = 750 и собираем строку Товар: Книга; сумма: 750 руб. из обычных и оформленных частей.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Отдельная учебная база, серверный общий модуль УчебныеЗадачи. Фрагмент без директив вставьте в тело ВыполнитьПример() Экспорт.
Документ создаётся заново в памяти при каждом запуске. Существующие реквизиты, файлы и документы конфигурации не меняются.
Сообщения показывают контрольные проверки. Для визуального просмотра оформления используйте отдельную задачу с полным модулем учебной формы.
Количество = 3;
Цена = 250;
Сумма = Количество * Цена;
Название = Новый ФорматированнаяСтрока("Книга", Новый Шрифт("Arial", 12, Истина));
СуммаТекстом = Новый ФорматированнаяСтрока(Формат(Сумма, "ЧГ=0;ЧДЦ=0") + " руб.", , Новый Цвет(20, 110, 50));
Составная = Новый ФорматированнаяСтрока("Товар: ", Название, "; сумма: ", СуммаТекстом);
Документ = Новый ФорматированныйДокумент;
Документ.УстановитьФорматированнуюСтроку(Составная);
Текст = Документ.ПолучитьТекст();
Сообщить(СтрНайти(Текст, "Книга") > 0);
Сообщить(СтрНайти(Текст, "750 руб.") > 0);
Копия = Новый ФорматированныйДокумент;
Копия.УстановитьФорматированнуюСтроку(Документ.ПолучитьФорматированнуюСтроку());
Сообщить(Копия.ПолучитьТекст() = Текст);Разбор по шагам
Сумму считаем как число, а в строку переводим только для представления. Формат с отключённой группировкой даёт 750 без пробелов между разрядами.
Конструктор по описанию форматирования задаёт шрифт названия и цвет суммы.
Конструктор на основании строк объединяет четыре части. Готовые ФорматированнаяСтрока сохраняют своё оформление внутри общей строки.
УстановитьФорматированнуюСтроку создаёт содержимое форматированного документа, ПолучитьТекст извлекает обычный текст для проверки.
ПолучитьФорматированнуюСтроку позволяет создать копию, но это не полная копия всех возможностей форматированного документа.
Как проверить результат
Все три сравнения Истина; в тексте есть Книга и 750 руб.; текст копии совпадает с исходным.
Для просмотра жирного шрифта и цвета перенесите эту строку в реквизит ФорматированныйДокумент учебной формы по отдельной визуальной задаче.
Ожидаемый результат
Сформировано реальное учебное уведомление с числовым расчётом и разнооформленными частями.
На что обратить внимание
Обычный текст проверки не показывает жирность и цвет — это отдельные визуальные свойства.
Преобразование документа в ФорматированнаяСтрока не сохраняет выравнивание, отступы и междустрочный интервал.
Некоторые картинки документа не входят в форматированную строку; данное упражнение картинок не содержит.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.