Player 物件

Player 物件是 Windows Media Player 控制項的根物件。 它支援下表所列的屬性、方法和事件。

Player 物件支援下列屬性。 以星號 () 標記的屬性 * 無法供面板存取。

屬性 描述
cdromCollection 抓取 CdromCollection 物件。
closedCaption 抓取 ClosedCaption 物件。
控制 抓取 控制項 物件。
currentMedia 指定或抓取目前的 媒體 物件。
currentPlaylist 指定或抓取目前的 播放清單 物件。
Dvd 抓取 DVD 物件。
enableCoNtextMenu* 指定或抓取值,指出是否要啟用操作功能表,這會在按下滑鼠右鍵時顯示。
已啟用* 指定或抓取值,指出是否已啟用 Windows Media Player 控制項。
error 捕獲 Error 物件。
全螢幕* 指定或抓取值,指出是否以全螢幕模式播放影片內容。
isOnline 抓取值,指出使用者是否已連接到網路。
isRemote* 抓取值,指出 Windows Media Player 控制項是否正在遠端模式中執行。
mediaCollection 抓取 MediaCollection 物件。
網路 抓取 Network 物件。
openState 抓取值,指出內容來源的狀態。
playerApplication* 當遠端 Windows Media Player 控制項正在執行時,會抓取PlayerApplication物件。
playlistCollection 抓取 PlaylistCollection 物件。
playState 抓取值,指出 Windows Media Player 操作的狀態。
設定 抓取設定物件。
status 抓取值,指出 Windows Media Player 的目前狀態。
stretchToFit* 指定或抓取值,指出影片是否會延展以符合 Windows Media Player 控制項影片顯示的大小。
uiMode* 指定或抓取值,指出當 Windows Media Player 內嵌在網頁中時,使用者介面中所顯示的控制項。
URL 指定或抓取要播放之剪輯的名稱。
versionInfo 抓取指定 Windows Media Player 版本的字串值。
windowlessVideo* 指定或抓取值,指出 Windows Media Player 控制項是否以無視窗模式呈現影片。

* 無法存取外觀。

Player 物件支援下列方法。

方法 描述
close 釋放 Windows Media Player 資源。
launchURL 將 URL 傳送給使用者的預設瀏覽器,以進行轉譯。
newMedia 建立新的 媒體 物件。
[] 建立新的 播放清單 物件。
openPlayer 使用指定的 URL 開啟 Windows Media Player。

Player 物件支援下列事件。 以星號 () 標記的事件 * 無法供面板存取。 如需在面板中處理滑鼠和鍵盤事件的相關資訊,請參閱 外來事件

事件 描述
AudioLanguageChange 發生于目前的音訊語言變更時。
緩衝處理 當 Windows Media Player 控制項開始或結束緩衝時發生。
CdromMediaChange 從 CD 或 DVD 光碟機插入或退出 CD 或 DVD 時發生。
按一下 * 發生于使用者按一下滑鼠按鍵時。
CurrentItemChange 發生于 控制項 時。currentItem 變更。
CurrentMediaItemAvailable 發生于目前媒體專案中的圖形中繼資料專案變成可用時。
CurrentPlaylistChange 發生于目前的播放清單中發生某個變更時。
CurrentPlaylistItemAvailable 發生于目前的播放清單專案變成可用時。
中斷連線 保留供未來使用。
DomainChange 發生于 DVD 網域變更時。
DoubleClick* 發生于使用者按兩下滑鼠按鍵時。
DurationUnitChange 保留供未來使用。
EndOfStream 保留供未來使用。
錯誤 當 Windows Media Player 控制項有錯誤條件時發生。
KeyDown * 發生於按下按鍵時。
按鍵* 發生于按下並放開按鍵時。
KeyUp * 發生於放開按鍵時。
MarkerHit 當到達標記時發生。
MediaChange 發生于媒體專案變更時。
MediaCollectionAttributeStringAdded 當屬性值新增至程式庫時發生。
MediaCollectionAttributeStringChanged 發生于程式庫中的屬性值變更時。
MediaCollectionAttributeStringRemoved 從程式庫移除屬性值時發生。
MediaCollectionChange 發生于媒體集合變更時。
MediaCollectionMediaAdded 當媒體專案加入至本機程式庫時發生。
MediaCollectionMediaRemoved 當媒體專案從本機程式庫中移除時發生。
MediaError 發生于 媒體 物件有錯誤狀況時。
ModeChange 當 Windows Media Player 模式變更時發生。
MouseDown* 發生于按下滑鼠按鍵時。
MouseMove* 發生于移動滑鼠指標時。
MouseUp* 發生于放開滑鼠按鍵時。
NewStream 保留供未來使用。
OpenPlaylistSwitch 發生于 DVD 上的標題開始播放時。
OpenStateChange 當 Windows Media Player 控制項變更狀態時發生。
PlaylistChange 當播放清單變更時發生。
PlaylistCollectionChange 發生于播放清單集合中的某些變更時。
PlaylistCollectionPlaylistAdded 當播放清單新增至播放清單集合時發生。
PlaylistCollectionPlaylistRemoved 從播放清單集合移除播放清單時發生。
PlaylistCollectionPlaylistSetAsDeleted 保留供未來使用。
PlayStateChange 當 Windows Media Player 控制項的播放狀態變更時發生。
PositionChange 當媒體專案目前的位置已變更時發生。
ScriptCommand 當收到同步處理的命令或 URL 時發生。
StatusChange status 屬性變更值時發生。
StringCollectionChange 當字串集合變更時發生。
警告 保留供未來使用。

* 無法存取外觀。 如需有關在外觀中處理滑鼠和鍵盤事件的詳細資訊,請參閱 環境事件處理常式

內嵌在網頁中時,可以使用物件標記中指定的識別碼值來存取 Player 物件。 在面板定義檔中,它是使用 media player 全域屬性來存取。 為了方便說明,在參考語法區段中,會使用 player 作為物件識別碼。

另請參閱

腳本的物件模型參考