Stimulsoft Reports предоставляет уникальную возможность оформления текста при помощи HTML тегов. Для чего это нужно? Предположим необходимо выделить часть выводимого текста шрифтом с жирным начертанием. К примеру:

 

 

Третье слово выделено при помощи другого начертания шрифта

 

 

 

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

 

 

Третье слово <b>выделено</b> при помощи другого начертания шрифта

 

 

Без использования HTML тегов для получения похожего результата пришлось бы использовать Rich текст. Но это создает дополнительные трудности. Кроме этого Rich текст компонент достаточно медленный.

 

HTML теги могут быть включены только в текстовое выражение, т.е. их использование возможно только в свойстве Текст (Text), компонента Текст (Text).

 

Информация

 

HTML теги могут быть включены только в текстовое выражение.

 

 

 

Кроме этого, HTML теги могут быть включены только в итоговую текстовую часть выражения. Например, следующие выражения верны:

 

 

Это простое <i>выражение {1+2}</i>

 

Это простое <i>выражение</i> {1+2}

 

Это простое выражение <i>{1+2}</i>

 

 

 

А эти неверны:

 

 

Это простое <i>выражение {1</i>+2}

 

Это простое <i>выражение {1+2</i>}

 

Это простое выражение {<i>1+2}</i>

 

 

 

Во втором случае HTML теги находятся в теле выражений на языке С# или VB.Net, и фактически последние становятся некорректными. Например, выражение

 

 

1+2</i>

 

 

 

невозможно вычислить.  Любые HTML теги могут быть вложенными. Например:

 

 

Это <b>простое <i>выражение {1+2}</i></b>

 

 

Вложенность тегов не ограничена. Если тег не закрывается, т.е. в тексте есть только открывающий тег, то такой тег действует до конца строки.

 

Стоит учитывать, что по умолчанию HTML теги игнорируются. Чтобы разрешить использование HTML тегов в текстовом выражении нужно использовать свойство Разрешить Html теги (AllowHtmlTags).

 

Информация

 

Чтобы разрешить использование HTML тегов в текстовом выражении нужно использовать свойство Разрешить Html теги (AllowHtmlTags).

 

 

 

Этому свойству нужно присвоить значение истина (true), для того чтобы теги учитывались при выводе. Если в текстовом выражении используются HTML теги, то переводы строки в выражении игнорируются. В этом случае, для перевода строки нужно использовать тег <br>.

 

Информация

 

Для перевода строки нужно использовать тег <br>.

 

 

 

Таблица html тегов, которые поддерживаются в Stimulsoft

 

Наименование

Описание

 

Теги шрифта:

<font color="#rrggbb" face="FontName" size="1..n"> </font>

Определяет цвет, шрифт и размер текста. Узнать больше.

<font-face="FontName"> </font-face>

Определяет шрифт текста. Узнать больше.

<font-name="FontName"> </font-name>

Определяет шрифт текста. Узнать больше.

<font-family="FontName"> </font-family>

Определяет шрифт текста. Узнать больше.

<font-size="1..n"> </font-size>

Определяет размер текста. Узнать больше.

<font-color="#rrggbb"> </font-color>

Определяет цвет текста. Узнать больше.

 

Теги стиля шрифта:

<b> </b>

Выделяет текст жирным начертанием шрифта. Узнать больше.

<i> </i>

Выделяет текст курсивным начертанием шрифта. Узнать больше.

<u> </u>

Предоставляет возможность подчеркнуть текст. Узнать больше.

<s> </s>

Предоставляет возможность отобразить перечеркнутый текст. Представляет собой сокращенную запись тега <strike>. Узнать больше.

<sub> </sub>

Предоставляет возможность отобразить текст в виде нижнего индекса. Текст будет располагаться ниже линии базового текста и его размер будет уменьшен. Узнать больше.

<sup> </sup>

Предоставляет возможность отобразить текст в виде верхнего индекса. Текст будет располагаться выше линии базового текста и его размер будет уменьшен. Узнать больше.

<strong> </strong>

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

<em> </em>

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

<strike> </strike>

Предоставляет возможность отобразить перечеркнутый текст. Аналогичен тегу <s>. Узнать больше.

 

Теги интервалов:

<letter-spacing="0"> </letter-spacing>

Определяет интервал между символами в пределах элемента, в единицах высоты шрифта. Узнать больше.

<word-spacing="0"> </word-spacing>

Устанавливает интервал между словами, в единицах высоты шрифта. Узнать больше.

<line-height="1"> </line-height>

Устанавливает межстрочный интервал текста. Узнать больше.

<text-align="left"> </text-align>

Предоставляет возможность изменить горизонтальное выравнивание текста: по левому краю (left), по правому краю (right), по центру (center) и по ширине (justify). Узнать больше.

 

Теги абзаца:

<br> , <br />

Установливает перевод строки. В отличие от тега <p>, не добавляет пустой отступ перед строкой. Узнать больше.

<p> </p>

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

 

Теги списков:

<ul> </ul>

Устанавливает маркированный список. Каждый элемент списка должен начинаться с тега <li>. Узнать больше.

<ol> </ol>

Устанавливает нумерованный список. Каждый элемент списка должен начинаться с тега <li>. Узнать больше.

<li> </li>

Определяет отдельный элемент маркированного или нумерованного списка.

 

Тег URL адреса:

<a href="...">…</a>

Устанавливает URL адрес для перехода, при нажатии на текст, который заключен между открывающим и закрывающим тегами.

 

Теги оформления:

<color="#rrggbb"> </color>

Предоставляет возможность определить цвет текста.

<background-color="#rrggbb"> </background-color>

Предоставляет возможность определить цвет фона текста.

 

Атрибуты style:

color

Определяет цвет текста в элементе.

background-color

Определяет цвет фона элемента.

text-decoration: underline, line-through, none

Предоставляет возможность:

strel11 underline - подчеркнуть текст;

strel11 line-through - перечеркнуть текст;

strel11 none - Отменить все эффекты, в том числе и для ссылок.

font-weight: bold, normal

Определяет толщину шрифта - жирный (bold) или нормальный (normal).

font-style: normal, italic

Определяет стиль шрифта - нормальный (normal) или наклонный (italic).

font-size

Определяет размер шрифта.

font-face, font-family, font-name

Предоставляет возможность определить шрифт.

vertical-align: baseline, sub, super

Определяет вертикальное выравнивание:

strel11 baseline - аналогично тегам </sub> или </super>.

strel11 sub - элемент отображается как нижний индекс. Размер шрифта при этом не будет изменен. Аналогично тегу <sub>.

strel11 super - элемент отображается как верхний индекс. Размер шрифта при этом не будет изменен. Аналогично тегу <sup>.

letter-spacing: normal, x.x

Определяет интервал между символами в пределах элемента:

strel11 normal - значение по умолчанию;

strel11 x.x - пользовательское значение в единицах высоты шрифта.

word-spacing: normal, x.x

Определяет интервал между словами в пределах элемента:

strel11 normal - значение по умолчанию;

strel11 x.x - пользовательское значение в единицах высоты шрифта.

line-height: normal, x.x

Определяет межстрочный интервал:

strel11 normal - значение по умолчанию;

strel11 x.x - пользовательское значение в единицах высоты шрифта.

text-align: left, center, right, justify

Определяет горизонтальное выравнивание:

strel11 left - выровнять элемент по левому краю;

strel11 center - выровнять элемент по центру;

strel11 right - выровнять элемент по правому краю;

strel11 justify - выровнять элемент по ширине.

margin-top, margin-bottom

Устанавливает величину отступа от верхнего и нижнего края элемента. Актуально только для тега <p>.

margin

Устанавливает величину отступа от верхнего и нижнего края элемента. Актуально только для тега <p>.

 

Форматы значений цвета:

#rrggbb

Определяет цвет в RGB-формате в виде HEX-кода.

#rgb

Определяет цвет в RGB-формате в виде HEX-кода в краткой форме.

rgb(r,g,b)

Определяет цвет в формате RGB с помощью десятичных значений .

 

Спецсимволы (всего более 200), ниже представлен список самые часто употребляемых:

&amp;

Предоставляет возможность отобразить амперсанд - &. Узнать больше.

&lt;

Предоставляет возможность отобразить знак меньше, чем - <. Узнать больше.

&gt;

Предоставляет возможность отобразить знак больше чем - >. Узнать больше.

&quot;

Предоставляет возможность отобразить двойную кавычку - ". Узнать больше.

&apos;

Предоставляет возможность отобразить двойную кавычку - '. Узнать больше.

&nbsp;

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

&#xxxx;

Шаблон записи символа в ASCII кодировке. Узнать больше.

 

Формат шрифта:

Font name formats: name name1,name2

Предоставляет возможность указать несколько шрифтов.