SLIDER 元素

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

SLIDER 元素提供了一种创建和操作简单水平或垂直滑块控件的方法。 它支持以下属性和事件处理程序。 为方便起见，还提供了预定义 的 SLIDER 元素。

SLIDER 元素支持以下属性。

Attribute 说明
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 元素。 以下预定义滑块可用。

预定义滑块 说明
BALANCESLIDER 用于设置音频平衡的 滑块 。
SEEKSLIDER 用于查找媒体文件中任何位置的 滑块 。
VOLUMESLIDER 用于设置音频音量的 滑块 。

 

皮肤编程参考