IManipulationProcessor

IManipulationProcessor は、マルチタッチ入力を監視して応答するための機能を提供します。

SupportedManipulations プロパティは、オブジェクトがどの操作(マニピュレーション)をサポートしているかを示すために使用します。(Get)

このプロパティを使用すると、オブジェクトがサポートする操作とサポートしない操作を制御できます。 たとえば、x 方向の平行移動操作をサポートしつつ、y 方向の平行移動操作をすべてブロックできます。

例

        CoInitialize(0);

        hr = spIManipProc.CoCreateInstance(CLSID_ManipulationProcessor, NULL, CLSCTX_ALL);

        MANIPULATION_PROCESSOR_MANIPULATIONS mpm;
        spIManipProc->get_SupportedManipulations(&mpm);    
        

SupportedManipulations プロパティは、オブジェクトがどの操作(マニピュレーション)をサポートしているかを示すために使用します。(Put)

このプロパティを使用すると、オブジェクトがサポートする操作とサポートしない操作を制御できます。 たとえば、x 方向の平行移動操作をサポートしつつ、y 方向の平行移動操作をすべてブロックできます。

例

        CoInitialize(0);

        hr = spIManipProc.CoCreateInstance(CLSID_ManipulationProcessor, NULL, CLSCTX_ALL);

        MANIPULATION_PROCESSOR_MANIPULATIONS mpm;
        spIManipProc->get_SupportedManipulations(&mpm);    
        

PivotPointX プロパティは、オブジェクトの水平方向の中心を表します。(Get)

PivotPointX プロパティは、オブジェクトの水平方向の中心を表します。(Put)

PivotPointY プロパティは、オブジェクトの垂直方向の中心を表します。(Get)

PivotPointY プロパティは、オブジェクトの垂直方向の中心を表します。(Put)

PivotRadius プロパティは、単一指の操作でどの程度の回転を使用するかを決定するために使用します。(Get)

PivotRadius プロパティは、単一指の操作でどの程度の回転を使用するかを決定するために使用します。(Put)

CompleteManipulation メソッドは、開発者が操作(マニピュレーション)を終了することを選択したときに呼び出します。

成功した場合は S_OK を返します。それ以外の場合は E_FAIL などのエラーコードを返します。

このメソッドは、その応答として ManipulationCompleted() イベントを発生させます。

Windows タッチ ジェスチャの間、最初のタッチ入力が処理のために送信されるとすぐに操作が開始されます。 2 番目のタッチ入力が処理される前に CompleteManipulation が呼び出された場合、 その 2 番目のタッチ入力は新しい操作を開始します。

ProcessDown メソッドは、タッチ ダウンのデータを、ターゲットに関連付けられた操作プロセッサーに供給します。

成功した場合は S_OK を返します。それ以外の場合は E_FAIL などのエラーコードを返します。

このメソッドは、タッチ ハードウェアからではなくシステム時刻を使用してタイムスタンプを取得します。パフォーマンスが低下している場合に体感を向上させるには、ProcessDownWithTime メソッドを使用してください。

ProcessMove メソッドは、ターゲット オブジェクトの移動データを、その操作プロセッサーに供給します。

成功した場合は S_OK を返します。それ以外の場合は E_FAIL などのエラーコードを返します。

このメソッドは、タッチ ハードウェアからではなくシステム時刻を使用してタイムスタンプを取得します。パフォーマンスが低下している場合に体感を向上させるには、ProcessMoveWithTime メソッドを使用してください。

ProcessUp メソッドは、タッチ アップのシーケンスのために、ターゲットの操作プロセッサーにデータを供給します。

成功した場合は S_OK を返します。それ以外の場合は E_FAIL などのエラーコードを返します。

このメソッドは、タッチ ハードウェアからではなくシステム時刻を使用してタイムスタンプを取得します。パフォーマンスが低下している場合に体感を向上させるには、ProcessUpWithTime メソッドを使用してください。

タイムスタンプを含むタッチ ダウンのデータを、ターゲットに関連付けられた操作プロセッサーに供給します。

メソッドが成功した場合は S_OK を返します。失敗した場合は E_FAIL などの HRESULT エラーコードを返します。

タッチ イベントは、生成された順序とは異なる順序で受信される可能性があります。これを解消するには、イベントを処理する際に TOUCHINPUT 構造体からタイムスタンプを抽出してください。

例

static void ProcessDown(TOUCHINPUT* pTouchInput, IManipulationProcessor* pManipulationProcessor){
  pManipulationProcessor->ProcessDownWithTime(
    pTouchInput->dwID, 
    static_cast<float>(pTouchInput->x), 
    static_cast<float>(pTouchInput->y), 
    pTouchInput->dwTime
  );
}
    

タイムスタンプを含む移動データを、ターゲット オブジェクトのために、その操作プロセッサーに供給します。

メソッドが成功した場合は S_OK を返します。失敗した場合は E_FAIL などの HRESULT エラーコードを返します。

タッチ イベントは、生成された順序とは異なる順序で受信される可能性があります。これを解消するには、イベントを処理する際に TOUCHINPUT 構造体からタイムスタンプを抽出してください。

例

static void ProcessMove(TOUCHINPUT* pTouchInput, IManipulationProcessor* pManipulationProcessor){
  pManipulationProcessor->ProcessMoveWithTime(
    pTouchInput->dwID, 
    static_cast<float>(pTouchInput->x), 
    static_cast<float>(pTouchInput->y), 
    pTouchInput->dwTime
  );
}
      

タイムスタンプを含むデータを、タッチ アップのシーケンスのために、ターゲットの操作プロセッサーに供給します。

メソッドが成功した場合は S_OK を返します。失敗した場合は E_FAIL などの HRESULT エラーコードを返します。

タッチ イベントは、生成された順序とは異なる順序で受信される可能性があります。これを解消するには、イベントを処理する際に TOUCHINPUT 構造体からタイムスタンプを抽出してください。

例

static void ProcessUp(TOUCHINPUT* pTouchInput, IManipulationProcessor* pManipulationProcessor){
  pManipulationProcessor->ProcessUpWithTime(
    pTouchInput->dwID, 
    static_cast<float>(pTouchInput->x), 
    static_cast<float>(pTouchInput->y), 
    pTouchInput->dwTime
  );
}

ターゲット オブジェクトの水平方向の速度を計算して返します。

メソッドが成功した場合は S_OK を返します。失敗した場合は E_FAIL などの HRESULT エラーコードを返します。

この値は、IInertiaProcessor インターフェイスを使用する際に役立ちます。操作(マニピュレーション)が完了したときにこの値を渡してください。

垂直方向の速度を計算して返します。

メソッドが成功した場合は S_OK を返します。失敗した場合は E_FAIL などの HRESULT エラーコードを返します。

この値は、IInertiaProcessor インターフェイスを使用する際に役立ちます。操作(マニピュレーション)が完了したときにこの値を渡してください。

GetExpansionVelocity メソッドは、ターゲット オブジェクトが拡大している速度を計算します。

成功した場合は S_OK を返します。それ以外の場合は E_FAIL などのエラーコードを返します。

この値は、IInertiaProcessor インターフェイスを使用する際に役立ちます。操作(マニピュレーション)が完了したときにこの値を渡してください。

GetAngularVelocity メソッドは、ターゲット オブジェクトが動いている回転速度を計算します。

成功した場合は S_OK を返します。それ以外の場合は E_FAIL などのエラーコードを返します。

この値は、IInertiaProcessor インターフェイスの初期状態を設定する際に役立ちます。操作(マニピュレーション)が完了したときにこの値を渡してください。

このプロパティは、ProcessMoveWithTime、ProcessMoveWithTime、ProcessUpWithTime の呼び出しによって明示的なタイムスタンプが指定されていない場合、ラジアン毎ミリ秒で表されます。指定されている場合、この関数はラジアン毎ユーザー定義時間単位を使用します。

拡大縮小または回転ジェスチャの接触点間の距離が、操作(マニピュレーション)をトリガーするためにどの程度大きくなければならないかを指定します。(Get)

 この値を設定すると、操作プロセッサーは半径が小さすぎるジェスチャを無視するようになります。
 これは、ユーザーがオブジェクトを小さすぎる半径に操作するのを防ぎたい場合に役立ちます。たとえば、
 円に対して操作プロセッサーを使用しており、その半径を 100 ピクセルより大きく保ちたい場合は、
 この値を 10000 に設定します。	

例

pManip->put_MinimumScaleRotateRadius(4000.0f);  

拡大縮小または回転ジェスチャの接触点間の距離が、操作(マニピュレーション)をトリガーするためにどの程度大きくなければならないかを指定します。(Put)

 この値を設定すると、操作プロセッサーは半径が小さすぎるジェスチャを無視するようになります。
 これは、ユーザーがオブジェクトを小さすぎる半径に操作するのを防ぎたい場合に役立ちます。たとえば、
 円に対して操作プロセッサーを使用しており、その半径を 100 ピクセルより大きく保ちたい場合は、
 この値を 10000 に設定します。	

例

pManip->put_MinimumScaleRotateRadius(4000.0f);