Displaying a License Agreement

To comply with legal requirements, most software products include a license agreement. Typically, the license agreement is displayed prior to or in the early stages of the installation process. Tarma Installer's Setup wizard will do this for your product through the predefined LicenseDlg dialog box (defined on the Tarma Installer Installer Dialogs project page) if desired, and will only continue with the installation process if the customer indicates that he accepts the terms and conditions of the license agreement.

The license agreement text itself is defined through one or more Rich Text resources on the Rich Texts project page.

Note - If you want the license agreement text to be available after installation, you should also provide it as a separate document, which you install along with the rest of your application. In that case, it might be a good idea to install a shortcut to that document. See Installing Files and Installing Shortcuts for more information on these topics.

The predefined LicenseDlg dialog box uses a RichText control to display the information. You can create additional dialog boxes with similar controls if you need to display other pre- or post-installation texts.

How to include a license agreement in your project

To include a license agreement for acceptance prior to installation, act as follows.

1. Select the Rich Texts project page in the navigation panel on the left.
2. Create a new Rich Text resource or import an existing plain or rich text file.
3. Enter the desired text into the main text field.
4. Create or import additional Rich Text resources if you want to provide localized versions of the license agreement.
5. Select the Tarma Installer Installer Dialogs project page in the navigation panel on the left.
6. Select the predefined LicenseDlg dialog box in the Dialogs tree.
7. Click on the large text control in the dialog box preview. This displays the RichText attributes for the MainText control.
8. In the RTF name field, enter the name of the Rich Text resource that you want to display, or click ... (browse) to select the resource name from a list.
9. To localize the license agreement text, repeat the previous step for additional languages. Make sure that the RTF name field is localized (the * button must appear pressed in). Before specifying additional resource names, select the project language in the main toolbar, or click the >> button to open the Edit Localized String dialog box to edit all languages there.
10. Select the Product Variables project page in the navigation panel on the left.
11. Select the UILicensePage product variable in the list, and make sure that its Value attribute is set to 1.