rtfAdded by IBM on October 10, 2012 | Version 1 (Original)
|Stores the rich text value for rich text fields.
Table 1. rtf parameter
|rich text||string||The rich text string.|
Example This sample shows a rich text field:
<rtf>rich text version of Hello</rtf>
- Default: if the rtf option is empty or does not exist, a default rich text string is created as follows:
To use rich text in a field, the texttype option must be set to text/rtf.
A plain text version of the rich text string is stored in the value option, with the following considerations:
- Text: set to equal the value option.
- Font: set as the fontinfo and fontcolor options.
- Justification: set as the justify option.
If the required options are not present, then the default settings for those options are used. Note that the background color is controlled by the bgcolor option, not the rich text.
Computed changes to the fontinfo, fontcolor, bgcolor, justify, texttype, or value options will cause the rtf option to update if necessary.
Changes to the rtf option do not cause changes to the fontinfo, fontcolor, bgcolor, or justify options.
Dynamically changing the texttype from rtf to plain text is not supported.
When using XForms, the rtf option is bound to the data model (as opposed to the value option).
- If the value option has a compute, that compute is lost when the text is copied from the rtf option. (However, external changes to the value are still made. For example, a set.)
- Once the text is copied to the value option, the format system may impose a change based on the format option. If a change occurs, then the rtf option is reset based on the formatted value option and the fontinfo, fontcolor, justify, and bgcolor options.
- If the plain text version does not match the rich text, then the rich text takes precedence. In this case, the value option is updated to reflect the rich text.