IDirectManipulationManager

クライアントアプリケーションが利用できる Direct Manipulation のすべての機能と API へのアクセスを提供します。

指定したウィンドウで、入力の処理とコールバックの処理を行うために Direct Manipulation を有効化します。

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

manipulation manager は既定では無効化されています。ウィンドウに対して Activate が呼び出されるまで、マネージャーは入力やコールバックを受け取ったり応答したりしません。

Activate と Deactivate の呼び出しは参照カウントされます。

例

次の例は、入力処理を有効化および無効化する方法を示しています。

LRESULT WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam )
{
    BOOL handled = FALSE;
    switch ( msg )
    {
    case WM_SIZE:
        switch ( wParam)
        {
        case SIZE_MINIMIZED:
        case SIZE_MAXHIDE:
            pManipulationManager->Deactivate(hwnd);
            break;

        default:
            pManipulationManager->Activate(hwnd);
            break;
        }
        break;
    }
    if ( !handled)
    {
        return DefWindowProc(hwnd,msg,wParam,lParam);
    }
    else
    {
        return 0;
    }
}

指定したウィンドウで、入力の処理とコールバックの処理を行う Direct Manipulation を無効化します。

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

manipulation manager は既定では無効化されています。Activate が呼び出されるまで、マネージャーは入力を受け取ったり応答したりしません。アプリが入力を受け取らない、または応答しない場合は、manipulation manager を無効化する必要があります。たとえば、アプリが最小化されているときです。

Activate と Deactivate の呼び出しは参照カウントされます。

ヒットテスト専用のスレッドを登録します。

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

ヒットテストは通常、アプリケーションの UI スレッドで実行されます。アプリケーションは WM_POINTERDOWN メッセージを受け取り、それに対してヒットテストが実行されます。マニピュレーションが必要な場合は、1 つ以上のビューポートに対して SetContact が呼び出されます。アプリケーションは RegisterHitTestTarget メソッドを使用して、このヒットテストの処理を別のヒットテストスレッドに委譲できます。

専用のヒットテストターゲットが正常に登録されると、WM_POINTERDOWN メッセージはヒットテストスレッドで処理されます。パンやズームなどのマニピュレーションが必要な場合は、このスレッドから SetContact が呼び出されます。

ヒットテストスレッドから SetContact が呼び出されない場合、登録時に指定された DIRECTMANIPULATION_HITTEST_TYPE に応じて、WM_POINTERDOWN メッセージが UI スレッドで処理されることがあります。

ヒットテストスレッドと UI スレッドのどちらからも SetContact が呼び出されない場合、Direct Manipulation は入力を無視し、その入力は UI スレッドで処理されます。

アプリの UI スレッドで、キーボードおよびマウスのメッセージを manipulation manager に渡します。

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

マウスおよびキーボードの入力に対してこのメソッドを呼び出します。

例

次の例は、manipulation manager にメッセージを渡す方法を示しています。

LRESULT WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    BOOL handled = FALSE;

LRESULT WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    BOOL handled = FALSE;
    switch (msg)
    {
    case WM_KEYDOWN:
    case WM_POINTERWHEEL:
    case WM_POINTERHWHEEL:
    case WM_MOUSEWHEEL:
    case WM_MOUSEHWHEEL:
        MSG msg = {};
        msg.hwnd = hwnd;
        msg.message = message;
        msg.lParam = lParam;
        msg.wParam = wParam;

        if (FAILED(m_pManipulationManager->ProcessInput(&msg, &handled)))
        {
            handled = false;
        }
        break;
    }

    if ( !handled)
    {
        return DefWindowProc(hwnd,msg,wParam,lParam);
    }
    else
    {
        return 0;
    }
}

コンポジターの更新を受け取る IDirectManipulationUpdateManager オブジェクトへのポインターを取得します。

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

コンポジターが Direct Manipulation からの更新イベントに応答するには、初期化時に IDirectManipulationUpdateManager を IDirectManipulationCompositor オブジェクトに関連付ける必要があります。GetUpdateManager を使用して IDirectManipulationUpdateManager オブジェクトへのポインターを取得します。SetUpdateManager メソッドを使用して、このポインターをコンポジターに渡します。

新しい IDirectManipulationViewport オブジェクトを作成するために使用されるファクトリーメソッドです。

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

ビューポート内にセカンダリコンテンツ(パンインジケーターなど)のインスタンスを作成するために使用されるファクトリーメソッドです。

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

プライマリコンテンツはビューポートと同時に自動的に作成され、ビューポートと 1 対 1 の関係を持ちます。そのため、プライマリコンテンツを作成、追加、削除することはできません。

セカンダリコンテンツはビューポートとは独立して作成されます。ビューポートに追加または削除できるセカンダリコンテンツの数に制限はありません。すべてのセカンダリコンテンツの変換は、プライマリコンテンツがサポートする変換から派生し、要素の用途(クラス識別子(CLSID)で識別される)に基づいて特定のルールが適用されます。