InkPicture.InkEnabled (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene o establece un valor que especifica si el control InkPicture recopila la entrada manuscrita.

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

Sintaxis

'Declaración
<BrowsableAttribute(True)> _
Public Property InkEnabled As Boolean
'Uso
Dim instance As InkPicture
Dim value As Boolean

value = instance.InkEnabled

instance.InkEnabled = value

[BrowsableAttribute(true)]
public bool InkEnabled { get; set; }

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

/** @property */
/** @attribute BrowsableAttribute(true) */
public boolean get_InkEnabled()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_InkEnabled(boolean value)

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

Valor de propiedad

Tipo: System.Boolean
Es true si el control InkPicture recopila la entrada de la pluma. Valor predeterminado.
Es false si el control InkPicture 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 paquetes en el aire, eventos de cursor en intervalo, etc.

El control InkPicture recopila la entrada manuscrita en Microsoft® Windows® XP Tablet PC 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 sólo se produce si utiliza 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 InkEnabled siempre es false si no se instala Windows XP Tablet PC Edition SDK.

Si el rectángulo de entrada de ventana de un control 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 control InkPicture, 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 InkEnabled en false mientras el control está recopilando entrada manuscrita (la propiedad CollectingInk es true).

La propiedad InkEnabled se debe establecer en false antes de definir o llamar a propiedades y métodos específicos del control. 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 InkEnabled en false:

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

Debería establecer la propiedad InkEnabled de un control InkPicture en false antes de cerrar una aplicación.

Ejemplos

En el ejemplo siguiente se define un controlador de eventos de un evento ButtonClick. Cuando se desencadena el evento, el controlador alterna el valor de la propiedad InkEnabled y actualiza el texto de Button para reflejar qué acción realizará el siguiente clic.

' Event handler for the button's Click event.
Private Sub buttonToggle_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles buttonToggle.Click
    ' toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = Not mInkPicture.InkEnabled
    If mInkPicture.InkEnabled Then
        DirectCast(sender, Button).Text = "Disable Ink"
    Else
        DirectCast(sender, Button).Text = "Enable Ink"
    End If

End Sub

// Event handler for the button's Click event.
private void buttonToggle_Click(object sender, System.EventArgs e)
{
    // toggle the InkEnabled property and update button text
    mInkPicture.InkEnabled = !mInkPicture.InkEnabled;
    ((Button)sender).Text = (mInkPicture.InkEnabled) ? "Disable Ink" : "Enable Ink";
}

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.