Tagasi ja navigeeri funktsioonid

  • Artikkel

Muudab kuvatava ekraani.

Ülevaade

Enamik rakendusi sisaldab mitut ekraani. Kasutage funktsioone Back ja Navigate, et muuta kuvatavaid ekraane. Näiteks määrake atribuut OnSelect valemi nupule, mis sisaldab fuktsiooni Navigate, kui soovite kuvada teist ekraani, kui kasutaja valib selle nupu. Sellises valemis saate määrata visuaalse siirde, nt Fade, et juhtida, kuidas üks ekraan muutub teiseks.

Funktsioonid Tagasi ja Navigeeri muudavad ainult seda, millist ekraani kuvatakse. Ekraanid, mida praegu ei kuvata, töötavad taustal. Saate luua valemeid, mis viitavad muude ekraanide juhtelementide atribuutidele. Näiteks kasutaja saab muuta liuguri väärtust ühel ekraanil, liikuda mõnele muule ekraanile, mis kasutab seda väärtust valemis, ja määratleda, kuidas see mõjutab seda, mis uues aknas juhtub. Seejärel saab kasutaja naasta algsele ekraanile ja kinnitada, et liugur on selle väärtuse säilitanud.

Konteksti muutujad säilitatakse ka siis, kui kasutaja navigeerib ekraanide vahel. Funktsiooni Navigate abil saate seada ekraani kuvamise jaoks ühe või mitu konteksti muutujat, mis on ainus võimalus seada konteksti muutujat väljaspoolt ekraani. Selle lähenemise abil saate parameetreid edastada ekraanile. Kui olete kasutanud mõnda muud programmeerimise tööriista, sarnaneb see lähenemine protseduuridele parameetrite edastamisega.

Kasutage esimese kuvatava ekraani juhtimiseks rakenduse objekti atribuuti StartScreen.

Võite käitumise valemis ühte neist funktsioonidest kasutada.

Kehtib: lõuendirakendused Mudelipõhised rakendused

Määrake esimeses argumendis kuvatava ekraani nimi.

Määrake teises argumendis, kuidas vana ekraan muutub uueks ekraaniks.

Ülemineku argument Kirjeldus Näidis
ScreenTransition.Cover Uus ekraan libiseb vaatesse, liikudes paremalt vasakule, et katta praeguse ekraani. ekraani ülemineku katmise animatsioon.
ScreenTransition.CoverRight Uus ekraan libiseb vaatesse, liikudes vasakult paremale, et katta praegust ekraani. ekraani ülemineku parempoolse katmise animatsioon.
ScreenTransition.Fade Praegune ekraan hajub ära, et avada uus ekraan. ekraani ülemineku hajumise animatsioon.
ScreenTransition.None (vaikesäte) Uus ekraan asendab praeguse ekraaniga kiiresti. ekraani ülemineku animatsiooni pole.
ScreenTransition.UnCover Uus ekraan libiseb vaatest välja, liikudes paremalt vasakule, et eemaldada kate uuelt ekraanilt. ekraani ülemineku katte eemaldamise animatsioon.
ScreenTransition.UnCoverRight Uus ekraan libiseb vaatest välja, liikudes vasakult paremale, et eemaldada kate uuelt ekraanilt. ekraani ülemineku parempoolse katteeemaldamise animatsioon.

Saate kasutada funktsiooni Navigate, et luua või värskendada uue ekraani kontekstimuutujaid. Valikulise kolmanda argumendina edastage kirje, mis sisaldab kontekstimuutuja nime veeru nimena ja uus väärtus kontekstimuutuja jaoks. See kirje on sama, mis funktsiooni UpdateContext sisaldav kirje.

Seadke vana ekraani atribuuti OnHidden, uue ekraani atribuuti OnVisible või mõlemaid, et teha täiendavaid muudatusi ülemineku ajal. Muudatuse peegeldamiseks uuendatakse atribuuti App.ActiveScreen.

Navigate tagastab tavaliselt väärtuse tõene, kuid tagastab väärtuse väär tõrke ilmnemisel.

Navigeerimise kontekstimuutujaid selgitab artikkel ekraanide vahel navigeerimine.

Tagasi

Kehtib: Lõuendirakendused

Funktsioon Back naaseb viimati kuvatud kuvale.

Iga funktsiooni Navigate kutsumise korral jälgib rakendus kuvatavat ekraani ja siiret. Järjestikuste funktsiooni Back kutsumiste abil saate tagasi pöörduda nii, et see kuvaks rakenduse käivitamise ajal kuvatud ekraani.

Kui funkstioon Back töötab, kasutatakse vaikimisi pööratud üleminekut. Näiteks, kui ekraan kuvatakse CoverRight siirdega, kasutab Back siiret UnCover (mis on vasakule) tagasipöördumiseks. Fade ja None on enda pöörded. Andke valikuline argument funktsioonile Back, et sundida teatud siiret.

Back tagastab tavaliselt väärtuse tõene, kuid tagastab väärtuse väär, kui kasutaja ei ole rakenduse käivitamisest saadik liikunud teisele ekraanile.

Süntaks

Back( [ Transition ] )

  • Siire – valikuline. Visuaalne siire praeguse ekraani ja eelmise ekraani vahel liikumiseks. Vt selles artiklis varem esitatud selle argumendi jaoks kehtivate väärtuste loendit. Vaikimisi on siire, mille kaudu ekraan naaseb, vastupidiseks siirdele, mille kaudu see ilmus.

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

  • Screen – nõutav. Kuvatav ekraan. Ekraani asemelsaate kasutada ka juhtelementi, mis asub ekraanil, kuhu soovite navigeerida.
  • Siire – valikuline. Visuaalne siire praeguse ekraani ja järgmise ekraani vahel liikumiseks. Vt selles artiklis varem esitatud selle argumendi jaoks kehtivate väärtuste loendit. Vaikeväärtus on Pole.
  • UpdateContextRecord – valikuline. Kirje, mis sisaldab vähemalt ühe veeru nime ja iga veeru väärtust. Selle kirjega värskendatakse uue ekraani kontekstimuutujaid, mis edastatakse funktsioonile UpdateContext.

Näited

Valem Kirjeldus Tulem
Navigate( Details ) Kuvab ekraani Üksikasjad, mis ei muutu ega muuda väärtust kontekstimuutuja jaoks. Ekraan Üksikasjad kuvatakse kiiresti.
Navigate( Details, ScreenTransition.Fade ) Kuvab ekraani Üksikasjad siirdega Hajutus. Konteksti muutuja väärtust ei muudeta. Praegune ekraan hajub ära, et avada ekraan Üksikasjad.
Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) Kuvab ekraani Üksikasjad siirdega Hajutus ja uuendab kontekstimuutuja ID väärtusele 12. Praegune ekraan hajub ära, et kuvada ekraan Üksikasjad ja kontekstimuutuja ID sellel ekraanil on seatud väärtusele 12.
Navigate( Details, ScreenTransition.Fade, { ID: 12, Shade: Color.Red } ) Kuvab ekraani Üksikasjad siirdega Hajutus. Uuendab ID kontekstimuutuja väärtuseks 12 ja uuendab kontekstimuutuja Vari väärtuseks Color. Red. Praegune ekraan hajub ära, et avada ekraan Üksikasjad. Kontekstimuutuja ID ekraanil Üksikasjad on seatud väärtusele 12 ja kontekstimuutuja Vari on seatud väärtusele Color.Red. Kui määrate juhtelemendi atribuudi Täide ekraanil Üksikasjad väärtuseks Vari, siis juhtelement kuvatakse punasena.
Back() Kuvab eelmise ekraani vaikimisi tagasipöördumise siirdega. Kuvab eelmise ekraani siirde kaudu, mis on vastupidiseks siirdele, mille kaudu ekraan ilmus.
Back( ScreenTransition.Cover ) Kuvab eelmise ekraani siirde Katmine kaudu. Kuvab eelmise ekraani siirde Katmine kaudu, olenemata siirdest, mille kaudu praegune ekraan ilmus.

Samm-sammult

  1. Tühja rakenduse loomine.

  2. Lisage sellele teine ekraan.

    Rakendus sisaldab kahte tühja ekraani: Screen1 ja Screen2.

  3. Määrake atribuut Täide ekraanil Screen2 väärtusele Gray.

  4. Ekraanil Screen2 lisage nupp ja määrake selle OnSelect atribuudiks see valem:

    Navigate( Screen1, ScreenTransition.Cover )

  5. Klahvi Alt all hoides valige nupp.

    Screen1 kuvatakse koos valge taustaga siirdega, mis katab vasakule.

  6. Ekraanil Screen1 lisage nupp ja määrake selle OnSelect atribuudiks see valem:

    Back()

  7. Klahvi Alt all hoides valige nupp.

    Teine ekraan ilmub hallil taustal siirde kaudu, mis eemaldab katte paremale (vastupidine siirdele Katmine).

  8. Valige igal ekraanil nuppu korduvalt, et tagastada edasi ja tagasi.

Vt ka

Kontekstimuutujate kasutamine