InkEdit 類別

發行項
10/29/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 控制項。

如果某個列舉型別 (Enumeration)、事件、方法或屬性沒有記錄在 RichTextBox 控制項底下，則表示它在 InkEdit 控制項中並未遭到覆寫，而且可以完全按照 RichTextBox 控制項文件說明的方法使用。尤其是文件中指出僅適用於 RichTextBox 控制項的值和參數 (例如 RichNoOleObjs 列舉型別欄位)，這些值和參數在與 InkEdit 控制項搭配使用時的運作方式完全相同，因為它是 RichTextBox 控制項。

警告

為了避免記憶體遺漏 (Memory Leak)，對於已附加事件處理常式的任何 InkEdit 物件，您必須在物件超出範圍之前明確呼叫 Dispose 方法。

您可以將 InkEdit 控制項與 Windows Vista 搭配使用。您不能在 Microsoft Windows 2000、Windows Server 2003，以及 Windows XP Tablet PC Edition 以外的任何 Windows XP 版本中，使用 InkEdit 控制項來轉譯筆墨。您只能在下列條件下輸入筆墨、接受筆勢或進行「手寫」辨識：

只有在安裝了 Windows XP Tablet PC Edition 的情況下，才能輸入及辨識筆墨。
只有在安裝了 Windows XP Tablet PC Edition 的情況下，才能辨識筆勢。
如果手寫來源是其他地方，而且辨識器存在的話，就可以進行手寫文字辨識。

如果使用的是 Windows 2000、Windows Server 2003，或是除了 Tablet PC Edition 以外的任何 Windows XP 版本，您可以指派值給 InkEdit 控制項的環境屬性 (Ambient Property)，也可以將筆墨複製並貼到其他應用程式中，但是它的 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 控制項。

安全性注意事項：
如果在部分信任的情況下使用，這個類別 (Class) 和它的所有方法都需要 SafeTopLevelWindows 權限。如需詳細資訊，請參閱Security and Trust。

InkEdit 控制項的 Managed 版本會包裝 COM InkEdit 控制項。如果 COM InkEdit 傳回錯誤，Managed InkEdit 控制項的建構函式 (Constructor)、Divide 方法、LineHeight 屬性、RecognizerContext 屬性和 Strokes 屬性全都會擲回 Marshal.ThrowExceptionForHR 例外狀況 (Exception)。如需可以傳回之錯誤的詳細資訊，請參閱 InkEdit Control Reference主題。