SLIDER 元素

  • 發行項

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

SLIDER元素可讓您建立及操作簡單的水準或垂直滑杆控制項。 它支援下列屬性和事件處理常式。 為了方便起見，也會提供預先定義的 SLIDER 元素。

SLIDER元素支援下列屬性。

屬性 描述
backgroundColor 指定或擷取滑杆控制項的背景色彩。
backgroundEndColor 指定或擷取滑杆控制項的背景結束色彩。
backgroundHoverImage 指定或擷取滑鼠停留在滑杆上方時所顯示的背景影像。
backgroundImage 指定或擷取滑杆的預設背景影像。
borderSize 以圖元指定或擷取框線大小。
cursor 指定或擷取值，指出當滑鼠停留在滑杆控制項上方時，會出現哪種類型的游標。
direction 指定或擷取滑杆影像配置的方向。
disabledColor 指定或擷取滑杆控制項的停用色彩。
disabledImage 指定或擷取停用控制項時出現的滑杆影像。
foregroundColor 指定或擷取滑杆控制項的前景色彩。
foregroundEndColor 指定或擷取滑杆控制項的前景結束色彩。
foregroundHoverImage 指定或擷取滑鼠停留在滑杆上時顯示的前景影像。
foregroundImage 指定或擷取滑杆的預設前景影像。
foregroundProgress 指定或擷取前景進度列的目前位置，以滑杆區域的百分比表示。
max 指定或擷取滑杆控制項所定義之範圍的最大值。
min 指定或擷取滑杆控制項所定義範圍的最小值。
幻燈片 指定或擷取值，指出前景影像是否投影到背景影像上。
thumbDisabledImage 指定或擷取滑杆控制項的停用指紋影像。
thumbDownImage 指定或擷取代表指紋向下狀態的影像。
thumbHoverImage 指定或擷取滑鼠停留在它上方時所顯示的指紋影像。
thumbImage 指定或擷取將用來代表滑杆目前位置的影像。
平鋪 指定或擷取值，指出是否要並排滑杆影像。
提示 指定或擷取滑杆控制項的工具提示文字。
transparencyColor 指定或擷取滑杆影像的透明色彩。
useForegroundProgress 指定或擷取值，指出是否要使用前景進度列。
value 指定並擷取滑杆的目前位置。

 

SLIDER元素可以實作下列事件處理常式。

事件處理常式 描述
onDragBegin 處理當使用者按一下並按住滑鼠左鍵並開始拖曳滑鼠時所發生的事件。
onDragEnd 處理在拖曳作業之後放開滑鼠左鍵時所發生的事件。
onPositionChange 處理當滑杆位置因使用者按一下或拖曳而變更時所發生的事件。

 

SLIDER元素支援環境屬性，並可實作環境事件處理常式。 如需詳細資訊，請參閱 環境屬性 和環境 事件處理常式。

預先定義的滑杆是預設指定各種通用屬性設定的一般 SLIDER 元素。 下列預先定義的滑杆可供使用。

預先定義的 SLIDER 描述
BALANCESLIDER 用來設定音訊平衡的 SLIDER 。
SEEKSLIDER 用來搜尋媒體檔案內任何位置的 SLIDER 。
VOLUMESLIDER 用來設定音訊音量的 SLIDER 。

 

面板程式設計參考