EFFECTS 元素

  • 项目

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

EFFECTS 元素提供了一种使用以下属性和方法组织和操作可视化效果的方法。 为方便起见，还提供了预定义 的 EFFECTS 元素。

EFFECTS 元素支持以下属性。

属性 描述
allowAll 指定或检索一个值，该值指示是否在注册表中包含所有可视化效果。
currentEffect 指定或检索当前可视化效果。
currentEffectPresetCount 检索当前可视化效果的可用预设数。
currentEffectTitle 检索当前可视化效果的显示标题。
currentEffectType 检索当前可视化效果的注册表名称。
currentPreset 指定或检索当前可视化效果的当前预设。
currentPresetTitle 检索当前可视化效果的当前预设的标题。
effectCanGoFullScreen 检索一个值，该值指示当前可视化效果是否可以全屏显示。
effectCount 检索可用可视化效果的数量。
effectHasPropertyPage 检索一个值，该值指示当前可视化效果是否具有属性页。
全屏 指定或检索一个值，该值指示当前可视化效果是否全屏显示。 只能在运行时设置。
windowed 指定或检索一个值，该值指示可视化效果是窗口化还是无窗口化，即控件的整个矩形是否随时可见，或者是否可以对其进行剪裁。 只能在设计时设置。

 

EFFECTS 元素支持以下方法。

方法 描述
effectTitle 检索具有指定注册表索引的可视化效果的友好名称。
effectType 检索具有指定注册表索引的可视化效果的注册表名称。
下一步 显示下一个可视化预设，如有必要，移动到下一个可视化效果。
nextEffect 显示下一个可视化效果的第一个预设，跳过中间预设。
nextPreset 显示当前可视化效果的下一个预设。
previous 显示上一个可视化预设，如有必要，移动到上一个可视化效果的最后一个预设。
previousEffect 显示上一个可视化效果，跳过预设。
previousPreset 显示当前可视化效果的上一个预设。
设置 显示当前可视化效果的属性页（如果存在）。

 

EFFECTS 元素支持环境属性，并且可以实现环境事件处理程序。 有关详细信息，请参阅 环境属性 和环境 事件处理程序。

预定义效果是默认指定的具有各种常见属性设置的普通 EFFECTS 元素。 以下预定义效果可用。

预定义效果 说明
WMPEFFECTS 循环访问可用效果的 EFFECTS 元素。

 

皮肤编程参考