InkCollector.Enabled (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece un valor que especifica si el objeto InkCollector recopila la entrada manuscrita.

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

Sintaxis

'Declaración
Public Property Enabled As Boolean
'Uso
Dim instance As InkCollector
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

public bool Enabled { get; set; }

public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_Enabled()
/** @property */
public  void set_Enabled(boolean value)

public function get Enabled () : boolean
public function set Enabled (value : boolean)

Valor de propiedad

Tipo: System.Boolean
Es true si el objeto InkCollector recopila la entrada manuscrita. Es false si el objeto InkCollector no notifica la entrada manuscrita. No se desencadena ningún evento relacionado con la pluma.

Comentarios

Además de la entrada manuscrita, la entrada de la pluma puede incluir entradas en el aire, eventos de cursor en intervalo, etc.

El objeto InkCollector recopila la entrada manuscrita en Microsoft® Windows® XP Tablet PC Edition o en cualquier edición de Windows 2000, Windows Server 2003 o Windows XP en la que se instale el SDK de Windows XP Tablet PC Edition. Sin embargo, el reconocimiento de la escritura a mano solo se produce si usa Windows XP Tablet PC Edition. En cualquier edición de Windows 2000, Windows Server 2003 o Windows XP distinta de Windows XP Tablet PC Edition, la propiedad Enabled siempre es false si no se instala el SDK de Windows XP Tablet PC Edition.

Si el rectángulo de entrada de la ventana de un objeto InkCollector o InkOverlay habilitado (establecido en el constructor o con el método SetWindowInputRectangle) se superpone al rectángulo de entrada de la ventana de un objeto InkCollector, se produce una excepción COMException.

Nota

La superposición se puede producir sin errores con tal de que solo esté habilitado uno de los rectángulos de entrada en todo momento.

Mientras un control no está habilitado, no se recibe ningún evento.

Si establece la propiedad Enabled de un control contenedor en false, todos sus controles incluidos también se deshabilitan.

No puede establecer la propiedad Enabled en false mientras el objeto está recopilando entradas manuscritas (la propiedad CollectingInk es true).

La propiedad Enabled se debe establecer en false antes de definir o llamar a propiedades y métodos específicos del objeto. Si intenta cambiar las propiedades especificadas o llamar a los métodos especificados, se produce un error.

No se pueden establecer ni llamar las propiedades y métodos siguientes a menos que se establezca primero la propiedad Enabled en false:

Propiedades:
- Handle
- Ink
- MarginX
- MarginY
Métodos:
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

Debe establecer la propiedad Enabled de un objeto InkCollector en false antes de cerrar una aplicación.

Nota

Esta función puede volver a especificarse si la propiedad Enabled se establece en determinados controladores de mensajes, lo que produce resultados inesperados. Procure evitar que se produzca una llamada reentrante al controlar alguno de los siguientes mensajes WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam se establece en SC_HOTKEY o SC_TASKLIST, y WM_SYSKEYDOWN (al procesar las combinaciones de teclas Alt-Tab o Alt-Esc). Este problema se produce con las aplicaciones del modelo de contenedor uniproceso.

Ejemplos

En este ejemplo de C# se crea y se habilita un objeto InkCollector.

using Microsoft.Ink;
//...
InkCollector theInkCollector = new InkCollector(Handle);
theInkCollector.Enabled = true;
//...

En este ejemplo de Microsoft Visual Basic .NET se crea y se habilita un objeto InkCollector.

Imports Microsoft.Ink
'...
Dim theInkCollector As New InkCollector(Handle)
theInkCollector.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.