SetFocus

O SetFocus função define o foco do teclado para a janela especificada. A janela deve ser associada com fila de mensagens do segmento chamado.

 (HWND SetFocus HWND  hWnd / / identificador para uma janela para receber o foco);
 

Parâmetros

hWnd
Identificador para a janela que receberá a entrada do teclado. Se este parâmetro é NULL, pressionamentos de tecla são ignorados.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador para a janela que anteriormente tinha o foco do teclado. Se a pasta hWnd parâmetro é inválido ou a janela não está associada com fila de mensagens do segmento chamado, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

O SetFocus função envia uma mensagem WM_KILLFOCUS para a janela que perde o foco do teclado e uma mensagem WM_SETFOCUS para a janela que recebe o foco do teclado. Ela também ativa a janela que recebe o foco ou o pai da janela que recebe o foco.

Se uma janela está ativa, mas não tem o foco, qualquer tecla pressionada produzirá o WM_SYSCHAR, WM_SYSKEYDOWNou WM_SYSKEYUP mensagem. Se a chave VK_MENU também é pressionada, o lParam parâmetro da mensagem será bit conjunto 30. Caso contrário, as mensagens produzidas não têm esse bit definido.

Usando a função AttachThreadInput , um thread pode anexar sua entrada para outro thread de processamento. Isso permite que um thread chamar SetFocus para definir o foco do teclado para a janela associado com fila de mensagem do outro segmento.

Windows CE: Não use o SetFocus função para definir o foco do teclado para a janela associado com fila de mensagem do outro segmento. Há uma exceção. Se uma janela em um segmento é o filho da janela no outro segmento, ou se as janelas são irmãos do mesmo pai, o thread associado com uma janela pode definir o foco para a janela do outra mesmo que ele pertence a um segmento diferente. Neste caso, não é necessário chamar AttachThreadInput primeiro.

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 de entrada de teclado, funções de entrada de teclado, AttachThreadInput, GetFocus, WM_KILLFOCUS, WM_SETFOCUS, WM_SYSCHAR, WM_SYSKEYDOWN, WM_SYSKEYUP

Index