Partager via


Windows Media Player Properties

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.

See Also

Windows Media Player Control

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.