urtfeditbox (RichEditBox)

Description

The urtfeditbox widget enables you to edit and store RTF data. Data can be inserted into the widget from a number of sources and the user can format the text as bold, italic, or underline using the keyboard.

The widget supports enhanced text manipulation using an integrated toolbar. For example, you can change the font, font size, and color, indent text, and create bulleted lists. You can determine whether the toolbar is displayed and what its contents are using the widget's properties.

The urtfeditbox supports the following functionality, with some restrictions:

Fields that use the Rich Text Edit widget must have Data Type String and Field Interface ShorthandC*.

Caution: Do not use field syntax codes such as LOW, UPC, and so on for fields that use the urtfeditbox widget. They are not compatible with RTF data and can result in data loss.

Widget Properties

The rich edit box widget does NOT support the standard color properties for widgets because the text displayed may contain colors that are not visible on the chosen background color.

Screen vs. Print Fonts

Some fonts that can be used in the urtfeditbox widget must have a different size defined for displaying and printing. For example, the bar-code 39 font cannot be used 1:1 on the printer.

;usys.ini
[printer]
barcodefont=bar-code 39,12,regular

[screen]
barcodefont=bar-code 39, 48

Assigning and Changing Values

The field value consists of RTF data. Although it is possible to assign plain text to a urtfeditbox widget, as soon as the data in the field is changed, the data is formatted as RTF.

For example, assume that the field MyTextField contains the string My name is John. This can be assigned to the rich text field MyRTFField:

MyRTFField = MyTextField

The data is displayed in the widget using the predefined font and color, which can be set using $fieldproperties or in the widget property form. If the data is edited, it is converted to RTF:

{\rtf1\ansi\ansicpg1252\deff0\deflang1033{\fonttbl{\f0\froman\fcharset0 Arial;}}
{\colortbl ;\red0\green255\blue255;}
\viewkind4\uc1\pard\cf1\f0\fs20 My name is Johnny
\par }

Although it is technically possible to compare the values of the two fields (for example, if (MyRTFField = MyTextField) ), it can only evaluate to true as long as the rich text field has not been changed.

Keyboard Interface

The following Uniface functions are supported by the urtfeditbox widget. Only those that are specific to this widget or that can be switched using the in particular and the functions which can be influenced by the NativeKey property are listed. All other functions supported by the standard edit widget are also available.

In the following table, the last column indicates whether the function can be switched using the NativeKey property, which redirects Ctrl key combinations.