rich-text.md

title	author
Rich Text	Anna Vekhina

Rich Text

Overview

The Rich Text control displays formatted text (static, dynamic or mixed) in a report.

To add this control to a report, drag the Rich Text item from the Toolbox onto the report's Design Surface.

Load Content from a File

You can load RTF or HTML content from an external file. Expand the Data category and click the Load file property's ellipsis button.

In the invoked Open dialog, select the file and click Open.

Rich Text supports the following file formats:

• RTF
• DOCX
• TXT
• HTML

Edit Content in Place

Double-click a Rich Text control and type text in the invoked in-place editor. A ribbon with text format options appears next to the editor.

Rich Text supports the following edit operations:

• Undo/Redo History

  The undo/redo history contains the last 100 operations and is available until you exit the in-place edit mode.

• Clipboard Operations

  You can use clipboard operations (Cut, Copy, and Paste) to manipulate text and images.

• Hyperlinks

  You can create and modify hyperlinks.

• Drag and Drop

  Use Drag and Drop to move images and text within the editor.

Note

The legacy Rich Text does not provide a ribbon with text format options. Its in-place editor allows you to enter only plain text. Bind the control to a data field that provides RTF or HTML content to display formatted text.

Bind to Data

Click the Rtf Expression or Html Expression option's ellipsis button to invoke the Expression Editor. Use this editor to bind the control to a data field or construct a complex binding expression with two or more data fields.

You can use HTML formatted text that contains markup tags to define text appearance. Click the Html Expression option's ellipsis button and enter this text in ' quotes ' in the invoked Expression Editor.

Drag and drop a numeric or text field from the Field List onto the Rich Text control to bind it to this field.

The Rich Text also enables you to merge data fields and static content in its text.

See the Bind Controls to Data and Use Embedded Fields topics for more information.

Markup Text

Supported Tags

The table below lists the supported HTML tags. External links are processed for inline pictures and style sheets (CSS files). The ID and Class attributes are interpreted for all tags, including the unlisted ones. These attributes are used to specify a style for content within a certain tag

Tag	Attributes	Notes
a	dir
b	dir
base
basefont	size color face dir
big	dir
blockquote	dir
br	dir
center	dir
code	dir
del	cite datetime
div	page-break-before page-break-after page-break-inside background-color border (CSS) dir	Only the always property value is supported for the page-break-before tag.
em	dir
font	size color face dir
h1-h6	align dir
head
html
hr	align color noshade size width
i	dir
ins	cite datetime
img	align src height width	If the align attribute is not specified, the image is considered as inline.
li	type value dir
link	href type media dir
meta
ol	type value align dir
p	align dir
script		Text inside this tag is ignored.
small
span
strike	dir
strong	dir
style
sub	dir
sup	dir
table	align bgcolor border bordercolor cellpadding cellspacing dir width	The dir attribute reorders table columns.
td	align bgcolor bordercolor colspan height nowrap rowspan text-align valign width	The align tag is supported in the Internet Explorer only. The Rich Text control's interpretation of the bordercolor attribute is different from the HTML browser.
th	any allowed
tr	align bgcolor bordercolor height text-align valign	The align attribute is supported in the Internet Explorer only.
title		Text inside this tag is ignored.
u	dir
ul	dir

Unsupported Tags

• <base> tag with href attribute;
• <div> tag with border, align and float CSS attribute;
• <li> tag with list-style-image CSS attribute;
• <margin> tag;
• <tab> tag;
• <table> tag with cols attribute;
• <td> tab with bordercolor and nowrap attributes;
• !important declaration;
• word-wrap and break-word css properties;
• css3 shapes;
• <ui> tag with type attribute.

Export to Excel

When a report is exported to XLS or XLSX, the following rich-text content is converted from Rich Text controls into Excel-native rich-text content:

	HTML Tags and RTF Equivalents
Text format	<b>, <i>, <u>, <s>, <strong>, <em>
Line break	<br>
Non-breaking space	&nbsp;
Font	<font face=[font name]>
Font size	<font size=[font size]>
Foreground color	<font color=[color]>