Divider 类

2008-11-04

表示分析笔画集合的布局，将这些笔画划分为文本和图形的能力。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class Divider _
    Implements IDisposable
用法
Dim instance As Divider

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class Divider : IDisposable

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class Divider : IDisposable

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class Divider implements IDisposable

public class Divider implements IDisposable

备注

警告

因为其对象持有非托管资源，所以必须在不再需要使用的 Microsoft.Ink.Divider 类实例超出范围之前对这些实例显式调用 Dispose 方法。否则，可能导致内存泄漏和异常。

有关释放托管对象的示例，请参见Using the Managed Library。

Divider 对象利用笔画布局、笔画的添加顺序、笔画的绘制方向以及其他因素分析墨迹。Strokes 集合包含在 Divider 的 Strokes 属性中。在 Strokes 集合中执行添加或删除操作的时候，Divider 对象会动态分析该集合。

分析结果由 DivisionResult 对象返回。

Divider 对象使用 RecognizerContext 对象更为准确地划分笔画以及将识别字符串分配给结果。

备注

Divider 对象使用 RecognizerContext 对象的默认属性设置。

如果没有为 Divider 对象分配识别器上下文，则 Divider 对象仍会分析墨迹，然而划分笔画的准确度较低，并且不会将文本与划分结果相关联。

备注

将笔画添加到 Strokes 属性之前应当设置 RecognizerContext 属性。在笔画添加到 Divider 对象之后，RecognizerContext 属性不可更改。

Divider 当前不支持垂直语言。如果希望 Divider 对象能够正确识别这些语言，语言的 Recognizer 对象必须支持自由输入功能。并且，字符的书写顺序必须是从左到右。

备注

Divider 对象的 Dispose 方法不释放附加的 RecognizerContext 对象和 Strokes 集合的资源。如果 Divider 对象持有唯一的引用，则应用程序应在释放 Divider 对象之前释放与 Divider 对象相关联的 RecognizerContext 对象和 Strokes 集合。

Divider 对象的托管版本包装了 COM InkDivider Class。如果 COM InkDivider 返回错误，则 Divider 对象的构造函数、Divide 方法、LineHeight 方法、RecognizerContext 方法和 Strokes 方法都将引发 Marshal.ThrowExceptionForHR 异常。有关可能返回的各种错误的详细信息，请参见 COM InkDivider Class成员的各个参考主题。