AoAlternarPainel

Realiza um script quando um controle de painéis altera os painéis. Isso pode ocorrer em um controle de abas, por exemplo, quando um usuário clique em um painel de abas inativo ou quando um script muda o foco para um objeto em um painel de abas diferente.

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.

Originada na versão

12.0

Notas

• AoAlternarPainel aplica-se a todo o controle de painéis, e não a painéis individuais. Para controlar a alternação para painéis particulares, use as funções Get(TriggerCurrentPanel) e Get(TriggerTargetPanel).

• Como esse gatilho de script é ativado antes do evento de alternação de painel ser processado, o valor do parâmetro de script que AoAlternarPainel transmite para o script é determinado depois de o painel ser alternado. Dessa forma, se você usar o parâmetro de script para transmitir o valor retornado de Get(TriggerCurrentPanel) ou Get(TriggerTargetPanel) para o script, o valor será zero. Para obter valores retornados úteis, use essas funções somente dentro do script ativado por AoAlternarPainel, não no parâmetro de script.

Tópicos relacionados

• Configuração de gatilhos de script para objetos

• Configuração de gatilhos de script