InkPicture 類別

發行項
10/29/2008

InkPicture 控制項可提供在應用程式中放置影像的能力，而且還能讓使用者在影像最上層加入筆墨。這個控制項主要供筆墨未辨識為文字，而是儲存為筆墨的情況使用。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
Public Class InkPicture _
    Inherits PictureBox
'用途
Dim instance As InkPicture

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
public class InkPicture : PictureBox

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
public ref class InkPicture : public PictureBox

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
public class InkPicture extends PictureBox

public class InkPicture extends PictureBox

備註

警告

您必須在這個物件超出範圍之前呼叫 Dispose 方法。這個物件會維護非 Managed 的資源。如果依賴這個物件的完成，可能會導致應用程式中發生記憶體遺漏和例外狀況。

如需處置 Managed 物件的範例，請參閱Using the Managed Library。

這個控制項的執行階段使用者介面是使用不透明背景 (單色、圖片背景或者兩個都有) 的視窗，該背景內含不透明的筆墨。

您可以在 Microsoft Windows 2000、Windows Server 2003、任何版本的 Windows XP 和任何版本的 Windows Vista 中使用 InkPicture 控制項呈現筆墨，但是只可以在下列條件下輸入筆墨、接受筆勢或辨識手寫：

必須要安裝 Tablet and Touch Technology，才能輸入及辨識筆墨。
必須要安裝 Microsoft 筆勢辨識器，才能辨識筆勢。
如果手寫來源是其他地方，而且辨識器存在的話，就可以將手寫辨識為文字。

如果使用的是 Windows 2000、Windows Server 2003，或是除了 Tablet PC Edition 以外的任何 Windows XP 版本，您可以指派值給 InkPicture 控制項的環境屬性 (Ambient Property)，然後複製筆墨並將它貼到其他應用程式中，但是其 InkEnabled 屬性的值一定會是 false。

在所有版本的 Windows XP (包括 Tablet PC Edition) 上都可以載入並顯示永續性的 Ink 物件，但是必須要安裝 Windows XP Tablet PC Edition，才能將 Ink 物件轉換成 (已辨識的) 文字。

如需筆墨控制項的詳細資訊，請參閱Ink Controls。

如需哪些執行緒會引發特定事件的詳細資訊，請參閱Threads on Which an Event Can Fire。

為了提升應用程式的效能，應該在不再需要時手動處置 InkPicture 控制項。

安全性提示：如果在部分信任的情況下使用，這個類別及其所有方法都需要 SafeTopLevelWindows 權限。如需詳細資訊，請參閱Security and Trust。