Função SetCapture (winuser.h)

Artigo
03/04/2024

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)