InkEdit 类

项目
11/04/2008

InkEdit 控件让您可以收集和识别墨迹，并将其作为文本显示。使用此控件可以启用智能窗体以提高文本输入的准确性。

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

语法

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

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

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

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkEdit extends RichTextBox

public class InkEdit extends RichTextBox

备注

此控件是 RichTextBox 控件的超集。它扩展了 RichTextBox 控件，具有捕获、识别和显示墨迹的功能。

如果本文下面没有提及 RichTextBox 控件的某个枚举、事件、方法或属性，则表示它没有在 InkEdit 控件中进行重写，可完全按照 RichTextBox 控件文档中的说明使用。特别说明，仅对于 RichTextBox 控件描述为有效的值和参数（如 RichNoOleObjs 枚举字段）对于 InkEdit 控件用法相同，因为该控件就是一个 RichTextBox 控件。

警告

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

InkEdit 控件可用于 Windows Vista。不能使用 InkEdit 控件在 Microsoft Windows 2000、Windows Server 2003 及除 Windows XP Tablet PC Edition 外的任何版本的 Windows XP 中呈现墨迹。只有在以下情况下，才可以输入墨迹、接受笔势或识别手写内容：

只有安装了 Windows XP Tablet PC Edition 才能输入和识别墨迹。
只有安装了 Windows XP Tablet PC Edition 才能识别笔势。
如果手写源于别处且存在识别器，则可将手写识别为文本。

如果使用的是 Windows 2000、Windows Server 2003 或除 Tablet PC Edition 外的任何 Windows XP 版本，则可以为 InkEdit 控件的环境属性赋值，也可以将墨迹复制并粘贴到其他应用程序中，但该控件的 InkMode 属性将为 Disabled。

只有安装了 Windows XP Tablet PC Edition，智能空格插入才可用。

在任何版本的 Windows XP（包括 Windows XP Tablet PC Edition）以及仅安装有 Tablet PC SDK 的系统中都可以加载和显示包含嵌入式 Ink 对象的文件。但是，只有安装了 Windows XP Tablet PC Edition 才能将嵌入式 Ink 对象转换成文本。

有关墨迹控件的更多信息，请参见Ink Controls。

有关各个线程引发的特定事件，请参见Threads on Which an Event Can Fire。

为了改进应用程序的性能，请在不再需要 InkEdit 控件时以手动方式将其释放。

安全说明：
如果在部分信任环境下使用，则此类及其所有方法都需要 SafeTopLevelWindows 权限。有关更多信息，请参见Security and Trust。

InkEdit 控件的托管版本包装了 COM InkEdit 控件。如果 COM InkEdit 返回错误，则托管 InkEdit 控件的构造函数、Divide 方法、LineHeight 属性、RecognizerContext 属性和 Strokes 属性都将引发 Marshal.ThrowExceptionForHR 异常。有关可返回的错误的更多信息，请参见 InkEdit Control Reference主题。