AoPressionarTeclaNoLayout

Realiza um script quando um ou mais caracteres são inseridos a partir do teclado, diretamente ou por meio 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.

Dois tipos de caracteres podem causar a ativação desse gatilho de script:

  • teclas que normalmente seriam aplicadas a um objeto ativo

  • teclas normalmente usadas para navegação

Quando o script é executado

Antes que o evento seja processado.

Modos em que o gatilho pode ser usado

Modos de navegação, de busca e de visualização.

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 Parcial
FileMaker WebDirect Parcial
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

  • 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 objeto ativo com um Gatilho de script AoPressionarTeclaEmObjeto pode processar um caractere.

    4. Um gatilho de script AoPressionarTeclaNoLayout pode processar um caractere.

    5. As teclas navegacionais são usadas para navegação, enquanto as teclas não navegacionais são processadas por um objeto ativo com um gatilho de script AoPressionarTeclaEmObjeto.

    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.

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

  • Windows: as teclas Alt e Ctrl não ativam esse gatilho de script.

  • macOS: a tecla Command não ativa esse gatilho de script.

  • FileMaker Go: esse gatilho de script é ativado somente se um campo estiver ativo quando o usuário pressionar uma tecla.

  • No FileMaker WebDirect, este gatilho de script é suportado apenas para as teclas Return, Enter e Escape (as teclas modificadoras são ignoradas).

  • Se um erro no script acionado fizer com que o script não seja concluído, o pressionamento de tecla que acionou o script não será processado.

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