Текст

Объект "Текст" - является основным объектом, с которым придется работать чаще всего.

Он выглядит следующим образом:

Объект может отображать любые текстовые данные, а именно:

• одну или несколько строк текста;
• поля источников данных;
• системные переменные типа Номер страницы;
• параметры отчета;
• итоговые значения;
• выражения;
• любую комбинацию из вышеперечисленных элементов.

Редактирование текста

Возможны 2 способа редактирования текста:

1. С помощью редактора

   Для редактирования текста объекта сделайте на нем двойной щелчок мыши. Вы увидите редактор текста:

   

   В правой части редактора находится окно данных, которые можно добавлять в текст. Это можно сделать двумя способами:

   • перетащить (drag&drop) элемент мышкой в нужное место текста;
   • сделать двойной щелчок на элементе, и он будет добавлен в текущую позицию курсора.

   Чтобы сохранить изменения и закрыть окно редактора, нажмите кнопку ОК, либо комбинацию клавиш Ctrl+Enter.

2. Редактирование на месте (на странице отчета)

   • выделите объект Текст;
   • нажмите клавишу Enter;
   • для окончания редактирования щелкните мышкой за пределами объекта либо нажмите комбинацию клавиш Ctrl+Enter.

   Примечания:

   • клавиша Esc отменяет изменения;
   • во время редактирования объекта на месте можно изменять его размеры мышкой.

Отображение выражений

Объект "Текст" может содержать как обычный текст, так и выражения.

Выражения обозначаются с помощью квадратных скобок: [ и ]. Подробнее о выражениях читайте в главе Выражения.

Кроме того, можно запретить обработку выражений – за это отвечает свойство AllowExpressions. В этом случае текст будет отображаться "как есть".

Пример 1: выражения вперемешку с текстом

Сегодня [Date]

При печати такого объекта все выражения, содержащиеся в тексте, будут вычислены. В текст будет подставлено значение выражения, например:

Сегодня 14 октября 2026г.

Пример 2: корректный синтаксис

В квадратных скобках может содержаться любое выражение, корректное с точки зрения компилятора.

Например, объект со следующим текстом:

2 * 2 = [2 * 2]

будет напечатан так:

2 * 2 = 4

Пример 3: типовая ошибка синтаксиса

Частая ошибка – попытка написать выражение за пределами квадратных скобок. Напоминаем, что считается выражением и вычисляется только то, что находится в квадратных скобках. Остальной текст печатается "как есть". Например:

2 * 2 = [2] * [2]

Такой текст будет напечатан следующим образом:

2 * 2 = 2 * 2

Пример 4: элементы c собственными квадратными скобками

В выражениях могут встречаться элементы, заключенные в собственные квадратные скобки. Например, это обращения к системным переменным. Рассмотрим следующий пример содержимого объекта "Текст":

Следующая страница: [[Page] + 1]

Текст содержит выражение [Page] + 1: это содержимое внешней пары скобок. Page – это системная переменная, которая возвращает номер текущей страницы отчета. Она заключена в собственные квадратные скобки.

Примечание: строго говоря, мы должны были использовать две пары квадратных скобок при попытке распечатать системную переменную Date в ранее рассмотренных примерах:

Сегодня [[Date]]

Здесь внешняя пара скобок обозначает выражение, внутренняя необходима, так как мы обращаемся к системной переменной. Однако дизайнер отчетов позволяет опускать лишнюю пару скобок, если в выражении есть только один член.

Отображение полей данных

Для обращения к полям источников данных используется следующая форма записи:

[Имя источника.Имя поля]

Как видно, здесь так же используются квадратные скобки. Имя источника отделяется от имени поля точкой, например:

[Employees.FirstName]

Подробнее об использовании полей в выражениях см. раздел Поля источников данных.

Для вставки поля в объект Текст можно использовать несколько способов.

Способ 1

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

Способ 2

В редакторе объекта выбираем нужное поле и перетаскиваем его в текст (также можно сделать двойной щелчок на поле):

Способ 3

Щелкаем мышкой на маленькой стрелочке в верхнем правом углу объекта и в открывшемся списке выбираем нужное поле:

Способ 4

Перетаскиваем нужное поле из окна Данные на страницу отчета с помощью мыши (drag&drop). В данном случае создается объект Текст, который содержит ссылку на выбранное поле.

Поддержка HTML тегов в тексте

Свойство текстового объекта TextRenderType предоставляет более широкий спектр функциональности, чем просто обработка HTML тегов.

Свойство TextRenderType имеет четыре возможных значения:

• Default - просто текст, без преобразования тегов;
• HtmlTags - применение HTML тегов. Список их довольно ограничен: <b>, <i>, <u>, <strike>, <br>, <sub>, <sup>, <img>;
• HtmlParagraph - позволяет регулировать межстрочный интервал, красную строку и все те же теги, что и HtmlTags;
• Inline - отображает текст в простом формате (только для внутреннего использования - не рекомендуется для внешнего использования).

HtmlTags

Пример 1: <b> - выделение текста жирным начертанием

<b>Дизайнер отчётов</b>

Результат:

---

Пример 2: <i> - курсивное начертание текста

<i>Дизайнер отчётов</i>

Результат:

---

Пример 3: <u> - подчеркивание текста снизу

<u>Дизайнер отчётов</u>

Результат:

---

Пример 4: <strike> - перечеркнутый текст

<strike>Дизайнер отчётов</strike>

Результат:

---

Пример 5: <br> - перенос строки

Дизайнер<br>отчётов

Результат:

---

Пример 6: <sub> - отображение текста в нижнем индексе

Дизайнер<sub>отчётов</sub>

Результат:

---

Пример 7: <sup> - отображение текста в верхнем индексе

Дизайнер<sup>отчётов</sup>

Результат:

---

Пример 8: <img> - вставка изображения в текст

Тег <img> поддерживает только атрибут src, который может содержать ссылку на изображение (http, https, base64), а также атрибуты width и height, определяющие размеры изображения в пикселях. Таким образом, изображения могут быть вставлены непосредственно в текст. Ссылки на изображения с протоколами http и https применимы для веб-отчетов.

<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADwAAAAyCAIAAACPlC9VAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAGkSURBVGhD7dDRjoMgEAXQ/v9Pd417poEVBBRttul569yRuenjOc+jxd5pEx7SaIQvjzr+vfvneGvQkc8cnMe73cY+cOQabnQYWe1gtcTGLqst3Xu7LHXzWYmNXX1LFeKjvLIhruvYKJHN4MWcrKIVl8jm8W5OVrKblchm83pOtlEPSmTXcCMnyw2UFlzJpYQgV5luCK7nXkKQ6CptehdXg2miNNoQ3MXVhCC0S5vey+1gGja/NwT3cjshWDVKm76DBsF09S09lQYJwZ/SwmD6PnoE02/p+fQIpt/S8+kRTL+l59MjmH5C6YU8mL6DBgnBPyptuvrE0gvBvdxOCFaFTraC6b3cDqahXXohuIurCUEoF7IbTO/iakIQukovBNdzLyFIVNv4IiG4kksJQW6g9EJ2DTdystxeD9/lZLN5PSfbaJTwdU42j3dzspJ2A2/kZDN4MSer6DrvpQ3xUV4psVHRe9hjJTZG+LLExq6Bk17dZbXExi6rLWP/k7ev4UaHsdK/HJnHu92OlP7l4DneGnS89Iv7g3x8yITSL+rU2Tvp+fwB+FeG5yXqCcoAAAAASUVORK5CYII=" alt=""/>

Результат:

---

HtmlParagraph

Этот режим обрабатывает тот же набор HTML тегов, что и HtmlTags, а также включает тег <span>.

Несмотря на то, что набор тегов у этого режима почти тот же, отрисовываются они иначе. Особенно это заметно на тегах <sub> и <sup>.

Тег <span> предоставляет возможность задавать стили для текста с использованием атрибута style.

Это позволяет применять различные CSS стили, такие как цвет текста, размер шрифта, выравнивание и другие параметры форматирования, непосредственно к определенному фрагменту текста.

Таким образом, вместо использования устаревшего тега <font>, который ограничивает функциональность и уступает в гибкости, теперь можно достигать того же эффекта, используя тег <span> с простейшими CSS стилями в атрибуте style.

Примеры использования:

<span style="font-size:20pt;">Дизайнер отчётов</span>
<span style="color:red;">Дизайнер</span> отчётов
<span style="font-family:Consolas;">Дизайнер отчётов</span>
<span style="background-color:yellow;">Дизайнер отчётов</span>

Результат:

---

ParagraphFormat

Отдельно стоит рассмотреть группу свойств ParagraphFormat.

Она работает в связке со свойством HtmlParagraph и представляет следующие настройки для отображения абзацев:

• FirstLineIndent - отступ первой строки;
• LineSpacing - расстояние между строками в сантиметрах;
• LineSpacingMultiple - коэффициент умножения на значение предыдущего параметра. Работает с типом Multiple;
• LineSpacingType - тип межстрочного расстояния:

• Одиночный (Single);
• Как минимум (At least);
• В точности (Exact);
• Множественный (Multiple).

Пример настроек:

Результат:

Свойства объекта "Текст"

Свойство	Описание
AllowExpressions "Выражения в тексте"	Отключение обработки выражений в тексте объекта. По умолчанию включено.
Angle"Поворот"	Угол поворота текста в градусах.
AutoShrink"Автосжатие шрифта"	Автоматическое уменьшение размера шрифта (Font.Size) или его ширины (FontWidthRatio) так, чтобы вместить весь текст.
AutoShrinkMinSize"Минимальный размер шрифта"	Минимальный размера шрифта или минимальное значение свойства FontWidthRatio, в зависимости от значения свойства AutoShrink.
AutoWidth"Автоширина"	Автоматический подбор ширины объекта так, чтобы поместить самую длинную строку текста целиком, без переноса слов.
Brackets"Скобки"	Пара символов, которые используются для обозначения выражений в тексте объекта.
BreakTo"Разрываться в..."	С помощью этого свойства можно организовать "перетекание" текста между двумя объектами "Текст". Допустим, у нас есть объекты А и В. Объект А содержит большой объем текста, часть которого не помещается в объекте. Если в свойстве BreakTo этого объекта указать объект В, в нем будет напечатан текст, не поместившийся в объекте А.
Clip"Обрезать"	Обрезание текста, который не поместился в объекте. По умолчанию включено.
Duplicates"Повторяющиеся значения"	Это свойство определяет, как будут печататься повторяющиеся значения. Подробнее об использовании этого свойства можно почитать в разделе "Форматирование".
FirstTabOffset"Первая табуляция"	Это свойство определяет, на сколько пикселей сдвинуть первый символ табуляции.
Font"Шрифт"	Параметры шрифта.
FontWidthRatio"Ширина шрифта"	Коэффициент масштабирования шрифта по ширине. По умолчанию свойство равно 1. Чтобы увеличить ширину шрифта, укажите значение > 1; чтобы уменьшить ширину, укажите значение между 0 и 1.
HideValue"Скрывать значение"	Скрытие значений выражений, которые равны заданному значению. Подробнее об использовании этого свойства можно почитать в разделе "Форматирование".
HideZeros"Скрывать нули"	Скрытие нулевых значений выражений. Подробнее об использовании этого свойства можно почитать в разделе "Форматирование".
Highlight"Условное выделение"	Изменение внешнего вида объекта в зависимости от заданных условий. Подробнее об использовании этого свойства можно почитать в разделе "Форматирование".
HtmlTags"Html теги"	Устарело, заменено на TextRenderType.
HorzAlign, VertAlignВыравнивание текста	Эти свойства задают выравнивание текста внутри объекта по горизонтали и вертикали.
LineHeight"Межстрочный интервал"	Межстрочный интервал, измеряемый в пикселях. Значение по умолчанию = 0, при этом используется стандартный межстрочный интервал.
MergeMode"Слияние текстовых объектов"	Объединение текстовых объектов с одинаковым содержимым, находящихся рядом. Содержит 2 значения: - Horizontal – объединение по горизонтали; - Vertical – объединение по вертикали. Допустимо использование как отдельно, как и совместно. Важное замечание! Объекты должны находиться вплотную друг к другу.
NullValue"Нулевое значение"	Настройки...".
Padding"Отступы"	Отступы текста от краев объекта, измеряемые в пикселях.
ParagraphFormat"Формат абзаца"	Настройки для отображения абзацев (межстрочный интервал, отступ красной строки). Подробнее об использовании этого свойства можно почитать на странице "Поддержка HTML тегов в тексте".
ParagraphOffset"Смещение абзаца"	Смещение абзаца, измеряемое в пикселях. Для TextRenderType.HtmlParagraph используйте свойство ParagraphFormat.FirstLineIndent.
RightToLeft"Справа налево"	Вывод текста справа налево.
TabPositions"Набор позиций символов табуляции"	Набор позиций символов табуляции, в пикселях. Отрицательные значения не оказывают влияния на это свойство.
TabWidth"Ширина табуляции"	Задание ширины символа табуляции, измеряемое в пикселях.
Text"Текст"	Текст объекта.
TextFill"Цвет текста"	Цвет текста. С помощью редактора этого свойства можно выбрать любую из доступных заливок.
TextOutline"Контур текста"	Контур текста.
TextRenderType"HTML теги"	Это свойство позволяет использовать HTML теги в тексте объекта. Подробнее об использовании этого свойства можно почитать на странице "Поддержка HTML тегов в тексте".
Trimming"Отсечение"	Это свойство определяет, как показывать текст, который выходит за границы объекта. Используется только в том случае, если свойство "Перенос слов" отключено.
Underlines"Подчеркивание"	Линии подчеркивания под каждой строкой текста. Подчеркивание можно использовать только для текста, выровненного по верхнему краю.
WordWrap"Перенос слов"	Это свойство определяет, надо ли переносить текст по словам. Wysiwyg Изменение режима отображения текста таким образом, чтобы добиться максимального соответствия между отображением текста на экране и на распечатке. Этот режим неявно включается, если использовать выравнивание текста по ширине или нестандартный межстрочный интервал.