IDialog
All members below are defined on IDialog.
Properties
Name
- Gets or sets the dialog's identifier. Setting an empty
name raises an error. Setting a name that is already used by another dialog raises an error;
setting the dialog's current name is a no-op.
Title
- Gets or sets the dialog title (the formatted text shown
in the title area).
Width
- Gets or sets the dialog width, in MSI dialog
units.
Height
- Gets or sets the dialog height, in MSI dialog units.
IsBuiltIn
- Returns $true when the dialog
is one of the Advanced Installer built-in dialogs. (Read-only)
IsErrorDialog
- Returns $true when the dialog is an error dialog.
(Read-only)
Controls (property, read-only)
- Returns an array of
IControl objects for every control hosted by the dialog. Transient
controls are not included. (Read-only)
Methods
FindControl
- Looks up a control on the dialog by name and
returns the matching IControl, or $null when the
dialog has no control with that name.
NewControl
- Creates a control on the dialog and returns it as
an IControl. The type must be one of
SupportedControlTypes, an error listing the accepted values
is raised. The second argument is an optional name: when supplied, it must be unique on the
dialog (otherwise an error is raised); when omitted a name is generated. The control is
made visible and enabled with a default position and size, and an associated property is
added for control types that require one (such as Edit, CheckBox or
ComboBox).
DeleteControl
- Deletes a control from the dialog. Controls
flagged as non-deletable raise an error and are kept.