InkOverlay.Enabled (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

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

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

Sintaxis

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

value = instance.Enabled

instance.Enabled = value

[BrowsableAttribute(false)]
public bool Enabled { get; set; }

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

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

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

Valor de propiedad

Tipo: System.Boolean
Si el objeto InkOverlay recopila o no la entrada manuscrita.
Es true si el objeto InkOverlay recopila la entrada de la pluma.
Es falso si el objeto InkOverlay no notifica la entrada de la pluma. No se desencadena ningún evento relacionado con la pluma.

Comentarios

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

El objeto InkOverlay recopila la entrada manuscrita en Microsoft Windows Vista, Windows XP Tablet Edition o cualquier edición de Windows 2000, Windows Server 2003 o Windows XP en la que se instala Windows XP Tablet PC Edition SDK. Sin embargo, el reconocimiento de la escritura a mano se produce desde 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 es false si no se instala Windows XP Tablet PC Edition SDK.

Si el rectángulo de entrada de 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 ventana de un objeto InkOverlay, se produce una excepción COMException.

Nota

La superposición se puede producir sin errores con tal de que sólo 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 entrada manuscrita (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

Debería establecer la propiedad Enabled de un objeto InkOverlay en false antes de cerrar una aplicación.

Ejemplos

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

using Microsoft.Ink;
//...
InkOverlay theInkOverlay = new InkOverlay(Handle);
theInkOverlay.Enabled = true;
//...

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

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