Fonctions Back et Navigate dans PowerAppsBack and Navigate functions in PowerApps

Permet de modifier l’écran qui s’affiche.Changes which screen is displayed.

Vue d’ensembleOverview

La plupart des applications contiennent plusieurs écrans.Most apps contain multiple screens. Utilisez les fonctions Back et Navigate pour modifier l’écran qui s’affiche.Use the Back and Navigate function to change which screen is displayed. Par exemple, définissez la propriété OnSelect d’un bouton sur une formule qui inclut une fonction Navigate si vous souhaitez afficher un écran différent lorsqu’un utilisateur appuie sur ce bouton.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. Dans cette formule, vous pouvez indiquer une transition visuelle (par exemple un effet de fondu pour contrôler le passage d’un écran à un autre.In that formula, you can specify a visual transition, such as Fade, to control how one screen changes to another.

Back et Navigate modifient uniquement l’écran qui s’affiche.Back and Navigate change only which screen is displayed. Les écrans qui ne s’affichent pas continuent de fonctionner à l’arrière-plan.Screens that aren't currently displayed continue to operate behind the scenes. Vous pouvez créer des formules qui font référence aux propriétés des contrôles sur un autre écran.You can build formulas that refer to properties of controls on another screen. Par exemple, un utilisateur modifie la valeur d’un curseur sur un écran, accède à un autre écran qui utilise cette valeur dans une formule, puis visualise la façon dont cela affecte le nouvel écran.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. L’utilisateur peut ensuite revenir à l’écran d’origine et constater que le curseur a conservé sa valeur.The user can then navigate back to the original screen and see that the slider has retained its value.

Les variables de contexte sont également préservées lorsqu’un utilisateur navigue d’un écran à l’autre.Context variables are also preserved when a user navigates between screens. Vous pouvez utiliser Navigate afin de définir une ou plusieurs variables de contexte pour l’écran que la formule va afficher. Il s’agit là du seul moyen de définir une variable de contexte depuis l’extérieur de l’écran.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. Utilisez cette approche pour transmettre des paramètres à un écran.You can use this approach to pass parameters to a screen. Si vous avez utilisé un autre outil de programmation, cette approche est similaire à celle consistant à transmettre des paramètres à des procédures.If you've used another programming tool, this approach is similar to passing parameters to procedures.

DescriptionDescription

BackBack

La fonction Back affiche l’écran apparu en dernier.The Back function displays the screen that was most recently displayed. Vous ne spécifiez aucun argument pour cette fonction.You don't specify any arguments for this function.

Dans le premier argument, indiquez le nom de l’écran à afficher.In the first argument, specify the name of the screen to display.

Dans le deuxième argument, indiquez comment effectuer la transition de l’ancien écran au nouvel écran :In the second argument, specify how the old screen changes to the new screen:

Argument de transitionTransition Argument DescriptionDescription
ScreenTransition.CoverScreenTransition.Cover Le nouvel écran apparaît, recouvrant l’écran actuel.The new screen slides into view, covering the current screen.
ScreenTransition.FadeScreenTransition.Fade L’ancien écran disparaît dans un effet de fondu pour afficher le nouvel écran.The old screen fades away to reveal the new screen.
ScreenTransition.NoneScreenTransition.None L’ancien écran est rapidement remplacé par le nouvel écran.The old screen is quickly replaced with the new screen.
ScreenTransition.UnCoverScreenTransition.UnCover L’ancien écran disparaît, révélant le nouvel écran.The old screen slides out of view, uncovering the new screen.

Vous pouvez utiliser Navigate pour créer ou mettre à jour les variables de contexte du nouvel écran.You can use Navigate to create or update context variables of the new screen. Comme troisième argument facultatif, transférez un enregistrement contenant le nom de la variable de contexte en tant que nom de colonne et la nouvelle valeur de la variable de contexte.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. Cet enregistrement est le même que celui que vous utilisez avec la fonction UpdateContext.This record is the same as the record that you use with the UpdateContext function.

Définissez la propriété OnHidden de l’ancien écran et la propriété OnVisible du nouvel écran, ou les deux pour apporter des modifications supplémentaires pendant la transition.Set the OnHidden property of the old screen, the OnVisible property of the new screen, or both to make additional changes during the transition. La propriété App.ActiveScreen est mise à jour pour refléter ces modifications.The App.ActiveScreen property will be updated to reflect the change.

Back renvoie normalement true, mais peut renvoyer false si l’utilisateur se trouve sur le premier écran présenté et qu’il n’existe aucun écran précédent.Back normally returns true but returns false if the user is on the first screen shown and there is no previous screen. Navigate renvoie normalement true, mais peut renvoyer false en cas de problème avec l’un de ses arguments.Navigate normally returns true but returns false if there is a problem with one of its arguments.

Utilisez ces fonctions uniquement au sein d’une formule de comportement.You can use these functions only within a behavior formula.

SyntaxeSyntax

Back()Back()

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

  • Screen : requis.Screen - Required. Écran à afficher.The screen to display.
  • Transition : requis.Transition - Required. Transition visuelle à utiliser entre l’écran actuel et l’écran suivant.The visual transition to use between the current screen and the next screen. Consultez la liste des valeurs valides pour cet argument telles que répertoriées précédemment dans cette rubrique.See the list of valid values for this argument earlier in this topic.
  • UpdateContextRecord : facultatif.UpdateContextRecord - Optional. Enregistrement contenant le nom d’au moins une colonne et une valeur pour cette colonne.A record that contains the name of at least one column and a value for each column. Cet enregistrement met à jour les variables de contexte du nouvel écran comme si elles étaient transmises à la fonction UpdateContext.This record updates the context variables of the new screen as if passed to the UpdateContext function.

ExemplesExamples

FormuleFormula DescriptionDescription RésultatResult
Navigate( Details, ScreenTransition.None )Navigate( Details, ScreenTransition.None ) Affiche l’écran Details sans transition ni changement de valeur d’une variable de contexte.Displays the Details screen with no transition or change in value for a context variable. L’écran Details apparaît rapidement.The Details screen appears quickly.
Navigate( Details, ScreenTransition.Fade )Navigate( Details, ScreenTransition.Fade ) Affiche l’écran Details avec une transition de type fondu.Displays the Details screen with a Fade transition. Aucune valeur de variable de contexte n’est modifiée.No value of a context variable is changed. L’écran actuel disparaît dans un effet de fondu pour révéler l’écran Details.The current screen fades away to show the Details screen.
Navigate( Details, ScreenTransition.Fade, { ID: 12 } )Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) Affiche l’écran Details avec une transition de type fondu, puis met à jour l’identifiant de la variable de contexte en lui donnant pour valeur 12.Displays the Details screen with a Fade transition, and updates the value of the ID context variable to 12. L’écran actuel disparaît dans un effet de fondu pour révéler l’écran Details, et l’identifiant de la variable de contexte de cet écran est défini sur 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 , Shade: Color.Red } )Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) Affiche l’écran Details avec une transition de type fondu.Displays the Details screen with a Fade transition. Met à jour la valeur de l’identifiant de la variable de contexte en lui donnant pour valeur 12, puis met à jour la valeur de la variable de contexte Shade en lui donnant pour valeur Color.Red.Updates the value of the ID context variable to 12, and updates the value of the Shade context variable to Color.Red. L’écran actuel disparaît dans un effet de fondu pour révéler l’écran Details.The current screen fades away to show the Details screen. L’identifiant de la variable de contexte de l’écran Details est défini sur 12, et la variable de contexte Shade est définie sur Color.Red.The context variable ID on the Details screen is set to 12, and the context variable Shade is set to Color.Red. Si vous définissez la propriété Fill d’un contrôle de l’écran Details sur Shade, ce contrôle s’affiche en rouge.If you set the Fill property of a control on the Details screen to Shade, that control would display as red.

Étape par étapeStep-by-step

  1. Nommez l’écran par défaut DefaultScreen, ajoutez-lui une étiquette, puis définissez la propriété Text de cette étiquette pour qu’elle affiche Default.Name the default screen DefaultScreen, add a label to it, and set the Text property of that label so that it shows Default.
  2. Ajoutez un écran, puis appelez-le AddlScreen.Add a screen, and name it AddlScreen.
  3. Ajoutez une étiquette à AddlScreen, puis définissez la propriété Text de cette étiquette pour qu’elle affiche Addl.Add a label to AddlScreen, and set the Text property of the label so that it shows Addl.
  4. Ajoutez un bouton à AddlScreen, puis définissez sa propriété OnSelect sur cette fonction :Add a button to AddlScreen, and set its OnSelect property to this function:
    Navigate(DefaultScreen, ScreenTransition.Fade)Navigate(DefaultScreen, ScreenTransition.Fade)
  5. À partir de AddlScreen, appuyez sur F5, puis cliquez sur le bouton.From the AddlScreen, press F5, and then select the button.
    DefaultScreen apparaît.DefaultScreen appears.

Autre exempleAnother example