setGuide 函数 (recapis.h)

设置用于装箱输入或内线输入的识别参考线。在向上下文添加笔划之前，必须调用此函数。

语法

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

hrc

识别器上下文的句柄。

pGuide

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

iIndex

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

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

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

参考线框基于 iIntex 值进行编号。

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [桌面应用 \|UWP 应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	recapis.h
DLL	inkobjcore.dll