Compartilhar via


Evento Report.KeyUp (Access)

O evento KeyUp ocorrerá quando o usuário libera uma tecla enquanto um relatório tem o foco. Esse evento também ocorre se você enviar um pressionamento de tecla para um relatório usando a ação EnviarSequênciaDeCaracteres em uma macro ou da instrução SendKeys no Visual Basic.

Sintaxe

expressão. KeyUp (KeyCode, Shift)

expressão Uma variável que representa um objeto Relatório .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
KeyCode Obrigatório Integer Um código de chave, como vbKeyF1 (a chave F1) ou vbKeyHome (a tecla Home). Para especificar códigos de tecla, use as constantes intrínsecas mostradas no Pesquisador de objetos. Pode impedir que um objeto receba um batimento de tecla ao definir KeyCode como 0.
Shift Obrigatório Integer O estado das teclas Shift, Ctrl e Alt no momento do evento. Se precisar de testar o argumento Shift , pode utilizar uma das seguintes constantes intrínsecas como máscaras de bits:
  • acShiftMask A máscara de bits da tecla Shift.

  • acCtrlMask A máscara de bits da tecla Ctrl.

  • acAltMask A máscara de bits da tecla Alt.

Comentários

Para executar um macro ou procedimento de evento quando esses eventos ocorrerem, defina a propriedade OnKeyUp com o nome da macro ou como [procedimento do evento].

Um relatório também receberá todos os eventos de teclado, mesmo aqueles que ocorrem para controles, se você definir a propriedade KeyPreview do relatório como Sim. Com a configuração dessa propriedade, todos os eventos de teclado ocorrem primeiro para o relatório e, em seguida, para o controle que tem o foco. Uma determinada combinação de teclas pode executar uma ação, independentemente do controle que tenha o foco. Por exemplo, poderá querer que a combinação de teclas Ctrl+X execute sempre a mesma ação num relatório.

Se premir sem soltar uma tecla, os eventos KeyDown e KeyPress alternam repetidamente (KeyDown, KeyPress, KeyDown, KeyPress, etc.) até libertar a tecla e, em seguida, ocorre o evento KeyUp .

Embora o evento KeyUp ocorra quando a maioria das teclas é pressionada, ele geralmente é utilizado para reconhecer ou diferenciar:

  • Teclas de caracteres estendidos, como as teclas de função.

  • Teclas de navegação, como Base, Fim, PgUp, PgDn, Seta Para Cima, Seta Para Baixo, Seta Para a Direita, Seta Para a Esquerda e Tecla de Tabulação.

  • Combinações de teclas e modificadores de teclado padrão (teclas Shift, Ctrl ou Alt).

  • O teclado numérico e teclas numéricas do teclado.

Para descobrir o caractere ANSI correspondente à tecla pressionada, utilize o evento KeyPress.

Se uma caixa de diálogo restrita for exibida como resultado do pressionamento ou envio de uma tecla, os eventos KeyDown e KeyPress ocorrem, mas o evento KeyUp não ocorre.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.