In PowerBuilder 11.5, you can use the RichText edit style to display column data in a rich text format, and to use different fonts and colors in the same data field.
Columns that you format with the RichText edit style require considerably more storage space than columns with plain text edit styles. Therefore you should set a minimum of 1 KB for the column width. Otherwise, you can use the RichText edit style with columns that have large text datatypes.
Existing methods and events
You can use the GetText method to return
text with its rich text formatting and the SetText method
to set text with rich text formatting. However, the data arguments
for the ItemChanged and ItemError events return text from rich text edit
columns without the rich text formatting.
By default, whenever a column with the RichText edit style is edited in the Preview view or at runtime, a font toolbar displays. The font toolbar disappears when the column loses focus. The toolbar can be moved and remembers its last position. You can modify the RichTextToolbarActivation constant on a DataWindow control to display the font toolbar whenever a DataWindow object containing columns with the RichText edit style has focus—whether or not this type of column is selected. You can also modify the constant so that the font toolbar never appears.
DataWindow property |
Datatype |
Description |
|---|---|---|
RichTextToolbarActivation |
RichTextToolbarActivation (enumerated) |
Specifies when the default font toolbar appears for a DataWindow object that has columns with the RichText edit style. Values are:
|
You can customize the toolbar by taking advantage of the properties, events, and methods introduced to support the RichText edit style. If you want to use a customized font toolbar instead of the default toolbar, you must set the RichTextToolbarActivation constant to RichTextToolbarActivationNever!.
A new DataWindow expression allows you to strip the RTF formatting of a RichText column. For details, see StripRTF in the online Help.
For more information on RichText column properties and methods, see the online Help for the following items:
RichTextToolbarActivation |
RichTextCurrentStyleChanged |
RichTextLoseFocus |
RichTextLimitError |
GetRichTextAlign |
GetRichTextColor |
GetRichTextFaceName |
GetRichTextSize |
GetRichTextStyle |
SetRichTextAlign |
SetRichTextColor |
SetRichTextFaceName |
SetRichTextSize |
SetRichTextStyle |
