Metodo IInkCollector::get_Enabled (msinkaut.h)

Articolo
08/24/2023

Ottiene o imposta un valore che specifica se l'oggetto InkCollector raccoglie l'input penna (pacchetti in aria, cursori negli eventi di intervallo e così via).

Si tratta di una proprietà di lettura/scrittura.

Sintassi

HRESULT get_Enabled(
  VARIANT_BOOL *Collecting
);

Parametri

Collecting

Valore restituito

nessuno

Osservazioni

Se il rettangolo di input della finestra di un oggetto abilitato (impostato nel costruttore o con il metodo SetWindowInputRectangle ) di un oggetto abilitato si sovrappone al rettangolo di input della finestra di un altro oggetto abilitato, viene restituito l'errore E_INK_OVERLAPPING_INPUT_RECT. La sovrapposizione può verificarsi senza un errore, purché solo uno dei rettangoli di input sia abilitato in qualsiasi momento noto.

Mentre un oggetto non è abilitato, non si ricevono eventi.

Quando un controllo contenitore ha la proprietà Enabled impostata su FALSE, vengono disabilitati anche tutti i relativi controlli contenuti.

Non è possibile impostare la proprietà Enabled su FALSE mentre l'oggetto raccoglie l'input penna (la proprietà CollectInk è TRUE).

È consigliabile impostare Abilitato su FALSE quando l'applicazione viene arrestata.

Nota L'impostazione di questa proprietà all'interno di determinati gestori di messaggi può comportare la reinsezione della funzione sottostante, causando risultati imprevisti. Prestare attenzione a evitare una chiamata reentrante 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 di combinazioni di tasti di Alt-Tab o di Alt-Esc). Si tratta di un problema con le applicazioni di modello apartment a thread singolo.

Questa proprietà deve essere impostata su FALSE prima di impostare o chiamare proprietà e metodi specifici dell'oggetto. Se si tenta di modificare le proprietà o i metodi specificati, si verifica un errore. Le proprietà e i metodi seguenti non possono essere impostati o chiamati a meno che la proprietà Enabled non sia impostata per la prima volta su FALSE:

Proprietà

Metodi

Requisiti


Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll