Funções Anterior e Navegar no PowerAppsBack and Navigate functions in PowerApps

Altera o ecrã apresentado.Changes which screen is displayed.

Descrição geralOverview

A maioria das aplicações contém vários ecrãs.Most apps contain multiple screens. Utilize a função Voltar e Navegar para alterar o ecrã apresentado.Use the Back and Navigate function to change which screen is displayed. Por exemplo, defina a propriedade OnSelect de um botão para uma fórmula que inclua uma função Navegar se quiser mostrar um ecrã diferente quando um utilizador seleciona esse botão.For example, set the OnSelect property of a button to a formula that includes a Navigate function if you want to show a different screen when a user selects that button. Nessa fórmula, pode especificar uma transição visual, por exemplo, Desvanecer, para controlar a forma como um ecrã muda para outro.In that formula, you can specify a visual transition, such as Fade, to control how one screen changes to another.

Anterior e Navegar só alteram o ecrã apresentado.Back and Navigate change only which screen is displayed. Os ecrãs que não sejam apresentados continuam a funcionar em segundo plano.Screens that aren't currently displayed continue to operate behind the scenes. Pode criar fórmulas que se referem às propriedades de controlos noutro ecrã.You can build formulas that refer to properties of controls on another screen. Por exemplo, um utilizador pode alterar o valor de um controlo de deslize num ecrã, navegar para um ecrã diferente que utiliza esse valor numa fórmula e ver como afeta o que acontece no novo ecrã.For example, a user can change the value of a slider on one screen, navigate to a different screen that uses that value in a formula, and see how it affects what happens in the new screen. O utilizador pode, em seguida, navegar para o ecrã original e verificar que o controlo de reteve o respetivo valor.The user can then navigate back to the original screen and see that the slider has retained its value.

As variáveis de contexto também são mantidas quando um utilizador navega entre ecrãs.Context variables are also preserved when a user navigates between screens. Pode utilizar Navegar para definir uma ou mais variáveis de contexto do ecrã que mostra a fórmula, que é a única forma de definir uma variável de contexto a partir do exterior do ecrã.You can use Navigate to set one or more context variables for the screen that the formula will display, which is the only way to set a context variable from outside the screen. Pode utilizar esta abordagem para passar parâmetros para um ecrã.You can use this approach to pass parameters to a screen. Se utilizou outra ferramenta de programação, esta abordagem é semelhante à transmissão de parâmetros para procedimentos.If you've used another programming tool, this approach is similar to passing parameters to procedures.

DescriçãoDescription

AnteriorBack

A função Anterior mostra o ecrã apresentado mais recentemente.The Back function displays the screen that was most recently displayed. Não especifique quaisquer argumentos para esta função.You don't specify any arguments for this function.

No primeiro argumento, especifique o nome do ecrã a apresentar.In the first argument, specify the name of the screen to display.

No segundo argumento, especifique como o ecrã antigo muda para o novo ecrã:In the second argument, specify how the old screen changes to the new screen:

Argumento de transiçãoTransition Argument DescriçãoDescription
ScreenTransition.CoverScreenTransition.Cover O novo ecrã é apresentado, e abrange o ecrã atual.The new screen slides into view, covering the current screen.
ScreenTransition.FadeScreenTransition.Fade O antigo ecrã desvanece e aparece o novo ecrã.The old screen fades away to reveal the new screen.
ScreenTransition.NoneScreenTransition.None O ecrã antigo é substituído rapidamente pelo novo ecrã.The old screen is quickly replaced with the new screen.
ScreenTransition.UnCoverScreenTransition.UnCover O ecrã antigo desaparece e aparece o novo ecrã.The old screen slides out of view, uncovering the new screen.

Pode utilizar Navegar para criar ou atualizar as variáveis de contexto do novo ecrã.You can use Navigate to create or update context variables of the new screen. Como terceiro argumento opcional, transmita um registo que contenha o nome de variável de contexto, como um nome de coluna e o novo valor para a variável de contexto.As an optional third argument, pass a record that contains the context-variable name as a column name and the new value for the context variable. Este registo é o mesmo que o registo que utiliza com a função UpdateContext.This record is the same as the record that you use with the UpdateContext function.

Defina a propriedade OnHidden do ecrã antigo, a propriedade OnVisible do novo ecrã, ou ambas para fazer alterações adicionais durante a transição.Set the OnHidden property of the old screen, the OnVisible property of the new screen, or both to make additional changes during the transition. A propriedade App.ActiveScreen será atualizada para refletir a alteração.The App.ActiveScreen property will be updated to reflect the change.

Antigo devolve normalmente verdadeiro, mas devolve falso se o utilizador estiver no primeiro ecrã apresentado e não houver um ecrã anterior.Back normally returns true but returns false if the user is on the first screen shown and there is no previous screen. Navegar normalmente devolve verdadeiro, mas devolve falso se houver um problema com um dos respetivos argumentos.Navigate normally returns true but returns false if there is a problem with one of its arguments.

Pode utilizar estas funções apenas dentro uma fórmula de comportamento.You can use these functions only within a behavior formula.

SintaxeSyntax

Anterior()Back()

Navegar( Ecrã, Transição [, UpdateContextRecord ])Navigate( Screen, Transition [, UpdateContextRecord ] )

  • Ecrã - Necessário.Screen - Required. O ecrã apresentado.The screen to display.
  • Transição - Necessário.Transition - Required. A transição visual a utilizar entre o ecrã atual e o ecrã seguinte.The visual transition to use between the current screen and the next screen. Consulte a lista de valores válidos para este argumento no início deste tópico.See the list of valid values for this argument earlier in this topic.
  • UpdateContextRecord - opcional.UpdateContextRecord - Optional. Um registo que contém o nome de pelo menos uma coluna e um valor para cada coluna.A record that contains the name of at least one column and a value for each column. Este registo atualiza as variáveis de contexto do novo ecrã, como se tivessem sido transmitidas para a função UpdateContext .This record updates the context variables of the new screen as if passed to the UpdateContext function.

ExemplosExamples

FórmulaFormula DescriçãoDescription ResultadoResult
Navegar ( Detalhes, ScreenTransition.None )Navigate( Details, ScreenTransition.None ) Apresenta o ecrã Detalhes sem transições ou alterações no valor de uma variável de contexto.Displays the Details screen with no transition or change in value for a context variable. O ecrã Detalhes aparece rapidamente.The Details screen appears quickly.
Navegar (Detalhes, ScreenTransition.Fade )Navigate( Details, ScreenTransition.Fade ) Apresenta o ecrã Detalhes com uma transição Desvanecimento.Displays the Details screen with a Fade transition. Nenhum valor de uma variável de contexto é alterado.No value of a context variable is changed. O ecrã atual desaparece e é apresentado o ecrã Detalhes.The current screen fades away to show the Details screen.
Navegar (Detalhes, ScreenTransition.Fade, { ID: 12 } )Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) Apresenta o ecrã Detalhes com uma transição Desvanecimenti e atualiza o valor da variável de contexto de ID para 12.Displays the Details screen with a Fade transition, and updates the value of the ID context variable to 12. O atual ecrã desaparece e é apresentado o ecrã Detalhes e a variável de contexto ID nesse ecrã é definida para 12.The current screen fades away to show the Details screen, and the context variable ID on that screen is set to 12.
Navegar (Detalhes, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } )Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) Apresenta o ecrã Detalhes com uma transição Desvanecimento.Displays the Details screen with a Fade transition. Atualiza o valor da variável de contexto ID para 12 e atualiza o valor da variável de contexto Tom para Color.Red.Updates the value of the ID context variable to 12, and updates the value of the Shade context variable to Color.Red. O ecrã atual desaparece e é apresentado o ecrã Detalhes.The current screen fades away to show the Details screen. A variável de contexto ID no ecrã Detalhes está definida para 12 e a variável de contexto Tom está definida para Color.Red.The context variable ID on the Details screen is set to 12, and the context variable Shade is set to Color.Red. Se definir a propriedade Preencher de um controlo no ecrã Detalhes para Tom, esse o controlo é apresentado a vermelho.If you set the Fill property of a control on the Details screen to Shade, that control would display as red.

Passo a passoStep-by-step

  1. Atribua um nome ao ecrã predefinido DefaultScreen, adicione uma etiqueta e defina a propriedade Texto dessa etiqueta para que mostre Predefinição.Name the default screen DefaultScreen, add a label to it, and set the Text property of that label so that it shows Default.
  2. Adicione um ecrã e dê-lhe o nome AddlScreen.Add a screen, and name it AddlScreen.
  3. Adicione uma etiqueta a AddlScreen e defina a propriedade Texto da etiqueta para que mostre Addl.Add a label to AddlScreen, and set the Text property of the label so that it shows Addl.
  4. Adicione um botão a AddlScreen e defina a respetiva propriedade OnSelect para esta função:Add a button to AddlScreen, and set its OnSelect property to this function:
    Navegar (DefaultScreen, ScreenTransition.Fade)Navigate(DefaultScreen, ScreenTransition.Fade)
  5. Em AddlScreen, prima F5 e, em seguida, selecione o botão.From the AddlScreen, press F5, and then select the button.
    É apresentado DefaultScreen.DefaultScreen appears.

Outro exemploAnother example