Metodo IInkPicture::SetWindowInputRectangle (msinkaut.h)

Modifica il rettangolo della finestra, in pixel, all'interno del quale viene disegnato l'input penna.

Sintassi

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

Parametri

[in] WindowInputRectangle

Rettangolo, nelle coordinate della finestra, su cui viene disegnato l'input penna.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
E_INVALIDARG	Le coordinate del rettangolo non sono valide,ad esempio larghezza/altezza pari a 0.
E_INK_COLLECTOR_BUSY	Impossibile aggiornare i mapping mentre al centro di un tratto.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo.
E_INK_OVERLAPPING_INPUT_RECT	Il rettangolo di input della finestra si sovrappone al rettangolo di input della finestra di un oggetto InkCollector abilitato.

Commenti

L'errore E_INK_OVERLAPPING_INPUT_RECT viene restituito se il rettangolo di input della finestra di un agente di raccolta input penna abilitato(impostato con la proprietà Enabled ) sovrappone il rettangolo di input della finestra di un altro agente di raccolta input penna abilitato.

Nota La sovrapposizione può verificarsi senza un errore purché solo uno dei rettangoli di input sia abilitato in qualsiasi momento noto.

 

Per impostazione predefinita, il rettangolo di input della finestra è impostato su {0,0,0,0}. Questo rettangolo predefinito esegue il mapping alle dimensioni dell'intera finestra.

Per reimpostare il rettangolo di input della finestra nel comportamento predefinito (un rettangolo vuoto con coordinate {0,0,0,0}), passare {0,0,0,0} la chiamata a SetWindowInputRectangle e non NULL.

Non è possibile passare un rettangolo in cui il valore della proprietà Right è minore del valore della proprietà Left ; o dove il valore della proprietà Bottom è minore del valore della proprietà Top . Ad esempio, un rettangolo con parametri di {500, 500, 400, 400} non è valido.

Attenzione Se si imposta il rettangolo di input della finestra per sovrapporsi a un controllo splitter o ai bordi della finestra, i risultati imprevedibili possono verificarsi quando la finestra viene ridimensionata.

 

Nota La chiamata a questo metodo all'interno di determinati gestori di messaggi può comportare la reinsezione 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.

 

Requisiti

Requisito	Valore
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

Vedi anche

Proprietà Enabled

Metodo GetWindowInputRectangle

IInkPicture

Inkpicture