次の方法で共有

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 とコンポジターとの関連付けが解除されるまで破棄しないでください。
アプリケーションで IDirectManipulationCompositor のカスタム実装を使用する場合:
  • device、 parentVisual、および childVisual は、コンポジターの有効な型である必要があります。 IDCompositionDevice オブジェクトまたは IDCompositionVisual オブジェクトである必要はありません。
  • device、 parentVisual、 childVisual は、コンポジターに応じて NULL にすることができます。

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー directmanipulation.h

関連項目

IDirectManipulationCompositor