SetCapture

La funzione SetCapture imposta la cattura del mouse nella finestra specificata appartenendo al thread corrente. Una volta che una finestra ha catturato il mouse, tutti del mouse input diretti a quella finestra, indipendentemente dal fatto se il cursore è all'interno dei confini di quella finestra. Solo una finestra in un momento in grado di catturare il mouse.

Se il cursore del mouse sopra una finestra creata da un altro thread, il sistema lo dirige input del mouse nella finestra specificata solo se un pulsante del mouse è premuto.

(HWND SetCapture HWND  hWnd / / handle di finestra per ricevere mouse capture);
 

Parametri

hWnd
Gestire alla finestra nel thread corrente che è quello di catturare il mouse.

Valori restituiti

Il valore restituito è l'handle della finestra che in precedenza aveva catturato il mouse. Se non non c'è nessuna tale finestra, il valore restituito è NULL.

Osservazioni

Solo la finestra in primo piano può catturare il mouse. Quando una finestra di sfondo tenta di farlo, la finestra riceve i messaggi solo per gli eventi del mouse che si verificano quando il punto caldo del cursore si trova la parte visibile della finestra. Inoltre, anche se la finestra in primo piano ha catturato il mouse, l'utente può ancora scegliere un'altra finestra, portandolo al primo piano.

Quando la finestra non è più necessario tutto l'input del mouse, il thread che ha creato la finestra deve chiamare la funzione ReleaseCapture per rilasciare il mouse.

Questa funzione non può essere utilizzata per acquisire l'input del mouse significato per un altro processo.

Windows 95: Chiamata SetCapture determina la finestra che sta perdendo la cattura del mouse per ricevere un messaggio WM_CAPTURECHANGED.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Cenni preliminari sull'Input del Mouse, funzioni di Input del Mouse, GetCapture, ReleaseCapture, WM_CAPTURECHANGED

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index