Fungsi Kembali dan Navigasi
Mengubah layar mana yang akan ditampilkan.
Gambaran Umum
Sebagian besar aplikasi berisi beberapa layar. Gunakan fungsi Back dan Navigate untuk mengubah layar yang ditampilkan. Misalnya, atur properti OnSelect dari tombol ke rumus yang mencakup fungsi Navigate jika Anda ingin menampilkan layar yang berbeda saat pengguna memilih tombol tersebut. Dalam rumus tersebut, Anda dapat menentukan transisi visual, seperti Fade, untuk mengontrol tampilan satu layar.
Back dan Navigate hanya mengubah layar yang ditampilkan. Layar yang tidak ditampilkan saat ini akan beroperasi di belakang layar. Anda dapat membuat rumus yang merujuk properti kontrol di layar lainnya. Misalnya, pengguna dapat mengubah nilai slider pada satu layar, menavigasi ke layar yang berbeda yang menggunakan nilai tersebut dalam formula, dan menentukan pengaruhnya terhadap apa yang terjadi di layar baru. Pengguna kemudian dapat menavigasi kembali ke layar asli dan mengonfirmasi bahwa slider telah menyimpan nilainya.
Variabel konteks juga ditetapkan saat pengguna menavigasi di antara layar. Anda dapat menggunakan Navigasi untuk menetapkan satu atau beberapa variabel konteks untuk layar yang akan ditampilkan rumus, yang merupakan satu-satunya cara untuk menetapkan variabel konteks dari luar layar. Anda dapat menggunakan metode ini untuk meneruskan parameter ke layar. Jika Anda telah menggunakan alat pemrograman lain, metode ini mirip dengan meneruskan parameter ke prosedur.
Gunakan properti StartScreen objek Aplikasi untuk mengontrol layar pertama yang akan ditampilkan.
Anda dapat menggunakan salah satu fungsi hanya dalam rumus perilaku.
Navigasikan
Berlaku untuk:
Aplikasi kanvas Aplikasi berdasarkan model
Dalam argumen pertama, tentukan nama layar yang akan ditampilkan.
Pada argumen kedua, tentukan bagaimana layar lama berubah ke layar baru:
| Argumen Transisi | KETERANGAN | Demo |
|---|---|---|
| ScreenTransition.Cover | Layar baru beralih ke tampilan, memindahkan kanan ke kiri, untuk menutupi layar saat ini. |  |
| ScreenTransition.CoverRight | Layar baru beralih ke tampilan, memindahkan kiri ke kanan, untuk menutupi layar saat ini. |  |
| ScreenTransition.Fade | Layar saat ini memudar untuk menampilkan layar baru. |  |
| ScreenTransition.None (Default) | Layar baru akan segera menggantikan layar saat ini. |  |
| ScreenTransition.UnCover | Layar saat ini beralih ke luar tampilan, memindahkan kanan ke kiri, untuk membuka layar baru. |  |
| ScreenTransition.UnCoverRight | Layar saat ini beralih ke luar tampilan, memindahkan kiri ke kanan, untuk membuka layar baru. |  |
Anda dapat menggunakan Navigasi untuk membuat atau memperbarui variabel konteks layar baru. Sebagai argumen ketiga opsional, teruskan rekaman yang berisi nama variabel konteks sebagai nama kolom dan nilai baru untuk variabel konteks. Rekaman ini sama dengan rekaman yang Anda gunakan dengan fungsi UpdateContext.
Atur properti OnHidden pada layar lama, properti OnVisible pada layar baru, atau keduanya untuk membuat perubahan tambahan selama transisi. Properti App.ActiveScreen akan diperbarui untuk mencerminkan perubahan.
Menavigasi biasanya menghasilkan nilai true namun akan menghasilkan false jika terjadi kesalahan.
Variabel konteks untuk navigasi dijelaskan dalam artikel menavigasi di antara layar.
Kembali
Berlaku untuk: Aplikasi kanvas
Fungsi Back menghasilkan ke layar yang terakhir ditampilkan.
Untuk setiap panggilan Navigasi, aplikasi melacak layar yang muncul dan transisi. Anda dapat menggunakan panggilan Kembali berturut-turut untuk kembali sepenuhnya ke layar yang muncul saat pengguna memulai aplikasi.
Bila fungsi Back berjalan, transisi terbalik digunakan secara default. Misalnya, jika layar muncul melalui transisi CoverRight, Back menggunakan UnCover (di sebelah kiri) untuk kembali. Fade dan None secara terbalik. Teruskan argumen opsional ke Back untuk memaksa transisi tertentu.
Back biasanya menghasilkan true, namun menghasilkan false jika pengguna belum menavigasi ke layar lain sejak memulai aplikasi.
Sintaks
Back( [ Transition ] )
- Transition - Opsional. Transisi visual yang akan digunakan antara layar saat ini dan layar sebelumnya. Lihat daftar nilai yang valid untuk argumen ini sebelumnya dalam artikel ini. Secara default, transisi yang dihasilkan layar adalah kebalikan dari transisi yang muncul.
Navigate( Screen [, Transition [, UpdateContextRecord ] ] )
- Screen - Wajib. Layar yang akan ditampilkan. Sebagai pengganti Layar, Anda juga dapat menggunakan kontrol yang ada di layar yang ingin Anda navigasikan.
- Transition - Opsional. Transisi visual yang akan digunakan antara layar saat ini dan layar berikutnya. Lihat daftar nilai yang valid untuk argumen ini sebelumnya dalam artikel ini. Nilai default adalah None.
- UpdateContextRecord - Opsional. Rekaman yang berisi nama setidaknya satu kolom dan nilai untuk setiap kolom. Rekaman ini akan memperbarui variabel konteks pada layar baru seolah-olah diteruskan ke fungsi UpdateContext.
Contoh
| Rumus | KETERANGAN | Hasil |
|---|---|---|
| Navigate( Details ) | Menampilkan layar Detail dengan tidak ada transisi atau perubahan nilai untuk variabel konteks. | Layar Detail ditampilkan dengan cepat. |
| Navigate( Details, ScreenTransition.Fade ) | Menampilkan layar Detail dengan transisi Fade . Tidak ada nilai variabel konteks yang diubah. | Layar saat ini memudar untuk menampilkan layar Detail. |
| Navigate( Details, ScreenTransition.Fade, { ID: 12 } ) | Menampilkan layar Detail dengan transisi Fade, dan memperbarui nilai dari variabel konteks ID ke 12. | Layar saat ini memudar untuk menampilkan layar Detail, dan ID variabel konteks di layar tersebut diatur ke 12. |
| Navigate( Details, ScreenTransition.Fade, { ID: 12 , Shade: Color.Red } ) | Menampilkan layar Detail dengan transisi Fade . Memperbarui nilai variabel konteks ID ke 12, dan memperbarui nilai variabel konteks Shade ke Color. Red. | Layar saat ini memudar untuk menampilkan layar Detail. ID variabel konteks pada layar Detail diatur ke 12, dan variabel konteks Shade diatur ke Color.Red. Jika Anda mengatur properti Fill pada kontrol pada layar Detail ke Shade, kontrol tersebut akan ditampilkan sebagai mérah. |
| Back() | Menampilkan layar sebelumnya dengan transisi kembali default. | Menampilkan layar sebelumnya melalui transisi terbalik pada transisi tempat layar saat ini muncul. |
| Back( ScreenTransition.Cover ) | Menampilkan layar sebelumnya dengan transisi Cover. | Menampilkan layar sebelumnya melalui transisi Cover, terlepas pada transisi tempat layar saat ini muncul. |
Langkah demi langkah
Buat aplikasi kosong.
Tambahkan layar kedua ke aplikasi.
Aplikasi ini berisi dua layar kosong: Screen1 dan Screen2.
Atur properti Fill pada Screen2 ke nilai
Gray.Pada Screen2, tambahkan tombol, lalu atur properti OnSelect ke rumus ini:
Navigate( Screen1, ScreenTransition.Cover )Sambil menekan terus tombol Alt, pilih tombol.
Screen1 muncul dengan latar belakang putih melalui transisi yang menutupi ke kiri.
Pada Screen1, tambahkan tombol, lalu atur properti OnSelect ke rumus ini:
Back()Sambil menekan terus tombol Alt, pilih tombol.
Layar kedua muncul dengan latar belakang abu-abu melalui transisi yang membuka ke kanan (kebalikan dari Cover).
Pilih tombol pada setiap layar berulang kali untuk memantul bolak-balik.