InkOverlay 类

项目
10/28/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

备注

警告

为了避免内存泄漏，必须在已附加事件处理程序的任何 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。