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.

Compatibilidade 

Produto Compatível
FileMaker Pro Sim
FileMaker Go Sim
FileMaker WebDirect Não
FileMaker Server Não
FileMaker Cloud Não
FileMaker Data API Não
Publicação na Web personalizada Não

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.

  • Os gatilhos de script AoEntrarEmObjeto, 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