De functies Back en Navigate in PowerAppsBack and Navigate functions in PowerApps

Wijzigen welk scherm wordt weergegeven.Changes which screen is displayed.

OverzichtOverview

De meeste apps bevatten meerdere schermen.Most apps contain multiple screens. Gebruik de functies Back en Navigate om te wijzigen welk scherm wordt weergegeven.Use the Back and Navigate function to change which screen is displayed. Stel bijvoorbeeld de eigenschap OnSelect van een knop in op een formule die de functie Navigate bevat als u een ander scherm wilt weergeven wanneer een gebruiker die knop selecteert.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. In die formule kunt u een visuele overgang, zoals Fade, opgeven om te bepalen hoe het ene scherm overgaat naar het andere.In that formula, you can specify a visual transition, such as Fade, to control how one screen changes to another.

Back en Navigate wijzigen alleen welk scherm wordt weergegeven.Back and Navigate change only which screen is displayed. Schermen die momenteel niet worden weergegeven, blijven werken achter de schermen.Screens that aren't currently displayed continue to operate behind the scenes. U kunt formules maken die verwijderen naar eigenschappen van besturingselementen op een ander scherm.You can build formulas that refer to properties of controls on another screen. Een gebruiker kan bijvoorbeeld de waarde van een schuifregelaar op het ene scherm wijzigen, navigeren naar een ander scherm dat die waarde in een formule gebruikt en zien hoe dit van invloed is op het nieuwe scherm.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. De gebruiker kan vervolgens terugkeren naar het oorspronkelijke scherm en zien dat de schuifregelaar zijn waarde heeft behouden.The user can then navigate back to the original screen and see that the slider has retained its value.

Contextvariabelen blijven ook behouden wanneer een gebruiker tussen schermen navigeert.Context variables are also preserved when a user navigates between screens. U kunt Navigate gebruiken om een of meer contextvariabelen in te stellen voor het scherm dat de formule weergeeft. Dit is de enige manier om een contextvariabele buiten het scherm in te stellen.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. U kunt deze methode gebruiken om parameters door te geven aan een scherm.You can use this approach to pass parameters to a screen. Als u een ander programmeerhulpmiddel gebruikt, is deze methode vergelijkbaar met het doorgeven van parameters aan procedures.If you've used another programming tool, this approach is similar to passing parameters to procedures.

BeschrijvingDescription

BackBack

De functie Back geeft het scherm weer dat het meest recent is weergegeven.The Back function displays the screen that was most recently displayed. U geeft geen argumenten op voor deze functie.You don't specify any arguments for this function.

In het eerste argument geeft u de naam op van het scherm dat moet worden weergegeven.In the first argument, specify the name of the screen to display.

In het tweede argument geeft u op hoe het oude scherm overgaat naar het nieuwe scherm:In the second argument, specify how the old screen changes to the new screen:

OvergangsargumentTransition Argument BeschrijvingDescription
ScreenTransition.CoverScreenTransition.Cover Het nieuwe scherm schuift in beeld en bedekt het huidige scherm.The new screen slides into view, covering the current screen.
ScreenTransition.FadeScreenTransition.Fade Het oude scherm vervaagt, waarna het nieuwe scherm zichtbaar wordt.The old screen fades away to reveal the new screen.
ScreenTransition.NoneScreenTransition.None Het oude scherm wordt snel vervangen door het nieuwe scherm.The old screen is quickly replaced with the new screen.
ScreenTransition.UnCoverScreenTransition.UnCover Het oude scherm schuift uit beeld, waardoor het nieuwe scherm verschijnt.The old screen slides out of view, uncovering the new screen.

U kunt Navigate gebruiken om contextvariabelen van het nieuwe scherm te maken of bij te werken.You can use Navigate to create or update context variables of the new screen. Als optioneel derde argument kunt u een record doorgeven die de naam van de contextvariabele bevat als kolomnaam en de nieuwe waarde voor de contextvariabele.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. Deze record is dezelfde als de record die u gebruikt met de functie UpdateContext.This record is the same as the record that you use with the UpdateContext function.

Stel de eigenschap OnHidden van het oude scherm, de eigenschap OnVisible van het nieuwe scherm of beide in om extra wijzigingen aan te brengen tijdens de overgang.Set the OnHidden property of the old screen, the OnVisible property of the new screen, or both to make additional changes during the transition. De eigenschap App.ActiveScreen wordt bijgewerkt om de wijziging te weerspiegelen.The App.ActiveScreen property will be updated to reflect the change.

Back retourneert normaal true, maar retourneert false als de gebruiker op het eerste scherm is en er geen vorig scherm is.Back normally returns true but returns false if the user is on the first screen shown and there is no previous screen. Navigate retourneert normaal true , maar retourneert false als er een probleem met een van de argumenten.Navigate normally returns true but returns false if there is a problem with one of its arguments.

U kunt deze functies alleen gebruiken binnen een gedragsformule.You can use these functions only within a behavior formula.

SyntaxisSyntax

Back()Back()

Navigate( Screen, Transition [, UpdateContextRecord ] )Navigate( Screen, Transition [, UpdateContextRecord ] )

  • Screen - vereist.Screen - Required. Het scherm dat moet worden weergegeven.The screen to display.
  • Transition - vereist.Transition - Required. De visuele overgang tussen het huidige scherm en het volgende scherm.The visual transition to use between the current screen and the next screen. Bekijk de lijst met geldige waarden voor dit argument eerder in dit onderwerp.See the list of valid values for this argument earlier in this topic.
  • UpdateContextRecord - optioneel.UpdateContextRecord - Optional. Een record die de naam bevat van ten minste één kolom en een waarde voor elke kolom.A record that contains the name of at least one column and a value for each column. Deze record werkt de contextvariabelen van het nieuwe scherm bij alsof het is doorgegeven aan de functie UpdateContext.This record updates the context variables of the new screen as if passed to the UpdateContext function.

VoorbeeldenExamples

FormuleFormula BeschrijvingDescription ResultaatResult
Navigate( Details, ScreenTransition.None )Navigate( Details, ScreenTransition.None ) Geeft het scherm Details weer zonder overgang en zonder de waarde van een contextvariabele te wijzigen.Displays the Details screen with no transition or change in value for a context variable. Het scherm Details wordt snel weergegeven.The Details screen appears quickly.
Navigate( Details, ScreenTransition.Fade )Navigate( Details, ScreenTransition.Fade ) Geeft het scherm Details weer met de overgang Fade.Displays the Details screen with a Fade transition. Er wordt geen waarde van een contextvariabele gewijzigd.No value of a context variable is changed. Het huidige scherm vervaagt terwijl het scherm Details verschijnt.The current screen fades away to show the Details screen.
Navigate( Details, ScreenTransition.Fade, { ID: 12 } )Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) Geeft het scherm Details weer met de overgang Fade en werkt de waarde van de contextvariabele ID bij naar 12.Displays the Details screen with a Fade transition, and updates the value of the ID context variable to 12. Het huidige scherm vervaagt terwijl het scherm Details verschijnt en de contextvariabele ID op dat scherm wordt ingesteld op 12.The current screen fades away to show the Details screen, and the context variable ID on that screen is set to 12.
Navigate( Details, ScreenTransition.Fade, { ID: 12 , Tint: Color.Red } )Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) Geeft het scherm Details weer met de overgang Fade.Displays the Details screen with a Fade transition. Werkt de waarde van de contextvariabele ID bij naar 12 en werkt de waarde van de contextvariabele Tint bij naar Color.Red.Updates the value of the ID context variable to 12, and updates the value of the Shade context variable to Color.Red. Het huidige scherm vervaagt terwijl het scherm Details verschijnt.The current screen fades away to show the Details screen. De contextvariabele ID op het scherm Details wordt ingesteld op 12 en de contextvariabele Tint wordt ingesteld op Color.Red.The context variable ID on the Details screen is set to 12, and the context variable Shade is set to Color.Red. Als u de eigenschap Fill van een besturingselement op het scherm Details instelt op Tint, wordt dat besturingselement rood weergegeven.If you set the Fill property of a control on the Details screen to Shade, that control would display as red.

Stap voor stapStep-by-step

  1. Geef het standaardscherm de naam Standaardscherm, voeg er een label aan toe en stel de eigenschap Text van dat label zo in dat Standaard wordt weergegeven.Name the default screen DefaultScreen, add a label to it, and set the Text property of that label so that it shows Default.
  2. Voeg een scherm toe en noem het ToegevoegdScherm.Add a screen, and name it AddlScreen.
  3. Voeg een label toe aan ToegevoegdScherm en stel de eigenschap Text van het label in op Toevoegen.Add a label to AddlScreen, and set the Text property of the label so that it shows Addl.
  4. Voeg een knop toe aan ToegevoegdScherm en stel de eigenschap OnSelect ervan in op deze functie:Add a button to AddlScreen, and set its OnSelect property to this function:
    Navigate(Standaardscherm, ScreenTransition.Fade)Navigate(DefaultScreen, ScreenTransition.Fade)
  5. Druk op ToegevoegdScherm op F5 en selecteer vervolgens de knop.From the AddlScreen, press F5, and then select the button.
    Standaardscherm wordt weergegeven.DefaultScreen appears.

Een ander voorbeeldAnother example