RecognizerContext 类

启用执行墨迹 识别、检索识别结果及检索备选项的功能。RecognizerContext 使系统上安装的各种识别器 可以使用墨迹识别对输入进行适当的处理。

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink(在 Microsoft.Ink.dll 中)

语法

声明
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class RecognizerContext _
    Implements ICloneable, IDisposable
用法
Dim instance As RecognizerContext
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class RecognizerContext : ICloneable, 
    IDisposable
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class RecognizerContext : ICloneable, 
    IDisposable
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class RecognizerContext implements ICloneable, 
    IDisposable
public class RecognizerContext implements ICloneable, IDisposable

备注

警告

为了避免内存泄漏,必须在已附加事件处理程序的任何 RecognizerContext 集合超出范围之前对该集合显式调用 Dispose 方法。

有两种类型的识别:后台识别(异步)和前台识别(同步)。后台识别是通过调用 BackgroundRecognizeBackgroundRecognizeWithAlternates 方法启动的,它在后台线程上执行,并通过事件机制将结果报告给应用程序。前台识别直到所有识别均完成后才会返回,这样无需侦听识别事件便可将识别结果提供给调用线程。

墨迹在后台进行连续处理。如果将 Stroke 添加到 RecognizerContext 所引用的 Strokes 集合中,则会立即识别 Stroke。有关更多详细信息,请参见 EndInkInput 方法主题中的备注。

所有识别均通过识别器上下文 执行。该上下文定义单个识别会话的设置。它接收必须识别的墨迹,并定义对墨迹输入和识别输出的约束。可对该上下文设置的约束包括所使用的语言、字典和语法。

备注

仅当 Strokes 集合为 nullnull 引用(在 Visual Basic 中为 Nothing) 时,才能成功设置 StrokesCharacterAutoCompletion 属性以外的属性。必须先设置这些其他属性,然后再将 Strokes 集合附加到 RecognizerContext;或者必须先将 Strokes 集合设置为 nullnull 引用(在 Visual Basic 中为 Nothing),然后再设置这些其他属性。如果先将 Strokes 集合设置为 nullnull 引用(在 Visual Basic 中为 Nothing),然后再设置这些其他属性,则可能必须重新附加 Strokes 集合。这是因为在将 Strokes 分配给 RecognizerContext 后会立即开始执行识别。当调用 RecognizeBackgroundRecognize 时,调用结果可能已经可用。

为了改进应用程序的性能,请在不再需要 RecognizerContext 对象时以手动方式将其释放。

继承层次结构

System.Object
  Microsoft.Ink.RecognizerContext

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

RecognizerContext 成员

Microsoft.Ink 命名空间

Recognizer

Strokes