Funzione SetCapture (winuser.h)
Imposta l'acquisizione del mouse sulla finestra specificata appartenente al thread corrente. SetCapture acquisisce l'input del mouse quando il mouse si trova sopra la finestra di acquisizione o quando il pulsante del mouse è stato premuto mentre il mouse era sopra la finestra di acquisizione e il pulsante è ancora inattivo. Una sola finestra alla volta può acquisire il mouse.
Se il cursore del mouse si trova su una finestra creata da un altro thread, il sistema indirizza l'input del mouse alla finestra specificata solo se un pulsante del mouse è inattivo.
Sintassi
HWND SetCapture(
[in] HWND hWnd
);
Parametri
[in] hWnd
Tipo: HWND
Handle nella finestra del thread corrente che consiste nell'acquisizione del mouse.
Valore restituito
Tipo: HWND
Il valore restituito è un handle della finestra che in precedenza ha acquisito il mouse. Se non esiste una finestra di questo tipo, il valore restituito è NULL.
Commenti
Solo la finestra in primo piano può acquisire il mouse. Quando una finestra di sfondo tenta di farlo, la finestra riceve messaggi solo per gli eventi del mouse che si verificano quando il cursore si trova all'interno della parte visibile della finestra. Inoltre, anche se la finestra in primo piano ha acquisito il mouse, l'utente può comunque fare clic su un'altra finestra, portandola in primo piano.
Quando la finestra non richiede più tutti gli input del mouse, il thread che ha creato la finestra deve chiamare la funzione ReleaseCapture per rilasciare il mouse.
Questa funzione non può essere usata per acquisire l'input del mouse destinato a un altro processo.
Quando il mouse viene acquisito, i tasti di scelta rapida dei menu e altri acceleratori di tastiera non funzionano.
Esempio
Per un esempio, vedere Linee di disegno con il mouse.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-mouse-l1-1-0 (introdotto in Windows 8) |
Vedi anche
Informazioni concettuali
Riferimento