位图类型

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

下表显示了对位图类型有效的值。 只需要背景类型;其他是可选的，与图像的不同可能用途相关。

值	说明
背景	必需。 所有按钮图像叠加的图像。 基本背景图像尺寸包括屏幕的完整宽度和高度。 这也是显示按钮和跟踪条自然状态图像的文件。 (按下和禁用的按钮不属于此映像。)
已禁用	必需。 指示按下按钮将不起作用。 定义当用户无法使用特定播放器功能时显示的图像。 必须提供坐标值以指示此图像相对于背景图像的左上角位置。
推	必需。 定义用户按下按钮时显示的图像。 使用“推送”在用户点击按钮时向用户提供视觉反馈。 必须提供坐标值以指示此图像相对于背景图像的左上角位置。
区域	定义使用彩色区域来表示点击类型按钮的点击响应区域的图像：PushHit、ToggleHit、2PushHit。 如果使用命中类型按钮，则必须提供区域图像。 此图像文件对每个控件使用特定的 Windows 调色板颜色。 这些颜色由表示该区域的红色、绿色和蓝色值的数字定义。 用户永远不会看到此图像。 还必须提供坐标值以指示此图像相对于背景图像的左上角位置。
SeekThumb	定义一个图像，该图像将与跟踪条结合使用以指示媒体项中的当前位置。 例如，如果歌曲已播放一半，SeekThumb 图像将显示在跟踪条的中间。 通过点击并拖动 SeekThumb 图像，用户可以在任何位置（称为 查找）重启媒体项。 跟踪条本身的图像在背景图像中定义。 SeekThumb 图像不包括在外观定义文件的“位图”部分中，而是指定为 TrackBars 部分中跟踪条定义的一部分。
超级	定义跟踪条的“已禁用”图像。 它还可以包含静音按钮的备用图像。
VolumeThumb	定义要与跟踪条一起使用以指示音量位置的图像。 通过点击并拖动 VolumeThumb 图像，用户可以更改音量级别。 跟踪条本身的图像在背景图像中定义。 VolumeThumb 图像不包括在外观定义文件的“位图”部分，但指定为 TrackBars 部分中跟踪条定义的一部分。

 

注意

区域和超级位图类型在 Windows 媒体播放器 10 Mobile 或更高版本的皮肤中已弃用。

 

请注意，文件名和文件类型不一定相同。 你可以根据需要调用“推送”文件，但在其他地方仍将其称为“已推送”。 例如，在“按钮”部分中，你将有一个项，例如：

Pushed @ 50,60

这指的是文件类型，而不是文件名。

相关主题

位图