Partilhar via


CWnd::OnHotKey

A estrutura chama essa função de membro quando o usuário pressiona uma tecla de acesso em qualquer sistema.

afx_msg void OnHotKey(
    UINT nHotKeyId, 
    UINT nKey1, 
    UINT nKey2
);

Parâmetros

Parâmetro

Descrição

[in] nHotKeyId

Identificador para a tecla de acesso que gerou a mensagem.Se a mensagem foi gerada por uma tecla de acesso sistema definida, este parâmetro será um dos seguintes valores:

  • IDHOT_SNAPDESKTOP - a tecla de acesso instantânea da área de trabalho foi pressionada.

  • IDHOT_SNAPWINDOW - a tecla de acesso instantânea da janela foi pressionada.

[in] nKey1

Um combinação bit a bit (OPERADOR) de sinalizadores que indicam as chaves que foram pressionadas em combinação com a chave especificado pelo parâmetro de nKey2 .Os valores possíveis são:

  • MOD_ALT - ou a tecla ALT foi mantido pressionado.

  • MOD_CONTROL - ou a tecla CTRL foi mantido pressionado.

  • MOD_SHIFT - ou a tecla SHIFT foi mantido pressionado.

  • MOD_WIN - qualquer tecla Windows foi mantido pressionado.Essas chaves são rotuladas com o logotipo do Microsoft Windows.

[in] nKey2

O código da tecla virtual da tecla de acesso.

Comentários

Este método recebe notificação de WM_HOTKEY , que é descrita em Windows SDK.Essa mensagem é colocada na fila mensagem associada com o segmento que registrou a tecla de acesso.Use a função de RegisterHotKey para registrar uma tecla de acesso em qualquer sistema.

ObservaçãoObservação

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece para a função.

Requisitos

Cabeçalho: afxwin.h

Este método é suportado em Windows Vista e posteriormente.

Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.

Consulte também

Referência

CWnd Class

Gráfico de hierarquia

WM_HOTKEY