IDCompositionEffectGroup::SetOpacity (IDCompositionAnimation*) 方法 (dcomp.h)
对 Opacity 属性的值进行动画处理。
语法
HRESULT SetOpacity(
[in] IDCompositionAnimation *animation
);
参数
[in] animation
表示不透明度属性值随时间变化的动画。 此参数不能为 NULL。
返回值
类型: HRESULT
如果函数成功,则返回S_OK。 否则,将返回 HRESULT 错误代码。 有关错误代码列表,请参阅 DirectComposition 错误代码。
注解
此方法创建指定动画的副本。 如果在调用此方法后更改 动画 参数引用的对象,则更改不会影响 Opacity 属性,除非再次调用此方法。 如果之前对 Opacity 属性进行了动画处理,则调用此方法会将以前的动画替换为新动画。
如果 动画 是无效的指针,或者不是由与受影响的合成效果组相同的 IDCompositionDevice 接口创建的,则此方法失败。 接口不能是自定义实现;只有 Microsoft DirectComposition 创建的接口才能与此方法一起使用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | dcomp.h |
Library | Dcomp.lib |
DLL | Dcomp.dll |