WM_SETHOTKEY mensagem

Enviado para uma janela para associar uma chave quente à janela. Quando o usuário pressiona a tecla de acesso, o sistema ativa a janela.

#define WM_SETHOTKEY                    0x0032

Parâmetros

wParam

O byte baixo da palavra de baixa ordem especifica o código de chave virtual a ser associado à janela.

O byte alto da palavra de baixa ordem pode ser um ou mais dos seguintes valores de CommCtrl.h.

Valor	Significado
HOTKEYF_ALT 0x04	Tecla Alt
HOTKEYF_CONTROL 0x02	Tecla CTRL
HOTKEYF_EXT 0x08	Chave estendida
HOTKEYF_SHIFT 0x01	Tecla SHIFT

A palavra de alta ordem do wParam é ignorada.

A configuração de wParam como NULL remove a tecla de acesso associada a uma janela.

lParam

Esse parâmetro não é usado.

Valor de retorno

O valor retornado é um dos seguintes.

Observações

Uma chave quente não pode ser associada a uma janela filho.

VK_ESCAPE, VK_SPACE, VK_TAB e VK_PACKET são chaves frequentes inválidas.

Quando o usuário pressiona a tecla ativa, o sistema gera uma mensagem WM_SYSCOMMAND com wParam igual a SC_HOTKEY e lParam igual ao identificador da janela. Se essa mensagem for passada para DefWindowProc, o sistema colocará o último pop-up ativo da janela (se existir) ou a própria janela (se não houver janela pop-up) em primeiro plano.

Uma janela só pode ter uma chave quente. Se a janela já tiver uma chave quente associada a ela, a nova tecla de acesso substituirá a antiga. Se mais de uma janela tiver a mesma chave quente, a janela ativada pela chave quente será aleatória.

Essas teclas frequentes não estão relacionadas às teclas de acesso definidas pelo RegisterHotKey.

Requisitos

Consulte também

Referência

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Conceitual

de entrada do teclado