PLAYER 元素

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer,而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]

PLAYER元素可讓您定義事件處理常式,並在設計階段在面板定義檔案內指定Player物件的URL屬性。 在腳本程式碼中, Player 物件是透過 player 全域屬性存取,而不是透過 ID 屬性所指定的名稱來存取, 而 PLAYER 元素不支援這個名稱。

PLAYER元素支援下列屬性。

屬性 描述
URL 指定或擷取要播放的檔案名。

 

PLAYER元素可以針對從Player物件引發的下列事件實作事件處理常式。

事件 描述
AudioLanguageChange 發生于目前的音訊語言變更時。
緩衝處理 發生于Windows 媒體播放機開始或結束緩衝時。
CdromMediaChange 發生于 CD 媒體變更時。
CurrentItemChange 發生于目前專案變更時。
CurrentMediaItemAvailable 當目前的媒體專案變成可用時發生。
CurrentPlaylistChange 發生于目前的播放清單變更時。
CurrentPlaylistItemAvailable 發生于目前的播放清單專案變成可用時。
DomainChange 發生于 DVD 網域變更時。
錯誤 發生于Windows 媒體播放機控制項有錯誤狀況時。
MarkerHit 發生于Windows 媒體播放機在剪輯中遇到標記時。
MediaChange 發生于媒體專案變更時。
MediaCollectionAttributeStringAdded 發生于將屬性值加入至程式庫時。
MediaCollectionAttributeStringChanged 發生于程式庫中的屬性值變更時。
MediaCollectionAttributeStringRemoved 發生于從程式庫移除屬性值時。
MediaCollectionChange 發生于 MediaCollection 物件變更時。
MediaError 發生于 Media 物件有錯誤狀況時。
ModeChange 在隨機和正常模式之間切換時發生。
OpenPlaylistSwitch 發生于 DVD 上的標題開始播放時。
OpenStateChange 發生于 播放程式時。openState 變更。
PlaylistChange 發生于播放清單變更時。
PlaylistCollectionChange 發生于播放清單集合中的某個專案變更時。
PlaylistCollectionPlaylistAdded 發生于將播放清單新增至播放清單集合時。
PlaylistCollectionPlaylistRemoved 發生于從播放清單集合中移除播放清單時。
PlayStateChange 發生于 播放程式時。playState 變更。
PositionChange 發生于 播放程式時。控制項currentPosition 變更。
ScriptCommand 發生于Windows 媒體播放機遇到內嵌在檔案中的指令碼命令時。
StatusChange 發生于 狀態 屬性變更值時。

 

Player 物件

面板程式設計參考