RichText Control attributes

A RichText control displays formatted text from Rich Text resources and is typically used for longer pieces of text, such as license agreements or Readme information. To display a Rich Text resource in a RichText control, you must add the desired text on the Rich Texts project page, then set the control's RTF name attribute to the name of the desired Rich Text resource.

Note: RichText controls are read-only.

RichText controls are implemented with the Windows RichEdit control. Over time, Microsoft has released several versions of this control; later versions have better support for different scripts and Unicode. InstallMate internally uses the most recent version of the RichEdit control that is available on the target system; this guarantees the best possible results under the circumstances. However, you should be aware that when the installer runs on earlier versions of Windows, the rendering of some text or formatting options may be different.

Attributes

This pane contains the following attributes and options.

Attribute Description
Control ID

Select a control ID from the drop-down list or type a numerical ID to use for this control. All controls within a dialog must have different control IDs. For most controls, you should select Automatic; for PushButton controls, one of the standard IDxxx values is generally recommended.

See Dialog Control IDs for an explanation of the available control IDs and their usage.

Name Enter the internal name for the control. This name is for use in InstallMate only; it is not used in the installer. All control names must be unique within their parent dialog box.
RTF name

Enter the name of the Rich Text resource to display in the control, or click ... (browse) to open the Select Rich Text dialog that allows you to select a Rich Text resource from the project's resources.

Tip: The RTF name attribute is localizable; you can use different Rich Text resources for different languages if you want.

Condition

Enter the display condition for the control or leave empty to display the control unconditionally. See Dialog Control Conditions for more information.

Visible
Enabled
Tab stop
Group
Border
Sunken
Client edge
Transparent
Don't mirror

These are all standard control styles; see Dialog Control Styles for a description.

Related topics

Installer Dialogs, Working with attribute pane