Windows Media Player 11 SDK Player Object 

Previous

Next

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.
dvd	Retrieves the DVD 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 value indicating whether the user is connected to a network.
isRemote *	Retrieves a value indicating whether the Windows Media Player control is running in remote mode.
mediaCollection	Retrieves the MediaCollection object.
network	Retrieves the Network object.
openState	Retrieves a value indicating the state of the content source.
playerApplication *	Retrieves the PlayerApplication object when a remoted Windows Media Player control is running.
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 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	Retrieves a String value specifying the version of the Windows Media Player.
windowlessVideo *	Specifies or retrieves a value indicating whether the Windows Media Player control renders video in windowless mode.

* Not accessible to skins.

The Player object supports the following methods.

Method	Description
close	Releases Windows Media Player resources.
launchURL	Sends a URL to the user's default browser to be rendered.
newMedia	Creates a new Media object.
newPlaylist	Creates a new Playlist object.
openPlayer	Opens Windows Media Player using the specified URL.

The Player object supports the following events. Events marked with an asterisk (*) are not accessible to skins. For information about handling mouse and keyboard events in skins, see External Events.

Event	Description
AudioLanguageChange	Occurs when the current audio language changes.
Buffering	Occurs when the Windows Media Player control begins or ends buffering.
CdromMediaChange	Occurs when a CD or DVD is inserted into or ejected from a CD or DVD drive.
Click *	Occurs when the user clicks a mouse button.
CurrentItemChange	Occurs when Controls.currentItem changes.
CurrentMediaItemAvailable	Occurs when a graphic metadata item in the current media item becomes available.
CurrentPlaylistChange	Occurs when something changes within the current playlist.
CurrentPlaylistItemAvailable	Occurs when the current playlist item becomes available.
Disconnect	Reserved for future use.
DomainChange	Occurs when the DVD domain changes.
DoubleClick *	Occurs when the user double-clicks a mouse button.
DurationUnitChange	Reserved for future use.
EndOfStream	Reserved for future use.
Error	Occurs when the Windows Media Player control has an error condition.
KeyDown *	Occurs when a key is pressed.
KeyPress *	Occurs when a key is pressed and then released.
KeyUp *	Occurs when a key is released.
MarkerHit	Occurs when a marker is reached.
MediaChange	Occurs when a media item changes.
MediaCollectionAttributeStringAdded	Occurs when an attribute value is added to the library.
MediaCollectionAttributeStringChanged	Occurs when an attribute value in the library is changed.
MediaCollectionAttributeStringRemoved	Occurs when an attribute value is removed from the library.
MediaCollectionChange	Occurs when the media collection changes.
MediaCollectionMediaAdded	Occurs when a media item is added to the local library.
MediaCollectionMediaRemoved	Occurs when a media item is removed from the local library.
MediaError	Occurs when the Media object has an error condition.
ModeChange	Occurs when a mode of Windows Media Player is changed.
MouseDown *	Occurs when a mouse button is pressed.
MouseMove *	Occurs when the mouse pointer is moved.
MouseUp *	Occurs when a mouse button is released.
NewStream	Reserved for future use.
OpenPlaylistSwitch	Occurs when a title on a DVD begins playing.
OpenStateChange	Occurs when the Windows Media Player control changes state.
PlaylistChange	Occurs when a playlist changes.
PlaylistCollectionChange	Occurs when something changes in the playlist collection.
PlaylistCollectionPlaylistAdded	Occurs when a playlist is added to the playlist collection.
PlaylistCollectionPlaylistRemoved	Occurs when a playlist is removed from the playlist collection.
PlaylistCollectionPlaylistSetAsDeleted	Reserved for future use.
PlayStateChange	Occurs when the play state of the Windows Media Player control changes.
PositionChange	Occurs when the current position of the media item has been changed.
ScriptCommand	Occurs when a synchronized command or URL is received.
StatusChange	Occurs when the status property changes value.
StringCollectionChange	Occurs when a string collection changes.
Warning	Reserved for future use.

* Not accessible to skins. For information about handling mouse and keyboard events in skins, see Ambient Event Handlers.

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

See Also

• Object Model Reference for Scripting

Previous

Next