Windows Media Player Properties

Article
06/30/2006

Windows Media Player provides a number of properties for use in monitoring and altering the state of the Player. A list of the properties exposed by the Windows Media Player is included below. Properties not supported are not listed below. Unsupported properties may be accessed, but their values are not meaningful, and manipulating them will have no effect.

Property	Access	Description
AllowChangeDisplaySize	Read/Write	Sets or retrieves a value specifying whether the display size can be changed.
AllowHideControls	Read/Write	Indicates whether the end-user can hide the control panel at run time.
AllowScan	Read/Write	Sets or retrieves a value specifying whether scanning is enabled for files that support scanning (fast-forwarding and rewinding).
AudioStream	Read/Write	Sets or retrieves a value specifying the stream number of the current audio stream.
AutoRewind	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control automatically returns to the clip's starting point after the clip finishes playing or has otherwise stopped.
AutoSize	Read/Write	Sets or retrieves a value indicating whether the Windows Media Player control automatically sizes to the proportions of the original media rendered at the current display size.
AutoStart	Read/Write	Sets or retrieves a value specifying whether to start playing the clip automatically.
Balance	Read/Write	Sets or retrieves a value indicating the stereo balance.
Bandwidth	Read-only	Retrieves the bandwidth of the current clip in bits per second.
BaseURL	Read-only	Retrieves a value specifying the base URL.
BufferingCount	Read-only	Retrieves a value specifying the number of times buffering occurred during playback of a clip.
BufferingProgress	Read-only	Retrieves a value specifying the percentage of buffering completed.
BufferingTime	Read-only	Retrieves a value specifying the buffering time in seconds.
CanScan	Read-only	Retrieves a value specifying whether the current file supports scanning.
CanSeek	Read-only	Retrieves a value specifying whether the current file has the ability to seek to a specific time.
CanSeekToMarkers	Read-only	Retrieves a value specifying whether markers in the file can be located with a seek operation.
ChannelDescription	Read-only	Retrieves a value representing the station description.
ChannelName	Read-only	Retrieves a value representing the station name.
ChannelURL	Read-only	Retrieves a value representing the URL of the station metafile.
ClickToPlay	Read/Write	Sets or retrieves a value specifying whether the user can toggle playback by clicking the video image.
CodecCount	Read-only	Retrieves the number of installable codecs used by the current clip.
ContactAddress	Read-only	Retrieves a value representing the station's contact address.
ContactEmail	Read-only	Retrieves a value representing the station's e-mail address.
ContactPhone	Read-only	Retrieves a value representing the station's contact telephone number.
CreationDate	Read-only	Retrieves a value specifying the date and time when the clip was created.
CurrentMarker	Read/Write	Sets or retrieves a value indicating the current marker number.
CurrentPosition	Read/Write	Sets or retrieves a value representing the clip's current position, in seconds.
CurrentState	Read-only	Specifies the playback file's current state: stopped, paused, or running.
DefaultFrame	Read/Write	Sets or retrieves a value representing the default target HTTP frame.
DisplayBackColor	Read/Write	Sets or retrieves a value specifying the display panel's background color.
DisplayForeColor	Read/Write	Sets or retrieves a value specifying the display panel's foreground color.
DisplaySize	Read/Write	Sets or retrieves a value specifying the size of the image display window.
Duration	Read-only	Retrieves a value indicating the clip's playing time in seconds.
Enabled	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control is enabled.
EnablePositionControls	Read/Write	Sets or retrieves a value specifying whether the position controls are enabled on the control bar.
EnableTracker	Read/Write	Sets or retrieves a value specifying whether the trackbar control is enabled.
EntryCount	Read-only	Returns the number of entries contained in the current Advanced Stream Redirector (ASX) file.
ErrorCode	Read-only	Retrieves a value specifying the current error code.
ErrorCorrection	Read-only	Retrieves a value specifying the error correction type of the current clip.
ErrorDescription	Read-only	Retrieves a value specifying the description of the current error state.
FileName	Read/Write	Sets or retrieves a value specifying the name of the clip to play.
FullScreenMode	Read/Write	Expands the area of the playback panel to fill the entire screen.
GetMoreInfoURL	Read-only	Retrieves a URL to additional information about the presentation.
HasError	Read-only	Retrieves a value specifying whether the Windows Media Player control currently has an error.
HasMultipleItems	Read-only	Retrieves a value specifying whether the current clip contains multiple items (playlists).
ImageSourceHeight	Read-only	Retrieves a value specifying the original image height of the current clip, in pixels.
ImageSourceWidth	Read-only	Retrieves a value specifying the original image width of the current clip, in pixels.
InvokeURLs	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control automatically invokes URLs in a browser (URL flipping).
IsBroadcast	Read-only	Retrieves a value specifying whether the source is broadcast.
IsDurationValid	Read-only	Retrieves a value specifying whether the value of the Duration property is valid.
Language	Read/Write	Sets or retrieves a value specifying the current locale used for national language support.
LostPackets	Read-only	Retrieves a value specifying the number of packets lost during transmission of the stream.
MarkerCount	Read-only	Retrieves a value specifying the number of markers in the current clip.
MovieWindowSize	Read/Write	Specifies the size of the playback panel.
Mute	Read/Write	Sets or retrieves a value indicating the current mute state of the Windows Media Player control.
OpenState	Read-only	Retrieves a value indicating the state of the content source.
PlayCount	Read/Write	Sets or retrieves a value indicating the number of times a clip plays.
PlayState	Read-only	Retrieves a value indicating the state of the Windows Media Player operation.
Rate	Read/Write	Sets or retrieves a value specifying the clip's playback rate.
ReadyState	Read-only	Retrieves a value specifying the state of readiness of the Windows Media Player control.
ReceivedPackets	Read-only	Retrieves a value specifying the number of packets received.
ReceptionQuality	Read-only	Retrieves a value specifying the percentage of packets received in the last 30 seconds.
RecoveredPackets	Read-only	Retrieves a value specifying the number of packets recovered.
SelectionEnd	Read/Write	Sets or retrieves a value specifying the time when playback of the current clip will stop.
SelectionStart	Read/Write	Sets or retrieves a value specifying where playback of the current clip will begin.
SendErrorEvents	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control sends error events.
SendKeyboardEvents	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control sends keyboard events.
SendMouseClickEvents	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control sends mouse click events.
SendMouseMoveEvents	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control sends mouse move events.
SendOpenStateChangeEvents	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control sends open state change events.
SendPlayStateChangeEvents	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control sends play state change events.
ShowAudioControls	Read/Write	Sets or retrieves a value specifying whether the audio controls appear on the control bar.
ShowControls	Read/Write	Sets or retrieves a value specifying whether the control bar is visible.
ShowPositionControls	Read/Write	Sets or retrieves a value specifying whether the control bar is visible.
ShowStatusBar	Read/Write	Sets or retrieves a value specifying whether the status bar is visible.
ShowTracker	Read/Write	Sets or retrieves a value specifying whether the trackbar is visible.
SourceLink	Read-only	Retrieves a value specifying the path to the current clip.
SourceProtocol	Read-only	Retrieves a value specifying the protocol used to receive data.
StreamCount	Read-only	Retrieves a value indicating the number of media streams in the current clip.
TransparentAtStart	Read/Write	Sets or retrieves a value specifying whether the Windows Media Player control is transparent before play begins.
VideoBorder3D	Read/Write	Sets or retrieves a value specifying whether the three-dimensional video border effect is enabled.
VideoBorderColor	Read/Write	Sets or retrieves a value specifying the color of the video border.
VideoBorderWidth	Read/Write	Sets or retrieves a value specifying the width of the video border, in pixels.
Volume	Read/Write	Sets or retrieves a value specifying the volume, in hundredths of decibels.

Windows Media Player Properties

See Also

Additional resources