Funktionen "Back" und "Navigate" in powerappsBack and Navigate functions in Power Apps

Ändern, welcher Bildschirm angezeigt wirdChanges which screen is displayed.

ÜbersichtOverview

Die meisten Apps umfassen mehrere Bildschirme.Most apps contain multiple screens. Verwenden Sie die Funktionen Back und Navigate, um zu ändern, welcher Bildschirm angezeigt wird.Use the Back and Navigate function to change which screen is displayed. Legen Sie z.B. die OnSelect -Eigenschaft einer Schaltfläche auf eine Formel fest, die eine Navigate-Funktion enthält, wenn Sie einen anderen Bildschirm anzeigen möchten, wenn ein Benutzer diese Schaltfläche auswählt.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 dieser Formel können Sie einen visuellen Übergang, wie z.B. Fade angeben, um zu steuern, wie ein Bildschirm zu einem anderen Bildschirm wechselt.In that formula, you can specify a visual transition, such as Fade, to control how one screen changes to another.

Die Funktionen Back und Navigate ändern nur, welcher Bildschirm angezeigt wird.Back and Navigate change only which screen is displayed. Bildschirme, die momentan nicht angezeigt werden, werden weiterhin im Hintergrund ausgeführt.Screens that aren't currently displayed continue to operate behind the scenes. Sie können Formeln erstellen, die auf Eigenschaften von Steuerelementen auf anderen Bildschirmen verweisen.You can build formulas that refer to properties of controls on other screens. Beispielsweise kann ein Benutzer den Wert eines Schiebereglers auf einem Bildschirm ändern, zu einem anderen Bildschirm navigieren, der diesen Wert in einer Formel verwendet, und die Auswirkungen auf das Verhalten im neuen Bildschirm ermitteln.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 ascertain how it affects what happens in the new screen. Der Benutzer kann dann zurück zum ursprünglichen Bildschirm navigieren und sich vergewissern, dass der Schieberegler seinen Wert beibehalten hat.The user can then navigate back to the original screen and confirm that the slider has retained its value.

Kontextvariablen werden ebenfalls beibehalten, wenn ein Benutzer zwischen Bildschirmen navigiert.Context variables are also preserved when a user navigates between screens. Sie können Navigate verwenden, um eine oder mehrere Kontextvariablen für den Bildschirm festzulegen, den die Formel anzeigen wird. Dies ist die einzige Möglichkeit, von außerhalb des Bildschirms eine Kontextvariable festzulegen.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. Sie können diesen Ansatz verwenden, um Parameter an einen Bildschirm zu übergeben.You can use this approach to pass parameters to a screen. Wenn Sie ein anderes Programmiertool verwendet haben, ähnelt diese Vorgehensweise der Übergabe von Parametern an Prozeduren.If you've used another programming tool, this approach is similar to passing parameters to procedures.

Sie können eine der beiden Funktionen nur innerhalb einer Verhaltens Formelverwenden.You can use either function only within a behavior formula.

Geben Sie im ersten Argument den Namen des Bildschirms an, der angezeigt werden soll.In the first argument, specify the name of the screen to display.

Geben Sie im zweiten Argument an, wie der alte Bildschirm auf den neuen Bildschirm wechselt:In the second argument, specify how the old screen changes to the new screen:

„Transition“-ArgumentTransition Argument BeschreibungDescription TionsDemonstration
ScreenTransition.CoverScreenTransition.Cover Der neue Bildschirm wird in die Ansicht verschoben, von rechts nach links, um den aktuellen Bildschirm abzudecken.The new screen slides into view, moving right to left, to cover the current screen. Animation des Bildschirm Übergangs abdecken
Screentransition. coverrightScreenTransition.CoverRight Der neue Bildschirm wird in die Ansicht verschoben, von links nach rechts, um den aktuellen Bildschirm abzudecken.The new screen slides into view, moving left to right, to cover the current screen. Bildschirm Übergangs Abdeckung für die richtige Animation
ScreenTransition.FadeScreenTransition.Fade Der aktuelle Bildschirm wird ausgeblendet, um den neuen Bildschirm anzuzeigen.The current screen fades away to reveal the new screen. Animation für Bildschirm Übergänge ausblenden
Screentransition. None (Standard)ScreenTransition.None (Default) Der neue Bildschirm ersetzt schnell den aktuellen Bildschirm.The new screen quickly replaces the current screen. Bildschirm Übergang keine Animation
ScreenTransition.UnCoverScreenTransition.UnCover Der aktuelle Bildschirm wird von rechts nach links verschoben, um den neuen Bildschirm anzuzeigen.The current screen slides out of view, moving right to left, to uncover the new screen. Bildschirm Übergang zum Entdecken der Animation
Screentransition. uncoverrightScreenTransition.UnCoverRight Der aktuelle Bildschirm wird von links nach rechts verschoben, um den neuen Bildschirm anzuzeigen.The current screen slides out of view, moving left to right, to uncover the new screen. Bildschirm Übergang mit rechter Animation

Sie können Navigate verwenden, um Kontextvariablen des neuen Bildschirms zu erstellen oder zu aktualisieren.You can use Navigate to create or update context variables of the new screen. Als optionales drittes Argument übergeben Sie einen Datensatz, der den Kontextvariablennamen als Spaltennamen sowie den neuen Wert für die Kontextvariable enthält.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. Dieser Datensatz ist identisch mit dem Datensatz, den Sie mit der UpdateContext -Funktion verwenden.This record is the same as the record that you use with the UpdateContext function.

Legen Sie die OnHidden -Eigenschaft des alten Bildschirms, die OnVisible -Eigenschaft des neuen Bildschirms oder beide fest, um während des Übergangs zusätzliche Änderungen vorzunehmen.Set the OnHidden property of the old screen, the OnVisible property of the new screen, or both to make additional changes during the transition. Die App.ActiveScreen-Eigenschaft wird aktualisiert, um die Änderung zu übernehmen.The App.ActiveScreen property will be updated to reflect the change.

Navigate gibt normalerweise true zurück, gibt jedoch false zurück, wenn ein Fehler aufgetreten ist.Navigate normally returns true but will return false if an error is encountered.

BackBack

Die Back -Funktion kehrt zum Bildschirm zurück, der zuletzt angezeigt wurde.The Back function returns to the screen that was most recently displayed.

Für jeden Navigate -Befehl verfolgt die APP den angezeigten Bildschirm und den Übergang.For each Navigate call, the app tracks the screen that appeared and the transition. Sie können nachfolgende Back -Aufrufe verwenden, um den Bildschirm zurückzugeben, der beim Starten der app durch den Benutzer aufgetreten ist.You can use successive Back calls to return all the way to the screen that appeared when the user started the app.

Wenn die Back -Funktion ausgeführt wird, wird standardmäßig der umgekehrte Übergang verwendet.When the Back function runs, the inverse transition is used by default. Wenn z. b. ein Bildschirm durch den Übergang " coverright " angezeigt wird , verwendet Back die Rückgabe von " zurück " (auf der linken Seite).For example, if a screen appeared through the CoverRight transition, Back uses UnCover (which is to the left) to return. Fade und None sind Ihre eigenen inversen.Fade and None are their own inverses. Übergeben Sie ein optionales Argument an zurück , um einen bestimmten Übergang zu erzwingen.Pass an optional argument to Back to force a specific transition.

Back gibt normalerweise true zurück, gibt jedoch false zurück, wenn der Benutzer seit dem Starten der APP nicht zu einem anderen Bildschirm navigiert hatBack normally returns true but returns false if the user hasn't navigated to another screen since starting the app.

SyntaxSyntax

Zurück([ Übergang ])Back( [ Transition ] )

  • Übergang : optional.Transition - Optional. Der visuelle Übergang, der zwischen dem aktuellen Bildschirm und dem vorherigen Bildschirm verwendet werden soll.The visual transition to use between the current screen and the previous screen. Eine Liste der gültigen Werte für dieses Argument finden Sie weiter oben in diesem Thema.Refer to the list of valid values for this argument earlier in this topic. Standardmäßig ist der Übergang, durch den ein Bildschirm zurückgegeben wird, der Umkehrung des Übergangs, durch den es auftrat.By default, the transition through which a screen returns is the inverse of the transition through which it appeared.

Navigate( Bildschirm [; Übergang [; updatecontextrecord ]])Navigate( Screen [; Transition [; UpdateContextRecord ] ] )

  • Bildschirm: Erforderlich.Screen - Required. Der anzuzeigende Bildschirm.The screen to display.
  • Übergang : optional.Transition - Optional. Der visuelle Übergang, der zwischen dem aktuellen Bildschirm und dem nächsten Bildschirm verwendet werden soll.The visual transition to use between the current screen and the next screen. Weitere Informationen finden Sie in der Liste der gültigen Werte für dieses Argument weiter oben in diesem Thema.See the list of valid values for this argument earlier in this topic. Der Standardwert ist " None".The default value is None.
  • Kontextaktualisierungs-Datensatz: Optional.UpdateContextRecord - Optional. Ein Datensatz, der den Namen mindestens einer Spalte und einen Wert für jede Spalte enthält.A record that contains the name of at least one column and a value for each column. Dieser Datensatz aktualisiert die Kontextvariablen des neuen Bildschirms wie bei der Übergabe an die UpdateContext -Funktion.This record updates the context variables of the new screen as if passed to the UpdateContext function.

BeispieleExamples

FormelFormula BeschreibungDescription ErgebnisResult
Navigation (Details)Navigate( Details ) Zeigt den Detailbildschirm ohne Übergang oder Änderung des Werts einer Kontextvariablen an.Displays the Details screen with no transition or change in value for a context variable. Der Detailbildschirm erscheint schnell.The Details screen appears quickly.
Navigate( Details; ScreenTransition.Fade )Navigate( Details; ScreenTransition.Fade ) Zeigt den Detailbildschirm mit einem Fade-Übergang an.Displays the Details screen with a Fade transition. Kein Wert einer Kontextvariablen wird geändert.No value of a context variable is changed. Der aktuelle Bildschirm wird ausgeblendet, um den Detailbildschirm anzuzeigen.The current screen fades away to show the Details screen.
Navigate( Details; ScreenTransition.Fade; { ID: 12 } )Navigate( Details; ScreenTransition.Fade; { ID: 12 } ) Zeigt den Detailbildschirm mit einem Fade-Übergang an und aktualisiert den Wert der Kontextvariable ID auf 12.Displays the Details screen with a Fade transition, and updates the value of the ID context variable to 12. Der aktuelle Bildschirm wird ausgeblendet, um den Detailbildschirm anzuzeigen, und die Kontextvariable ID auf diesem Bildschirm wird auf 12 festgelegt.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 ; Shade: Color.Red } )Navigate( Details; ScreenTransition.Fade; { ID: 12 ; Shade: Color.Red } ) Zeigt den Detailbildschirm mit einem Fade-Übergang an.Displays the Details screen with a Fade transition. Aktualisiert den Wert der Kontextvariable ID auf 12 und aktualisiert den Wert der Kontextvariable Shade auf Color.Red.Updates the value of the ID context variable to 12, and updates the value of the Shade context variable to Color.Red. Der aktuelle Bildschirm wird ausgeblendet, um den Detailbildschirm anzuzeigen.The current screen fades away to show the Details screen. Die Kontextvariable ID auf dem Detailbildschirm wird auf 12 festgelegt, und die Kontextvariable Shade wird auf Color.Red festgelegt.The context variable ID on the Details screen is set to 12, and the context variable Shade is set to Color.Red. Wenn Sie die Fill-Eigenschaft eines Steuerelements auf dem Detailbildschirm auf Shade festlegen, würde dieses Steuerelement rot angezeigt werden.If you set the Fill property of a control on the Details screen to Shade, that control would display as red.
Back()Back() Zeigt den vorherigen Bildschirm mit dem standardmäßigen Rückgabe Übergang an.Displays the previous screen with the default return transition. Zeigt den vorherigen Bildschirm durch den umgekehrten Übergang des Übergangs an, durch den der aktuelle Bildschirm angezeigt wurde.Displays the previous screen through the inverse transition of the transition through which the current screen appeared.
Zurück (screentransition. Cover)Back( ScreenTransition.Cover ) Zeigt den vorherigen Bildschirm mit dem Deck Übergang an.Displays the previous screen with the Cover transition. Zeigt den vorherigen Bildschirm über den Umschlag Übergang an, unabhängig von der Umstellung, in der der aktuelle Bildschirm angezeigt wird.Displays the previous screen through the Cover transition, regardless of the transition through which the current screen appeared.

Schritt für SchrittStep-by-step

  1. Erstellen Sie eine leere app.Create a blank app.

  2. Fügen Sie einen zweiten Bildschirm hinzu.Add a second screen to it.

    Die app enthält zwei leere Bildschirme: Screen1 und Screen2.The app contains two blank screens: Screen1 and Screen2.

  3. Legen Sie die Fill -Eigenschaft von Screen2 auf den Wert Grayfest.Set the Fill property of Screen2 to the value Gray.

  4. Fügen Sie auf Screen2eine Schaltfläche hinzu, und legen Sie die onselect -Eigenschaft auf diese Formel fest:On Screen2, add a button, and set its OnSelect property to this formula:

    Navigate( Screen1; ScreenTransition.Cover )
    
  5. Wenn Sie die alt -Taste gedrückt halten, wählen Sie die Schaltfläche aus.While holding down the Alt key, select the button.

    Screen1 wird mit einem weißen Hintergrund durch einen Übergang angezeigt, der sich auf der linken Seite befindet.Screen1 appears with a white background through a transition that covers to the left.

  6. Fügen Sie auf Screen1eine Schaltfläche hinzu, und legen Sie die onselect -Eigenschaft auf diese Formel fest:On Screen1, add a button, and set its OnSelect property to this formula:

    Back()
    
  7. Wenn Sie die alt -Taste gedrückt halten, wählen Sie die Schaltfläche aus.While holding down the Alt key, select the button.

    Der zweite Bildschirm wird mit einem grauen Hintergrund durch einen Übergang angezeigt, der auf der rechten Seite (umgekehrter Abdeckung) steht.The second screen appears with a gray background through a transition that uncovers to the right (the inverse of Cover).

  8. Wählen Sie die Schaltfläche auf jedem Bildschirm wiederholt aus, um hin und her zu springenSelect the button on each screen repeatedly to bounce back and forth.

Ein weiteres BeispielAnother example