共用方式為

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 與 childVisual之間) 直接操作裝置所擁有的小型視覺化樹狀結構 (插入。 轉換接著可以套用至插入的內容。

不論 類型為何，所有內容都必須新增至撰寫器。 這可以是從檢視區取得的主要內容，方法是呼叫 GetPrimaryContent或次要內容，例如呼叫 CreateContent所建立的移動流覽指標。

如果應用程式使用系統提供的 IDirectManipulationCompositor：

  • device 必須是 IDCompositionDevice 物件，而父視覺效果和子視覺效果必須是 IDCompositionVisual 物件。
  • device、 parentVisual和 childVisual 不能是 Null。
  • 裝置、 parentVisual和 childVisual 物件是由應用程式所建立和擁有。
  • 使用此方法將內容新增至組合樹狀結構時，會在 parentVisual 和 childVisual之間插入新的組合視覺效果。 在取消與 Compositor 與 RemoveContent的關聯之前，不應該終結新的視覺效果。
如果應用程式使用 IDirectManipulationCompositor的自訂實作：
  • device、 parentVisual和 childVisual 必須是撰寫器的有效類型。 它們不需要是 IDCompositionDevice 或 IDCompositionVisual 物件。
  • 根據撰寫器而定，device、 parentVisual和 childVisual 可以是 Null。

需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 directmanipulation.h

另請參閱

IDirectManipulationCompositor