Metodo IInkOverlay::get_Enabled (msinkaut.h)

Articolo
03/08/2023

Ottiene o imposta un valore che specifica se l'oggetto InkOverlay 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 un rettangolo di input della finestra dell'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, tutti i controlli contenuti sono disabilitati.

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 messaggi può comportare l'immissione nuovamente della funzione sottostante, causando risultati imprevisti. Prestare attenzione a evitare una chiamata reentrant 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 Alt-Tab o Alt-Esc). Si tratta di un problema con applicazioni di modello 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 prima impostata 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