Working with RTF tags

The RTF tags that you use in a dynamic text control must be well formed. An RTF tag starts with a \ and ends with a space or a new line character. To turn off the effect of a tag, use the same tag with a 0 after it. For example, the following RTF code:

Hello world\par

\b Hello stars\b0\par Hello moon

produces the following text that contains bold text and multiple paragraphs:

Hello world

Hello stars

Hello moon

You can concatenate tags. For example, the following RTF code:

\b\i Hello\i0  stars\b0

produces the following text that is both bold and italic:

Hello stars

You do not need to provide a complete RTF document by providing an RTF header.

Table A-1 lists the supported RTF structural and definition tags. For more information about using RTF tags, refer to RTF documentation, such as “Rich Text Format (RTF) Specification, version 1.6,” which is available at the following URL:

http://latex2rtf.sourceforge.net/rtfspec.html

Table A-1  RTF structural and definition tags

RTF tag supported	Description
\*	This extended feature group indicator specifies the contents of groups identified in this way are ignored.
\blueN	Specifies blue value in color table.
\colortbl	Specifies the color table.
\fonttbl	Specifies the font table.
\greenN	Specifies the green value in color table.
\redN	Specifies the red value in color table.
\rtfN	Specifies the RTF dynamic text. N indicates the major RTF version number. The value of N must be 1.
\ucN	Specifies the number of text characters to skip following a \uN tag. RTF text can contain alternative representations for Unicode characters for use by RTF readers that do not support Unicode. RTF readers that do not support Unicode skip the \uN tag and display the following character. For example, \rtf1\u8364 E displays the Euro currency symbol on an RTF reader that supports Unicode and E on a reader that does not support Unicode. RTF text that contains alternative representations for Unicode characters uses \ucN to enable RTF readers that support the \uN tag to display the Unicode character(s) and skip the following character(s).
\uN	Specifies a Unicode character.

Table A-2 lists the supported RTF paragraph format tags.

Table A-2  RTF paragraph format tags 

RTF paragraph tag supported	Description
\fiN	Specifies first line left indent. N indicates the indent in twips. \fi is additive with \li and N can be a negative number. For example, \li1440\fi-720 makes the first line indented 0.5" and remaining lines indented 1.0".
\keep	Specifies keeping the paragraph intact. This tag prevents page breaks in the middle of a paragraph.
\keepn	Specifies keeping the paragraph with the next paragraph. This tag adjusts the page break so that both paragraphs are rendered on the same page.
\liN	Specifies left indent. N indicates the indent in twips.
\pard	Specifies resetting all paragraph formatting attributes.
\qc	Specifies centering text.
\qj	Specifies justified alignment.
\ql	Specifies left-aligned text.
\qr	Specifies right-aligned text.
\riN	Specifies right indent. N indicates the indent in twips.
\saN	Specifies vertical space after the paragraph. N indicates the space in twips.
\sbN	Specifies vertical space before the paragraph. N indicates the space in twips.
\slN	Specifies vertical line spacing. N indicates the total line height in twips.
\slmultN	Specifies vertical line spacing multiplier. N indicates the multiplication type.
\txN	Specifies the tab stop. N indicates the tab stop position in twips.

Table A-3 lists the supported RTF character format tags.

Table A-3  RTF character format tags 

RTF character tag supported	Description
\b	Specifies start bold text.
\b0	Specifies end bold text.
\cfN	Specifies color number. N indicates the color number in the color table.
\fN	Specifies font number. N indicates the font number in the font table.
\fsN	Specifies font size. N indicates the font size in half points. Because AFC does not recognize fractional font sizes, half point sizes round to integers. For example, \fs21 indicates font size 10.5pt, which rounds to 10pt.
\i	Specifies start italic text.
\i0	Specifies end italic text.
\plain	Specifies end all character attributes, such as bold, font, and italic.
\ul	Specifies start underline.
\ul0	Specifies end underline.

The dynamic text control recognizes any Unicode character encoded in the standard RTF form \un where n is the decimal Unicode value of the character. If the specified character does not exist in the requested font, the null symbol (Unicode value 127) is used.

The dynamic text control recognizes any character encoded in the standard RTF format \'xx where xx is the 2-digit hex value of the character. This format is treated as a Unicode value, regardless of the original document encoding. If the specified character does not exist in the requested font, the null symbol (hex value 0x7f) is used.

Table A-4 lists the supported special characters.

Table A-4  Special characters 

Character	Unicode	Tag	Description
\	\u92	\\	Backslash
		\par	Paragraph break
		\<LF>	Paragraph break. <LF> is ASCII 10.
		\<CR>	Paragraph break. <CR> is ASCII 13.
		\line	Line break
		\tab	Move to next tab stop.
		<TAB>	Move to next tab stop. <TAB> is ASCII 8.
		\emspace	Space equal in width to m
		\enspace	Space equal in width to n
{	\u123	\{	Left brace
}	\u125	\}	Right brace
‘	\u145	\lquote	Left single quote
’	\u146	\rquote	Right single quote
“	\u147	\ldblquote	Left double quote
”	\u148	\rdblquote	Right double quote
•	\u149	\bullet	Bullet symbol
–	\u150	\endash	En-dash
—	\u151	\emdash	Em-dash
	\u160	\~	Non-breaking space
-		\-	Optional soft hyphen
-		\_	Non-breaking hyphen

(c) Copyright Actuate Corporation 2011