RichText attributes (Tarma control)

Reference information
Project page Installer Dialogs
Related topics Working with attribute panes

Introduction

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. Tarma Installer 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.

MSI note The Windows Installer equivalent is the ScrollableText control. However, this control internally always uses the RichEdit window class, which is the earliest and most limited version of the RichEdit control (1.0).

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 Tarma ExpertInstall 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.