Flash Object

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

There are three tabs on the Properties dialog:

Settings

Attributes

Script

Settings Tab

Object

File:

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

Player Options

Alignment:

The alignment of the Flash movie within the object's bounding box.

Quality:

The rendering quality to use when displaying the Flash file, including the level of anti-aliasing performed. Choose from:

Low

Gives priority to playback speed over appearance. Anti-aliasing is turned off.

High

Gives priority to appearance over playback speed. Anti-aliasing is turned on.

Auto Low

Emphasizes speed at first, but improves appearance whenever possible. Playback begins with anti-aliasing turned off; if the Player determines that the system can handle it, it turns anti-aliasing on.

Auto High

Emphasizes speed and appearance equally at first, but sacrifices appearance for the sake of speed if necessary. Playback begins with anti-aliasing turned on, but it will be turned off if the frame rate drops below an acceptable level.

Context menu:

Control which context menu will display when you right-click on the Flash movie at run time. Choose from:

Standard

The standard right-click context menu will be shown.

Full

The full right-click context menu will be shown.

Scaling mode:

How the Flash movie will be made to fit within the bounding box. Choose from:

Show All

Makes the entire movie visible in the area defined by the object's bounding box without distortion, while maintaining the original aspect ratio of the movie. Borders may appear on two sides of the movie.

No Border

Scales the movie to fill the area defined by the object's bounding box without distortion, while maintaining the original aspect ratio of the movie. Any part of the movie that falls outside the area defined by the object's bounding box will be cropped.

Exact Fit

Resizes the movie to fill the area defined by the object's bounding box, ignoring the movie's original aspect ratio. The movie may appear distorted as a result.

Override background

Override the background color of the Flash file (.swf). This allows you to replace the background color in your Flash file with something more appropriate. 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.

Device font

Set the "Device Font Attribute" for the Flash control. When this option is enabled (checked), and appropriate fonts are installed on the user's system, the control will substitute installed system fonts for any fonts used in the Flash movie. Any text whose fonts are substituted will appear aliased (rough) regardless of the Quality setting. If the necessary fonts are not installed, the text will be rendered in the normal anti-aliased (smooth) way.

Special

Auto start

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

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

Loop

Automatically begin playing from the beginning again whenever the Flash movie reaches the end.

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

Visible

Set the object's initial visibility (whether it's visible when the page or dialog is displayed). You can use the Flash.SetVisible action to make the object visible or invisible at run time.

Note: This option simply controls the initial visibility of the object and does not affect its play state. For example, if the object is set to start automatically, it will begin to play when the page or dialog opens whether it is visible or not.

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.

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.

Script Tab

You can use the script 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 FSCommand

The actions that will be performed whenever an fscommand() function is performed in the Flash file's internal actionscript code.

Note: "fscommand()" is the name of a Flash actionscript function that allows a .swf file to send a message or "command" to the application that is playing it. Whenever a Flash file calls the fscommand() function, AutoPlay responds by performing the action that you assigned to the On FSCommand event.

Tip: The Flash fscommand() function passes a command in the form of a short text string. You can use AutoPlay's own scripting abilities to differentiate between fscommand() calls that pass different command strings. In fact, your Flash file can use the fscommand() function to send any number of custom commands to your AutoPlay application, and you can make your application respond to each command in any way you want.

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

e_FSCommand

(string) A string containing the last FSCommand fired within the Flash object.

e_FSArgs

(string) A string containing the arguments of the last FSCommand fired within the Flash object.

On FlashCall

The actions that will be performed whenever an exposed Flash actionscript function is called using the control's external API (ExternalInterface class) causing it to dispatch its FlashCall event. You can respond to Flash actionscript function calls using the Flash.SetReturnValue action, or call Flash actionscript functions using the Flash.CallFunction action.

Flash's external API offers additional functionality compared to fscommand() by allowing any number of arguments to be passed as well as various data types.

Note: This event is only available in Flash version 8.0 or later.

e_FlashCall

(string) An XML formatted string containing the function request from the Flash file's actionscript code. This string can be parsed using the available XML actions.