Get(TriggerModifierKeys)

Retorna o estado das teclas modificadoras de teclado quando um gatilho de script AoPressionarTeclaEmObjeto ou AoPressionarTeclaNoLayout foi ativado.

Formato 

Get ( TriggerModifierKeys )

Parâmetros 

Nenhum

Tipo de dados retornado 

número

Originada na versão 

10.0

Descrição 

Retorna um valor somente quando chamado de um script ativado por um gatilho de script ou de um subscript chamado a partir do script acionado; caso contrário, retorna uma cadeia vazia.

  • Consulte Get(ActiveModifierKeys) para uma descrição dos valores atribuídos às teclas de modificador de teclado.
  • Consulte a Função Code para uma lista das teclas de navegação e dos códigos retornados por um script ativado por este gatilho.

Pode decorrer um tempo entre o momento em que as teclas que ativaram um gatilho de script são pressionadas e a solicitação de informações pelo script nas teclas de modificador. Use Get(TriggerKeystroke) e Get(TriggerModifierKeys) para capturar as teclas que estavam ativas quando o gatilho de script estava ativado. Use Get(ActiveModifierKeys) para capturar todas as teclas atuais sendo pressionadas.

Notas 

  • Windows: as combinações de tecla Alt e Ctrl não ativam gatilhos de script.
  • macOS: as combinações com a tecla Comando não ativam gatilhos de script.
  • Esta função não é compatível com o FileMaker WebDirect e retorna uma cadeia vazia.
  • Esta função não é compatível com o FileMaker Go e retorna 0.

Exemplo 1 

O seguinte exemplo mostrará somente uma caixa de diálogo personalizada quando a letra minúscula "a" é inserida:

Copiar 
If [ Get ( TriggerKeystroke ) = "a" and Get ( TriggerModifierKeys ) = 0 ]
    Mostrar caixa de diálogo personalizada ["Você digitou \"a\"."]
End If

Exemplo 2 

O valor 9 é retornado quando se pressiona Shift-Option em um computador executando macOS. Se as teclas Option e Shift forem pressionadas em um Mac quando um script for acionado, Get(TriggerModifierKeys) retornará 9, independentemente de quais teclas de modificador foram pressionadas entre o momento em que o gatilho foi ativado e a execução do script.

Tópicos relacionados