SetGuide 函数 (recapis.h)

设置用于装箱或换行输入的识别指南。 在将笔划添加到上下文之前,必须调用此函数。

Syntax

HRESULT SetGuide(
  HRECOCONTEXT     hrc,
  const RECO_GUIDE *pGuide,
  ULONG            iIndex
);

参数

hrc

识别器上下文的句柄。

pGuide

用于框或行输入的指南。 将此参数设置为 NULL 意味着上下文没有指南。 这是默认值,表示识别器处于自由输入模式。 有关指南详细信息,请参阅 RECO_GUIDE 结构。

iIndex

要用于上下文中第一个框或行的索引值。

返回值

此函数可以返回其中一个值。

返回代码 Description
S_OK
成功。
E_POINTER
上下文无效,或者其中一个参数是无效指针。
E_OUTOFMEMORY
无法分配内存以完成作。
E_INVALIDARG
尝试设置识别模式(自由、线条、装箱等)不受识别器支持,或者RECO_GUIDE字段值是非法的(例如负高度或宽度)。
E_FAIL
发生未指定的错误。
TPC_E_OUT_OF_ORDER_CALL
尝试在 reco 上下文中已有一些墨迹时设置指南,或者在东亚字符识别器的情况下调用 SetCACMode 之前。

注解

参考线框是根据 iIntex 值编号的。

要求

Requirement 价值
最低支持的客户端 Windows XP Tablet PC Edition [桌面应用 |UWP 应用]
支持的最低服务器 无受支持的版本
目标平台 Windows操作系统
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

另请参阅

GetGuide 函数

RECO_GUIDE结构