InkPicture 类

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 方法。此对象维护非托管资源。依赖于此对象的终止操作可能造成应用程序中出现内存泄漏和异常。

有关释放托管对象的示例,请参见Using the Managed Library

此控件的运行时用户界面为具有不透明背景(纯色、图片背景或两者同用)且包含不透明墨迹的窗口。

可以使用 InkPicture 控件在 Microsoft Windows 2000、Windows Server 2003、任何版本的 Windows XP 以及任何版本的 Windows Vista 中呈现墨迹。但是,只有在以下情况下,才可以输入墨迹、接受笔势或识别手写 内容:

  • 只有安装了 Tablet 和触摸技术才能输入和识别墨迹。

  • 只有安装了 Microsoft 笔势识别器才能识别笔势。

  • 如果手写源于别处且存在识别器,则可将手写识别为文本。

如果使用的是 Windows 2000、Windows Server 2003 或非 Tablet PC Edition 的任何 Windows XP 版本,虽然可以为 InkPicture 控件的环境属性赋值,也可以将墨迹复制并粘贴到其他应用程序中,但该控件的 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

继承层次结构

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.PictureBox
          Microsoft.Ink.InkPicture

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

InkPicture 成员

Microsoft.Ink 命名空间

InkOverlay

其他资源

Ink Controls

Threads on Which an Event Can Fire