IInkRecognizerContext::get_Guide 方法 (msinkaut.h)
获取或设置用于 墨迹输入的 InkRecognizerGuide 。
此属性是可读写的。
语法
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 |