Altera qual tela é exibida.

Visão geral

A maioria dos aplicativos contêm várias telas. Use a função Voltar e Navegar para alterar qual tela será exibida. Por exemplo, defina a propriedade OnSelect de um botão como uma fórmula que inclui uma função Navegar se desejar mostrar uma tela diferente quando um usuário seleciona esse botão. Nessa fórmula, você pode especificar uma transição visual, como Fade para controlar como uma tela muda para outra.

Voltar e Navegar alteram apenas qual tela será exibida. As telas não exibidas no momento continuam em operação por trás dos bastidores. Você pode criar fórmulas que fazem referência às propriedades de controles em outra tela. Por exemplo, um usuário pode alterar o valor de um controle deslizante em uma única tela, navegar até uma tela diferente que usa esse valor em uma fórmula e ver como isso afeta o que acontece na nova tela. O usuário pode navegar de volta para a tela original e ver que o controle deslizante manteve seu valor.

Variáveis de contexto também são preservadas quando um usuário navega entre telas. Você pode usar Navegar para definir uma ou mais variáveis de contexto para a tela que a fórmula exibirá, que é a única maneira de definir uma variável de contexto de fora da tela. Você pode usar essa abordagem para passar parâmetros para uma tela. Se você já usou outra ferramenta de programação, essa abordagem é semelhante a passar parâmetros para procedimentos.

Descrição

Back

A função Back exibe a tela exibida mais recentemente. Você não especifica nenhum argumento para essa função.

Navegar

No primeiro argumento, especifique o nome da tela a ser exibida.

No segundo argumento, especifique como a tela antiga muda para a nova tela:

Argumento de transição Descrição
ScreenTransition.Cover A nova tela entra na exibição, cobrindo a tela atual.
ScreenTransition.Fade A tela antiga desaparece para revelar a nova tela.
ScreenTransition.None A tela antiga é substituída rapidamente pela nova tela.
ScreenTransition.UnCover A tela antiga desliza para fora da exibição, descobrindo a nova tela.

Você pode usar Navegar para criar ou atualizar variáveis de contexto da nova tela. Como um terceiro argumento opcional, passe um registro que contém o nome de variável de contexto como um nome de coluna e o novo valor para a variável de contexto. Esse registro é o mesmo que o registro que você usa com a função AtualizarContexto.

Defina a propriedade OnHidden da tela anterior, a propriedade OnVisible da nova tela ou ambas para fazer alterações adicionais durante a transição. A propriedade App.ActiveScreen será atualizada para refletir a alteração.

Voltar normalmente retorna true, mas retornará false se o usuário estiver na primeira tela exibida e não houver nenhuma tela anterior. Navegar normalmente retorna true, mas retornará false se houver um problema com um de seus argumentos.

Você pode usar essas funções somente em uma fórmula de comportamento.

Sintaxe

Back()

Navigate( Screen, Transition [, UpdateContextRecord ] )

  • Tela – Obrigatório. A tela a ser exibida.
  • Transição – Obrigatória. A transição visual a ser usada entre a tela atual e a próxima tela. Consulte a lista de valores válidos para esse argumento anteriormente neste tópico.
  • UpdateContextRecord – Opcional. Um registro que contém o nome de, pelo menos, uma coluna e um valor para cada coluna. Esse registro atualiza as variáveis de contexto da nova tela como se passadas para a função AtualizarContexto.

Exemplos

Fórmula Descrição Resultado
Navigate( Details, ScreenTransition.None ) Exibe a tela Detalhes sem transição ou alteração no valor para uma variável de contexto. A tela Detalhes é exibida rapidamente.
Navigate( Details, ScreenTransition.Fade ) Exibe a tela Detalhes com uma transição Fade. Nenhum valor de uma variável de contexto é alterado. A tela atual esmaece imediatamente para exibir a tela Detalhes.
Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) Exibe a tela Detalhes com uma transição Apagar e atualiza o valor da variável de contexto ID para 12. A tela atual esmaece imediatamente para exibir a tela Detalhes e a ID da variável de contexto nessa tela é definida como 12.
Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) Exibe a tela Detalhes com uma transição Fade. Atualiza o valor da variável de contexto ID para 12 e atualiza o valor da variável de contexto Apagar para Color.Red. A tela atual esmaece imediatamente para exibir a tela Detalhes. A ID da variável de contexto na tela Detalhes está definida como 12 e a variável de contexto Apagar está definida como Color.Red. Se você definir a propriedade Preencher de um controle na tela Detalhes como Sombreamento, esse controle será exibido em vermelho.

Passo a passo

  1. Nomeie a tela padrão como DefaultScreen, adicione um rótulo a ela e defina a propriedade de Texto desse rótulo para que ela exiba Default.

  2. Adicione uma tela e nomeie-a como AddlScreen.

  3. Adicione um rótulo a AddlScreen e defina a propriedade de Texto do rótulo para que ela exiba Addl.

  4. Adicione um botão a AddlScreen e defina sua propriedade OnSelect como essa função:
    Navigate(DefaultScreen, ScreenTransition.Fade)

  5. Em AddlScreen, pressione F5 e, em seguida, selecione o botão.
    DefaultScreen é exibida.

Outro exemplo