InkCollector.Handle (Propiedad)
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)). |
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.
![]() |
---|
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.
Información de versión
.NET Framework
Compatible con: 3.0