Dialog

Here are the dialog's settings as they appear in the properties pane:

Dialog

Name

The unique name that is used to identify this dialog.

UseCustomSettings

Setting this value to true will allow you to change the look of your dialog background. If this value is false, the dialog background will be the default background color for windows applications.

Note: If you skin your application, the default background color will come from your skin file.

Note: if this value is set to true, the BackgroundStyle, BackgroundImage, ImageStyle, BackgroundColor and GradientColor settings will be ignored.

BackgroundStyle

The type of background to use. Choose from:

Solid

Cover the background with a single, solid color.

Gradient

Cover the background with a 2-color gradient.
(A smooth transition from one color at the top of the dialog, to a second color at the bottom of the dialog.)

Image

Display an image as the background. The image will be resized to fit the dialog.

BackgroundImage

The image that will be used as the background for this dialog. Click the browse button to select an image file.

ImageStyle

The background image style to show. Choose from:

Fit to page

Resize or stretch the image to cover the entire dialog. (This may cause some images to appear distorted.)

Tile

Cover the background with copies of the image placed side-by-side and top-to-bottom, like tiles on a floor.

Actual size

Display the image using it's original dimensions. The image will be positioned in the top left hand corner of the dialog.

BackgroundColor

The background color for the dialog.

Tip: You can click the select button to bring up a color chooser. Clicking the "More Colors..." button on the color menu allows you to choose either a standard color/custom color, or use the eyedropper to pick a color from somewhere within the AutoPlay application window.

GradientColor

The bottom color for the Gradient background style. The dialog background will be blended from the background color (at the top of the dialog) to this color (at the bottom of the dialog) when Style is set to "Gradient."

WindowTitle

The text that will be displayed in the title bar of the dialog's window.

Movable

Whether to make the dialog window "movable." Choose from:

True

If the Standard style is selected, allow the user to left-click the title bar and drag the dialog window around their screen. If the Flat style is selected, allow the user to left-click on the dialog surface and drag it around their screen.

False

Don't allow the user to move the dialog window around their screen.

AlwaysOnTop

Whether to make the dialog window always appear on top of all other windows on the desktop. Choose from:

True

Make the dialog window always appear on top of all other windows on the desktop. The window will remain on top even if the user switches to another application.

False

Don't make the dialog window always appear on top of all other windows.

Width

The width of the dialog surface, in pixels.

Height

The height of the dialog surface, in pixels.

Style

The window style to use for the dialog. Choose from:

Standard

A title bar and border will be displayed for the dialog window.

Bordered

A border will be displayed around the dialog window with no title bar.

Flat

The dialog will be displayed without a title bar or border.

Custom

The dialog will be displayed as a custom window shape using the custom mask file defined in CustomMask.

Note: When some of these options are used, the controls that normally appear on the title bar—such as the "X"-shaped close button in the upper right corner—will not be available. Make sure you provide some other way for your users to exit from the dialog. (For example, you could have an "Exit" button somewhere on the dialog.) You can also exit the dialog using the Escape key, or ALT+F4.

CustomMask

Make certain parts of your dialog's window transparent when the Custom style is selected. You can use this option to make a custom window shape for your dialog.

To specify the areas that you want to make transparent, you need to create a transparency mask file in your favorite drawing program.

A transparency mask file is just an image where a single color represents the parts that you want to make transparent. Picture this image as being invisibly "placed over" your dialog's window, like a mask or a stencil.

In AutoPlay, the transparent parts of the mask should all be solid black. Wherever solid black appears in the mask image, the corresponding part of the window will be made transparent. The transparency mask acts like a "cookie cutter," cutting holes in the dialog's window so the user's desktop can show through.

Click the browse button to select an image file.

FitToWindow

Whether to take your transparency mask image in CustomMask and resize it to fit the dialog. Choose from:

True

Take your transparency mask image and resize it to fit the dialog.

False

Use the original image dimensions to mask the dialog.

Resizable

Whether to make the dialog window resizable. Choose from:

True

Make the dialog window resizable. Enabling this option allows the user to resize the dialog window either by dragging the title bar, or by pressing the maximize/restore button. This option only applies to dialogs using the Standard and Bordered window styles.

Tip: To manipulate the size, position, visibility, etc. of objects when the dialog is resized, use the On Size event of the dialog's Script tab.

False

Don't allow the user to resize the dialog window.

MinWidth

The minimum dialog width to use at runtime if the window is resizable.

Note: This is the minimum dialog width, not the window width.

MinHeight

The minimum dialog height to use at runtime if the window is resizable.

Note: This is the minimum dialog height, not the window height.

UseCustomIcon

Whether to show a custom icon in the top left corner of the dialog window. Choose from:

True

Show a custom icon in the top left corner of the dialog window if the Standard style is selected.

False

Show the default application icon in the top left corner of the dialog window.

CustomIcon

The custom icon file to show in the top left corner of the dialog window if the Standard style is selected, and UseCustomIcon is set to True. You can use the browse button to select a standard icon (.ico) file.

Actions

On Preload

The actions that will be performed right after the dialog is created in memory, before the dialog (or any of the objects on it) is shown.

You can use this event to set the initial visibility of each object on the dialog. Simply show or hide the objects according to whether they should start out visible or hidden. (By doing so before the dialog is displayed, you can avoid any visible "flickering" as the objects are hidden or shown.)

Note: Some actions (especially object-related actions) may not work properly on this event because it occurs before any of the dialog's objects are "created." If an action doesn't work at On Preload, try it at On Show instead.

 Click the edit button to open the script editor.

On Show

The actions that will be performed whenever the dialog is opened (after the dialog is shown and the objects have been drawn). Click the edit button to open the script editor.

On Close

The actions that will be performed whenever the dialog is closed. Click the edit button to open the script editor.

Tip: If you need to prevent the user from closing the dialog or want to add a confirmation message, you can use the built-in function QueryAllowDialogClose.

On Timer

The actions that will be performed whenever a dialog timer fires. You can start a dialog timer using a DialogEx.StartTimer action. Click the edit button to open the script editor.

On Audio

The actions that will be performed whenever an audio channel's state changes on the dialog. For example, if a channel's audio is paused, this event will be triggered. Click the edit button to open the script editor.

On Size

The actions that will be performed whenever the dialog changes size. For example, if the user maximizes the application's window, this event will fire. Click the edit button to open the script editor.

On Key

The actions that will be performed whenever the dialog window has focus and the user presses a key. Click the edit button to open the script editor.

On Mouse Button

The actions that will be performed when a mouse button is clicked within the bounds of your dialog. Click the edit button to open the script editor.

On Mouse Move

The actions that will be performed when the mouse moves within the bounds of your dialog. Click the edit button to open the script editor.

On Mouse Wheel

The actions that will be performed when the mouse wheel is rotated while the dialog has focus. Click the edit button to open the script editor.