Back și Navigate funcții

Se aplică pentru: planșă de lucru aplicații

Modifică ecranul care este afișat.

Prezentare generală

Majoritatea aplicațiilor conțin mai multe ecrane. Utilizați funcția Back și Navigate pentru a modifica ecranul afișat. De exemplu, setați proprietatea OnSelect a unui buton la o formulă care include o Navigate funcție dacă doriți să afișați un alt ecran atunci când un utilizator selectează butonul respectiv. În această formulă, puteți specifica o tranziție vizuală, cum ar fi Fade, pentru a controla cum se schimbă un ecran în altul.

Back și Navigate modificați doar ecranul care se afișează. Ecranele care nu sunt afișate în prezent continuă să funcționeze în culise. Puteți construi formule care se referă la proprietățile controalelor pe alte ecrane. De exemplu, un utilizator poate modifica valoarea unui glisor pe un ecran, poate naviga la un ecran diferit care utilizează acea valoare într-o formulă și poate determina modul în care afectează ceea ce se întâmplă în noul ecran. Utilizatorul poate naviga înapoi la ecranul inițial și să confirme că glisorul și-a păstrat valoarea.

Variabilele de context sunt păstrate și atunci când un utilizator navighează între ecrane. Puteți utiliza Navigate pentru a seta una sau mai multe variabile contextuale pentru ecranul pe care îl va afișa formula, care este singura modalitate de a seta o variabilă contextuală din afara ecranului. Puteți utiliza această abordare pentru a trece parametrii pe un ecran. Dacă ați utilizat un alt instrument de programare, această abordare este similară cu trecerea parametrilor la proceduri.

Utilizați proprietatea obiectului aplicațieiStartScreen pentru a controla primul ecran care va fi afișat.

Puteți utiliza oricare dintre funcții doar în cadrul unei formula comportamentale.

Navigate

În primul argument, specificați numele ecranului de afișat.

În al doilea argument, specificați modul în care ecranul vechi se schimbă la noul ecran:

Argument Transition	Descriere	Demonstrație
ScreenTransition.Cover	Noul ecran se afișează, deplasându-se de la dreapta la stânga, pentru a acoperi ecranul curent.
ScreenTransition.CoverRight	Noul ecran se afișează, deplasându-se de la stânga la dreapta, pentru a acoperi ecranul curent.
ScreenTransition.Fade	Ecranul curent se estompează pentru a dezvălui noul ecran.
ScreenTransition.None (Implicit)	Noul ecran înlocuiește rapid ecranul curent.
ScreenTransition.UnCover	Ecranul curent se ascunde, deplasându-se de la dreapta la stânga, pentru a dezvălui ecranul nou.
ScreenTransition.UnCoverRight	Ecranul curent se ascunde, deplasându-se de la stânga la dreapta pentru a dezvălui ecranul nou.

Puteți utiliza Navigate pentru a crea sau a actualiza variabilele contextuale ale noului ecran. Ca un al treilea argument opțional, transmiteți o înregistrare care conține numele variabilă de context ca nume coloană și noua valoare pentru variabila de context. Această înregistrare este aceeași cu înregistrarea pe care o utilizați cu funcția UpdateContext.

Setați proprietatea OnHidden a ecranului vechi, proprietatea OnVisible a noului ecran sau ambele pentru a face modificări suplimentare în timpul tranziției. Proprietatea App.ActiveScreen va fi actualizată pentru a reflecta schimbarea.

Navigate în mod normal returnează true , dar va returna fals dacă se întâlnește o eroare.

Variabilele de context pentru navigare sunt explicate în articolul navigați între ecrane.

Back

Funcția Back revine la ecranul care a fost afișat cel mai recent.

Pentru fiecare Navigate apel, aplicația urmărește ecranul care a apărut și tranziția. Puteți utiliza apeluri succesive Back pentru a reveni la ecranul care a apărut atunci când utilizatorul a început aplicația.

Atunci când funcția rulează, tranziția Back inversă este utilizată în mod implicit. De exemplu, dacă un ecran a apărut prin tranziția CoverRight , Back utilizează Descoperire (care se află la stânga) pentru a reveni. Fade și Niciuna sunt propriile lor inverse. Treceți un argument opțional pentru a Back impune o anumită tranziție.

Back în mod normal returnează true , dar returnează fals dacă utilizatorul nu a navigat la alt ecran de la pornirea aplicației.

Sintaxă

Back( [ Tranziție ] )

• Tranziție - Opțional. Tranziția vizuală de utilizat între ecranul curent și ecranul anterior. Consultați lista valorilor valabile pentru acest argument anterior în acest articol. În mod implicit, tranziția prin care revine un ecran este inversă tranziției prin care a apărut.

Navigate( Ecran [, Tranziție [, UpdateContextRecord ] ] )

• Ecran - Obligatoriu. Ecranul de afișat. În locul Ecran, puteți utiliza și o comandă care se află pe ecranul la care doriți să navigați.
• Tranziție - Opțional. Tranziția vizuală de utilizat între ecranul curent și următorul ecran. Vedeți lista valorilor valabile pentru acest argument anterior în acest articol. Valoarea implicită este Niciunul.
• UpdateContextRecord - Opțional. O înregistrare care conține numele a cel puțin o coloană și o valoare pentru fiecare coloană. Această înregistrare actualizează variabile de context din noul ecran ca și cum ar fi trecut la funcția UpdateContext.

Exemple

Formulă	Descriere	Rezultat
Navigate( Detalii )	Afișează ecranul Detalii fără tranziție sau modificare de valoare pentru o variabilă de context.	Ecranul Detalii apare rapid.
Navigate( Detalii, ScreenTransition.Fade )	Afișează ecranul Detalii cu o tranziție Estompare. Nu este modificată nicio valoare a unei variabile de context.	Ecranul curent se estompează pentru a arăta ecranul Detalii.
Navigate( Detalii, ScreenTransition.Fade, { ID: 12 } )	Afișează ecranul Detalii cu o tranziție Estompare și actualizează valoarea variabilei de context ID la 12.	Ecranul curent se estompează pentru a afișa ecranul Detalii, iar ID-ul variabilei de context pe ecranul respectiv este setat la 12.
Navigate( Detalii, ScreenTransition.Fade, { ID: 12 , Umbră: Culoare.roșu } )	Afișează ecranul Detalii cu o tranziție Estompare. Actualizează valoarea variabilei de context ID la 12 și actualizează valoarea variabilei de context Umbră la Color.Red.	Ecranul curent se estompează pentru a arăta ecranul Detalii. ID-ul variabilei de context la ecranul Detalii este setat la 12, iar variabila de context Umbră este setată la Color.Red. Dacă setați proprietatea Umplere a unui control asupra ecranului Detalii la Umbră, acel control se va afișa ca roșu.
Back()	Afișează ecranul anterior cu tranziția de întoarcere implicită.	Afișează ecranul anterior prin tranziția inversă a tranziției prin care ecranul curent a apărut.
Back( ScreenTransition.Cover )	Afișează ecranul anterior cu tranziția Cover.	Afișează ecranul anterior prin tranziția inversă a tranziției Cover, indiferent de tranziția prin care ecranul curent a apărut.

Pas cu pas

1. Creați o aplicație necompletată.

2. Adăugați un al doilea ecran.

   Aplicația conține două ecrane goale: Screen1 și Screen2.

3. Setați proprietatea Umplere a Screen2 la valoarea Gray.

4. Pe Screen2, adăugați un buton, apoi setați-i proprietatea OnSelect la această formulă:

   Navigate( Screen1, ScreenTransition.Cover )
   

5. În timp ce țineți apăsată tasta Alt, selectați butonul.

   Screen1 apare cu un fundal alb printr-o tranziție care acoperă spre stânga.

6. Pe Screen1, adăugați un buton, apoi setați-i proprietatea OnSelect la această formulă:

   Back()
   

7. În timp ce țineți apăsată tasta Alt, selectați butonul.

   Cel de-al doilea ecran apare cu un fundal gri printr-o tranziție care se descoperă spre dreapta (inversul lui Acoperi).

8. Selectați butonul de pe fiecare ecran în mod repetat pentru a sări înapoi și înapoi.

Consultați și

Utilizarea variabilelor de context