BUTTONGROUP.mappingImage

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

mappingImage 属性指定或检索表示 BUTTONGROUP 的按钮映射的图像的名称。

        elementID.mappingImage

可能的值

此属性是读/写 字符串。

备注

这是必须指定的必需属性。

映射图像的尺寸应与main图像相同。 它是main图像的可单击区域的地图。 通过使用不同的颜色填充每个可单击区域来构造地图。

定义每个 BUTTONELEMENT 时，请使用 mappingColor 属性从地图中指定其颜色。 例如，如果在main图像中有一个停止标志形状的按钮图形，则可以创建一个地图，其中标志的区域为红色。 然后，必须将 BUTTONELEMENT 属性指定为红色，以使停止符号图像可单击。

支持的图像格式为 BMP、JPG、PNG 和 GIF (不包括动画 GIF) 。 由于 JPG 是有损的，因此可能会发生意外的颜色更改，因此不建议将其用于映射图像。

示例

下图是 mappingImage 及其对应的可见图像的示例。 这些图像是 SDK 随附的 Tiny 文件夹中外观的一部分。

请参阅 BUTTONELEMENT。演示如何使用此属性的代码示例的 mappingColor 属性。

要求

要求	值
版本	Windows 媒体播放器版本 7.0 或更高版本

另请参阅

BUTTONELEMENT.mappingColor

BUTTONGROUP 元素

BUTTONGROUP.image

BUTTONGROUP.transparencyColor