InkPicture (Clase)

Artículo
11/26/2008

Actualización: noviembre 2007

El control InkPicture proporciona la capacidad de colocar una imagen en una aplicación y permitir a los usuarios agregar entrada manuscrita sobre ella. Está pensado para escenarios en los que la entrada manuscrita no se reconoce como texto pero sí se almacena como entrada manuscrita.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
Public Class InkPicture _
    Inherits PictureBox
'Uso
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

Comentarios

Advertencia

Debe llamar al método Dispose en este objeto antes de que dicho objeto esté fuera de ámbito. Este objeto mantiene recursos no administrados. Confiar en la finalización de este objeto puede producir pérdidas de memoria y excepciones dentro de la aplicación.

Para obtener un ejemplo sobre la eliminación de objetos administrados, vea Using the Managed Library.

La interfaz de usuario en tiempo de ejecución de este control es una ventana con un fondo opaco (un único color, una imagen de fondo, o ambos) que contiene entrada manuscrita opaca.

Puede utilizar el control InkPicture para representar la entrada manuscrita en Microsoft Windows 2000, Windows Server 2003, cualquier edición de Windows XP y cualquier versión de Windows Vista. Sin embargo, puede introducir entrada manuscrita, aceptar movimientos o reconocer escritura a mano sólo bajo las siguientes condiciones:

La entrada manuscrita sólo se puede introducir y reconocer si está instalada la Tecnología táctil y de Tablet PC.
Los movimientos sólo se pueden reconocer si está instalado el reconocedor de movimiento de Microsoft.
La escritura a mano se puede reconocer como texto si ésta se realizó en otra parte y si existen reconocedores.

Si usa Windows 2000, Windows Server 2003 o alguna edición de Windows XP que no sea Tablet PC Edition, puede asignar valores a las propiedades ambiente del control InkPicture y copiar y pegar la entrada manuscrita en otras aplicaciones, pero el valor de su propiedad InkEnabled es siempre false.

Los objetos Ink conservados se pueden cargar y mostrar en todas las ediciones de Windows XP (incluso la edición para Tablet PC). Sin embargo, los objetos Ink se pueden convertir en texto (reconocidos) sólo si está instalado Windows XP Tablet PC Edition.

Para obtener más información sobre los controles de entrada manuscrita, vea Ink Controls.

Para obtener información sobre qué subprocesos provocan determinados eventos, vea Threads on Which an Event Can Fire.

Para mejorar el rendimiento de la aplicación, elimine manualmente un control InkPicture cuando ya no lo necesite.

Nota de seguridad Si se utiliza con confianza parcial, esta clase y todos sus métodos requieren el permiso SafeTopLevelWindows.Vea Security and Trust para obtener más información.

Jerarquía de herencia

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

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.