Page

Here are the page's settings as they appear on the "double-click" Properties dialog.

There are two tabs on the Properties dialog:

Settings

Actions

Settings Tab

Page

Name:

The unique name that is used to identify this page.

Colors

Background

The background color for the page. You can click the select button ( ) to bring up a color chooser.

Gradient

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 Background is set to "Gradient." You can click the select button ( ) to bring up a color chooser.

Background

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.

Transition

Effect:

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

Settings...

Opens the transition properties dialog where you can choose the settings you want to have for the selected transition effect.

Image

File:

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" background is selected.

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.

Inherit

Background from Page:

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.

Objects from Page:

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 Tab

You can use the action editor on this tab to edit the script of actions that will be performed on each of this page's events.

Each page supports the following events:

On Show

The actions that will be performed whenever the page is opened (after the page is shown and the objects have been drawn).

On Close

The actions that will be performed whenever the page is closed.

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.

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:

CONSTANT

VALUE

DESCRIPTION

CHANNEL_BACKGROUND

5

Background audio channel.

CHANNEL_EFFECTS

0

Effects channel (used for mouse over, down, and click sounds).

CHANNEL_NARRATION

6

Narration channel (used for voice overs).

CHANNEL_USER1

1

User channel 1. (Only available in the Professional edition.)

CHANNEL_USER2

2

User channel 2. (Only available in the Professional edition.)

CHANNEL_USER3

3

User channel 3. (Only available in the Professional edition.)

CHANNEL_USER4

4

User channel 4. (Only available in the Professional edition.)

CHANNEL_ALL

-3

All audio channels.

e_State

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

VALUE

TYPE

DESCRIPTION

Finish

string

The audio channel's track reached it's end.

Pause

string

The audio channel was paused using the Audio.Pause action.

Play

string

The audio channel was played using the Audio.Play action

Stop

string

The audio channel was stopped using the Audio.Stop action.

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.

On Key (Pro edition only)

The actions that will be performed whenever the application window has focus and the user presses a key.

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.

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.