IDirectManipulationCompositor2：：AddContentWithCrossProcessChaining 方法 (directmanipulation.h)

發行項
03/05/2024

將元件) 主機所擁有的內容 (與撰寫器產生關聯、將組合裝置指派給內容，並指定與其他組合視覺效果相對之組合樹狀結構中內容的位置。表示將操作內容與跨多個進程繪圖介面建立關聯的 Compositor 物件。

語法

HRESULT AddContentWithCrossProcessChaining(
  [in] IDirectManipulationPrimaryContent *content,
  [in] IUnknown                          *device,
  [in] IUnknown                          *parentVisual,
  [in] IUnknown                          *childVisual
);

參數

[in] content

要加入至組合樹狀結構的內容。

內容會放在組合樹狀結構中的 parentVisual 和 childVisual 之間。

只有與檢視區同時建立的主要內容有效。

[in] device

用來撰寫內容的裝置。

請注意，應用程式 會建立裝置。

[in] parentVisual

要新增之內容組合樹狀結構中的父視覺效果。

parentVisual 也必須是組合樹狀結構中 childVisual 的父系。

[in] childVisual

要新增之內容組合樹狀結構中的子視覺效果。

parentVisual 也必須是組合樹狀結構中 childVisual 的父系。

傳回值

如果方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法會在父項Visual 與 childVisual 之間插入直接操作裝置所擁有的小型可視化 (樹狀結構 ) 。轉換接著可以套用至插入的內容。

不論類型為何，所有內容都必須新增至撰寫器。

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

device 必須是 IDCompositionDevice 物件，父視覺效果和子視覺效果必須是 IDCompositionVisual 物件。
device、 parentVisual 和 childVisual 不能是 NULL。
裝置、 parentVisual 和 childVisual 物件是由應用程式建立和擁有。
使用此方法將內容新增至組合樹狀結構時，會在 parentVisual 和 childVisual之間插入新的組合視覺效果。在取消與 Compositor 與 RemoveContent 的關聯之前，不應該終結新的視覺效果。

如果應用程式使用 IDirectManipulationCompositor 的自訂實作：

device、 parentVisual 和 childVisual 必須是撰寫器的有效類型。它們不需要是 IDCompositionDevice 或 IDCompositionVisual 物件。
裝置、 parentVisual 和 childVisual 可以是 NULL，視撰寫器而定。