IInkRecognizerContext：：get_Guide 方法 (msinkaut.h)

项目
08/25/2023

此属性是可读写的。

语法

HRESULT get_Guide(
  IInkRecognizerGuide **RecognizerGuide
);

参数

RecognizerGuide

返回值

无

备注

仅当 InkStrokes 集合为 NULL 时，设置 Guide 属性才会成功。在将 InkStrokes 集合附加到 InkRecognizerContext 之前，必须设置 Guide 属性，或者必须将 InkStrokes 集合设置为 NULL，然后将 Guide (并可能重新附加 InkStrokes 集合) 。

InkRecognizerCapabilities 枚举包含IRC_FreeInput、IRC_LinedInput和IRC_BoxedInput标志。这些标志指定识别器的功能，但由于它们是只读的，因此无法直接在 IInkRecognizer 或 InkRecognizerContext 对象上设置其中的任何一个。将识别器置于特定模式的唯一方法是使用 Guide 属性设置指南。如果未设置 Guide 属性，则识别器默认为 FreeInput 模式 (如果识别器能够执行此) 。将识别器设置为 FreeInput 模式的另一种方法是将 Guide 属性设置为 InkRecognizerGuide 对象，该对象的 Columns 属性设置为零， Rows 属性设置为零。

如果将 Guide 属性设置为 InkRecognizerGuide 对象，该对象的 Columns 属性设置为零，其 Rows 属性设置为 1 或更多，则识别器处于 IRC_LinedInput 模式 (如果识别器能够执行此) 。识别器使用 Rows 属性来控制行数。

如果将 Guide 属性设置为 InkRecognizerGuide 对象，该对象的 Rows 属性设置为零，其 Columns 属性设置为 1 或更多，则识别器处于 IRC_LinedInput 模式 (如果识别器能够进行垂直写入) 。识别器使用 Columns 属性来控制垂直线的数量。如果识别器能够执行此操作，则 IInkRecognizer 对象的 Capabilities 属性将返回 IRC_DownAndLeft 或 IRC_DownAndRight，或者同时返回这两者。

如果将 Guide 属性设置为 InkRecognizerGuide 对象，该对象的 Columns 属性设置为 1 或更多，其 Rows 属性设置为 1 或更多，则识别器处于 IRC_BoxedInput 模式 (如果识别器能够进行此) 。

如果将模式设置为此识别器中不可用的模式，则返回错误。

有关如何查询特定识别器提供的功能或模式的信息，请参阅 IInkRecognizer 对象的 Capabilities 属性。通常，拉丁文脚本的识别器支持自由输入和水平行输入，东亚字符的识别器支持自由输入和装箱输入，手势识别器仅支持自由输入。

要求


最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	msinkaut.h
Library	InkObj.dll