Button Object

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

Button Object

Name

The name that is used to identify this object.

File

The AutoPlay button file (.btn) that you want to display in the button object. Click the browse button ( ) to select a file.

Type

Choose from:

Standard

A standard button. Click to enter the down state; release the mouse button to return to the up state automatically.

Toggle

A toggle button. Click once to enter the down state; click again to return to the up state.

State

The initial state of a toggle button. Choose from:

Up

Begin in the up state.

Down

Begin in the down (pressed) state.

Text

The text that you want to display on the button object.

Font

The font that you want to use for the text. Click the edit button ( ) to open the Font dialog where you can edit all of the font settings.

Family

The font family that you want to use.

Size

The font size, in points.

Bold

Make the text bolded.

Italic

Make the text appear in italics.

Alignment

The alignment to use. Choose from:

Left

Left-align the text within the object's bounding box, like so:

This text is left-aligned

Center

Center the text within the object's bounding box, like so:

This text is centered

Right

Right-align the text within the object's bounding box, like so:

This text is right-aligned

Offset X

The x offset for the text, i.e. the number of pixels that the text should be offset horizontally from its default position. Positive values move the text to the right, and negative values move it to the left.

For example, you can offset the text 5 pixels to the left by setting this to -5.

Offset Y

The y offset for the text, i.e. the number of pixels that the text should be offset vertically from its default position. Positive values move the text down, and negative values move the text up.

For example, you can offset the text 7 pixels down by setting this to 7.

State Colors

Up

The text color for the button's up state. (Normally used when the mouse is not over the object and the user is not clicking on it.)

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

Down

The text color for the button's down state. (Normally used while the left mouse button is pressed down on the object.)

Highlight

The text color for the button's highlight state. (Normally used while the mouse is held over the object.)

Disabled

The text color for the disabled state. This color will persist until a Button.SetEnabled action is called. While in the disabled state, the object will not respond to any mouse overs or clicks. (Button.SetEnabled is only available in the Professional edition.)

Attributes

Highlight Sound

The sound that will be played when the mouse moves over this object. Choose from:

None

Don't play any sound.

Standard

Play the default mouse over sound, as configured on the Sound Effects tab of the Audio Settings dialog.

Custom

Play a custom mouse over sound.

File

The custom audio file to play. Click the browse button ( ) to select an appropriate sound file.

Click Sound

The sound that will be played when the user clicks on this object. Choose from:

None

Don't play any sound.

Standard

Play the default mouse click sound, as configured on the Sound Effects tab of the Audio Settings dialog.

Custom

Play a custom mouse click sound.

File

The custom audio file to play. Click the browse button ( ) to select an appropriate sound file.

Cursor

The mouse pointer that will be used while the mouse is over this object.

Tooltip

A short string of text that will appear after the mouse hovers over this object for a moment.

Enabled

Enable the object so it responds to user interaction. Choose from:

True

The object will respond to mouse overs and clicks and perform any actions assigned to its events.

False

The object will not respond to any mouse overs or clicks and will not perform any actions until it is enabled.

Note: You can use the Button.SetEnabled action to enable this object. (Button.SetEnabled is only available in the Professional edition.)

Visible

Set the object's initial visibility. Choose from:

True

The object will be visible when the page is displayed.

False

The object will be invisible when the page is displayed.

Note: You can use the Button.SetVisible action to make the object visible or invisible at run time.

Left

The distance in pixels from the left edge of the object to the left edge of the page.

Tip: You can also change the position of an object by dragging it or using the arrow keys.

Top

The distance in pixels from the top edge of the object to the top edge of the page.

Width

The width of the object in pixels.

Tip: You can also resize an object by dragging one of the resize handles on its bounding box.

Height

The height of the object in pixels.

Actions

On Click

The actions that will be performed when the user clicks on this object. Click the edit button ( ) to open the action editor.

On Enter

The actions that will be performed when the mouse moves onto this object ("enters" the object's territory). Click the edit button ( ) to open the action editor.

On Leave

The actions that will be performed when the mouse moves off of this object ("leaves" the object's territory). Click the edit button ( ) to open the action editor.