AmbientAttributes.clippingImage
[与此页面关联的功能(Windows 媒体播放器 SDK)是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
clippingImage 属性指定或检索要将控件剪辑到的区域。
elementID.clippingImage
可能的值
此属性是一个读/写 字符串 ,指示图像文件名。 它没有默认值。
备注
clippingImage 属性支持 PNG、JPG、BMP 和 GIF 文件, (不包括动画 gif) 。 由于 JPG 是有损的,因此可能会发生意外的颜色更改,因此不建议将其用于剪辑图像。
如果只想显示控件图像的一部分,而不显示整个矩形区域,则此属性非常有用。 clippingColor 属性指示剪裁图像的区域,这些区域对应于控件的透明、不可单击的部分。 因此,控件可以是任何形状。 为了获得最佳结果,剪裁图像的大小应与控件图像大小相同。
PLAYLIST、VIEW 和 SUBVIEW 元素不支持 clippingImage 属性。 如果 VIDEO,剪裁图像将无法与 VIDEO 元素一起使用。windowless 设置为 false,如果 EFFECTS,则也设置为 EFFECTS 元素。windowed 设置为 true。
由于使用剪裁图像会产生性能损失,因此在效率问题时不应使用这些图像。
示例
有关演示此属性用法的示例,请参阅 BUTTONELEMENT.mappingColor 属性。
要求
要求 | 值 |
---|---|
版本 |
Windows 媒体播放器版本 7.0 或更高版本 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈