按钮类型

  • 项目

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

按钮有两种常规类型：位置和区域。 每个常规类型都有三种特定类型，共提供六种按钮类型。

注意

Windows 媒体播放器 10 移动版或更高版本的皮肤中已弃用按钮类型。

 

位置按钮类型

位置按钮使用坐标来定义其相对于背景的位置。 下表显示了对位置按钮类型有效的值。 无需为皮肤中不使用的类型定义值。

值 说明
推送 定义触发事件一次的按钮。 每次必须按下按钮才能触发更多事件。 例如，移动到播放列表中的下一项的按钮。 按钮的位置由其坐标定义。
切换 定义一个按钮，该按钮触发更改状态的事件。 该状态一直保持，直到再次按下按钮。 例如，用于随机播放播放列表的按钮。 播放列表处于无序状态后，它将保持随机状态，直到再次按下按钮。 按钮的位置由其坐标定义。
2Push 定义一个按钮，该按钮触发事件，然后更改为已准备好触发其他事件的状态。 每次按下按钮时都会切换这两种状态。 例如，使用 PlayPause 函数在播放和暂停当前媒体项之间切换的按钮。 首次按下按钮时，将触发主要播放状态，并显示辅助图像以指示可以触发 Pause 事件。 再次按下按钮时，将触发暂停状态，并显示原始图像以指示可以触发 Play 事件。 按钮的位置由其坐标定义。

 

区域按钮类型

区域按钮使用区域图像中的颜色区域来定义特定按钮的点击处理位置。 下表显示了对区域按钮类型有效的值。 无需为皮肤中不使用的类型定义值。

值 说明
PushHit 类似于“推送”按钮值，只不过按钮的命中区域由区域图像中的颜色值定义。
ToggleHit 类似于“切换”按钮值，只不过按钮的命中区域由区域图像中的颜色值定义。
2PushHit 类似于 2Push 按钮值，只不过按钮的命中区域由区域图像中的颜色值定义。

 

按钮