Partager via


Windows Media Player Properties

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Windows Media Player provides a number of properties for use in monitoring and altering the state of the Player.

Following is a list of the properties exposed by the Windows Media Player.

Properties not supported are not listed. Unsupported properties can 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 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 the buffering time, which is the time allocated for buffering incoming data before playback begins.

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

Reference

Windows Media Player Control Reference