InkCollector.Handle (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

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

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

Sintaxis

'Declaración
Public Property Handle As IntPtr
'Uso
Dim instance As InkCollector
Dim value As IntPtr

value = instance.Handle

instance.Handle = value

public IntPtr Handle { get; set; }

public:
property IntPtr Handle {
    IntPtr get ();
    void set (IntPtr value);
}

/** @property */
public IntPtr get_Handle()
/** @property */
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 InkCollector.

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

Comentarios

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

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

Nota

Se debe deshabilitar el objeto InkCollector antes de establecer esta propiedad. Para deshabilitar el objeto InkCollector, 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 usa 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 usa en entornos de confianza parcial, esta propiedad necesita el permiso SecurityPermissionFlag.UnmanagedCode, además de los permisos que requiere InkCollector. Vea Security and Trust para obtener más información.

Ejemplos

En el ejemplo siguiente se muestra un método que se puede usar para dirigir un objeto InkCollector o InkOverlay para recopilar entradas manuscritas 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.