SlideShow Object

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

There are four tabs on the Properties dialog:

Settings

Attributes

Quick Action

Script

Settings Tab

Image Files

 

The image files you wish to show in the slideshow object.

Click the add button to choose an image file through the Select File dialog. Repeat this step if you wish to include multiple files, or click the add folder button to add all supported images within a folder on your system. You can manipulate the image files list by first highlighting the image file, then either clicking the edit, delete, or the arrow buttons to achieve the desired image list.

Note: The slideshow object has a wide range of supported file types.

Background Style

Solid

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

Tip: 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.

Transparent

Make the background of the object transparent.

Border Style

Solid

The border color for the object. You can click the select button to bring up a color chooser.

Tip: 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.

None

Don't show any border for the object.

Timer

Interval (milliseconds):

The duration to show each slide in the object (in milliseconds).

Auto-start

Start playing the slideshow automatically (as soon as the page or dialog is opened).

Note: If this option is unchecked, the slideshow will not play until you start it with a SlideShow.Play action.

Options

Resize mode:

The resize mode to use for the image slides. Choose from:

Crop

Fill the area defined by the object's bounding box and crop any parts that extends beyond the object's dimensions.

Proportional

Resize the image so it fits inside the area defined by the object's bounding box using the image's largest dimension.

Stretch

Resize the image to fill the entire area defined by the object's bounding box.

Note: This setting ignores the image's original dimensions. The image may appear distorted as a result.

Loop

Automatically begin playing from the beginning again whenever the slideshow reaches the end.

Note: If this option is checked, the On Finished event will not be fired.

Transitions

Show a transition effect between slides.

Shuffle

Play the slides in the object's image file list in random order. If unchecked, they will be played in the order they were defined at design-time.

No enlarge

If checked, and Resize mode is set to "Proportional," any images that are smaller than the object's dimensions will be centered in the object, and not enlarged to fit the dimensions of the object. If unchecked, images will be proportionally resized to fit the object's dimensions.

Attributes Tab

Identification

Object name:

The name that is used to identify this object.

State

Enabled

Enable the object so it responds to user interaction. When an object is disabled, it will not respond to any mouse overs or clicks and will not perform any actions until it is enabled.

Note: You can use the SlideShow.SetEnabled action to enable this object.

Visible

Set the object's initial visibility (whether it's visible when the page or dialog is displayed).

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

Auto-Resize

Left

If checked, the left side of the object will move when the application is resized. If unchecked, the left side of the object will not move.

Right

If checked, the right side of the object will move when the application is resized. If unchecked, the right side of the object will not move.

Top

If checked, the top of the object will move when the application is resized. If unchecked, the top of the object will not move.

Bottom

If checked, the bottom of the object will move when the application is resized. If unchecked, the bottom of the object will not move.

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.

Restore Original

Set's the object's size back to the original values. (This feature is not available for the SlideShow object.)

Feedback

Tooltip:

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 "&&&".

Spelling

Check the spelling of the tooltip text.

Cursor:

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

Sounds

Highlight:

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 click 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:

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.

Quick Action Tab

You can use this tab to perform a simple action when the object is clicked.

When Object is Clicked

Action to run:

The action to perform when the object is clicked. Choose from:

ACTION

DESCRIPTION

None

Does nothing.

Show Page

Jumps to the specified page in your application. Click here for more information.

Show Dialog

Shows a specific dialog in your application. Click here for more information.

Close Dialog

Closes the currently displayed dialog. Click here for more information.

Run Program

Runs an application with optional command line arguments. Click here for more information.

Open Document

Opens a document in an external viewer. Click here for more information.

Print Document

Prints a document on the user's system. Click here for more information.

Send Email

Sends an email through the user's default email program. Click here for more information.

View Website

Opens a website in the user's default web browser. Click here for more information.

Explore Folder

Explores a folder on the user's system. Click here for more information.

Play Multimedia

Plays a multimedia file in the default player on the user's system. Click here for more information.

Play/Pause Background Music

Toggles the play state of the background music. Click here for more information.

Exit/Close

Exits from the AutoPlay application. Click here for more information.

Properties

Any additional settings corresponding to the selected quick action.

Script Tab

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

This object supports the following events:

On Click

The actions that will be performed when the user clicks on this object.

On Right-Click

The actions that will be performed when the user right-clicks this object.

On Enter

The actions that will be performed when the mouse moves onto this object ("enters" the object's territory).

On Leave

The actions that will be performed when the mouse moves off of this object ("leaves" the object's territory).

On Play

The actions that will be performed when the slideshow begins to play.

On Pause

The actions that will be performed when the slideshow is paused.

On Finished

The actions that will be performed when the slideshow reaches the end.

Note: If the Loop setting is selected, this event will not be fired.

On Slide Changed

The actions that will be performed each time the slide changes in the slideshow object.

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

e_Index

(number) The 1-based index of the slide that was changed to in the slideshow (currently shown).

e_FilePath

(string) The full path to the image file that was changed to in the slideshow (currently shown).