IDCompositionMatrixTransform::SetMatrixElement (int,int,IDCompositionAnimation*) 方法 (dcomp.h)

对此 2D 转换的矩阵中一个元素的值进行动画处理。

语法

HRESULT SetMatrixElement(
  [in] int                    row,
  [in] int                    column,
  [in] IDCompositionAnimation *animation
);

参数

[in] row

要更改的元素的行索引。 此值必须介于 0 和 2(含)之间。

[in] column

要更改的元素的列索引。 此值必须介于 0 和 1(含)之间。

[in] animation

表示指定元素的值如何随时间变化的动画。 此参数不能为 NULL。

返回值

如果函数成功,则返回S_OK。 否则,将返回 HRESULT 错误代码。 有关错误代码列表,请参阅 DirectComposition 错误代码。

备注

此方法创建指定动画的副本。 如果在调用此方法后更改 动画 参数引用的对象,则更改不会影响元素,除非再次调用此方法。 如果元素以前已创建动画,则调用此方法会将以前的动画替换为新动画。

如果 动画 是无效的指针,或者不是由与受影响的转换相同的 IDCompositionDevice 接口创建的,则此方法失败。 接口不能是自定义实现;只有 Microsoft DirectComposition 创建的接口才能与此方法一起使用。

要求

   
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 dcomp.h
Library Dcomp.lib
DLL Dcomp.dll

请参阅

IDCompositionMatrixTransform