IDirectManipulationCompositor

操作対象のコンテンツを、canvas(JavaScript を使用する Windows アプリ)や Canvas(C++、C#、または Visual Basic を使用する Windows ストアアプリ)などの描画サーフェスに関連付けるコンポジターオブジェクトを表します。

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

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

• SetViewportOptions(DIRECTMANIPULATION_VIEWPORT_OPTIONS_MANUALUPDATE を指定)。
• SetUpdateMode(DIRECTMANIPULATION_INPUT_MODE_MANUAL を指定)。

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

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

このメソッドは、小さなビジュアルツリー(Direct Manipulation デバイスが所有)を 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 にできます。

コンポジターからコンテンツを削除します。

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

このメソッドは、AddContent で追加されたコンテンツを削除し、コンポジションツリー内の親ビジュアルと子ビジュアルの元の関係を復元します。言い換えると、RemoveContent は AddContent を元に戻します。

コンポジターの更新を Direct Manipulation に送信するために使用するアップデートマネージャーを設定します。

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

updateManager は、GetUpdateManager を呼び出して取得します。

コンポジターを update manager に接続するには、Direct Manipulation の初期化中にこのメソッドを呼び出してください。

コンポジター内の保留中のすべての更新を、レンダリングのためにシステムにコミットします。

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

このメソッドは、プロセスの中断などのシステムイベントの前に、Direct Manipulation が保留中の変更をそのビジュアルにフラッシュできるようにします。