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