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 方法。
有两种类型的识别:后台识别(异步)和前台识别(同步)。后台识别是通过调用 BackgroundRecognize 或 BackgroundRecognizeWithAlternates 方法启动的,它在后台线程上执行,并通过事件机制将结果报告给应用程序。前台识别直到所有识别均完成后才会返回,这样无需侦听识别事件便可将识别结果提供给调用线程。
墨迹在后台进行连续处理。如果将 Stroke 添加到 RecognizerContext 所引用的 Strokes 集合中,则会立即识别 Stroke。有关更多详细信息,请参见 EndInkInput 方法主题中的备注。
所有识别均通过识别器上下文 执行。该上下文定义单个识别会话的设置。它接收必须识别的墨迹,并定义对墨迹输入和识别输出的约束。可对该上下文设置的约束包括所使用的语言、字典和语法。
备注
仅当 Strokes 集合为 nullnull 引用(在 Visual Basic 中为 Nothing) 时,才能成功设置 Strokes 或 CharacterAutoCompletion 属性以外的属性。必须先设置这些其他属性,然后再将 Strokes 集合附加到 RecognizerContext;或者必须先将 Strokes 集合设置为 nullnull 引用(在 Visual Basic 中为 Nothing),然后再设置这些其他属性。如果先将 Strokes 集合设置为 nullnull 引用(在 Visual Basic 中为 Nothing),然后再设置这些其他属性,则可能必须重新附加 Strokes 集合。这是因为在将 Strokes 分配给 RecognizerContext 后会立即开始执行识别。当调用 Recognize 或 BackgroundRecognize 时,调用结果可能已经可用。
为了改进应用程序的性能,请在不再需要 RecognizerContext 对象时以手动方式将其释放。
继承层次结构
System.Object
Microsoft.Ink.RecognizerContext
线程安全
此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。
平台
Windows Vista
.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。
版本信息
.NET Framework
受以下版本支持:3.0