Pilih fungsi

Berlaku untuk: Aplikasi kanvas Aplikasi berdasarkan model

Menyimulasikan tindakan tertentu pada suatu kontrol, yang menyebabkan rumus OnSelect dievaluasi.

KETERANGAN

Fungsi Select mensimulasikan tindakan pilih pada kontrol seolah-olah pengguna telah mengklik atau mengetuk kontrol. Akibatnya rumus OnSelect pada kontrol target dievaluasi.

Gunakan Select untuk menyebarkan tindakan pilih ke kontrol induk. Jenis penyebaran adalah perilaku default dalam, misalnya, galeri. Secara default, properti OnSelect dari kontrol dalam kontrol Galeri diatur ke Select( Parent ). Dengan begitu, Anda dapat mengatur nilai properti OnSelect kontrol galeri itu sendiri, dan rumus akan dievaluasi terlepas lokasi yang mungkin diklik atau diketuk pengguna dalam galeri.

Jika Anda ingin satu atau beberapa kontrol dalam galeri melakukan tindakan yang berbeda dari galeri itu sendiri, atur properti OnSelect untuk kontrol tersebut ke sesuatu selain nilai default. Anda dapat membiarkan nilai default untuk properti OnSelect dari sebagian besar kontrol dalam galeri jika Anda ingin kontrol melakukan tindakan yang sama seperti galeri itu sendiri.

Select mengantre OnSelect target untuk pemrosesan nanti, yang mungkin terjadi setelah rumus saat ini selesai dievaluasi. Select tidak menyebabkan target OnSelect segera mengevaluasi, atau Select menunggu untuk OnSelect selesai dievaluasi.

Anda tidak dapat menggunakan Select di seluruh layar.

Anda dapat menggunakan Select hanya dengan kontrol yang memiliki properti OnSelect.

Anda hanya dapat menggunakan Select dalam rumus perilaku.

Kontrol tidak dapat memilih Select sendiri secara langsung atau tidak langsung melalui kontrol lainnya.

Fungsi Select juga dapat digunakan dengan galeri. Misalnya, fungsi tersebut dapat digunakan untuk menentukan baris atau kolom untuk dipilih dalam galeri dan kontrol untuk dipilih dalam baris atau kolom galeri. Bila Anda memilih baris atau kolom, perubahan pilihan galeri dan rumus OnSelect pada kontrol galeri dievaluasi. Jika kontrol dalam baris atau kolom disediakan, rumus OnSelect untuk kontrol turunan akan dievaluasi.

Sintaks

Select( Control )

• Control – Wajib. Kontrol akan dipilih atas nama pengguna.

Select( Control, Row or column, Child Control )

• Control – Wajib. Kontrol akan dipilih atas nama pengguna.
• Row atau column – Tidak diperlukan. Jumlah baris atau kolom (dimulai dengan 1) di kontrol galeri untuk memilih atas nama pengguna.
• Child Control - Tidak diperlukan. Kontrol turunan pada kontrol yang diidentifikasi dalam parameter 'kontrol' untuk dipilih.

Contoh

• Button

  Select(button1)

• Galeri

  Select(Gallery1, 1)

  Mensimulasikan pengguna memilih baris 1 atau kolom 1 di Gallery1.

• Galeri

  Select(Gallery1, 1, ChildControl1)

  Mensimulasikan pengguna memilih ChildConttrol1 dalam baris 1 atau kolom 1 pada Gallery1.

Penggunaan dasar

1. Tambahkan kontrol Tombol, dan namai kembali Button1 jika memiliki nama yang berbeda.

2. Atur properti OnSelect pada Button1 ke rumus ini:

   Notify( "Hello World" )

3. Di layar yang sama, tambahkan kontrol Tombol kedua dan atur properti OnSelect ke rumus ini:

   Select( Button1 )

4. Sambil menekan terus tombol Alt, pilih tombol kedua.

   Pemberitahuan muncul di bagian atas aplikasi Anda. Properti OnSelect pada Button1 menghasilkan pemberitahuan ini:

   

Kontrol Galeri

1. Tambahkan kontrol Galeri vertikal yang berisi kontrol lainnya.

   

2. Atur properti OnSelect dari galeri ke rumus ini:

   Notify( "Gallery Selected" )

3. Sambil menahan tombol Alt, klik atau ketuk latar belakang galeri atau kontrol di galeri.

   Semua tindakan akan menampilkan pemberitahuan Galeri Dipilih di bagian atas aplikasi.

   Gunakan properti OnSelect galeri untuk menentukan tindakan default yang akan dilakukan saat pengguna mengklik atau mengetuk item di galeri.

4. Atur properti OnSelect pada kontrol gambar ke rumus ini:

   Notify( "Image Selected", Success )

5. Sambil menahan tombol Alt, klik atau ketuk berbagai elemen galeri.

   Bila Anda mengklik atau mengetuk kontrol apa pun di galeri kecuali gambar, Galeri Dipilih ditampilkan seperti sebelumnya. Saat Anda mengklik atau mengetuk gambar, Gambar Dipilih akan ditampilkan.

   Gunakan kontrol individu dalam galeri untuk melakukan tindakan yang berbeda dari tindakan default galeri.

   

6. Di layar yang sama, tambahkan kontrol Tombol dan atur properti OnSelect ke rumus ini:

   Select( Gallery1,2,Image1 )

7. Sambil menekan terus tombol Alt, pilih tombol.

   Pemberitahuan Image Selected muncul di bagian atas aplikasi Anda. Klik tombol disimulasikan memilih gambar dalam baris 2 galeri.