BUTTONELEMENT 元素

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

BUTTONELEMENT元素會在父BUTTONGROUP元素內定義單一按鈕。 它支援下列屬性。 也提供預先定義的 BUTTONELEMENT 元素,方便使用。

BUTTONELEMENT元素支援下列屬性。

屬性 描述
cursor 指定或擷取當滑鼠位於BUTTONELEMENT上方時出現的BUTTONELEMENT游標值。
向下 指定或擷取 BUTTONELEMENT的向上或向下值。
downToolTip 指定或擷取當滑鼠位於 BUTTONELEMENT 上方且 BUTTONELEMENT 處於向下狀態時出現的工具提示文字。
index 擷取BUTTONGROUP內的BUTTONELEMENT索引。
mappingColor 指定或擷取色彩索引鍵,以識別 BUTTONELEMENT 群組中的這個 BUTTONELEMENT
指定或擷取值,指出 BUTTONELEMENT 是否黏性。 黏性時, BUTTONELEMENT 會在按一下之後變更狀態,並維持在新狀態中,直到再次按一下為止。
upToolTip 指定或擷取當滑鼠超過 BUTTONELEMENTBUTTONELEMENT 處於向上或作用中狀態時出現的工具提示文字。

 

BUTTONELEMENT元素支援下列方法。

方法 描述
點擊 呼叫針對BUTTONELEMENT定義的onclick事件處理常式。

 

BUTTONELEMENT元素可以實作環境事件處理常式。 如需詳細資訊,請參閱 環境事件處理常式

BUTTONELEMENT元素支援下列環境屬性:enabledtabStop

預先定義的效果是一般 EFFECTS 元素,預設會指定各種通用屬性設定。 下列預先定義的 BUTTONELEMENT 元素可供使用。

預先定義的 BUTTONELEMENT 描述
FFWDELEMENT 具有內建onclick事件處理常式的BUTTONELEMENT,可呼叫player.controls.fastForward
NEXTELEMENT BUTTONELEMENT,內建onclick事件處理常式會呼叫player.controls.next
PAUSEELEMENT 具有內建onclick事件處理常式的BUTTONELEMENT,可呼叫player.controls.pause
PLAYELEMENT 具有內建onclick事件處理常式的BUTTONELEMENT,可呼叫player.controls.play
PREVELEMENT BUTTONELEMENT,內建onclick事件處理常式會呼叫player.controls.previous
REWELEMENT 具有內建onclick事件處理常式的BUTTONELEMENT,可呼叫player.controls.rewind
STOPELEMENT 具有內建onclick事件處理常式的BUTTONELEMENT,可呼叫player.controls.stop

 

面板程式設計參考