iInkRecognizerContext::p utref_Guide 方法 (msinkaut.h)

获取或设置用于 墨迹输入的 InkRecognizerGuide

此属性是可读写的。

语法

HRESULT putref_Guide(
  IInkRecognizerGuide *RecognizerGuide
);

参数

RecognizerGuide

返回值

备注

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

InkRecognizerCapabilities 枚举包含IRC_FreeInputIRC_LinedInputIRC_BoxedInput标志。 这些标志指定识别器的功能,但由于它们是只读的,因此无法直接在 IInkRecognizerInkRecognizerContext 对象上设置其中的任何功能。 将识别器置于特定模式的唯一方法是使用 Guide 属性设置 参考线 。 如果未设置 Guide 属性,则识别器默认为 FreeInput 模式 (如果识别器能够进行此) 。 将识别器设置为 FreeInput 模式的另一种方法是将 Guide 属性设置为 InkRecognizerGuide 对象,该对象的 Columns 属性设置为零, Rows 属性设置为零。

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

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

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

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

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

要求

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

请参阅

Capabilities 属性

Columns 属性

IInkRecognizer 接口

IInkRecognizerContext

InkRecognizerCapabilities 枚举

InkRecognizerContext 类

InkRecognizerGuide 类

InkStrokes 集合

Rows 属性