InkOverlay.Handle (Propiedad)

Artículo
10/28/2008

Actualización: noviembre 2007

Obtiene o establece el identificador de ventana al que está asociado el objeto InkOverlay.

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

Sintaxis

'Declaración
<BrowsableAttribute(False)> _
Public Property Handle As IntPtr
'Uso
Dim instance As InkOverlay
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

[BrowsableAttribute(false)]
public IntPtr Handle { get; set; }

[BrowsableAttribute(false)]
public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public IntPtr get_Handle()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Handle(IntPtr value)

public function get Handle () : IntPtr
public function set Handle (value : IntPtr)

Valor de propiedad

Tipo: System.IntPtr
Identificador de ventana al que está asociado el objeto InkOverlay.

Valor	Significado
nullreferencia null (Nothing en Visual Basic)	El objeto InkOverlay no está asociado a una ventana (si AttachedControl es también nullreferencia null (Nothing en Visual Basic)).
System.Windows.Forms.	Identificador de ventana al que está asociado el objeto InkOverlay.

Comentarios

Se debe establecer la propiedad Handle o AttachedControl para poder habilitar el objeto InkOverlay.

Si se asocia el objeto InkOverlay a un identificador de ventana, el establecimiento de esta propiedad asocia el objeto InkOverlay a un control y borra la propiedad AttachedControl.

Nota

Se debe deshabilitar el objeto InkOverlay antes de establecer esta propiedad. Para deshabilitar el objeto InkOverlay, establezca la propiedad Enabled en false. A continuación, puede establecer esta propiedad y volver a habilitar el objeto estableciendo la propiedad Enabled en true.

Si utiliza las propiedades AttachedControl y Handle en la aplicación, obtendrá una excepción de seguridad al ejecutar la aplicación en la zona de Internet. Esto se debe a que la propiedad Handle no es válida en el entorno de confianza parcial de la zona de Internet, de modo que el sistema operativo de Tablet PC revierte a la propiedad AttachedControl.

Nota de seguridad:
Si se utiliza en entornos de confianza parcial, esta propiedad necesita el permiso SecurityPermissionFlag.UnmanagedCode, además de los permisos requeridos por InkOverlay. Vea Security and Trust para obtener más información.

Ejemplos

En el ejemplo siguiente se muestra un método que se puede utilizar para dirigir un objeto InkCollector o InkOverlay para recopilar entrada manuscrita en un nuevo control.

Private Sub SwitchInkObjectHandle(ByVal collectingControl As Control)
    ' mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = False
    ' setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle
    mInkObject.Enabled = True
End Sub

private void SwitchInkObjectHandle(Control collectingControl)
{
    // mInkObject can be InkCollector or InkOverlay
    mInkObject.Enabled = false;
    // setting the Handle property sets the AttachedControl property to null
    mInkObject.Handle = collectingControl.Handle;
    mInkObject.Enabled = true;
}

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.