BUTTON 元素

  • 项目

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

BUTTON 元素提供了一种在外观中创建按钮的方法。 下面的属性可用于自定义按钮的行为，或者预定义的按钮可用于方便起见。

BUTTON 元素支持以下属性。

Attribute 说明
cursor 指定或检索鼠标指针悬停在 BUTTON 上时显示的光标。
disabledImage 指定或检索禁用 BUTTON 时显示的图像。
down 指定或检索一个值，该值指示 BUTTON 是处于向上还是向下位置。
downImage 指定或检索表示 BUTTON 的关闭状态的图像。
downToolTip 指定或检索当鼠标悬停在 BUTTON 上且 BUTTON 处于向下或按下状态时出现的工具提示文本。
hoverDownImage 指定或检索 当 BUTTON 处于向下状态且用户用鼠标指针悬停在按钮上方时显示的图像。
hoverImage 指定或检索 BUTTON 处于向上状态且用户用鼠标指针悬停在按钮上方时显示的图像。
图像 指定或检索 BUTTON 的默认图像。
粘 指定或检索一个值，该值指示 BUTTON 是切换按钮，即是双状态按钮还是单状态按钮。
平铺 指定或检索一个值，该值指示是否对 BUTTON 图像进行平铺。
transparencyColor 指定或检索 将在 BUTTON 图像中透明的颜色。
upToolTip 指定或检索当鼠标悬停在 BUTTON 上且 BUTTON 处于向上状态时出现的工具提示文本。

 

BUTTON 元素支持环境属性，并且可以实现环境事件处理程序。 有关详细信息，请参阅 环境属性 和环境 事件处理程序。

预定义按钮是具有默认指定的各种通用属性设置的普通 BUTTON 元素。 以下预定义按钮可用。

预定义按钮 说明
CLOSEBUTTON 用于关闭播放器的 BUTTON 。
FFWDBUTTON 单击时，具有对 player.controls.fastForward 的内置调用的 BUTTON。
IMAGEBUTTON 用于显示图像的 BUTTON 。
MINIMIZEBUTTON 用于最小化播放器的 BUTTON 。
MUTEBUTTON 用于将音频静音和取消静音的 BUTTON 。
NEXTBUTTON 单击时具有对 player.controls.next 的内置调用的 BUTTON。
PAUSEBUTTON 单击时具有对 player.controls.pause 的内置调用的 BUTTON。
PLAYBUTTON 单击时具有对 player.controls.play 的内置调用的 BUTTON。
PREVBUTTON 单击时具有对 player.controls.previous 的内置调用的 BUTTON。
REPEATBUTTON 切换“重复”选项的 BUTTON 。
RETURNBUTTON 将Windows 媒体播放器返回到媒体中心的 BUTTON。
REWBUTTON 单击时具有对 player.controls.fastReverse 的内置调用的 BUTTON。
SHUFFLEBUTTON 切换“随机”选项的 BUTTON 。
STOPBUTTON 一个 按钮 ，在单击时内置调用 player.controls.stop 。

 

外观编程参考