# Windows手写输入法

**Repository Path**: ll.zhangll/windows_handwriting

## Basic Information

- **Project Name**: Windows手写输入法
- **Description**: No description available
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 3
- **Created**: 2020-03-20
- **Last Updated**: 2026-01-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QT集成Windows手写输入法

> 关键词：qt、手写输入法、顾客签名
>
> 此 Demo 是利用 windows Tablet_PC_SDK 版本，实现的在Windows下实现手写识别，截签名按钮是将签名的区域截取保存成png图片，整体效果如下：

![效果](效果.gif)

## 简介

1. 此Demo使用QT Creator 4.11.0, Based on Qt 5.14.0 编写，大部分qt版本均适用。
2. 开发编译时，需要安装 Tablet_PC_SDK，开发完毕后，实际部署时，不需要安装此SDK。
3. Demo源码链接在本文最后提供。

## 使用步骤

1. Tablet_PC_SDK_v1.7.exe 安装此文件，此工程将此文件安装到了C:\MicrosoftTablet目录下，文件是开发SDK，开发完毕编译后，在部署的机器上不需要安装此文件；安装过程中，选择用户自定义安装 Custom，安装路径不要使用默认的，选择C:\MicrosoftTablet（没有则新建）。

   此SDK可在以下链接中下载，或在本文最后提供的链接上下载。

   ```
   https://getintopc.com/softwares/development/microsoft-tablet-pc-sdk-free-download/
   ```

2. 在.pro中加入：

   ```
   QT       += axcontainer
   INCLUDEPATH +=C:\MicrosoftTablet\Include  //此为SDK安装地址，注意不要使用默认的，因为有的QT不支持中文的（）
   ```

3. 在头文件中需包含以下头文件：

   ```
   Windows_handwriting\hand\handsinput.h 头文件中包含了C:\MicrosoftTablet\Include 中的以下头文件：
   #include <msinkaut_i.c>
   #include <msinkaut.h>
   ```

4. 直接编译会出错，需要注释掉以下文件中的两行：

   ```
   C:\MicrosoftTablet\Include\msinkaut.h 中的：
   475行：//void * __RPC_USER MIDL_user_allocate(size_t);
   
   C:\MicrosoftTablet\Include\tpcshrd.h 中的：
   59行：//void * __RPC_USER MIDL_user_allocate(size_t);
   ```

5. 编译通过后，即可运行。

## 核心代码

此Demo的核心代码如下，可以根据SDK自行编码调试，或下载源码修改调试：

```
void handsInput::inputInit(HWND hwnd)
{
	// 初始化 COM 接口
    CoInitialize(NULL);
    HRESULT hr;

    // 使用默认的识别器创建一个识别上下文
    // 这个上下文会被所有的识别对象使用
    hr = CoCreateInstance(CLSID_InkRecognizerContext,NULL, CLSCTX_INPROC_SERVER,IID_IInkRecognizerContext,(void **) &g_pIInkRecoContext);
    if (FAILED(hr)) {
        qDebug() << "没有安装手写识别软件=";
        return ;
    }
    // 创建一个墨迹收集对象
    hr = CoCreateInstance(CLSID_InkCollector,NULL, CLSCTX_INPROC_SERVER,IID_IInkCollector,(void **) &g_pIInkCollector);
    if (FAILED(hr))
        return ;

    // 获取墨迹对象的指针
    hr = g_pIInkCollector->get_Ink(&g_pIInkDisp);
    if (FAILED(hr))
        return ;

    // 将墨迹对象关联一个 hWnd 的窗口
    hr = g_pIInkCollector->put_hWnd((long)hwnd);
    if (FAILED(hr))
        return ;

    // 设置颜色
    IInkDrawingAttributes* p;
    if (SUCCEEDED(g_pIInkCollector->get_DefaultDrawingAttributes(&p)))
    {
        p->put_Color(RGB(0,0,255));
    }

    // 打开墨迹输入的开关
    hr = g_pIInkCollector->put_Enabled(VARIANT_TRUE);
    if (FAILED(hr))
        return ;

#if 1
    //设置手写只识别为一个字
    IInkRecognizerGuide *RecognizerGuide;
    hr = CoCreateInstance(CLSID_InkRecognizerGuide,NULL, CLSCTX_INPROC_SERVER,IID_IInkRecognizerGuide,(void **) &RecognizerGuide);
    if (FAILED(hr))
        return;
    InkRecoGuide recoguide;
    RECT rect;
    rect.bottom = 2;//不能为1
    rect.left = 0;
    rect.right = 2;//不能为1
    rect.top = 0;

    recoguide.rectWritingBox = rect;
    recoguide.rectDrawnBox = rect;
    recoguide.cRows = 1;//不要过大
    recoguide.cColumns = 1;
    recoguide.midline = -1;
    RecognizerGuide->put_GuideData(recoguide);
    g_pIInkRecoContext->putref_Guide(RecognizerGuide);
#endif
}

void handsInput::RegDataEx(InPutRltS &Rlts)
{
    // 将鼠标变为沙漏
    //	HCURSOR hCursor = ::SetCursor(::LoadCursor(NULL, IDC_WAIT));
    // 获取指向墨迹收集器的指针
    // 这个收集器是整个墨迹的快照
    if (!Rlts.empty())
    {
        Rlts.clear();
    }
    IInkStrokes* pIInkStrokes = NULL;
    HRESULT hr = g_pIInkDisp->get_Strokes(&pIInkStrokes);
    if (SUCCEEDED(hr))
    {
        // 将笔触收集器传递给识别器
        hr = g_pIInkRecoContext->putref_Strokes(pIInkStrokes);
        if (SUCCEEDED(hr))
        {
            // 识别
            IInkRecognitionResult* pIInkRecoResult = NULL;
            InkRecognitionStatus RecognitionStatus = IRS_NoError;

            hr = g_pIInkRecoContext->Recognize(&RecognitionStatus, &pIInkRecoResult);
            if (SUCCEEDED(hr) && (pIInkRecoResult!= NULL))
            {
                // 枚举可能的所有结果
                //                CComPtr<IInkRecognitionAlternates> spIInkRecoAlternates;
                IInkRecognitionAlternates* spIInkRecoAlternates;
                hr = pIInkRecoResult->AlternatesFromSelection(
                            0,                              // in: selection start
                            -1,                             // in: selection length; -1 means "up to the last one"
                            10,								// in: the number of alternates we're interested in
                            &spIInkRecoAlternates           // out: the receiving pointer
                            );
                long lCount = 0;
                if (SUCCEEDED(hr) && SUCCEEDED(spIInkRecoAlternates->get_Count(&lCount)))
                {
                    // 获取所有的识别结果
                    IInkRecognitionAlternate* pIInkRecoAlternate = NULL;
                    for (LONG iItem = 0; (iItem < lCount) && (iItem < 10); iItem++)
                    {
                        // Get the alternate string if there is one
                        if (SUCCEEDED(spIInkRecoAlternates->Item(iItem, &pIInkRecoAlternate)))
                        {
                            BSTR bstr = NULL;
                            if (SUCCEEDED(pIInkRecoAlternate->get_String(&bstr)))
                            {
                                InputRlt temp = {0};
                                QString str = QString::fromWCharArray(bstr);
                                //qDebug() << "字体=" << str.toUtf8().data();
                                strcpy(temp.rlt, str.toUtf8().data());
                                Rlts.push_back(temp);
                            }
                            pIInkRecoAlternate->Release();
                        }
                    }
                    //枚举结束，显示出来
                }
            }
            // 重置识别器内容
            g_pIInkRecoContext->putref_Strokes(NULL);
        }
        pIInkStrokes->Release();
    }
    // 重置鼠标
    //	::SetCursor(hCursor);
}
```

## 相关链接

SDK安装文件与源码包下载链接。