处理非托管代码中的惯性

项目
06/13/2023

本部分介绍如何使用 IInertiaProcessor 接口来处理非托管代码中的惯性。

概述

若要在非托管代码中使用惯性，必须为操作处理器和惯性处理器实现事件接收器。首先，按照向非托管代码添加操作支持部分中所述，向应用程序添加操作支持。请注意，操作支持要求使用触摸消息而不是手势消息将事件数据馈送给操作处理器。操作正常工作后，还必须为 IInertiaProcessor 接口将生成或需要修改现有事件接收器的事件实现第二个事件接收器，以适应 IInertiaProcessor 和 IManipulationProcessor 接口生成的事件。就此示例而言，从为向非托管代码添加操作支持部分创建的事件接收器开始，并添加第二个使用惯性处理器而不是操作处理器的构造函数会更容易。这样，事件接收器实现就可以对操作处理器或惯性处理器起作用。除了添加第二个构造函数外，事件接收器还将具有一个变量，指示它是否将基于惯性输入而不是操作输入执行操作。

向操作处理器事件接收器添加惯性支持

下面的代码显示了新的事件接收器构造函数、 IInertiaProcessor 接口的新成员变量，以及一个指示接收器是否推断惯性的标志。

    CManipulationEventSink(IManipulationProcessor *pManip, IInertiaProcessor *pInert, HWND hWnd);
    CManipulationEventSink(IInertiaProcessor *pInert, HWND hWnd);

    IInertiaProcessor*      m_pInert;
    BOOL fExtrapolating;

在类标头具有新的构造函数和指示是否推断的标志后，可以实现事件接收器，以便为 IManipulationProcessor 事件和 IInertiaProcessor 事件提供单独的处理块。接受 IManipulationProcessor 和 IInertiaProcessor 的构造函数应将 fExtrapolating 标志设置为 false，这表示这是 IManipulationProcessor 事件处理程序。以下代码演示如何实现使用 IManipulationProcessor 的事件接收器的构造函数。

CManipulationEventSink::CManipulationEventSink(IManipulationProcessor *pManip, IInertiaProcessor *pInert, HWND hWnd)
{
    m_hWnd = hWnd;

    //Set initial ref count to 1.
    m_cRefCount = 1;

    fExtrapolating=FALSE;

    m_pManip = pManip;
    
    m_pInert = pInert;
    
    m_pManip->put_PivotRadius(-1);

    m_cStartedEventCount = 0;
    m_cDeltaEventCount = 0;
    m_cCompletedEventCount = 0;

    HRESULT hr = S_OK;

    //Get the container with the connection points.
    IConnectionPointContainer* spConnectionContainer;
    
    hr = pManip->QueryInterface(
      IID_IConnectionPointContainer, 
          (LPVOID*) &spConnectionContainer
        );
    //hr = manip->QueryInterface(&spConnectionContainer);
    if (spConnectionContainer == NULL){
        // something went wrong, try to gracefully quit
        
    }

    //Get a connection point.
    hr = spConnectionContainer->FindConnectionPoint(__uuidof(_IManipulationEvents), &m_pConnPoint);
    if (m_pConnPoint == NULL){
        // something went wrong, try to gracefully quit
    }

    DWORD dwCookie;

    //Advise.
    hr = m_pConnPoint->Advise(this, &dwCookie);
}

以下代码演示如何实现使用 IInertiaProcessor 的事件接收器的构造函数。此构造函数将 fExtrapolating 标志设置为 true，指示事件接收器类的此实例将执行推断，并将执行以前由操作处理器事件执行的任何移动操作。

CManipulationEventSink::CManipulationEventSink(IInertiaProcessor *pInert, HWND hWnd)
{
    m_hWnd = hWnd;

    m_pInert = pInert;
    //Set initial ref count to 1.
    m_cRefCount = 1;

    fExtrapolating=TRUE;

    m_cStartedEventCount = 0;
    m_cDeltaEventCount = 0;
    m_cCompletedEventCount = 0;

    HRESULT hr = S_OK;

    //Get the container with the connection points.
    IConnectionPointContainer* spConnectionContainer;
    
    hr = pInert->QueryInterface(
      IID_IConnectionPointContainer, 
          (LPVOID*) &spConnectionContainer
        );
    //hr = manip->QueryInterface(&spConnectionContainer);
    if (spConnectionContainer == NULL){
        // something went wrong, try to gracefully quit        
    }

    //Get a connection point.
    hr = spConnectionContainer->FindConnectionPoint(__uuidof(_IManipulationEvents), &m_pConnPoint);
    if (m_pConnPoint == NULL){
        // something went wrong, try to gracefully quit
    }
    DWORD dwCookie;

    //Advise.
    hr = m_pConnPoint->Advise(this, &dwCookie);
}

注意

操作处理器事件接收器中的事件接收器类实现作为惯性处理器的事件接收器重复使用。

现在，在构造此类 CManipulationEventSink 时，可以将它构造为操作处理器的事件接收器或惯性处理器的事件接收器。当它构造为惯性处理器事件接收器时，它将 fExtrapolating 标志设置为 true，表示应推断操作事件。

注意

ManipulationStarted 将由 IManipulationProcessor 和 IInertiaProcessor 接口引发。

操作启动时，将设置 IInertiaProcessor 接口属性。以下代码演示如何处理已启动事件。

HRESULT STDMETHODCALLTYPE CManipulationEventSink::ManipulationStarted( 
    /* [in] */ FLOAT x,
    /* [in] */ FLOAT y)
{
    m_cStartedEventCount ++;       

    // set origins in manipulation processor
    m_pInert->put_InitialOriginX(x);
    m_pInert->put_InitialOriginY(y);
    
    RECT screenRect;

    HWND desktop = GetDesktopWindow();
    GetClientRect(desktop, &screenRect);

    // physics settings
    // deceleration is units per square millisecond
    m_pInert->put_DesiredDeceleration(.1f);

    // set the boundaries        
    screenRect.left-= 1024;
    m_pInert->put_BoundaryLeft  ( static_cast<float>(screenRect.left   * 100));
    m_pInert->put_BoundaryTop   ( static_cast<float>(screenRect.top    * 100));
    m_pInert->put_BoundaryRight ( static_cast<float>(screenRect.right  * 100));
    m_pInert->put_BoundaryBottom( static_cast<float>(screenRect.bottom * 100));
    
    
    // Elastic boundaries - I set these to 90% of the screen 
    // so... 5% at left, 95% right, 5% top,  95% bottom
    // Values are whole numbers because units are in centipixels
    m_pInert->put_ElasticMarginLeft  (static_cast<float>(screenRect.left   * 5));
    m_pInert->put_ElasticMarginTop   (static_cast<float>(screenRect.top    * 5));
    m_pInert->put_ElasticMarginRight (static_cast<float>(screenRect.right  * 95));
    m_pInert->put_ElasticMarginBottom(static_cast<float>(screenRect.bottom * 95));
    
    
    return S_OK;
}

在此示例中，操作增量用于移动窗口。以下代码演示如何处理增量事件。

HRESULT STDMETHODCALLTYPE CManipulationEventSink::ManipulationDelta( 
    /* [in] */ FLOAT x,
    /* [in] */ FLOAT y,
    /* [in] */ FLOAT translationDeltaX,
    /* [in] */ FLOAT translationDeltaY,
    /* [in] */ FLOAT scaleDelta,
    /* [in] */ FLOAT expansionDelta,
    /* [in] */ FLOAT rotationDelta,
    /* [in] */ FLOAT cumulativeTranslationX,
    /* [in] */ FLOAT cumulativeTranslationY,
    /* [in] */ FLOAT cumulativeScale,
    /* [in] */ FLOAT cumulativeExpansion,
    /* [in] */ FLOAT cumulativeRotation)
{
    m_cDeltaEventCount ++;
        
    RECT rect;
            
    GetWindowRect(m_hWnd, &rect);
        
    int oldWidth =  rect.right-rect.left;
    int oldHeight = rect.bottom-rect.top;            

    // scale and translate the window size / position    
    MoveWindow(m_hWnd,                                              // the window to move
        static_cast<int>(rect.left + (translationDeltaX / 100.0f)), // the x position
        static_cast<int>(rect.top + (translationDeltaY/100.0f)),    // the y position
        static_cast<int>(oldWidth * scaleDelta),                    // width
        static_cast<int>(oldHeight * scaleDelta),                   // height
        TRUE);                                                      // redraw
                     
    return S_OK;
}

在此示例中，操作已完成的事件启动或停止将在 IInertiaProcessor 接口上调用 Process 的计时器。以下代码演示如何处理已完成的操作事件。

HRESULT STDMETHODCALLTYPE CManipulationEventSink::ManipulationCompleted( 
    /* [in] */ FLOAT x,
    /* [in] */ FLOAT y,
    /* [in] */ FLOAT cumulativeTranslationX,
    /* [in] */ FLOAT cumulativeTranslationY,
    /* [in] */ FLOAT cumulativeScale,
    /* [in] */ FLOAT cumulativeExpansion,
    /* [in] */ FLOAT cumulativeRotation)
{
    m_cCompletedEventCount ++;

    m_fX = x;
    m_fY = y;

    // place your code handler here to do any operations based on the manipulation   
    
    if (fExtrapolating){
        //Inertia Complete, stop the timer used for processing      
        KillTimer(m_hWnd,0);        
    }else{ 
        // setup velocities for inertia processor
        float vX = 0.0f;
        float vY = 0.0f;
        float vA = 0.0f;
        m_pManip->GetVelocityX(&vX);
        m_pManip->GetVelocityY(&vY);
        m_pManip->GetAngularVelocity(&vA);

        // complete any previous processing
        m_pInert->Complete();
        
        // Reset sets the  initial timestamp
        m_pInert->Reset();
                
        // 
        m_pInert->put_InitialVelocityX(vX);
        m_pInert->put_InitialVelocityY(vY);        
        
        m_pInert->put_InitialOriginX(x);
        m_pInert->put_InitialOriginY(y);
        
           
        // Start a timer
        SetTimer(m_hWnd,0, 50, 0);        
    }

    return S_OK;
}

以下代码演示如何解释 WndProc 中的WM_TIMER消息，以在 IInertiaProcessor 接口上对 Process 执行调用。

case WM_TIMER:       
  if (g_pIInertProc){
    BOOL b;       
    g_pIInertProc->Process(&b);        
  }
  break;

共同初始化惯性处理器和操作处理器并初始化事件接收器

将事件接收器修改为同时支持 IManipulationProcessor 和 IInertiaProcessor 后，即可初始化事件接收器并将其设置为从应用程序运行。以下代码演示如何分配接口指针。

//Include windows.h for touch events
#include "windows.h"  

// Manipulation implementation file
#include <manipulations_i.c>
    
// Smart Pointer to a global reference of a manipulation processor, event sink
IManipulationProcessor* g_pIManipProc;
IInertiaProcessor*      g_pIInertProc;

下面的代码示例演示如何实例化接口。

   HRESULT hr = CoInitialize(0);
        
   hr = CoCreateInstance(CLSID_ManipulationProcessor,
       NULL,
       CLSCTX_INPROC_SERVER,
       IID_IUnknown,
       (VOID**)(&g_pIManipProc)
   );
   
   hr = CoCreateInstance(CLSID_InertiaProcessor,
       NULL,
       CLSCTX_INPROC_SERVER,
       IID_IUnknown,
       (VOID**)(&g_pIInertProc)
   );

下面的代码示例演示如何在给定接口指针的情况下构造事件接收器，并为触摸输入注册窗口。

   g_pManipulationEventSink = new CManipulationEventSink(g_pIManipProc, g_pIInertProc, hWnd);
   g_pManipulationEventSink = new CManipulationEventSink(g_pIInertProc, hWnd);


   RegisterTouchWindow(hWnd, 0);

惯性

通过

处理非托管代码中的惯性

概述

向操作处理器事件接收器添加惯性支持

共同初始化惯性处理器和操作处理器并初始化事件接收器

反馈

其他资源

通过

处理非托管代码中的惯性

概述

向操作处理器事件接收器添加惯性支持

共同初始化惯性处理器和操作处理器并初始化事件接收器

相关主题

反馈

其他资源