RegisterHotKey

A função de RegisterHotKey define um tecla de acesso de todo o sistema.

(BOOL RegisterHotKey HWND  hWnd, / / janela para receber notificação de teclas de atalhoint id, / / identificador da tecla de acessoUINTfsModifiers, / / chave modificador sinalizadoresUINTVK / / virtual-chave código);
 

Parâmetros

hWnd

Identificador para a janela que receberá mensagens WM_HOTKEY geradas pelo tecla de acesso. Se este parâmetro é NULL, WM_HOTKEY mensagens são postadas para a fila de mensagens do segmento chamado e devem ser processadas no loop de mensagem.

identificação

Especifica o identificador da tecla de acesso. Nenhuma outra tecla de acesso no thread de chamada deve ter o mesmo identificador. Um aplicativo deve especificar um valor no intervalo de 0x0000 por meio de 0xBFFF. Uma biblioteca de vínculo dinâmico (DLL) compartilhada deve especificar um valor no intervalo 0xC000 a 0xFFFF (o intervalo retornado pelo GlobalAddAtom função). Para evitar conflitos com hot-chave identificadores definidos por outras DLLs compartilhadas, um DLL deve usar o GlobalAddAtom função para obter o identificador de hot-chave.

fsModifiers

Especifica as chaves que devem ser pressionadas em combinação com a chave especificada pelo parâmetro nVirtKey para gerar a mensagem WM_HOTKEY. O parâmetro fsModifiers pode ser uma combinação dos seguintes valores.

Valor	Significado
MOD_ALT	Deve ser pressionada qualquer tecla alt.
MOD_CONTROL	Deve ser pressionada qualquer tecla ctrl.
MOD_SHIFT	Qualquer tecla deve ser pressionada.
MOD_WIN	Qualquer chave WINDOWS foi pressionada. Essas chaves são rotuladas com o logótipo do Microsoft Windows.

vk

Especifica o código chave virtual da chave quente.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Quando uma tecla é pressionada, o sistema procura uma correspondência contra todas as teclas de atalho. Encontrar uma correspondência, o sistema envia a mensagem WM_HOTKEY para a fila de mensagens do segmento que registrou a tecla de acesso. Esta mensagem está lançada para o início da fila assim que ela é removida pela próxima iteração do loop de mensagem.

Essa função não é possível associar uma tecla de acesso com uma janela criada por outro segmento.

RegisterHotKey falhará se a combinação de teclas especificada para o tecla de acesso já foram registradas por outra tecla de acesso.

Se a janela identificada pelo hWnd parâmetro já registrou uma tecla de acesso com o mesmo identificador como especificado pelo parâmetro id , os novos valores para os parâmetros fsModifiers e vk substituem os valores para esses parâmetros especificados anteriormente.

Windows CE: Versões do Windows CE 2.0 e posteriores suportam um sinalizador adicional, chamado MOD_KEYUP, para o parâmetro de fsModifiers . Se você definir o sinalizador MOD_KEYUP, a janela será enviada uma mensagem WM_HOTKEY numa chave de evento, como também em uma tecla pressionada evento.

RegisterHotKey pode ser usado para registrar teclas de atalho em segmentos.

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.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de entrada de teclado, funções de entrada de teclado, GlobalAddAtom, UnregisterHotKey, WM_HOTKEY

Index