QuickTime.SetProperties

OverviewExamples

QuickTime.SetProperties (

string ObjectName,

table Properties )

Description

Sets the properties of a QuickTime object.

Parameters

ObjectName

(string) The name of the QuickTime object.

Properties

(table) A table containing the QuickTime object's properties indexed by the following keys:

KEY

TYPE

DESCRIPTION

MovieFile

string

The media file to load into the QuickTime object.

SizingMode

number

How to display the media within the QuickTime control:

CONSTANT

VALUE

DESCRIPTION

qtMovieFitsControl

1

Resize the media to fill the area defined by the object's bounding box. This setting ignores the media's original aspect ratio.

qtMovieFitsControlMaintainAspectRatio

2

Fit the media within the object's bounding box while maintaining the original aspect ratio for the file.

qtMovieCenteredInControl

3

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

BorderStyle

number

The type of border to show around the object:

CONSTANT

VALUE

DESCRIPTION

bsNone

0

Don't show a border.

bsPlain

1

Show a solid blank line around the object.

bs3D

2

Show the standard 3D/sunken border. On 64-bit versions of Windows this style may not display properly.

AutoStart

boolean

True if the QuickTime object should automatically play the loaded media as soon as the page or dialog is shown, false if it should not.

Loop

boolean

True if the media should restart when it ends, false if it should not.

ShowControls

boolean

True if the control panel should be shown, false if it should not.

UseBackgroundColor

boolean

True if the color specified in BackgroundColor should be used as the background of the media, false if it should not.

BackgroundColor

number

The color to replace the media background with if UseBackgroundColor is set to true.

Enabled

boolean

True if the QuickTime object should be enabled, false if it should not be.

Visible

boolean

True if the QuickTime object should be visible, false if it should not be.

X

number

The horizontal position (in pixels) of the top left corner of the QuickTime object in relation to the current page or dialog.

Note: The top left corner of the current page or dialog has an X value of 0

Y

number

The vertical position (in pixels) of the top left corner of the QuickTime object in relation to the current page or dialog.

Note: The top left corner of the current page or dialog has a Y value of 0

Width

number

The width (in pixels) of the QuickTime object.

Height

number

The height (in pixels) of the QuickTime object.

ResizeLeft

boolean

True if the left side of the object should move when the application is resized, false if it should not.

ResizeRight

boolean

True if the right side of the object should move when the application is resized, false if it should not.

ResizeTop

boolean

True if the top of the object should move when the application is resized, false if it should not.

ResizeBottom

boolean

True if the bottom of the object should move when the application is resized, false if it should not.

HighlightSound

number

The type of sound that should be played when the mouse moves over the QuickTime object.

CONSTANT

VALUE

DESCRIPTION

SND_NONE

0

No highlight sound.

SND_STANDARD

1

Standard highlight sound.

SND_CUSTOM

2

Custom highlight sound.

HighlightSoundFile

string

The path to the QuickTime object's custom highlight sound file if it uses one.

ClickSound

number

The type of sound that should be played when the mouse clicks the QuickTime object.

CONSTANT

VALUE

DESCRIPTION

SND_NONE

0

No click sound.

SND_STANDARD

1

Standard click sound.

SND_CUSTOM

2

Custom click sound.

ClickSoundFile

string

The path to the QuickTime object's custom click sound file if it should use one.

Returns

Nothing. You can use Application.GetLastError to determine whether this action failed, and why.

See also: Related Actions