Fungsi Kembali dan Navigasi

Mengubah skrin yang dipaparkan.

Gambaran keseluruhan

Sebilangan besar aplikasi mengandungi berbilang skrin. Gunakan fungsi Back dan Navigate untuk mengubah skrin yang dipaparkan. Sebagai contoh, tetapkan sifat OnSelect butang ke formula yang merangkumi fungsi Navigasi jika anda mahu menunjukkan skrin yang berbeza apabila pengguna memilih butang tersebut. Dalam formula tersebut, anda boleh menentukan peralihan visual, seperti Pudar, untuk mengawal cara satu skrin berubah kepada yang lain.

Kembali dan Navigasi hanya mengubah skrin yang dipaparkan. Skrin yang pada masa ini tidak dipaparkan terus beroperasi di sebalik tabir. Anda boleh membina formula yang merujuk kepada sifat kawalan pada skrin lain. Sebagai contoh, pengguna dapat mengubah nilai gelangsar pada satu skrin, menavigasi ke skrin berbeza yang menggunakan nilai tersebut dalam formula, dan menentukan cara ia mempengaruhi perkara yang berlaku dalam layar baharu. Pengguna kemudian boleh menavigasi kembali ke skrin asal dan mengesahkan bahawa gelangsar telah mengekalkan nilainya.

Pemboleh ubah konteks juga dikekalkan ketika pengguna menavigasi antara skrin. Anda boleh menggunakan Navigasi untuk menetapkan satu atau lebih pemboleh ubah konteks untuk skrin yang formula akan dipaparkan, yang mana merupakan satu-satunya cara untuk menetapkan pemboleh ubah konteks dari luar skrin. Anda boleh menggunakan pendekatan ini untuk menghantar parameter ke skrin. Jika anda telah menggunakan alat pengaturcaraan lain, pendekatan ini sama dengan menghantar parameter ke prosedur.

Gunakan objek Aplikasi sifat StartScreen untuk mengawal skrin yang pertama untuk dipaparkan.

Anda boleh menggunakan sama ada fungsi hanya dalam formula tingkah laku.

Digunakan pada: Aplikasi kanvas Apl berpandukan model

Pada argumen pertama, tentukan nama skrin yang akan dipaparkan.

Dalam argumen kedua, tentukan cara skrin lama berubah kepada skrin baharu:

Argumen Peralihan Penerangan Demonstrasi
ScreenTransition.Cover Skrin baharu meluncur ke dalam pandangan, bergerak dari kanan ke kiri, untuk menutup skrin semasa. peralihan skrin meliputi animasi.
ScreenTransition.CoverRight Skrin baharu meluncur ke dalam pandangan, bergerak dari kiri ke kanan, untuk menutup skrin semasa. peralihan skrin meliputi animasi kanan.
ScreenTransition.Fade Skrin semasa mula pudar untuk mendedahkan skrin baharu. peralihan skrin animasi pudar.
ScreenTransition.None (Lalai) Skrin baharu menggantikan skrin semasa dengan cepat. peralihan skrin tiada animasi.
ScreenTransition.UnCover Skrin semasa meluncur keluar dari pandangan, bergerak dari kanan ke kiri, untuk membongkar skrin baharu. peralihan skrin mendedahkan animasi.
ScreenTransition.UnCoverRight Skrin semasa meluncur keluar dari pandangan, bergerak dari kiri ke kanan, untuk membongkar skrin baharu. peralihan skrin mendedahkan animasi kanan.

Anda boleh menggunakan Navigasi untuk mencipta atau kemas kini pemboleh ubah konteks bagi skrin baharu. Sebagai argumen pilihan ketiga, hantar rekod yang mengandungi nama pemboleh ubah konteks sebagai nama lajur dan nilai baharu untuk pemboleh ubah konteks. Rekod ini sama dengan rekod yang anda gunakan dengan fungsi UpdateContext.

Tetapkan sifat OnHidden bagi skrin lama, sifat OnVisible bagi skrin baharu atau kedua-duanya untuk membuat perubahan tambahan semasa peralihan. Sifat App.ActiveScreen akan dikemas kini untuk menunjukkan perubahan.

Navigasi biasanya mengembalikan benar tetapi akan mengembalikan palsu sekiranya berlaku ralat.

Pemboleh ubah konteks untuk navigasi diterangkan dalam artikel navigasi antara skrin.

Kembali

Digunakan untuk: Aplikasi kanvas

Fungsi Back akan kembali ke skrin yang dipaparkan baru-baru ini.

Untuk setiap panggilan Navigasi, aplikasi menjejaki skrin yang muncul dan peralihan. Anda boleh menggunakan panggilan Kembali berturut-turut untuk kembali ke skrin yang muncul semasa pengguna memulakan aplikasi.

Apabila fungsi Back dijalankan, peralihan songsang digunakan secara lalai. Sebagai contoh, jika skrin muncul melalui peralihan CoverRight, Kembali menggunakan UnCover (yang berada di sebelah kiri) untuk kembali. Pudar dan Tiada adalah songsangan sendiri. Hantar argumen pilihan ke Kembali untuk memaksa peralihan tertentu.

Kembali biasanya mengembalikan benar tetapi mengembalikan palsu jika pengguna belum menavigasi ke skrin lain sejak memulakan aplikasi.

Sintaks

Kembali( [ Peralihan ] )

  • Peralihan - Pilihan. Peralihan visual untuk digunakan antara skrin semasa dan skrin sebelumnya. Rujuk senarai nilai yang sah untuk argumen ini sebelum dalam artikel ini. Secara lalai, peralihan melalui skrin kembali adalah pembalikan peralihan di tempat ia muncul.

Navigasi( Skrin [, Peralihan [, UpdateContextRecord ] ] )

  • Skrin - Diperlukan. Tiada skrin untuk dipaparkan. Di tempat Skrin, anda juga boleh menggunakan kawalan yang ada pada skrin yang ingin anda lalui.
  • Peralihan - Pilihan. Peralihan visual untuk digunakan antara skrin semasa dan skrin seterusnya. Lihat senarai nilai yang sah untuk argumen ini yang lebih awal dalam artikel ini. Nilai lalai adalah Tiada.
  • UpdateContextRecord - Pilihan. Rekod yang mengandungi nama sekurang-kurangnya satu lajur dan nilai untuk setiap lajur. Rekod ini mengemas kini pemboleh ubah konteks bagi skrin baharu jika dihantar ke fungsi UpdateContext.

Contoh

Formula Penerangan Hasil
Navigasi( Butiran ) Memaparkan skrin Butiran dengan tiada peralihan atau perubahan nilai untuk pemboleh ubah konteks. Skrin Butiran muncul dengan cepat.
Navigasi( Butiran, ScreenTransition.Fade ) Memaparkan skrin Butiran dengan peralihan Pudar. Tidak ada nilai pemboleh ubah konteks yang diubah. Skrin semasa mula pudar untuk menunjukkan skrin Butiran.
Navigasi( Butiran, ScreenTransition.Fade, { ID: 12 } ) Memaparkan skrin Butiran dengan peralihan Pudar dan mengemas kini nilai pemboleh ubah konteks ID kepada 12. Skrin semasa mula pudar untuk menunjukkan skrin Butiran dan pemboleh ubah konteks ID pada skrin tersebut adalah ditetapkan kepada 12.
Navigasi( Butiran, ScreenTransition.Fade, { ID: 12 , Bayang: Color.Red } ) Memaparkan skrin Butiran dengan peralihan Pudar. Kemas kini nilai pemboleh ubah konteks ID kepada 12 dan mengemas kini nilai pemboleh ubah Bayang kepada Color.Red. Skrin semasa mula pudar untuk menunjukkan skrin Butiran. Pemboleh ubah ID pada skrin Butiran adalah ditetapkan kepada 12 dan pemboleh ubah konteks Bayang adalah ditetapkan kepada Color.Red. Jika anda menetapkan Isi sifat kawalan pada skrin Butiran untuk Bayang, yang kawalan akan dipaparkan sebagai merah.
Kembali() Memaparkan skrin sebelumnya dengan peralihan kembali lalai. Memaparkan skrin sebelumnya dengan peralihan pembalikan tempat skrin semasa muncul.
Kembali( ScreenTransition.Cover ) Memaparkan skrin sebelumnya dengan peralihan Penutup. Memaparkan skrin sebelumnya melalui peralihan Penutup, tanpa mengira peralihan yang mana skrin semasa muncul.

Langkah demi langkah

  1. Cipta aplikasi kosong.

  2. Tambah skrin kedua padanya.

    Aplikasi ini mengandungi dua skrin kosong: Screen1 dan Screen2.

  3. Tetapkan Isi sifat Screen2 kepada nilai Gray.

  4. Pada Screen2, tambah butang dan tetapkan sifat OnSelect untuk formula ini:

    Navigate( Screen1, ScreenTransition.Cover )
    
  5. Semasa menahan kekunci Alt, pilih butang.

    Screen1 muncul dengan latar belakang putih melalui peralihan yang meliputi ke kiri.

  6. Pada Screen1, tambah butang dan tetapkan sifat OnSelect untuk formula ini:

    Back()
    
  7. Semasa menahan kekunci Alt, pilih butang.

    Skrin kedua muncul dengan latar belakang kelabu melalui peralihan yang terbongkar ke kanan (kebalikan dari Penutup).

  8. Pilih butang pada setiap skrin berulang kali melantun bersilih ganti.

Lihat juga

Menggunakan pemboleh ubah konteks