Windows Touch 消息入门-中文这个理

最新推荐文章于 2023-06-07 15:46:12 发布

原创最新推荐文章于 2023-06-07 15:46:12 发布 · 4.4k 阅读

3 ·

CC 4.0 BY-SA版权

Windows Touch 专栏收录该内容

55 篇文章

订阅专栏

本文介绍如何在Windows应用程序中使用Touch输入，包括测试输入数字化器功能、注册接收Touch消息及处理Touch消息的方法。

Windows Touch 消息入门

本节说明用于使 Windows Touch 输入在应用程序中正常工作的相关任务。

以下步骤通常会在使用 Windows Touch 消息时执行：

测试输入数字化器的功能。
注册为接收 Windows Touch 消息。
处理消息。

用于 Windows Touch 的消息为 WM_TOUCH。此消息指示与数字化器接触的各种状态。

测试输入数字化器的功能

可使用 GetSystemMetrics 函数通过传入 SM_DIGITIZER 的 nIndex 值，查询输入数字化器的功能。GetSystemMetrics 返回一个位字段，该字段指示设备是否准备就绪、设备是支持笔还是触摸、输入设备是集成的还是外置的以及设备是否支持多个输入 (Windows Touch)。下表显示各个字段的位。

位	8	7	6	5	4	3	2	1
值	堆栈就绪	多输入	保留	保留	外部笔	集成笔	外部触摸屏	集成触摸屏

若要测试通过特定功能的命令获得的结果，可以使用按位 & 运算符和正在测试的特定位。例如，若要测试 Windows Touch，应测试是否设置了第七顺序位（十六进制表示形式为 0x40）。以下代码示例演示如何测试这些值。

#include <windows.h>

     // test for touch
int value = GetSystemMetrics(SM_DIGITIZER);
if (value & NID_READY){ /* stack ready */}
if (value  & NID_MULTI_INPUT){
    /* digitizer is multitouch */ 
    MessageBoxW(hWnd, L"Multitouch found", L"IsMulti!", MB_OK);
}
if (value & NID_INTEGRATED_TOUCH){ /* Integrated touch */}


    

下表列出了 windows.h 中定义的常量，这些常量用于测试输入数字化器的触摸功能。

名称	值	说明
TABLET_CONFIG_NONE	0x00000000	输入数字化器不具有触摸功能。
NID_INTEGRATED_TOUCH	0x00000001	使用集成触摸数字化器进行输入。
NID_EXTERNAL_TOUCH	0x00000002	使用外部触摸数字化器进行输入。
NID_INTEGRATED_PEN	0x00000004	使用集成笔数字化器进行输入。
NID_EXTERNAL_PEN	0x00000008	使用外部笔数字化器进行输入。
NID_MULTI_INPUT	0x00000040	使用支持多个输入的输入数字化器进行输入。
NID_READY	0x00000080	输入数字化器已准备好进行输入。如果未设置此值，则可能意味着 Tablet 服务已停止、数字化器不受支持或未安装数字化器驱动程序。

检查 NID_* 值是一种很有用的方式，可用来检查用户计算机的功能以便配置应用程序进行触控输入、笔输入或非 Tablet 输入。例如，如果您具有动态用户界面 (UI) 并需要自动配置其中的部分内容，则可检查 NID_INTEGRATED_TOUCH、NID_MULTITOUCH，并且可以获取用户首次运行应用程序时的最大触摸次数。

注意 SM_GETSYSTEMMETRICS 有一些内在限制。例如，不支持即插即用。因此，在使用此函数作为一种永久配置方式时，请谨慎使用。

注册为接收 Windows Touch 输入

在接收 Windows Touch 输入之前，应用程序必须先注册为接收 Windows Touch 输入。通过注册应用程序窗口，应用程序指示它是与触摸兼容的。在应用程序注册其窗口之后，在该窗口中进行输入时，来自 Windows Touch 驱动程序的通知将转发到应用程序。当应用程序关闭时，它将注销其窗口以禁用通知。

注意 WM_TOUCH 消息当前是“贪婪的”。在一个窗口中收到第一条触控消息后，所有触控消息都将发送到该窗口，直到另一个窗口收到焦点。

注意默认情况下，您将接收 WM_GESTURE 消息而不是 WM_TOUCH 消息。如果调用 RegisterTouchWindow，您将停止接收 WM_GESTURE 消息。

以下代码演示应用程序如何注册为接收 Win32 应用程序中的 Windows Touch 消息。

RegisterTouchWindow(hWnd, 0);

处理 Windows Touch 消息

可通过多种方式在 Windows 操作系统中处理来自应用程序的 Windows Touch 消息。如果您正在对 GUI 应用程序进行编程，则可在 WndProc 函数中添加代码以处理感兴趣的消息。如果您正在对 Microsoft 基础类 (MFC) 或托管应用程序进行编程，则可为感兴趣的消息添加处理程序。以下代码示例演示如何在基于 Windows 的应用程序中从 WndProc 处理触控消息。

       LRESULT OnTouch(HWND hWnd, WPARAM wParam, LPARAM lParam ){
    BOOL bHandled = FALSE;
    UINT cInputs = LOWORD(wParam);
    PTOUCHINPUT pInputs = new TOUCHINPUT[cInputs];
    if (pInputs){
        if (GetTouchInputInfo((HTOUCHINPUT)lParam, cInputs, pInputs, sizeof(TOUCHINPUT))){
            for (UINT i=0; i < cInputs; i++){
                TOUCHINPUT ti = pInputs[i];
                //do something with each touch input entry
            }            
            bHandled = TRUE;
        }else{
             /* handle the error here */
        }
        delete [] pInputs;
    }else{
        /* handle the error here, probably out of memory */
    }
    if (bHandled){
        // if you handled the message, close the touch input handle and return
        CloseTouchInputHandle((HTOUCHINPUT)lParam);
        return 0;
    }else{
        // if you didn't handle the message, let DefWindowProc handle it
        return DefWindowProc(hWnd, WM_TOUCH, wParam, lParam);
    }
  }


    

     LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    int wmId, wmEvent;
    PAINTSTRUCT ps;
    HDC hdc;

    switch (message)
    {
      // pass touch messages to the touch handler 
      case WM_TOUCH:
        OnTouch(hWnd, wParam, lParam);
        break;


    

以下代码演示如何实现消息映射和消息处理程序。请注意，必须先在消息映射中声明消息，然后再实现消息的处理程序。例如，在 MFC 应用程序中，可以在对话框代码中进行此类声明。另请注意，对话框窗口的 OnInitDialog 函数必须包含对 RegisterTouchWindow 的调用，例如 RegisterTouchWindow(m_hWnd, 0)。

       // Class implementations within a dialog
  LRESULT TestDlg::OnTouch( WPARAM wParam, LPARAM lParam ){
    //Insert handler code here to do something with the message or uncomment the following line to test
    //MessageBox(L"touch!", L"touch!", MB_OK);
    return 0;
  }
  // The message map
  BEGIN_MESSAGE_MAP()
    ON_WM_CREATE()
    ... ... ...
    ON_MESSAGE(WM_TOUCH, OnTouch)
  END_MESSAGE_MAP()  
 
  BOOL TestDlg::OnInitDialog()
  {
    CDialog::OnInitDialog();	

    RegisterTouchWindow(m_hWnd, 0);
	 ... ... ...
  }	 
  

    

触摸该窗口将指示来自弹出窗口的触摸。

在开始接收触控消息后，可以将这些消息转换为触控输入结构，并可执行更多所需的操作。以下代码演示如何转换消息。

       LRESULT OnTouchHandled(HWND hWnd, WPARAM wParam, LPARAM lParam ){
    BOOL bHandled = FALSE;
    UINT cInputs = LOWORD(wParam);
    PTOUCHINPUT pInputs = new TOUCHINPUT[cInputs];
    if (pInputs){
        if (GetTouchInputInfo((HTOUCHINPUT)lParam, cInputs, pInputs, sizeof(TOUCHINPUT))){
            for (UINT i=0; i < cInputs; i++){
                TOUCHINPUT ti = pInputs[i];
                //do something with each touch input entry
            }            
        }else{
             /* handle the error here */
        }
        delete [] pInputs;
    }else{
        /* handle the error here, probably out of memory */
    }
    if (bHandled){
        // if you handled the message, close the touch input handle and return
        CloseTouchInputHandle((HTOUCHINPUT)lParam);
        return 0;
    }else{
        // if you didn't handle the message, let DefWindowProc handle it
        return DefWindowProc(hWnd, WM_TOUCH, wParam, lParam);
    }
  }


    