InkOverlay (Clase)

Artículo
11/26/2008

Actualización: noviembre 2007

Representa un objeto que resulta útil para los escenarios de anotación en los que a los usuarios no les preocupa realizar el reconocimiento de la entrada manuscrita si no que les interesa el tamaño, forma, color y posición de la entrada manuscrita.

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

Sintaxis

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

Comentarios

Advertencia

Para evitar una pérdida de memoria debe llamar explícitamente al método Dispose en cualquier objeto InkOverlay al que se haya asociado un controlador de eventos antes de que el objeto quede fuera de ámbito.

El objeto InkOverlay resulta adecuado para tomar notas y escribir a mano alzada. El uso principal previsto de este objeto es mostrar la entrada manuscrita como entrada manuscrita.

En general, la interfaz de usuario en tiempo de ejecución de este objeto es una ventana transparente con entrada manuscrita opaca.

Los eventos MouseDown, MouseMove, MouseUp y MouseWheel devuelven coordinadas X e Y en píxeles y no en unidades HIMETRIC que están asociadas al espacio de entrada manuscrita. Esto se debe a que estos eventos reemplazan a eventos del mouse de aplicaciones que no reconocen la pluma, y estas aplicaciones sólo entienden píxeles.

Advertencia

Si está estableciendo la propiedad AttachMode del objeto InkOverlay en InFront, cree el objeto InkOverlay en el subproceso en el que se está ejecutando el formulario. La aplicación puede dejar de responder si el objeto InkOverlay se crea en un subproceso diferente y su propiedad AttachMode se establece en InFront.

Nota

El objeto InkOverlay no se puede liberar sin riesgos en un subproceso que no sea de interfaz de usuario.

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

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

Jerarquía de herencia

System.Object
Microsoft.Ink.InkOverlay

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.