QuickTime 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

Script

Settings Tab

File

The media file that you want to display in the QuickTime object. Click the Browse button to select a file.

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

Options

Sizing mode:

The way that media files will be displayed within the QuickTime control. Choose from:

Centered In Control

Center the media file at full size within the object's bounding box.

Maintain Aspect Ratio

Fit the media file within the object's bounding box while maintaining the original aspect ratio for the file. The aspect ratio of media file is its width to height ratio. For example 4:3 or 16:9. This option enables you to ensure the media is viewed at its intended dimensions.

Movie Fits Control

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

Note: This setting ignores the media's original aspect ratio. The media may appear distorted as a result.

Border style:

The type of border that the QuickTime object will have. Choose from:

Note: The border styles may not draw properly on 64-bit versions of the Windows operating system.

3D

The standard 3D/sunken border will surround the QuickTime object.

Note: On 64-bit versions of Windows this style may not display properly.

None

No border will be displayed.

Plain

A solid black line will be used for the object's border.

Auto start

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

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

Loop

Automatically begin playing from the beginning whenever the end of the media file is reached.

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 QuickTime.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 QuickTime.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.

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

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.

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 Mouse Button Down

The actions that will be performed when the cursor is over the QuickTime object and a mouse button is pressed down.

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

e_Button

(number) The index of the button that was pressed:

CONSTANT

VALUE

DESCRIPTION

BUTTON_LEFT

1

Left mouse button.

BUTTON_RIGHT

2

Right mouse button.

BUTTON_MIDDLE

3

Middle mouse button.

e_Modifiers

(table) A table containing three boolean values that describe which modifier keys were held down while the mouse button was pressed. A modifier key is a key that can be held down while button 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.

e_XObject

(number) The horizontal position of the mouse cursor when the mouse button was pressed, relative to the top left of the object.

e_YObject

(number) The vertical position of the mouse cursor when the mouse button was pressed, relative to the top left of the object.

e_X

(number) The horizontal position of the mouse cursor when the mouse button was pressed, relative to the top left of the page.

e_Y

(number) The vertical position of the mouse cursor when the mouse button was pressed, relative to the top left of the page.

On Mouse Button Up

The actions that will be performed when the cursor is over the QuickTime object and a mouse button is released.

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

e_Button

(number) The index of the button that was pressed:

CONSTANT

VALUE

DESCRIPTION

BUTTON_LEFT

1

Left mouse button.

BUTTON_RIGHT

2

Right mouse button.

BUTTON_MIDDLE

3

Middle mouse button.

e_Modifiers

(table) A table containing three boolean values that describe which modifier keys were held down while the mouse button was pressed. A modifier key is a key that can be held down while button 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.

e_XObject

(number) The horizontal position of the mouse cursor when the mouse button was pressed, relative to the top left of the object.

e_YObject

(number) The vertical position of the mouse cursor when the mouse button was pressed, relative to the top left of the object.

e_X

(number) The horizontal position of the mouse cursor when the mouse button was pressed, relative to the top left of the page.

e_Y

(number) The vertical position of the mouse cursor when the mouse button was pressed, relative to the top left of the page.

On Mouse Move

The actions that will be performed when the mouse cursor moves over the QuickTime object.

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

e_Button

(number) The index of the button that was pressed:

CONSTANT

VALUE

DESCRIPTION

BUTTON_LEFT

1

Left mouse button.

BUTTON_RIGHT

2

Right mouse button.

BUTTON_MIDDLE

3

Middle mouse button.

e_Modifiers

(table) A table containing three boolean values that describe which modifier keys were held down while the mouse button was pressed. A modifier key is a key that can be held down while button 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.

e_XObject

(number) The horizontal position of the mouse cursor when the mouse button was pressed, relative to the top left of the object.

e_YObject

(number) The vertical position of the mouse cursor when the mouse button was pressed, relative to the top left of the object.

e_X

(number) The horizontal position of the mouse cursor when the mouse button was pressed, relative to the top left of the page.

e_Y

(number) The vertical position of the mouse cursor when the mouse button was pressed, relative to the top left of the page.

On Rate Change

The actions that will be performed when the play rate of the media file within the QuickTime object has changed.

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

e_Rate

(number) The new rate of the media file.

On Movie End

The actions that will be performed when the media file has finished playing.

On Error

The actions that will be performed when an error occurs in the QuickTime object.

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

e_ErrorCode

(number) The numeric code of the error that has occurred.

e_ErrorOrigin

(number) Where the error originated from:

CONSTANT

VALUE

DESCRIPTION

qtErrorEventOriginControl

0

An error occurred in the QTControl area of the QuickTime ActiveX control.

qtErrorEventOriginMovie

1

An error occurred in the QTMovie area of the QuickTime ActiveX control.

qtErrorEventOriginQuickTime

2

An error occurred in the QTQuickTime area of the QuickTime ActiveX control.