OverviewExamples
table Application.GetDialogProperties ( |
Returns a table containing the properties of the specified dialog.
(string) The name of the dialog whose properties you want.
(table) A table containing the dialog's properties indexed by the following keys. If the dialog doesn't exist or an error occurs, nil is returned.
KEY |
TYPE |
DESCRIPTION |
DialogTitle |
string |
The window title of the dialog. |
Movable |
boolean |
True if the dialog is set to be movable, or false if it is not. |
AlwaysOnTop |
boolean |
True if the dialog window is set to always appear on top of all other windows, or false if it is not. |
Width |
number |
The width of the dialog surface, in pixels. |
Height |
number |
The height of the dialog surface, in pixels. |
DialogStyle |
number |
The window style of the dialog: DIALOG_STYLE_STANDARD (0), DIALOG_STYLE_BORDERED (1), DIALOG_STYLE_FLAT (2), DIALOG_STYLE_CUSTOM_MASK (3). |
Resizable |
boolean |
True if the dialog is set to be resizable, or false if it is not. |
MinWidth |
number |
The minimum dialog width to use if Resizable is set to true. |
MinHeight |
number |
The minimum dialog height to use if Resizable is set to true. |
UseCustomIcon |
boolean |
True if a custom icon is set to be shown in the top left corner of the dialog, or false if it is not. |
CustomIcon |
string |
The path to the custom icon to show if UseCustomIcon is true, and DialogStyle is set to DIALOG_STYLE_STANDARD. |
UseCustomSettings |
boolean |
True if custom colors are being used, or false if the default background color for windows applications is being used. |
BackgroundType |
number |
The type of background: BG_SOLID (0), BG_GRADIENT (1), BG_IMAGE (2) |
BackgroundColor |
number |
The numeric value of the background color. |
GradientColorTop |
number |
The numeric value of the gradient top color. Only applicable if BackgroundType = BG_GRADIENT. |
ImageFilename |
string |
The path to the image file to be used for the background image if BackgroundType = BG_IMAGE. |
ImageStretchMode |
number |
The type of image stretching to be performed if BackgroundType = BG_IMAGE. Choose from BG_IMAGE_FITPAGE (0), BG_IMAGE_TILE (1), BG_IMAGE_ACTUALSIZE (2). |
CustomMask |
string |
The path to the file that is being used as the window mask when DialogStyle is set to DIALOG_STYLE_CUSTOM_MASK. |
FitCustomMaskToWindow |
boolean |
True if the mask file is set to resize to match the dimensions of the dialog, false if it is not. |
When adding an action with the script editor, you can use this field to specify a variable that the return value will be stored in.
See also: Related Actions