Share via


SetFocus

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função define o foco do teclado para a janela especificada. Todos os entrada do teclado subseqüente é direcionada para esta janela. A janela, se houver, que anteriormente tivesse o foco do teclado perde-lo.

Syntax

HWND SetFocus(
  HWND hWnd 
); 

Parameters

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

Return Value

O identificador para a janela que anteriormente tinha a foco do teclado indica sucesso. NULL Indica que o hWnd parâmetro é inválido ou a janela não está associado com fila de mensagens do segmento chamado. Para informações de erro estendidas get, chamar GetLastError.

Remarks

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

Se uma janela está ativo, mas não tem o foco, qualquer chave pressionado irá gerar o WM_SYSCHAR, WM_SYSKEYDOWNou WM_SYSKEYUP mensagem. Se o ALT chave também é pressionada, o lParam parâmetro da mensagem terá conjunto 30 bit. Caso contrário, as mensagens produzidas não tem esse bit definido.

Não use o SetFocus função para definir o foco do teclado para uma janela associado com fila de mensagens 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 segmento associado com uma janela pode definir o foco para a outra janela mesmo que ele pertence a um segmento diferente.

Requirements

Header winuser.h
Library Caret.lib, Foregnd.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Keyboard Functions