Button Properties

A button defines the dialog that is shown next and lets you assign default parameter settings. For example, to present different types of installation, such as Typical, Minimal, and User-specific, in the installation dialog, you add three buttons to the installation dialog and assign the default parameters for each type of installation.
cla140
A button defines the dialog that is shown next and lets you assign default parameter settings. For example, to present different types of installation, such as Typical, Minimal, and User-specific, in the installation dialog, you add three buttons to the installation dialog and assign the default parameters for each type of installation.
The following properties can be set:
  • Ctrl name
    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.
  • Action
    Indicates the type of action that is performed when the button is clicked. This property can have one of the following values:
    • Numerical value: 0
      Action performed: Cancel installation.
    • Numerical value: 1
      Action performed: Install package.
    • Numerical value: 2
      Action performed Next dialog. Show the next dialog.
    • Numerical value: 3
      Action performed: Remove package.
    • Numerical value: 4
      Action performed: Show previous dialog.
    • Numerical value: 5
      Action performed: Dynamic dialog. Determine next installation dialog dynamically by evaluating a script.
    • Numerical value: 6
      Action performed: End installation and start a user script.
    • Numerical value: 7
      Action performed: Go to another installation dialog and take origin of that dialog.
    • Numerical value: 8
      Action performed: Start script and continue. The current dialog is closed, the specified script is executed, and the initial dialog is started again.
    • Numerical value: 9
      Action performed: Execute script. The specified script is executed and the result is shown in the specified result pane, which can be a progress area or text area.
  • Next dialog
    Specifies the name of the dialog that is shown when the button is clicked.
  • Script (when Dynamic dialog was chosen as action to be performed)
    Specifies the name of a script that is executed when the button is clicked. 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.
  • Icon file
    Specifies the file name of an icon that appears on the button. The icon file must have been added to the pre-installation component.
  • Parameter list
    Specifies a set of value assignments in the following format:
    $PARAM1=value_1,$PARAM2=value_2,...,$PARAMn=value_n
    When the button is clicked, the values are assigned to the parameters.
  • Label
    Specifies the text that appears on the button. The text must not contain any control character, such as CR (carriage return) or LF (line feed). Within the text, you can use the ampersand (&) character to define a shortcut. The ampersand character precedes that character, which you can use as a shortcut. For example, if you write Ne&xt as the button text, the small letter x is the defined shortcut. By default, the first character of the text string serves as the shortcut.
  • Font
    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.
  • Enabled
    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.