Como usar teclas de aceleração dentro de uma caixa de diálogo modal no Visual C++

Teclas de aceleração são um recurso de interface de usuário comum de aplicativos do Windows; portanto, limitam-los por que a apenas o aplicativo? Este artigo mostra como adicionar funcionalidade da chave acelerador a qualquer caixa de diálogo modal.

Aceleradores de teclado são processados chamando a função TranslateAccelerator() em loop de mensagem principal do aplicativo. No entanto, para uma caixa de diálogo modal, o loop de mensagem diálogo caixa gerente (embutido no Windows) é usado para converter e distribuir mensagens. Obviamente, como esse loop de mensagem não foi projetado para processar aceleradores, ele não chama a função TranslateAccelerator().

Para processar teclas aceleradoras em uma caixa de diálogo restrita, você deve substituir PreTranslateMessage() da caixa de diálogo funcionar e tente processar a mensagem como um acelerador chamando:: TranslateAccelerator(). Se esse método falhar, processamento, em seguida, continua chamando a classe base PreTranslateMessage().

Para os fins deste artigo, podemos adicionar acelerador principais funcionalidades à caixa de diálogo AboutBox de um aplicativo MDI do MFC:

1. Crie um aplicativo MDI do MFC novo chamado Test.
2. Adicione um botão, com ID de recurso "IDC_BUTTON1", para o recurso de caixa de diálogo AboutBox.
3. Clique duas vezes o botão para adicionar um manipulador para este botão e insira o código a seguir como um indicador que a tecla aceleradora funciona:

   AfxMessageBox("Hello");

4. Inserir uma nova tabela de acelerador para o recurso.
5. Adicionar uma chave do acelerador à tabela associando o F5 chave a identificação do recurso "IDC_BUTTON1".
6. Adicione m_hAccelTable variável, o membro, à classe CAboutBox:

   HACCEL  m_hAccelTable;

7. Inicializar m_hAccelTable em CAboutBox::CAboutBox:

   m_hAccelTable = LoadAccelerators(AfxGetInstanceHandle(), MAKEINTRESOURCE(IDR_ACCELERATOR1));

8. Use o Assistente de código (o Assistente classe no Visual C++ 6.0 e versões anteriores) para adicionar uma substituição do PreTranslateMessage para o CAboutDlg.
9. No método CAboutBox::PreTranslateMessage(), adicione as linhas de código a seguir:

   BOOL CAboutDlg::PreTranslateMessage(MSG* pMsg) {
      if (m_hAccelTable) {
         if (::TranslateAccelerator(m_hWnd, m_hAccelTable, pMsg)) {
            return(TRUE);
         }
      }
      return CDialog::PreTranslateMessage(pMsg);
   
   }

10. Compile e execute CTestApp.

resultados Tecla aceleradora F5 agora aciona o manipulador de button1 quando o CAboutBox está ativo.

Para obter informações adicionais sobre tecla aceleradora de processamento em caixas de diálogo modal, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft: