Proprietà InkCollector.Enabled

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene o imposta un valore che specifica se l'oggetto InkCollector raccoglie l'input penna.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Property Enabled As Boolean
'Utilizzo
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)

Valore proprietà

Tipo: System.Boolean
true se l'oggetto InkCollector raccoglie l'input penna. false se l'oggetto InkCollector non segnala l'input penna. Non vengono generati eventi correlati alla penna.

Note

L'input penna può includere inoltre pacchetti in-air, il cursore in eventi dell'intervallo e così via.

L'oggetto InkCollector raccoglie l'input penna in Microsoft® Windows® XP Tablet PC Edition o in qualsiasi versione di Windows 2000, Windows Server 2003 o Windows XP in cui sia installato l'SDK di Windows XP Tablet PC Edition. Tuttavia, il riconoscimento grafia è possibile solo se si utilizza Windows XP Tablet PC Edition. In tutte le versioni di Windows 2000, Windows Server 2003 o Windows XP diverse da Windows XP Tablet PC Edition, la proprietà Enabled risulta sempre false se non è installato Windows XP Tablet PC Edition SDK.

Se il rettangolo di input della finestra di un oggetto InkCollector o InkOverlay attivato (impostato nel costruttore o con il metodo SetWindowInputRectangle) è sovrapposto al rettangolo di input della finestra di un oggetto InkCollector, viene generata un'eccezione COMException.

Nota

La sovrapposizione può verificarsi senza errori se in qualsiasi momento è abilitato uno solo dei rettangoli di input.

Se non è attivato un controllo, non si ricevono eventi.

Quando si imposta la proprietà Enabled di un controllo contenitore su false, vengono disattivati anche tutti i controlli in esso contenuti.

Non è possibile impostare la proprietà Enabled su false mentre l'oggetto raccoglie l'input penna (la proprietà CollectingInk risulta true).

La proprietà Enabled deve essere impostata su false prima di impostare o chiamare proprietà e metodi specifici dell'oggetto. Se si tenta di modificare le proprietà specificate o di chiamare i metodi specificati, viene generato un errore.

Le proprietà e i metodi seguenti non possono essere impostati o chiamati a meno che la proprietà Enabled non sia impostata prima su false:

Proprietà:
- Handle
- Ink
- MarginX
- MarginY
Metodi:
- SetAllTabletsMode
- SetSingleTabletIntegratedMode

È necessario impostare la proprietà Enabled di un oggetto InkCollector su false prima di chiudere un'applicazione.

Nota

Se all'interno di alcuni gestori di messaggi è impostata la proprietà Enabled, è possibile che questa funzione venga reimmessa, provocando risultati imprevisti. Prestare attenzione per evitare una chiamata rientrante durante la gestione di uno dei messaggi seguenti: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT, WM_SYSCOMMAND se wParam è impostato su SC_HOTKEY o SC_TASKLIST e WM_SYSKEYDOWN (durante l'elaborazione delle combinazioni di tasti ALT-TAB o ALT-ESC). Questo problema è relativo alle applicazioni con modello di apartment a thread singolo.

Esempi

In questo esempio di C# viene creato e attivato un oggetto InkCollector.

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

In questo esempio di Microsoft Visual Basic. NET viene creato e attivato un oggetto InkCollector.

Imports Microsoft.Ink
'...
Dim theInkCollector As New InkCollector(Handle)
theInkCollector.Enabled() = True
'...

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.