xButton Object

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

Object

Name

The name that is used to identify this object.

Text

The text that you want to display on the xButton object. If EnableMarkup is selected, you can specify the desired text and formatting using supported Extensible Application Markup Language (XAML) syntax.

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.

Tip: You can set the default font for this object type by configuring its settings on the Objects tab in Edit > Preferences.

FontFamily

The font family that you want to use.

FontSize

The font size, in points.

FontBold

Make the text bolded.

FontItalic

Make the text appear in italics.

TextColor

The color to use for the text.

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.

EnableMarkup

Whether to use markup text. Choose from:

True

Enable the use of markup text using supported Extensible Application Markup Language (XAML) syntax. This enables you to add text highlighting, hyperlinks and more.

False

Use standard text.

ButtonImage

The image that you want to display on the xButton object. Click the browse button to select a file. The xButton supports the following image formats: .bmp, .jpg, .png, .wmf, .gif and .ico (icon).

ImageAlignment

The alignment to use for the image. Choose from:

Middle Left

Align the image to the middle left.

Middle Right

Align the image to the middle right.

Middle Center

Align the image to the middle center.

Top Left

Align the image to the top left.

Top Right

Align the image to the top right.

Top Center

Align the image to the top center.

Bottom Left

Align the image to the bottom left.

Bottom Right

Align the image to the bottom right.

Bottom Center

Align the image to the bottom center.

TextAlignment

The alignment to use for the text. Choose from:

Middle Left

Align the text to the middle left.

Middle Right

Align the text to the middle right.

Middle Center

Align the text to the middle center.

Top Left

Align the text to the top left.

Top Right

Align the text to the top right.

Top Center

Align the text to the top center.

Bottom Left

Align the text to the bottom left.

Bottom Right

Align the text to the bottom right.

Bottom Center

Align the text to the bottom center.

ImageTextRelation

The relationship to use between the text and image:

Overlay

Display the image over top of the text.

Image Above Text

Display the image above the text.

Text Above Image

Display the text above the image.

Image Before Text

Display the image before (to the left) of the text.

Text Before Image

Display the text before (to the left) of the image.

Theme

The visual theme to use for the xButton. Click the select button to choose from a variety of themes. Any button with Office 2007 selected as it's theme will use the Office 20007 sub-theme that can be changed on the Appearance tab of the Project Settings dialog.

Style

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.

DefaultToggleState

The initial state of a toggle button. Choose from:

Up

Begin in the up state.

Down

Begin in the down (pressed) state.

Attributes

TooltipText

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

Tip: You can choose from several tooltip styles for all tooltips in your project, Standard, Balloon and Extended. This setting can be found on the Appearance tab of the Project > Settings.

Tip: If you want a newline in your tooltip text, use "\r\n". For example, for an Extended tooltip, "My First Line\r\nMy Second Line|My Title". Newlines are not supported in the Title text for Balloon or Extended styles.

Tip: If you want a "&" character in the text, you must enter "&&&".

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 xButton.SetEnabled action to enable this object.

Visible

Set the object's initial visibility. Choose from:

True

The object will be visible when the page or dialog is displayed.

False

The object will be invisible when the page or dialog is displayed.

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

Cursor

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

Position

Left

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

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 or dialog.

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.

Auto-Resize

ResizeLeft

Whether the left side of the object will move when resized. Choose from:

True

The left side of the object will move when the application is resized.

False

Don't move the left side of the object when the application is resized.

ResizeRight

Whether the right side of the object will move when resized. Choose from:

True

The right side of the object will move when the application is resized.

False

Don't move the right side of the object when the application is resized.

ResizeTop

Whether the top of the object will move when resized. Choose from:

True

The top of the object will move when the application is resized.

False

Don't move the top of the object when the application is resized.

ResizeBottom

Whether the bottom of the object will move when resized. Choose from:

True

The bottom of the object will move when the application is resized.

False

Don't move the bottom of the object when the application is resized.

Sounds

HighlightSound

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.

HighlightFile

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

ClickSound

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.

ClickFile

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

Actions

Quick Action

A quick action to perform when the object is clicked. Click the edit button to select a quick action.

On Click

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

On Right-Click

The actions that will be performed when the user right-clicks on this object. Click the edit button to open the script 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 script 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 script editor.

On Hyperlink

The actions that will be performed when the user clicks on a hyperlink in a markup enabled xButton object.