Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O evento KeyPress ocorre quando o usuário pressiona e libera uma tecla ou combinação de teclas que corresponde a um código ANSI enquanto um relatório tem o foco. Esse evento também ocorre se você enviar um pressionamento de tecla ANSI para um relatório usando a ação EnviarSequênciaDeCaracteres em uma macro ou da instrução SendKeys no Visual Basic.
Sintaxe
expressão. KeyPress (KeyAscii)
expressão Uma variável que representa um objeto Relatório .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| KeyAscii | Obrigatório | Integer | Returns a numeric ANSI key code. The KeyAscii argument is passed by reference; changing it sends a different character to the object. Setting the KeyAscii argument to 0 cancels the keystroke so that the object doesn't recognize that a key was pressed. |
Comentários
Para executar um macro ou procedimento de evento quando esse evento ocorrer, defina a propriedade OnKeyPress 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 ANSI, os eventos KeyDown e KeyPress alternam repetidamente (KeyDown, KeyPress, KeyDown, KeyPress, etc.) até soltar a tecla e, em seguida, ocorre o evento KeyUp .
Um evento KeyPress pode envolver qualquer caráter de teclado imprimível, a tecla Ctrl combinada com um caráter do alfabeto padrão ou um caráter especial e a tecla Enter ou Retrocesso. Utilize os procedimentos de eventos KeyDown e KeyUp para processar qualquer batimento de tecla não reconhecido pelo evento KeyPress , como teclas de função, teclas de navegação e qualquer combinação destes com modificadores de teclado (teclas Alt, Shift ou Ctrl). Ao contrário os eventos KeyDown e KeyUp, o evento KeyPress não indica o estado físico do teclado; em vez disso, ele indica o caractere ANSI correspondente à tecla pressionada ou combinações de teclas.
KeyPress interpreta as versões maiúscula e minúscula de cada caractere como códigos de teclas distintos e, portanto, como dois caracteres distintos.
Observação
A tecla De retrocesso faz parte do conjunto de carateres ANSI, mas a tecla Delete não. Se eliminar um caráter num controlo com a tecla De retrocesso, causará um evento KeyPress ; Se utilizar a chave Delete, não utiliza.
Os eventos KeyDown e KeyPress ocorrem quando você pressiona ou envia uma tecla ANSI. O evento KeyUp ocorre depois de qualquer evento para um controle gerado pelo pressionamento ou envio da tecla. Se um pressionamento de tecla faz o foco mover de um controle para outro controle, o evento KeyDown ocorra para o primeiro controle, enquanto os eventos KeyPress e KeyUp ocorrem para o segundo controle.
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.