区域文件

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

如果使用任何类型的点击按钮 (2PushHit、PushHit 或 ToggleHit) ,则需要区域文件。

区域文件用于定义将响应特定按钮上的点击(也称为点击)的区域。 对于每个点击按钮,区域位图中的一个区域都会获得特定的 Web 颜色 (,例如#FF0000,这是纯红色) 的值。 颜色编号在区域按钮定义中指定。 当用户显示外观时,按钮图像将使用区域位图中的坐标叠加到背景上。

例如,可以在对应于“下一步”按钮位置的位置绘制红色圆圈,并将其着色为纯红色 (#FF0000) 。 然后在按钮定义中,可以分配命中 RGB 值 255,0,0 (这相当于#FF0000) 的 RGB。 在这种情况下,“下一步”按钮仅响应红圈内点击 (点击) 。

如果要定义矩形以外的形状,则使用点击按钮。 仍必须为每个按钮定义坐标,以便可以正确定位推送和禁用等辅助映像。 实际上,每个按钮都由一个矩形绑定,这些虚构边界矩形不得重叠。

注意

Windows 媒体播放器 10 个移动外观中不需要区域艺术文件,因为 Windows 媒体播放器 10 移动版或更高版本不支持按钮类型。

 

下图是典型的区域文件。

region 文件

此文件定义每个点击类型按钮的皮肤部分。 每种颜色将按其颜色编号在外观定义文件的“按钮”部分进行标识。

艺术文件