Condividi tramite


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