Advanced

See also Extension DLLs

The Advanced page allows configuration of a number of advanced options. It is subdivided into two main sections:

• Customer registration - Configures the optional Registration information TIN Setup page (also commonly known as "user info"). As its name suggests, this page is intended to gather customer registration information, such as a name and product code, prior to installation.
• Extension DLL - Allows you to add an extension DLL to the project. An extension DLL acts as a seamless extension of the regular TIN Setup program and can be used to customize the installation process beyond TIN Setup's built-in capabilities. For more information about extension DLLs, refer to the Extension DLLs topic.

The options in the two sections can be used on their own, or they can be combined for even greater functionality.

Customer registration fields

The Customer registration section contains the following fields.

Include customer registration page...

Check this box to include a Registration information page in the TIN Setup wizard sequence; clear it to omit that page.

The following fields are only available if Include customer registration page... is checked.

1, 2, 3

Check the boxes that correspond to the fields that you want to include on the Registration information wizard page; clear the boxes of the fields that you don't need. The fields are displayed in the order 1-2-3 on the Registration information page; unchecked fields are omitted.

The three fields correspond to the UserField1-3 predefined variables. When Setup starts, it initializes the fields from these variables (optionally followed by further initialization; see Use <RegOwner> and <RegOrganization> to initialize fields 1 and 2 below). After the user has edited the fields on the Setup - Registration information page, the UserField1-3 variables are updated to reflect the user input.

Each of the fields is followed by its options in the following order.

• Label - (unnamed) Enter the label for the customer registration field. You can use an ampersand (&) to indicate a keyboard accelerator; it's also a good idea to add a trailing colon (:).
• Style - (unnamed) Select the desired edit style for the customer registration field. The available options are:
  • Standard - Standard edit box; the customer can enter any text and no conversion takes place.
  • Uppercase - All letters in the customer input are converted to uppercase; other characters are left as-is.
  • Lowercase - All letters in the customer input are converted to lowercase; other characters are left as-is.
  • Number - Customer input is restricted to digits only.
  • Password - The customer can enter any text, but the input is masked by asterisks (*).
• Required - Check this box if the customer must enter some information in this field; clear it if the customer information in this field is optional. Note that TIN Setup strips leading and trailing white space before testing.
• Store as - Check this box and enter the name for the registry value where the customer information for this field must be initialized from and stored to. (This is subject to the Registry key for information option below.) Clear this box if this field should not be automatically initialized and stored.

Store under registry key

Check this box to let TIN Setup initialize the selected customer information fields from the registry prior to displaying the Registration information page, and to let it store the information when the installation process finishes. If checked, you should also enter the applicable registry key path. The individual field information is stored as REG_SZ values under this key, with names as specified under Store as.

Note - If you do not check this option, you should provide an extension DLL and check the Perform validity check option (see below) or the customer registration process won't have any permanent effect.

Use <RegOwner> and <RegOrganization> to initialize fields 1 and 2

Check this box to let TIN Setup initialize the first two fields to the name of the registered owner and the registered organization, respectively, as maintained by Windows; clear it to omit this initialization. Note that this initialization may be overridden by values subsequently read from the registry as per the Registry key for information option.

Perform validity check

Check this box to let TIN Setup query the extension DLL for validation of the customer registration; clear it to restrict customer registration to the built-in options. If you check this option, you should also configure an extension DLL (see below).

Note - Including an extension DLL without checking Perform validity check works, but does not involve the extension DLL in the customer registration process.

Leader text

Enter the text that should appear as the introduction on the Registration information page; leave it blank to use the default text. You may use symbolic variables in the text and Setup will resolve them at installation time.

Trailer text

Enter the text that should appear at the bottom of the Registration information page; leave it blank to use the default text. You may use symbolic variables in the text and Setup will resolve them at installation time.

Extension DLL fields

The Extension DLL section contains the following fields.

Include Extension DLL

Check this box to add an extension DLL to the project; clear it to omit the DLL. An extension DLL can be used for many purposes and is not limited to customer registration. Refer to the topic Extension DLLs for more information about extension DLLs.

Enter the path to the extension DLL that you want to add to the project. If desired, click the ... (browse) button to open a standard Windows Open dialog to browse for the DLL.

Note - The extension DLL, if any, is automatically included in the Setup package; you do not (and should not) install it manually. It is also automatically removed when your application is uninstalled.

Absolute DLL path

Check this box to make Tarma QuickInstall store the DLL path in absolute form, rather than relative to the location of the .tin project file. The latter is the default and is usually the most convenient, but an absolute path may be required if the project file is moved independently from the DLL file.

Test DLL

Click this button to perform a basic sanity check on the extension DLL that you specified. The results of the test appear in the Diagnostics Messages Area. The same test is automatically performed as part of the normal preflight check sequence.

Note - The test is fairly limited and intended only as a confidence check; you should perform additional testing with a fully built Setup package before distributing your application.