InkOverlay 類別

發行項
10/29/2008

表示有助於附註使用者感興趣之筆墨內容的物件，適合使用者對筆墨辨識過程不感興趣但對筆墨的大小、形狀、色彩和位置有興趣的情況。

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

語法

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

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

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

/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class InkOverlay implements IDisposable

public class InkOverlay implements IDisposable

備註

警告

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

InkOverlay 物件非常適合記事和基本塗鴉。充分發揮筆墨的作用是這個物件的主要用途。

一般而言，這個物件的執行階段使用者介面是一種兼具透明視窗和不透明筆墨的介面。

MouseDown、MouseMove、MouseUp 和 MouseWheel 事件所傳回的 X 及 Y 座標是以像素為單位，而非以與筆墨空間關聯的 HIMETRIC 為單位。這是因為這些事件取代了無畫筆感應之應用程式的滑鼠事件，而這一類的應用程式只能處理像素。

警告

若您將 InkOverlay 物件的 AttachMode 屬性設定為 InFront，則在執行表單的執行緒中就會建立 InkOverlay 物件。如果 InkOverlay 物件是在不同執行緒中建立的，而且它的 AttachMode 屬性是設定為 InFront，您的應用程式可能會停止回應。

注意事項：
在非使用者介面 (UI) 執行緒上無法安全地釋放 InkOverlay 物件。

為了提升應用程式的效能，應該在不再需要時手動處置 InkOverlay 物件。

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