BUTTONGROUP 元素

  • 项目

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

BUTTONGROUP 元素提供了一种对外观中的多个按钮进行分组的方法。 可以使用 BUTTONELEMENT 元素作为 BUTTONGROUP 元素的子元素来指定这些按钮。

BUTTONGROUP 元素支持以下属性。

属性 说明
buttonCount 检索 BUTTONGROUP 中的按钮数。
cursor 指定或检索鼠标悬停在 BUTTONGROUP 中的按钮上时显示的光标类型。
disabledImage 指定或检索表示 BUTTONGROUP 中按钮的禁用状态的图像的名称。
downImage 指定或检索表示 BUTTONGROUP 的关闭状态的图像的名称。
hoverDownImage 指定或检索表示 BUTTONGROUP 中按钮的悬停状态的图像的名称。 当按钮处于向下状态并且用户用鼠标悬停在按钮上方时，将发生悬停状态。
hoverImage 指定或检索表示 BUTTONGROUP 中按钮的悬停状态的图像的名称。 当按钮处于向上状态，并且用户用鼠标悬停在按钮上时，会出现悬停状态。
hueShift 指定或检索 BUTTONGROUP 图像色调的移动量。
图像 指定或检索表示 BUTTONGROUP 按钮的图像的名称。
mappingImage 指定或检索表示 BUTTONGROUP 的按钮映射的图像的名称。
radio 指定或检索一个值，该值指示 BUTTONGROUP 是否由单选按钮组成。
saturation 指定或检索 BUTTONGROUP 图像的饱和度值。
showBackground 指定或检索一个值，该值指示 BUTTONGROUP 是仅显示按钮，还是显示 图像 属性中指定的完整位图。
transparencyColor 指定或检索 BUTTONGROUP 图像的透明颜色。

 

BUTTONGROUP 元素支持以下方法。

方法 说明
点击 使用指定的索引调用为 BUTTONELEMENT 定义的 onclick 事件处理程序。
getButton 检索具有指定索引的 BUTTONELEMENT 。

 

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

外观编程参考