Page

 OverviewPanelDialogActions

Here are the page's settings as they appear in the properties inspector:

Page Settings

Name

The unique name that is used to identify this page.

Style

The type of background to use. Choose from:

Solid Color

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 page, to a second color at the bottom of the page.)

Image

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

Image

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

Note: This setting is only available when the "Image" style is selected.

Image Mode

The display mode for the background image. Choose from:

Fit to Page

Resize or stretch the image to cover the entire page. (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 page.

Back Color

The background color for the page.

Tip: You can click the select button ( ) to bring up a color chooser.

Gradient Color

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

Transition

The type of transition you want to have between pages in your project. Click the select button ( ) to choose one of the available transition styles.

Settings

The settings you want to have for the selected transition style. Click the edit button ( ) to open the transition properties dialog.

Inherit Background

The name of the page whose background properties you want to inherit. The background for that page will be used on the current page. If you need to edit the background, you will need to go to the page you inherited from to make any changes.

Inherit Objects

The name of the page whose objects you want to inherit. If you need to edit any objects that are inherited, you will need to go to the page you inherited from to make any changes.

Actions

On Show

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

On Close

The actions that will be performed whenever the page is closed. Click the edit button ( ) to open the action editor.

On Audio

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

The following event variables are automatically set whenever this event is triggered:

e_Channel

(number) The audio channel whose state has changed. One of the following channel values will be returned:

e_State

(string) The state that the audio channel has changed to. One of the following states will be returned:

On Timer (Pro edition only)

The actions that will be performed whenever the page timer fires. You can start the page timer using a Page.StartTimer action. Click the edit button ( ) to open the action editor.

On Key (Pro edition only)

The actions that will be performed whenever the application window has focus and the user presses a key. Click the edit button ( ) to open the action editor.

The following event variables are automatically set whenever this event is triggered:

e_Key

(number) The virtual key code of the key that was pressed.

e_Modifiers

(table) A table containing three boolean values that describe which modifier keys were held down while the key was pressed. A modifier key is a key that can be held down while another key is pressed, to "modify" it.

There are three true/false values in the table, one for each type of modifier key on the keyboard: shift, ctrl, and alt. You can access these values as e_Modifiers.shift, e_Modifiers.ctrl, and e_Modifiers.alt.

On Preload

The actions that will be performed right after the page is created in memory, before the page (or any of the objects on it) is shown. Click the edit button ( ) to open the action editor.

You can use this event to set the initial visibility of each object on the page. Simply show or hide the objects according to whether they should start out visible or hidden. (By doing so before the page 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 page's objects are "created." If an action doesn't work at On Preload, try it at On Show instead.