SetCapture

A função SetCapture define a captura do mouse para a janela especificada que pertence ao thread atual. Depois que a janela tenha capturado o mouse, todos entrada de mouse é dirigido para essa janela, independentemente de saber se o cursor estiver dentro das fronteiras dessa janela. Apenas uma janela em um tempo pode captura o mouse.

Se o cursor do mouse estiver sobre uma janela criada por outro thread, o sistema irá direcionar a entrada do mouse para a janela especificada somente se um botão do mouse é para baixo.

(HWND SetCapture HWND  hWnd / / identificador da janela para receber a captura do mouse);
 

Parâmetros

hWnd
Identificador para a janela na atual segmento que é capturar o mouse.

Retornar valores

O valor de retorno é o identificador da janela que anteriormente tinha capturado o mouse. Se não houver nenhuma janela, o valor de retorno é NULL.

Observações

Somente a janela primeiro plano pode captura o mouse. Quando uma janela segundo plano tenta fazê-lo, a janela recebe mensagens apenas de eventos mouse que ocorrer quando o ponto de acesso do cursor está dentro a parte visível da janela. Além disso, mesmo se a janela primeiro plano tenha capturado o mouse, o usuário pode ainda clique outra janela, trazendo-os para o primeiro plano.

Quando a janela não requer todas as entrada do mouse, o segmento que criado a janela deve chamar a função ReleaseCapture para soltar o botão do mouse.

Essa função não pode ser usada para capturar entrada mouse significada para outro processo.

Windows 95: Chamar SetCapture faz com que a janela que estiver perdendo a captura do mouse para receber uma mensagem WM_CAPTURECHANGED.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral da entrada do Mouse, funções de entrada do Mouse, GetCapture, ReleaseCapture, WM_CAPTURECHANGED

Index