Backfunzioni e Navigate

Si applica a: App Canvas

Cambiano la schermata visualizzata.

Descrizione

La maggior parte delle app contengono diverse schermate. Usare la Back funzione e Navigate per modificare la schermata visualizzata. Ad esempio, impostare la proprietà OnSelect di un pulsante su una formula che include una Navigate funzione se si desidera visualizzare una schermata diversa quando un utente seleziona tale pulsante. Nella formula, è possibile specificare una transizione visiva, ad esempio dissolvenza, per controllare come una schermata cambia in un'altra.

Back e Navigate modificare solo la schermata visualizzata. Le schermate che non sono attualmente visualizzate continuano a essere eseguite in background. È possibile creare formule che fanno riferimento alle proprietà dei controlli in altre schermate. Ad esempio, un utente può modificare il valore di un dispositivo di scorrimento in una schermata, passare a un'altra schermata che usa tale valore in una formula e determinare gli effetti nella nuova schermata. L'utente può quindi tornare alla schermata originale e confermare che il dispositivo di scorrimento ha mantenuto il valore.

Le variabili di contesto vengono conservate anche quando un utente naviga tra le schermate. È possibile usare Navigate per impostare una o più variabili di contesto per la schermata visualizzata dalla formula, che è l'unico modo per impostare una variabile di contesto dall'esterno dello schermo. È possibile usare questo approccio per passare parametri a una schermata. Se si ha esperienza con un altro strumento di programmazione, questo approccio è simile al passaggio di parametri alle procedure.

Usa la proprietà StartScreen dell'oggetto App per controllare la prima schermata da visualizzare.

È possibile usare queste funzioni solo in una formula di comportamento.

Navigate

Nel primo argomento, specificare il nome della schermata da visualizzare.

Nel secondo argomento, specificare in che modo la schermata precedente passa alla nuova:

Argomento di transizione	Descrizione	Dimostrazione
Transizione dello schermo.Copertina	La nuova schermata entra nella visualizzazione, spostandosi da destra a sinistra, per coprire la schermata corrente.
Transizione dello schermo.Copertina destra	La nuova schermata entra nella visualizzazione, spostandosi da sinistra a destra, per coprire la schermata corrente.
Transizione dello schermo. Dissolvenza	La schermata corrente si dissolve per consentire la visualizzazione della nuova schermata.
ScreenTransition.None (Predefinito)	La nuova schermata sostituisce rapidamente la schermata corrente.
Transizione dello schermo.Scopri	La schermata corrente esce dalla visualizzazione, spostandosi da destra a sinistra, per visualizzare la nuova schermata.
Transizione dello schermo.Scoprire la destra	La schermata corrente esce dalla visualizzazione, spostandosi da sinistra a destra, per visualizzare la nuova schermata.

È possibile usare Navigate per creare o aggiornare le variabili di contesto della nuova schermata. 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. Questo è lo stesso record usato con la funzione UpdateContext.

Impostare la proprietà OnHidden della schermata precedente, la proprietà OnVisible della nuova schermata o entrambe per implementare altre modifiche durante la transizione. La proprietà App.ActiveScreen verrà aggiornata per riflettere la modifica.

Navigate in genere restituisce true ma restituisce false se viene rilevato un errore.

Le variabili di contesto per la navigazione sono descritte nell'articolo Passare da una schermata all'altra.

Back

La Back funzione torna alla schermata visualizzata più di recente.

Per ogni Navigate chiamata, l'app tiene traccia della schermata visualizzata e della transizione. È possibile usare le chiamate successive Back per tornare allo schermo visualizzato quando l'utente ha avviato l'app.

Quando la Back funzione viene eseguita, la transizione inversa viene usata per impostazione predefinita. Ad esempio, se una schermata è apparsa tramite la transizione CoverRight , Back usa UnCover (che si trova a sinistra) per tornare. Fade e None sono i loro inversi. Passare un argomento facoltativo a per forzare Back una transizione specifica.

Back in genere restituisce true ma restituisce false se l'utente non ha eseguito lo spostamento su un'altra schermata dall'avvio dell'app.

Sintassi

Back( [ Transizione ] )

• Transizione - Facoltativo. La transizione visiva da usare tra la schermata corrente e la schermata precedente. Vedere l'elenco dei valori validi per questo argomento nelle sezioni precedenti di questo articolo. Per impostazione predefinita, la transizione mediante la quale una schermata ritorna è l'inverso della transizione mediante la quale è apparsa.

Navigate( Schermata [, Transizione [, UpdateContextRecord ] ] )

• Schermo - Obbligatorio. La schermata da visualizzare. Al posto di Schermata, puoi anche utilizzare un controllo che si trova nella schermata a cui desideri accedere.
• Transizione - Facoltativo. La transizione visiva da usare tra la schermata corrente e la schermata successiva. Vedere l'elenco dei valori validi per questo argomento nelle sezioni precedenti di questo articolo. Il valore predefinito è None.
• UpdateContextRecord - Facoltativo. Un record che contiene il nome di almeno una colonna e un valore per ogni colonna. Questo record aggiorna le variabili di contesto della nuova schermata come se fossero stati passati alla funzione UpdateContext.

Esempi

Formula	Descrizione	Risultato
Navigate( Dettagli )	Visualizza la schermata Details senza transizione o cambia in un valore per una variabile di contesto.	La schermata Dettagli appare rapidamente.
Navigate( Details, ScreenTransition.Fade )	Consente di visualizzare la schermata Dettagli con una transizione di dissolvenza (Fade). Non viene modificato alcun valore delle variabili di contesto.	La schermata corrente scompare con una dissolvenza e appare la schermata Dettagli.
Navigate( Details, ScreenTransition.Fade, { ID: 12 } )	Consente di visualizzare la schermata Dettagli con una transizione di dissolvenza (Fade) e aggiorna il valore della variabile di contesto ID impostandolo su 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.
Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } )	Consente di visualizzare la schermata Dettagli con una transizione di dissolvenza (Fade). Aggiorna il valore della variabile di contesto ID a 12 e aggiorna il valore della variabile di contesto Shade a Color.Red.	La schermata corrente scompare con una dissolvenza e appare la schermata Dettagli. La variabile di contesto ID della schermata Details viene impostata su 12e la variabile di contesto Shade viene impostata suColor.Red. Se si imposta la proprietà Fill di un controllo della schermata Details su Shade, tale controllo verrà visualizzato in rosso.
Back()	Visualizza la schermata precedente con la transizione di ritorno predefinita.	Visualizza la schermata precedente tramite la transizione inversa della transizione mediante la quale la schermata corrente è apparsa.
Back( ScreenTransition.Cover )	Visualizza la schermata precedente con la transizione Cover.	Visualizza la schermata precedente tramite la transizione Cover, indipendentemente dalla transizione mediante la quale la schermata corrente è apparsa.

Procedura dettagliata

1. Creare un'app vuota.

2. Aggiungere una seconda schermata alla stessa.

   L'app contiene due schermate vuote: Screen1 e Screen2.

3. Impostare la proprietà Fill di Screen2 su Gray.

4. In Screen2, aggiungere un pulsante e impostare la relativa proprietà OnSelect su questa formula:

   Navigate( Screen1, ScreenTransition.Cover )
   

5. Selezionare il pulsante tenendo premuto il tasto ALT.

   Screen1 appare con uno sfondo bianco attraverso una transizione che si estende verso sinistra.

6. In Screen1, aggiungere un pulsante e impostare la relativa proprietà OnSelect su questa formula:

   Back()
   

7. Selezionare il pulsante tenendo premuto il tasto ALT.

   La seconda schermata appare con uno sfondo grigio tramite una transizione che appare a destra (l'inverso di Cover).

8. Selezionare il pulsante in ogni schermata ripetutamente per tornare indietro e di nuovo avanti.

Vedi anche

Utilizzo delle variabili di contesto