Windows Media Player SDK banner art
PreviousNext

Player Object

The Player object is the root object for the Windows Media Player control. It supports the properties, methods, and events listed in the following tables.

The Player object supports the following properties. Properties marked with an asterisk (*) are not accessible to skins.

Property Description
cdromCollection Retrieves the CdromCollection object.
closedCaption Retrieves the ClosedCaption object.
controls Retrieves the Controls object.
currentMedia Specifies or retrieves the current Media object.
currentPlaylist Specifies or retrieves the current Playlist object.
enableContextMenu * Specifies or retrieves a value indicating whether to enable the context menu, which appears when the right mouse button is clicked.
enabled * Specifies or retrieves a value indicating whether the Windows Media Player control is enabled.
error Retrieves the Error object.
fullScreen * Specifies or retrieves a value indicating whether video content is played back in full-screen mode.
isOnline Retrieves a Boolean value indicating whether the user is connected to a network.
mediaCollection Retrieves the MediaCollection object.
network Retrieves the Network object.
openState Returns a value indicating the state of the content source.
playlistCollection Retrieves the PlaylistCollection object.
playState Retrieves a value indicating the state of the Windows Media Player operation.
settings Retrieves the Settings object.
status Retrieves a value indicating the current status of the Windows Media Player.
stretchToFit Specifies or retrieves a value indicating whether video will stretch to fit size of the Windows Media Player control video display.
uiMode * Specifies or retrieves a value indicating which controls are shown in the user interface when Windows Media Player is embedded in a Web page.
URL Specifies or retrieves the name of the clip to play.
versionInfo Returns a String value specifying the version of the Windows Media Player.

* Not accessible to skins.

The Player object supports the following methods.

Method Description
close Closes the Windows Media Player.
launchURL Sends a URL to the user’s default browser to be rendered.

The Player object supports the following events.

Event Description
buffering Occurs when the Windows Media Player control begins or ends buffering.
currentItemChange Occurs when Controls.currentItem changes.
currentPlaylistChange Occurs when the current playlist changes.
disconnect Reserved for future use.
error Occurs when the Windows Media Player control has an error condition.
markerHit Occurs when a marker is reached.
mediaChange Occurs when a media item changes.
mediaCollectionChange Occurs when the media collection changes.
modeChange Occurs when a mode of the player is changed.
openStateChange Occurs when the Windows Media Player control changes state.
playlistChange Occurs when a playlist changes.
playStateChange Occurs when the play state of the Windows Media Player control changes.
positionChange Occurs when the current position of the movie has changed.
scriptCommand Occurs when a synchronized command or URL is received.
statusChange Occurs when the status property changes value.

When embedded in a Web page, the Player object can be accessed using the ID value specified in the OBJECT tag. Within a skin definition file, it is accessed using the player global attribute. For illustration purposes in the reference syntax sections, player will be used as the object ID.

PreviousNext


© 2000-2001 Microsoft Corporation. All rights reserved.