Funzioni Back e Navigate in PowerAppsBack and Navigate functions in PowerApps

Cambiano la schermata visualizzata.Changes which screen is displayed.

PanoramicaOverview

La maggior parte delle app contengono diverse schermate.Most apps contain multiple screens. Usare le funzioni Back e Navigate per cambiare la schermata visualizzata.Use the Back and Navigate function to change which screen is displayed. Ad esempio, impostare la proprietà OnSelect di un pulsante su una formula che include la funzione Navigate se si vuole visualizzare un'altra schermata quando l'utente selezione tale pulsante.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. Nella formula, è possibile specificare una transizione visiva, ad esempio dissolvenza, per controllare come una schermata cambia in un'altra.In that formula, you can specify a visual transition, such as Fade, to control how one screen changes to another.

Le funzione Back e Navigate cambiano solo la schermata visualizzata.Back and Navigate change only which screen is displayed. Le schermate che non sono attualmente visualizzate continuano a essere eseguite in background.Screens that aren't currently displayed continue to operate behind the scenes. È possibile compilare formule che fanno riferimento alle proprietà dei controlli in altre schermate.You can build formulas that refer to properties of controls on other screens. Un utente può, ad esempio, modificare il valore di un dispositivo di scorrimento in una schermata, passare a una schermata diversa che utilizza tale valore in una formula e verificare il modo in cui influiscono sulle operazioni eseguite nella nuova schermata.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. L'utente può quindi tornare alla schermata originale e verificare che il dispositivo di scorrimento abbia mantenuto il valore.The user can then navigate back to the original screen and confirm that the slider has retained its value.

Le variabili di contesto vengono mantenute anche quando un utente si sposta tra le schermate.Context variables are also preserved when a user navigates between screens. È possibile usare la funzione Navigate per impostare una o più variabili di contesto per la schermata che verrà visualizzata dalla formula. Questo è l'unico modo per impostare una variabile di contesto fuori dalla schermata.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. È possibile usare questo approccio per passare parametri a una schermata.You can use this approach to pass parameters to a screen. Se si ha esperienza con un altro strumento di programmazione, questo approccio è simile al passaggio di parametri alle procedure.If you've used another programming tool, this approach is similar to passing parameters to procedures.

È possibile utilizzare una delle due funzioni solo all'interno di una formula di comportamento.You can use either function only within a behavior formula.

Nel primo argomento, specificare il nome della schermata da visualizzare.In the first argument, specify the name of the screen to display.

Nel secondo argomento, specificare in che modo la schermata precedente passa alla nuova:In the second argument, specify how the old screen changes to the new screen:

Argomento di transizioneTransition Argument DescrizioneDescription DimostrazioneDemonstration
ScreenTransition.CoverScreenTransition.Cover La nuova schermata scorre in visualizzazione, spostando da destra a sinistra, per coprire la schermata corrente.The new screen slides into view, moving right to left, to cover the current screen. animazione della copertura della transizione dello schermo
ScreenTransition.CoverRightScreenTransition.CoverRight La nuova schermata scorre in visualizzazione, spostando da sinistra verso destra, per coprire la schermata corrente.The new screen slides into view, moving left to right, to cover the current screen. animazione a destra del coperchio della transizione dello schermo
ScreenTransition.FadeScreenTransition.Fade La schermata corrente si dissolve per rivelare la nuova schermata.The current screen fades away to reveal the new screen. animazione dissolvenza transizione schermo
ScreenTransition. None (impostazione predefinita)ScreenTransition.None (Default) La nuova schermata sostituisce rapidamente la schermata corrente.The new screen quickly replaces the current screen. animazione nessuna transizione schermo
ScreenTransition.UnCoverScreenTransition.UnCover Lo schermo corrente scorre fuori dalla visualizzazione, spostando da destra a sinistra, per individuare la nuova schermata.The current screen slides out of view, moving right to left, to uncover the new screen. animazione di recupero della transizione dello schermo
ScreenTransition.UnCoverRightScreenTransition.UnCoverRight Lo schermo corrente scorre fuori dalla visualizzazione, spostandosi da sinistra a destra, per individuare la nuova schermata.The current screen slides out of view, moving left to right, to uncover the new screen. animazione a destra della transizione dello schermo

È possibile usare la funzione Navigate per creare o aggiornare le variabili di contesto della nuova schermata.You can use Navigate to create or update context variables of the new screen. Come terzo argomento facoltativo, indicare un record che contiene il nome di una variabile di contesto come nome colonna e il nuovo valore per la variabile di contesto.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. Questo è lo stesso record usato con la funzione UpdateContext .This record is the same as the record that you use with the UpdateContext function.

Impostare la proprietà OnHidden della schermata precedente, la proprietà OnVisible della nuova schermata o entrambe per implementare altre modifiche durante la transizione.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 proprietà App.ActiveScreen verrà aggiornata per riflettere la modifica.The App.ActiveScreen property will be updated to reflect the change.

La funzione Navigate restituisce normalmente true , ma restituisce false se viene rilevato un errore.Navigate normally returns true but will return false if an error is encountered.

BackBack

La funzione back torna alla schermata visualizzata più di recente.The Back function returns to the screen that was most recently displayed.

Per ogni chiamata di navigazione , l'app tiene traccia dello schermo visualizzato e della transizione.For each Navigate call, the app tracks the screen that appeared and the transition. È possibile usare le chiamate successive per tornare alla schermata visualizzata quando l'utente ha avviato l'app.You can use successive Back calls to return all the way to the screen that appeared when the user started the app.

Quando viene eseguita la funzione back , per impostazione predefinita viene usata la transizione inversa.When the Back function runs, the inverse transition is used by default. Se, ad esempio, una schermata è stata visualizzata attraverso la transizione CoverRight , back USA uncover (ovvero a sinistra) per restituire.For example, if a screen appeared through the CoverRight transition, Back uses UnCover (which is to the left) to return. Fade e None sono i propri inversi.Fade and None are their own inverses. Passare un argomento facoltativo a back per forzare una transizione specifica.Pass an optional argument to Back to force a specific transition.

Restituisce normalmente true , ma restituisce false se l'utente non ha eseguito l'esplorazione in un'altra schermata dall'avvio dell'app.Back normally returns true but returns false if the user hasn't navigated to another screen since starting the app.

SintassiSyntax

Indietro([ transizione ])Back( [ Transition ] )

  • Transition -facoltativo.Transition - Optional. Transizione visiva da utilizzare tra la schermata corrente e quella precedente.The visual transition to use between the current screen and the previous screen. Vedere l'elenco dei valori validi per questo argomento in precedenza in questo argomento.Refer to the list of valid values for this argument earlier in this topic. Per impostazione predefinita, la transizione attraverso cui viene restituita una schermata è l'inverso della transizione attraverso cui è comparso.By default, the transition through which a screen returns is the inverse of the transition through which it appeared.

Navigate( schermata [; transizione [; recordcontestoaggiornato ]])Navigate( Screen [; Transition [; UpdateContextRecord ] ] )

  • Schermata: obbligatorio.Screen - Required. La schermata da visualizzare.The screen to display.
  • Transition -facoltativo.Transition - Optional. La transizione visiva da usare tra la schermata corrente e la schermata successiva.The visual transition to use between the current screen and the next screen. Vedere l'elenco dei valori validi per questo argomento nelle sezioni precedenti.See the list of valid values for this argument earlier in this topic. Il valore predefinito è None.The default value is None.
  • RecordContestoAggiornamento: facoltativo.UpdateContextRecord - Optional. Un record che contiene il nome di almeno una colonna e un valore per ogni colonna.A record that contains the name of at least one column and a value for each column. Questo record aggiorna le variabili di contesto della nuova schermata come se fossero stati passati alla funzione UpdateContext .This record updates the context variables of the new screen as if passed to the UpdateContext function.

EsempiExamples

FormulaFormula DescrizioneDescription RisultatoResult
Navigate (Dettagli)Navigate( Details ) Visualizza la schermata Details senza transizione o cambia in un valore per una variabile di contesto.Displays the Details screen with no transition or change in value for a context variable. La schermata Details viene visualizzata in modo rapido.The Details screen appears quickly.
Navigate( Details; ScreenTransition.Fade )Navigate( Details; ScreenTransition.Fade ) Visualizza la schermata Details con una transizione a dissolvenza.Displays the Details screen with a Fade transition. Non viene modificato alcun valore di una variabile di contesto.No value of a context variable is changed. La schermata corrente si dissolve in uscita per visualizzare la schermata Details.The current screen fades away to show the Details screen.
Navigate( Details; ScreenTransition.Fade; { ID: 12 } )Navigate( Details; ScreenTransition.Fade; { ID: 12 } ) Visualizza la schermata Details con una transizione a dissolvenza e aggiorna il valore della variabile di contesto ID a 12.Displays the Details screen with a Fade transition, and updates the value of the ID context variable to 12. La schermata corrente si dissolve in uscita per visualizzare la schermata Details e la variabile di contesto ID di tale schermata viene impostata su 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 } ) Visualizza la schermata Details con una transizione a dissolvenza.Displays the Details screen with a Fade transition. Aggiorna il valore della variabile di contesto ID a 12 e aggiorna il valore della variabile di contesto Shade a Color.Red.Updates the value of the ID context variable to 12, and updates the value of the Shade context variable to Color.Red. La schermata corrente si dissolve in uscita per visualizzare la schermata Details.The current screen fades away to show the Details screen. La variabile di contesto ID della schermata Details viene impostata su 12e la variabile di contesto Shade viene impostata suColor.Red.The context variable ID on the Details screen is set to 12, and the context variable Shade is set to Color.Red. Se si imposta la proprietà Fill di un controllo della schermata Details su Shade, tale controllo verrà visualizzato in rosso.If you set the Fill property of a control on the Details screen to Shade, that control would display as red.
Back()Back() Visualizza la schermata precedente con la transizione restituita predefinita.Displays the previous screen with the default return transition. Visualizza la schermata precedente tramite la transizione inversa della transizione attraverso la quale è apparsa la schermata corrente.Displays the previous screen through the inverse transition of the transition through which the current screen appeared.
Indietro (ScreenTransition. Cover)Back( ScreenTransition.Cover ) Visualizza la schermata precedente con la transizione della copertura .Displays the previous screen with the Cover transition. Visualizza la schermata precedente nella transizione della copertura , indipendentemente dalla transizione attraverso la quale è stata visualizzata la schermata corrente.Displays the previous screen through the Cover transition, regardless of the transition through which the current screen appeared.

Istruzioni dettagliateStep-by-step

  1. Creare un'app vuota.Create a blank app.

  2. Aggiungere una seconda schermata.Add a second screen to it.

    L'app contiene due schermate vuote: Screen1 e Screen2.The app contains two blank screens: Screen1 and Screen2.

  3. Impostare la proprietà Fill di Screen2 sul valore Gray.Set the Fill property of Screen2 to the value Gray.

  4. In Screen2aggiungere un pulsante e impostarne la proprietà onselect sulla formula seguente:On Screen2, add a button, and set its OnSelect property to this formula:

    Navigate( Screen1; ScreenTransition.Cover )
    
  5. Tenendo premuto il tasto ALT , selezionare il pulsante.While holding down the Alt key, select the button.

    Screen1 viene visualizzato con uno sfondo bianco attraverso una transizione che copre a sinistra.Screen1 appears with a white background through a transition that covers to the left.

  6. In Screen1aggiungere un pulsante e impostarne la proprietà onselect sulla formula seguente:On Screen1, add a button, and set its OnSelect property to this formula:

    Back()
    
  7. Tenendo premuto il tasto ALT , selezionare il pulsante.While holding down the Alt key, select the button.

    La seconda schermata viene visualizzata con uno sfondo grigio tramite una transizione che consente di individuare a destra (l'inverso della copertura).The second screen appears with a gray background through a transition that uncovers to the right (the inverse of Cover).

  8. Selezionare ripetutamente il pulsante in ogni schermata per eseguire il rimbalzo avanti e indietro.Select the button on each screen repeatedly to bounce back and forth.

Un altro esempioAnother example