IDirectManipulationCompositor2

複数のプロセスにまたがって、操作対象のコンテンツを描画サーフェスに関連付けるコンポジターオブジェクトを表します。

IDirectManipulationCompositor2 のカスタム実装では、Direct Manipulation ビューポートのコンテンツを、入力イベント中に手動で更新する必要があります。ビューポート内のコンテンツを再描画するには Update を呼び出します。

ビューポートに手動モードを指定するには、次のいずれかの関数を呼び出します。

• SetViewportOptions を、DIRECTMANIPULATION_VIEWPORT_OPTIONS_MANUALUPDATE を指定して呼び出します。
• SetUpdateMode を、DIRECTMANIPULATION_INPUT_MODE_MANUAL を指定して呼び出します。

コンテンツ(コンポーネントホストが所有)をコンポジターに関連付け、そのコンテンツにコンポジションデバイスを割り当て、他のコンポジションビジュアルに対するコンポジションツリー内でのコンテンツの位置を指定します。

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

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

すべてのコンテンツは、種類にかかわらずコンポジターに追加する必要があります。

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

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

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