RichText resource
A RichText resource represents a formatted text for use in the installer's user interface, typically for the product's license agreement or installation information. To display a RichText resource, you must place a RichText control in the dialog box, then link the control to the desired RichText resource.
External files
You can edit RichText resources in InstallMate. By default, RichText resources are stored inside the InstallMate project file. However, if you assign a File path (see above) to the resource, the RichText is stored in that file and the project file only contains the file path to the external resource file. This allows you to edit the RichText both from within InstallMate and through an external editor.
Be sure to edit it from only one application at the time, and to save any changes before you switch to another editor. In particular:
- If there are any unsaved changes in the RichText resource during a build or preflight check, the text is automatically saved to the external file. This will overwrite any changes made to the external file.
- If the RichText resource is unchanged but the external file has been modified, then the RichText resource will be reloaded from the file at the start of a build or preflight check.
Tip: If you want to use an external editor to edit a RichText file, we strongly recommend that you use the WordPad tool that comes with Microsoft Windows. WordPad uses a limited subset of the RTF syntax that is compatible with the RichEdit controls used by the installers. (In fact, WordPad internally uses that same RichEdit control.) Other RTF-capable word processors may add additional and sometimes very verbose formatting that is ignored at best, and may cause rendering problems at worst.
Attributes
The following attributes and options are available.
| Attribute | Description |
|---|---|
| Name | Enter the name for the RichText resource. This name is used in InstallMate to refer to the text and must be unique among all RichText resources. |
| File path | Displays the file path for the RichText resource. This is optional; if you don't specify a file path, the RichText resource is stored inside the InstallMate project file. To save the RichText resource in an external file, click Save As... to open a standard Save As dialog box that lets you specify the desired file name and location. From then on, the RichText resource is stored in that file instead of in the InstallMate project file. |
| Save As... | Click this button to open a standard Save As dialog box that lets you specify the desired file path for the RichText resource. From then on, the RichText resource is stored in that file instead of in the InstallMate project file. |