Propriedade Form.KeyPreview (Access)
Use a propriedade KeyPreview para especificar se os procedimentos de evento de teclado no nível do formulário são invocados antes dos procedimentos de evento de teclado de um controle. Boolean de leitura/gravação.
Sintaxe
expressão. Keypreview
expressão Uma variável que representa um objeto Form.
Comentários
A propriedade KeyPreview utiliza as configurações a seguir.
| Configuração | Visual Basic | Descrição |
|---|---|---|
| Sim | Verdadeiro | O formulário recebe eventos de teclado primeiro e, em seguida, o controle ativo recebe eventos de teclado. |
| Não | Falso | (Padrão) Somente o controle ativo recebe eventos de teclado. |
Você pode definir a propriedade KeyPreview em qualquer modo.
Use a propriedade KeyPreview para criar um procedimento de tratamento de teclado para um formulário. Por exemplo, quando um aplicativo usar as teclas de função, a configuração da propriedade KeyPreview como Truepermitirá processar o pressionamento de teclas em nível de formulário em vez de digitar o código para cada controle que possa receber eventos de pressionamento de teclas.
Para manipular eventos de teclado somente em nível de formulário e impedir que os controles recebam esses eventos, defina o argumento KeyAscii como 0 no procedimento do evento KeyPress do formulário e defina o argumento KeyCode como 0 nos procedimentos de evento KeyDown e KeyUp.
Se um formulário não tiver controles visíveis ou ativados, automaticamente, receberá todos os eventos de teclado.
Exemplo
No exemplo a seguir, a propriedade KeyPreview está definida como True no procedimento do evento Load do formulário. Isso faz com que o formulário receba eventos de teclado antes que deles serem recebidos por qualquer outro controle. Em seguida, o evento KeyDown do formulário verificará o valor do argumento KeyCode para determinar se as teclas F2, F3 ou F4 foram pressionadas.
Private Sub Form_Load()
Me.KeyPreview = True
End Sub
Private Sub Form_KeyDown(KeyCode As Integer, Shift As Integer)
Select Case KeyCode
Case vbKeyF2
' Process F2 key events.
Case vbKeyF3
' Process F3 key events.
Case vbKeyF4
' Process F4 key events.
Case Else
End Select
End Sub
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.