WM_SETHOTKEY mensagem

  • Artigo

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

#define WM_SETHOTKEY                    0x0032

Parâmetros

wParam

A palavra de baixa ordem especifica o código de chave virtual a ser associado à janela.

A palavra de alta ordem pode ser um ou mais dos valores a seguir de CommCtrl.h.

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

Valor Significado
HOTKEYF_ALT
0x04
 tecla ALT
HOTKEYF_CONTROL
0x02
 Tecla CTRL
HOTKEYF_EXT
0x08
 Tecla estendida
HOTKEYF_SHIFT
0x01
 Tecla SHIFT

lParam

Este parâmetro não é usado.

Valor retornado

O valor retornado é um dos seguintes.

Valor retornado Descrição
-1
 A função não tem êxito; a tecla de acesso é inválida.
0
 A função não tem êxito; a janela é inválida.
1
 A função é bem-sucedida e nenhuma outra janela tem a mesma tecla de acesso.
2
 A função foi bem-sucedida, mas outra janela já tem a mesma tecla de acesso.

Comentários

Uma tecla de acesso não pode ser associada a 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 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 tecla de acesso. Se a janela já tiver uma tecla de acesso associada a ela, a nova tecla de acesso substituirá a antiga. Se mais de uma janela tiver a mesma tecla de acesso, a janela ativada pela tecla de acesso será aleatória.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

Referência

Registerhotkey

WM_GETHOTKEY

WM_SYSCOMMAND

Conceitual

Entrada por teclado