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

mais simples. KeyUp (KeyCode, Shift)

expressão Uma variável que representa um objeto Report .

Parâmetros

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

  • acShiftMask A máscara de bits para a tecla Shift.

  • acCtrlMask A máscara de bits para a tecla Ctrl.

  • acAltMask A máscara de bits para a 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, talvez você queira que a combinação de teclas Ctrl+X sempre execute a mesma ação em um relatório.

Se você pressionar e manter pressionada uma tecla, os eventos KeyDown e KeyPress se alternarão repetidamente (KeyDown, KeyPress, KeyDown, KeyPress e assim por diante) até que você solte a tecla e, em seguida, o evento KeyUp ocorrerá.

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 Home, End, PgUp, PgDn, Seta para cima, Seta para baixo, Seta para a direita, Seta para a esquerda e Tab.

  • 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.

  • Last updated on