Referência > Referências dos gatilhos de script > AoPressionarTeclaEmObjeto
 

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 

Formato 

FileMaker Pro Advanced 

Sim 

FileMaker Go 

Sim 

FileMaker WebDirect 

Não 

FileMaker Server 

Não 

Produto FileMaker Cloud 

Não 

FileMaker Data API 

Não 

Publicação na Web personalizada 

Não 

Solução runtime 

Sim 

Originado em 

FileMaker Pro 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 Advanced 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 AoPressionarTeclaEmObjeto ou AoPressionarTeclaNoLayout não serão ativados se o objeto ativo for um visualizador Web.

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 das ações que não ativam esse gatilho de script.

Tópicos relacionados 

Configuração de gatilhos de script

Configuração de gatilhos de script para layouts

Configuração de gatilhos de script para objetos