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 エラー コードを返します。

解説

このメソッドは、parentVisual と childVisual の間に小さなビジュアル ツリー (直接操作デバイスが所有) を挿入します。 その後、挿入されたコンテンツに変換を適用できます。

種類に関係なく、すべてのコンテンツをコンポジターに追加する必要があります。 これは、 GetPrimaryContent を呼び出してビューポートから取得したプライマリ コンテンツ、または CreateContent を呼び出して作成されたパン インジケーターなどのセカンダリ コンテンツです。

アプリケーションでシステム提供の IDirectManipulationCompositor を使用する場合:

• device は IDCompositionDevice オブジェクトである必要があり、親ビジュアルと子ビジュアルは IDCompositionVisual オブジェクトである必要があります。
• device、 parentVisual、 childVisual を NULL にすることはできません。
• device、 parentVisual、 childVisual オブジェクトは、アプリケーションによって作成および所有されます。
• このメソッドを使用してコンポジション ツリーにコンテンツを追加すると、 parentVisual と childVisual の間に新しいコンポジション ビジュアルが挿入されます。 新しいビジュアルは、 RemoveContent とコンポジターとの関連付けが解除されるまで破棄しないでください。

• device、 parentVisual、および childVisual は、コンポジターの有効な型である必要があります。 IDCompositionDevice オブジェクトまたは IDCompositionVisual オブジェクトである必要はありません。
• device、 parentVisual、 childVisual は、コンポジターに応じて NULL にすることができます。

要件

関連項目

IDirectManipulationCompositor