Função SetCapture (winuser.h)
Define a captura do mouse para a janela especificada que pertence ao thread atual. SetCapture captura a entrada do mouse quando o mouse está sobre a janela de captura ou quando o botão do mouse foi pressionado enquanto o mouse estava sobre a janela de captura e o botão ainda está inativo. Somente uma janela de cada vez pode capturar o mouse.
Se o cursor do mouse estiver sobre uma janela criada por outro thread, o sistema direcionará a entrada do mouse para a janela especificada somente se um botão do mouse estiver inativo.
Sintaxe
HWND SetCapture(
[in] HWND hWnd
);
Parâmetros
[in] hWnd
Digite: HWND
Um identificador para a janela no thread atual que deve capturar o mouse.
Retornar valor
Digite: HWND
O valor retornado é um identificador para a janela que havia capturado anteriormente o mouse. Se não houver essa janela, o valor retornado será NULL.
Comentários
Somente a janela em primeiro plano pode capturar o mouse. Quando uma janela em segundo plano tenta fazer isso, a janela recebe mensagens somente para eventos do mouse que ocorrem quando o ponto de acesso do cursor está dentro da parte visível da janela. Além disso, mesmo que a janela em primeiro plano tenha capturado o mouse, o usuário ainda poderá clicar em outra janela, colocando-a em primeiro plano.
Quando a janela não exigir mais toda a entrada do mouse, o thread que criou a janela deverá chamar a função ReleaseCapture para liberar o mouse.
Essa função não pode ser usada para capturar a entrada do mouse destinada a outro processo.
Quando o mouse é capturado, as teclas de acesso do menu e outros aceleradores de teclado não funcionam.
Exemplos
Para obter um exemplo, consulte Linhas de Desenho com o Mouse.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-mouse-l1-1-0 (introduzido em Windows 8) |
Confira também
Conceitual
Referência