Início > Projeto e criação de soluções > Criação e gerenciamento de layouts e relatórios > Configuração de gatilhos de script

Configuração de gatilhos de script

Você pode configurar um gatilho de script para especificar que o script seja executado quando um evento ocorrer. Por exemplo, você pode usar um gatilho de script para executar um script que insira dados em campos automaticamente baseado no que foi inserido em outro campo.

Alguns gatilhos de script executam o script antes de um evento ser processado pelo mecanismo do banco de dados. Alguns gatilhos de script executam o script após um evento ser processado pelo mecanismo do banco de dados. Por exemplo, você poderia usar o gatilho de script AoEntrarEmObjeto para executar um script após entrar em um campo. (O campo é o objeto; entrar no campo é o evento.)

Os gatilhos de script podem ser ativados por ações do usuário ou por scripts. Por exemplo, você poderia usar o gatilho de script AoEntrarEmObjeto para ativar um script para executar quando o usuário entrar no campo seja clicando nele ou usando a etapa de script Ir para objeto.

Você pode configurar um gatilho de script para ser ativado:

•	quando um usuário entrar em um layout específico. Consulte Configuração de gatilhos de script para layouts.

•	quando um usuário entrar, modificar ou sair de um objeto ou objetos em um layout. Consulte Configuração de gatilhos de script para objetos.

•	quando um arquivo for aberto ou fechado, ou o estado de reprodução mudar para um arquivo de mídia. Para obter informações sobre como fazer isso, consulte Definição das opções de arquivo.

Para saber quais objetos de layout e layouts têm gatilhos de script atribuídos a eles, no Modo de layout, escolha o menu Exibir > Mostrar > Gatilhos de script.

Os seguintes gatilhos de script estão disponíveis:

 

Área de gatilho	Gatilho de script	Antes do processamento	Depois do processamento
Objeto	AoEntrarEmObjeto		X
	AoPressionarTeclaEmObjeto	X
	AoModificarObjeto		X
	AoValidarObjeto	X
	AoSalvarObjeto		X
	AoSairDeObjeto	X
	AoAlternarPainel	X
	AoAlterarObjetoAVPlayer		X
Layout	AoCarregarRegistro		X
	AoConfirmarRegistro	X
	AoReverterRegistro	X
	AoPressionarTeclaNoLayout	X
	AoEntrarNoLayout		X
	AoSairDoLayout	X
	AoAlterarTamanhoDoLayout		X
	AoEntrarEmModo		X
	AoSairDeModo	X
	AoAlterarExibição		X
	AoGestoDeToque	X
	AoReceberComandoExterno		X
Opções de arquivo	AoAbrirPrimeiraJanela		X
	AoFecharÚltimaJanela	X
	AoAbrirJanela	X
	AoFecharJanela		X
	AoAlterarArquivoAVPlayer		X

Ordem de ativação de gatilhos de script

Quando vários gatilhos de scripts são ativados pelo mesmo evento, os gatilhos de script são executados na seguinte ordem relativa:

1.	AoAbrirPrimeiraJanela

2.	AoAbrirJanela

3.	AoEntrarNoLayout

4.	AoEntrarEmModo

5.	AoCarregarRegistro

6.	AoAlterarTamanhoDoLayout

7.	AoEntrarEmObjeto

8.	AoPressionarTeclaEmObjeto

9.	AoPressionarTeclaNoLayout

10.	AoGestoDeToque

11.	AoAlterarObjetoAVPlayer

12.	AoAlterarArquivoAVPlayer

13.	AoReceberComandoExterno

14.	AoAlternarPainel

15.	AoModificarObjeto

16.	AoValidarObjeto

17.	AoSalvarObjeto

18.	AoSairDeObjeto

19.	AoConfirmarRegistro ou AoReverterRegistro

20.	AoAlterarExibição

21.	AoSairDeModo

22.	AoSairDoLayout

23.	AoFecharJanela

24.	AoFecharÚltimaJanela

Notas

•	Os scripts que são executados por gatilhos de script usam os privilégios existentes. A menos que um script esteja definido para ser executado com privilégios totais, o script é executado usando os privilégios do usuário.

•

Na Publicação na Web personalizada, os gatilhos de script podem ser ativados somente por um script e não por uma interação direta do usuário. Por exemplo, se um usuário selecionar com a tecla Tab um campo que tiver o gatilho de script AoEntrarEmObjeto, o gatilho não será ativado. Se uma etapa de script fizer com que o foco passe para esse campo, o gatilho de script não será ativado.

•

Alguns gatilhos de script permitem que o evento de acionamento seja cancelado, caso o script executado pelo gatilho retorne um valor Falso. Quando um comando ou evento é cancelado dessa forma, o código do erro é definido como 20. Consulte Get(LastError) função para obter mais informações. Se o script executado pelo gatilho de script AoFecharÚltimaJanela retornar um valor Falso, o arquivo não será fechado.

•

Os gatilhos de script AoAbrirPrimeiraJanela e AoAbrirJanela são exibidos no Depurador de scripts quando um script está definido para ser executado ao abrir o arquivo; os gatilhos de script AoFecharÚltimaJanela e AoFecharJanela são exibidos no Depurador de scripts quando um script está definido para ser executado ao fechar o arquivo.

•	Windows: As combinações de tecla Alt e Ctrl não ativam gatilhos de script.

•	OS X: As combinações com a tecla Comando não ativam gatilhos de script.

Tópicos relacionados 

Depuração de scripts (FileMaker Pro Advanced)

Uso do Visualizador de dados (FileMaker Pro Advanced)