Funzione SetCapture (winuser.h)

Articolo
03/04/2024

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)