User interface
The User interface page contains options that control high-level features of the installer's user interface:
- If a Readme page will be included.
- If a License Agreement page will be included.
- If the application will be started when the installation completes.
- If and how InstallMate will support product registration during installation.
How product registration works
The product registration functionality uses three symbolic variables, UserField1, UserField2, and UserField3, to hold up to three pieces of registration information (typically the user's name, organization name or email address, and registration code). The variables are linked to the predefined RegistrationDlg dialog box on the Dialogs project page, and are also used by the LoadCustomerInfo and SaveCustomerInfo standard actions on the Actions project page. Furthermore, they are also accessible from any extension DLL that you use in the installer on the Installer options project page.
It is up to you to decide how your product uses this information; apart from some rudimentary data validation done by the RegistrationDlg dialog box, InstallMate does not check or modify the product registration fields.
Attributes and options
The following attributes and options are available on the User interface page.
Warning: If you modify the predefined installer dialogs, then some of these options may no longer work as intended.
| Attribute | Description |
|---|---|
| Include Readme page | Check this box to display a Readme dialog box prior to installation; clear the box to omit that dialog box. This option sets or resets the UIReadmePage variable. This variable is used in the default Setup dialog sequence; you can also use it for your own purposes. |
| Edit Readme... | Click this button to transfer to the RichTexts project page with the default Readme RichText object selected. You can edit the desired text for the ReadmeDlg dialog box. Note that this command takes you to the default Readme RichText object. If you are developing a multilingual installer package and want to localize the Readme texts as well, then you must add further RichText objects for the remaining languages and link them to the RichText control on the ReadmeDlg dialog box on the Dialogs project page. |
| Include License page | Check this box to display a License agreement dialog box prior to installation; clear the box to omit that dialog box. This option sets or resets the UILicensePage variable. This variable is used in the default Setup dialog sequence; you can also use it for your own purposes. |
| Edit License... | Click this button to transfer to the RichTexts project page with the default License RichText object selected. You can edit the desired text for the LicenseDlg dialog box. Note that this command takes you to the default License RichText object. If you are developing a multilingual installer package and want to localize the license agreement texts as well, then you must add further RichText objects for the remaining languages and link them to the RichText control on the LicenseDlg dialog box on the Dialogs project page. |
| Show Run App on Finish page |
Check this box to display the Start the application option on the final installer dialog page; clear it to hide the option. This option sets or resets the UIShowRunApp variable. This variable is used by the FinishDlg dialog box in the default Setup dialog sequence; you can also use it for your own purposes. |
| Target path | Enter the installation path of the application to run from the Finish page or click the ... (browse) button to open the Select Installation File or Folder dialog box to browse for the desired file. This option sets or resets the UIRunAppPath variable. This variable is used by the FinishDlg dialog box in the default Setup dialog sequence; you can also use it for your own purposes. Tip: You can also enter fully qualified URL such as https://tarma.com/im9/register.htm if you want the installer to display a web page after installation. |
| Arguments | Enter any command line arguments for the application that runs from the Finish page, or leave empty if no arguments are required. This option sets or resets the UIRunAppArgs variable. This variable is used by the FinishDlg dialog box in the default Setup dialog sequence; you can also use it for your own purposes. |
| Start in | Enter the initial working folder for the application that runs from the Finish page, or leave empty to start the application from its own folder. This option sets or resets the UIRunAppDir variable. This variable is used by the FinishDlg dialog box in the default Setup dialog sequence; you can also use it for your own purposes. |
| Include product registration page |
Check this box to enable the RegistrationDlg dialog box and related processing; clear it to skip registration-related processing. This option sets or clears the value of the UIRegistrationPage variable, which is used to control registration-related actions in the UIFirstInstall action sequence. |
| Load user fields from and store to registry |
Check this box to initialize the product registration fields from information in the registry and store it back later; clear it for no initialization or storage. If you check this box, the LoadCustomerInfo and SaveCustomerInfo standard actions will perform the registry I/O, using the information from the following four attributes. |
| Registry key | Enter the path to the registry key that contains the product registration information for your product. The actual information is stored as REG_SZ values under this key. |
| User field 1 | Check this box and enter the name of the registry value that will be used for the UserField1 variable; clear it if no registry I/O must be performed for the variable. Note: The default value for the UserField1 variable is <RegOwner>, i.e., the name of the registered owner of the target system. The default value will be used if you don't check the User field 1 box, or if the corresponding registry value does not exist or is empty. |
| User field 2 | Check this box and enter the name of the registry value that will be used for the UserField2 variable; clear it if no registry I/O must be performed for the variable. Note: The default value for the UserField2 variable is <RegOrganization>, i.e., the name of the registered organization of the target system. The default value will be used if you don't check the User field 2 box, or if the corresponding registry value does not exist or is empty. |
| User field 3 | Check this box and enter the name of the registry value that will be used for the UserField3 variable; clear it if no registry I/O must be performed for the variable. |