WM_SETHOTKEY mensagem

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

#define WM_SETHOTKEY                    0x0032

Parâmetros

wParam

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

O byte alto da palavra de ordem baixa 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 de wParam é ignorada.

Definir wParam como NULL remove a tecla de atalho associada a uma janela.

lParam

Este parâmetro não é usado.

Valor de retorno

O valor de retorno é um dos seguintes.

Observações

Uma tecla de atalho não pode ser associada a uma janela filho.

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

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

Uma janela só pode ter uma tecla de atalho. Se a janela já tiver uma tecla de atalho associada, a nova tecla de atalho substitui a antiga. Se mais de uma janela tiver a mesma tecla de atalho, a janela ativada pela tecla de atalho será aleatória.

Estas teclas de atalho não estão relacionadas com as teclas de atalho definidas por RegisterHotKey.

Requerimentos

Ver também

Referência

RegistrarHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Conceptual

Entrada de Teclado