AoPressionarTeclaEmObjeto

Realiza um script quando um objeto está ativo e recebe um ou mais caracteres do teclado, diretamente ou através de um editor de método de entrada (IME). Use a Função Get(TriggerKeystroke) para retornar os caracteres que ativaram o gatilho de script.

Quando o script é executado

Antes que o evento seja processado.

Modos em que o gatilho pode ser usado

Modos de navegação e de busca.

Resultado

É possível usar a Etapa de script Sair do script no script acionado para retornar Verdadeiro ou Falso.

• Verdadeiro: o evento que acionou o script é processado.
• Falso: o evento que acionou o script é cancelado.

Originada na versão

10.0

Notas

• A combinação de pressionamentos de tecla em um IME não ativará esse gatilho de script. Em vez disso, o gatilho é ativado depois que o texto é confirmado no IME. O script acionado processa a string confirmada.

• Use as funções Get(TriggerModifierKeys), Code e Char para trabalhar com caracteres especiais, como teclas navegacionais (por exemplo, a tecla Tab e as teclas de seta), e caracteres Unicode gerais. Consulte a função Code para obter uma lista das teclas navegacionais e os códigos relatados para um script. A função Char retorna os caracteres dos pontos de código Unicode.

• Os pressionamentos de tecla são processados na seguinte ordem:

  1. O sistema operacional processa determinadas teclas.

  2. O FileMaker Pro processa as teclas de atalho do teclado.

  3. Um script acionado pelo script AoPressionarTeclaEmObjeto processa os caracteres.

  4. Um script acionado pelo Gatilho de script AoPressionarTeclaNoLayout processa os caracteres.

  5. As teclas navegacionais são usadas para navegação, enquanto as teclas não navegacionais são processadas pelo objeto ativo, se houver algum.

  6. Se não houver objetos ativos, um alerta será exibido para as teclas não navegacionais.

  A primeira dessas etapas a usar a tecla interrompe o processo. Um script executado pelo gatilho de script AoPressionarTeclaEmObjeto ou AoPressionarTeclaNoLayout pode interromper o processamento posterior do pressionamento de tecla retornando Falso.

• Atalhos de teclado, como as ações de recortar e colar (Ctrl+X, Ctrl+V no Windows, Command-X, Command-V no macOS) não irão ativar este gatilho de script.

• O uso das teclas de seta ou do mouse para navegar e fazer a seleção em listas pop-up, menus e calendários não ativará esse gatilho de script. A inserção de texto nesses campos ativará o gatilho de script.

• No FileMaker WebDirect, este gatilho de script é suportado apenas para:

  • As teclas Return, Enter e Escape (as teclas modificadoras são ignoradas)

  • Um objeto de campo ativo com Estilo de controle definido como Caixa de edição

• Os gatilhos de script Gatilho de script AoEntrarEmObjeto, Gatilho de script AoSairDeObjeto e AoPressionarTeclaEmObjeto podem ser ativados quando atribuídos a campos de resumo e de cálculo.

• Consulte Ações que não ativam gatilhos de script para obter uma lista de ações que não ativam esse gatilho de script.

Tópicos relacionados

• Configuração de gatilhos de script para objetos

• Configuração de gatilhos de script