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 |
Предоставляет возможность: underline - подчеркнуть текст; line-through - перечеркнуть текст; 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 |
Определяет вертикальное выравнивание: baseline - аналогично тегам </sub> или </super>. sub - элемент отображается как нижний индекс. Размер шрифта при этом не будет изменен. Аналогично тегу <sub>. super - элемент отображается как верхний индекс. Размер шрифта при этом не будет изменен. Аналогично тегу <sup>. |
letter-spacing: normal, x.x |
Определяет интервал между символами в пределах элемента: normal - значение по умолчанию; x.x - пользовательское значение в единицах высоты шрифта. |
word-spacing: normal, x.x |
Определяет интервал между словами в пределах элемента: normal - значение по умолчанию; x.x - пользовательское значение в единицах высоты шрифта. |
line-height: normal, x.x |
Определяет межстрочный интервал: normal - значение по умолчанию; x.x - пользовательское значение в единицах высоты шрифта. |
text-align: left, center, right, justify |
Определяет горизонтальное выравнивание: left - выровнять элемент по левому краю; center - выровнять элемент по центру; right - выровнять элемент по правому краю; justify - выровнять элемент по ширине. |
margin-top, margin-bottom |
Устанавливает величину отступа от верхнего и нижнего края элемента. Актуально только для тега <p>. |
margin |
Устанавливает величину отступа от верхнего и нижнего края элемента. Актуально только для тега <p>. |
Форматы значений цвета: |
|
#rrggbb |
Определяет цвет в RGB-формате в виде HEX-кода. |
#rgb |
Определяет цвет в RGB-формате в виде HEX-кода в краткой форме. |
rgb(r,g,b) |
Определяет цвет в формате RGB с помощью десятичных значений . |
Спецсимволы (всего более 200), ниже представлен список самые часто употребляемых: |
|
& |
Предоставляет возможность отобразить амперсанд - &. Узнать больше. |
< |
Предоставляет возможность отобразить знак меньше, чем - <. Узнать больше. |
> |
Предоставляет возможность отобразить знак больше чем - >. Узнать больше. |
" |
Предоставляет возможность отобразить двойную кавычку - ". Узнать больше. |
' |
Предоставляет возможность отобразить двойную кавычку - '. Узнать больше. |
|
Предоставляет возможность отобразить неразрывной пробел. Узнать больше. |
&#xxxx; |
Шаблон записи символа в ASCII кодировке. Узнать больше. |
Формат шрифта: |
|
Font name formats: name name1,name2 |
Предоставляет возможность указать несколько шрифтов. |