WM_SETHOTKEY

Um aplicativo envia uma mensagem WM_SETHOTKEY para uma janela para associar uma tecla de atalho da janela. Quando o usuário pressiona a tecla de acesso, o sistema ativa a janela.

WM_SETHOTKEY wParam = MAKEWORD (WPARAM) (vChave, modificadores) / / virtual-código de chave e modificadores de hot lParam chave = 0;                                   / / não é usado; deve ser zero

Parâmetros

vchave

Valor de wParam. Especifica o virtual-código de chave e modificadores da tecla quente para associar com a janela. O código de chave virtual é o byte baixo do parâmetro e os sinalizadores de modificador são em byte alto. Definir este parâmetro como NULL remove a tecla de acesso associado com uma janela. O byte de modificador pode ser uma combinação dos sinalizadores a seguir.

Valor	Significado
HOTKEYF_ALT	Tecla ALT
HOTKEYF_CONTROL	Tecla CTRL
HOTKEYF_EXT	Chave estendida
HOTKEYF_SHIFT	Tecla SHIFT

Retornar valores

O valor de retorno é o seguinte:

Valor	Significado
– 1	A função for malsucedido — o tecla de acesso é inválido.
..0	A função for malsucedido — a janela é inválida.
..1	A função é bem-sucedido, e nenhuma outra janela tem a mesma chave quente.
..2	A função é bem-sucedido, mas outra janela já tem a mesma chave quente.

Observações

Uma tecla de acesso não pode ser associada com uma janela filho.

VK_ESCAPE, VK_SPACE e VK_TAB são teclas de acesso inválidas.

Quando o usuário pressiona a tecla de acesso, o sistema gera uma mensagem WM_SYSCOMMAND com wParam igual a SC_HOTKEY e lParam igual a alça da janela. Se esta mensagem é passada para DefWindowProc, o sistema irá trazer último popup ativo da janela (se existir) ou a janela própria (se não houver nenhuma janela pop-up) para o primeiro plano.

Uma janela pode ter apenas uma tecla de acesso. Se a janela já tem uma tecla de atalho associada a ele, a nova tecla de atalho substituirá o antigo. Se mais de uma janela tem a mesma chave quente, a janela que é ativada pela chave de quente é aleatória.

Estas teclas de atalho estão relacionadas para as teclas de atalho definidas pelo RegisterHotKey.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de entrada do teclado, as mensagens de entrada de teclado, RegisterHotKey, WM_GETHOTKEY, WM_SYSCOMMAND

Index