A text field is the standard input field for installation dialogs. The text entered is assigned to a parameter, which is then passed through the installation process. Therefore, the parameter must be defined as a property of the text field. You can specify a script that validates the content of the input field.
We do not recommend using a text field and a text area in the same line of an installation dialog.
You can set the following properties for a text field:
Indicates the name of a dialog element. Control names within the dialog editor are predefined by the GUI. There is no need to change these names. However, if for some reason you want to change the name, you can do so for a selected element by changing the value in this field.
Indicates the name of the parameter that contains the text. The parameter name starts with the dollar sign ($), and consists of a maximum of 64 characters, including the dollar sign. The following characters are not allowed within a parameter name:
. ; : \t \n \\ \" /
Indicates the default value for the text field. This value is shown the first time the text field is presented on an installation dialog.
Indicates the type of the parameter - Standard or Command.
Indicates the validation script. This script is executed when the user exits the installation dialog. Select a script from the drop-down list or click the browse button (...) to browse for a script. The script file must have been added to the pre-installation component. If the validation script detects an error it must return a value from 1 to 255, which refers to an error message defined in the Resource section of the prototype file.
Example: Script that verifies the allowed input values Yes and No
## --------------------------------------------------------------
## example validation script
## allowed values: "Yes" or "No"
## --------------------------------------------------------------
## empty field is not allowed
[ != "$1" ] && { exit 100; }
## check allowed values
[ "$1" != "Yes" -a "$1" != "No" ] && { exit 101; }
## validation ok
exit 0
Defines the font to be used for displaying the text. Clicking the browse icon displays the Font Chooser dialog where you can add or change font specifications.
Controls that the element is activated (or deactivated) by default. If you want to disable a specific field that is only activated on a specific event, you can use this property.
|
Copyright © 2013 CA.
All rights reserved.
|
|