通过

IDirectManipulationCompositor：：AddContent 方法 (directmanipulation.h)

  • 项目

将调用方) 拥有的内容 (与合成器相关联，为内容分配合成设备，并指定内容在合成树中相对于其他合成视觉对象的位置。

语法

HRESULT AddContent(
  [in]           IDirectManipulationContent *content,
  [in, optional] IUnknown                   *device,
  [in]           IUnknown                   *parentVisual,
  [in]           IUnknown                   *childVisual
);

参数

[in] content

要添加到合成树的内容。

内容 放置在合成树中的 parentVisual 和 childVisual 之间。

[in, optional] device

用于撰写内容的设备。

请注意，设备 由应用程序创建。
 

[in] parentVisual

要添加的内容的组合树中的父视觉对象。

parentVisual 还必须是合成树中的 childVisual 的父级。

[in] childVisual

要添加的内容的组合树中的子视觉对象。

parentVisual 还必须是合成树中的 childVisual 的父级。

返回值

如果方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

备注

此方法在父Visual 和子Visual之间插入一个直接操作设备拥有 () 的小型可视化树。 然后，可以将转换应用于插入的内容。

所有内容（无论类型如何）都必须添加到合成器。 可以是主要内容，通过调用 GetPrimaryContent 从视区获取，也可以是辅助内容（如通过调用 CreateContent 创建的平移指示器）。

如果应用程序使用系统提供的 IDirectManipulationCompositor：

  • device 必须是 IDCompositionDevice 对象，父视觉对象和子视觉对象必须是 IDCompositionVisual 对象。
  • device、 parentVisual 和 childVisual 不能为 NULL。
  • device、 parentVisual 和 childVisual 对象由应用程序创建和拥有。
  • 使用此方法将内容添加到合成树时，将在 parentVisual 和 childVisual 之间插入新的合成视觉对象。 在使用 RemoveContent 取消与合成器关联之前，不应销毁新视觉对象。
如果应用程序使用 IDirectManipulationCompositor 的自定义实现：
  • device、 parentVisual 和 childVisual 必须是合成器的有效类型。 它们不必是 IDCompositionDevice 或 IDCompositionVisual 对象。
  • device、 parentVisual 和 childVisual 可以为 NULL，具体取决于合成器。

要求

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

另请参阅

IDirectManipulationCompositor