Pilih fungsi

Digunakan pada: Aplikasi kanvas Apl berpandukan model

Merangsang tindakan pilih pada kawalan, mengakibatkan formula OnSelect dinilai.

Penerangan

Fungsi Select merangsang tindakan pilih pada kawalan seolah-olah pengguna telah mengklik atau mengetik kawalan. Hasilnya, formula OnSelect pada kawalan sasaran dinilai.

Gunakan Pilih untuk merambat tindakan pilih ke kawalan induk. Jenis perambatan ini adalah dalam tingkah laku lalai, contohnya galeri . Secara lalai, sifat OnSelect pada mana-mana kawalan dalam kawalan Galeri ditetapkan ke Pilih( Induk ). Dengan cara itu, anda boleh menetapkan nilai sifat OnSelect kawalan galeri itu sendiri, dan formula itu akan dinilai tanpa mengira di mana pengguna galeri klik atau ketik.

Jika anda mahu satu atau lebih kawalan dalam galeri untuk melaksanakan tindakan yang berbeza daripada galeri itu sendiri, tetapkan sifat OnSelect ke sesuatu berbanding nilai lalai ke kawalan itu. Anda boleh meninggalkan nilai lalai untuk sifat OnSelect bagi kebanyakan kawalan dalam galeri jika anda mahu ianya melakukan tindakan yang sama seperti galeri itu sendiri.

Pilih membariskan sasaran OnSelect untuk diproses kemudian, yang mungkin akan berlaku selepas formula semasa selesai dinilai. Pilih tidak mengakibatkan sasaran OnSelect untuk dinilai dengan segera, juga Pilih tidak menunggu OnSelect untuk selesai dinilai.

Anda tidak boleh menggunakan Pilih merentasi skrin.

Anda boleh menggunakan Pilih hanya dengan kawalan yang mempunyai sifat OnSelect.

Anda boleh menggunakan Pilih hanya dalam formulas tingkah laku.

Kawalan tidak boleh Pilih diri sendiri secara langsung atau tidak langsung melalui kawalan lain.

Fungsi pilih juga boleh digunakan dengan galeri. Contohnya, ia boleh digunakan bagi menentukan baris atau lajur untuk dipilih dalam galeri dan kawalan untuk dipilih dalam baris atau lajur galeri. Apabila anda memilih baris atau lajur, pemilihan galeri berubah dan formula OnSelect pada kawalan galeri dinilai. Jika kawalan dalam baris atau lajur disediakan, formula OnSelect untuk kawalan anak akan dinilai.

Sintaks

Pilih( Kawalan )

• Kawalan – Diperlukan. Kawalan untuk memilih bagi pihak pengguna.

Pilih( Kawalan, Baris atau lajur, Kawalan Anak )

• Kawalan – Diperlukan. Kawalan untuk memilih bagi pihak pengguna.
• Baris atau lajur – Tidak diperlukan. Bilangan baris atau lajur (bermula dengan 1) dalam kawalan galeri untuk memilih bagi pihak pengguna.
• Kawalan Anak - Tidak diperlukan. Kawalan anak bagi kawalan yang dikenal pasti dalam parameter 'kawalan' untuk dipilih.

Contoh

• Butang

  Select(button1)

• Galeri

  Select(Gallery1, 1)

  Mensimulasikan pengguna memilih baris 1 atau lajur 1 dalam Gallery1.

• Galeri

  Select(Gallery1, 1, ChildControl1)

  Mensimulasikan pengguna memilih ChildConttrol1 dalam baris 1 atau lajur 1 Gallery1.

Penggunaan asas

1. Tambah kawalan Button, dan namakannya semula Button1 jika ia mempunyai nama yang berbeza.

2. Tetapkan sifat OnSelect untuk Button1 ke formula ini:

   Beritahu( "Helo Dunia" )

3. Pada skrin yang sama, tambah kawalan Butang kedua, dan tetapkan sifat OnSelect ke formula ini:

   Pilih( Button1 )

4. Semasa menekan kunci Alt, pilih butang kedua.

   Pemberitahuan dipaparkan merentasi di atas aplikasi anda. Sifat OnSelect untuk Button1 menjana pemberitahuan ini.

   

Kawalan galeri

1. Tambah kawalan Galeri menegak yang mengandungi kawalan lain.

   

2. Tetapkan sifat OnSelect untuk galeri ke formula ini:

   Beritahu( "Galeri Dipilih" )

3. Semasa menekan kunci Alt, klik atau ketik latar belakang galeri atau sebarang kawalan dalam galeri.

   Semua tindakan akan menunjukkan pemberitahuan Galeri Dipilih pada atas aplikasi.

   Gunakan sifat OnSelect galeri bagi menentukan tindakan lalai untuk diambil apabila pengguna klik atau ketik item dalam galeri.

4. Tetapkan kawalan imej sifat OnSelect ke formula ini:

   Beritahu( "Imej Dipilih", Berjaya )

5. Semasa menekan kunci Alt, klik atau ketik pelbagai elemen galeri.

   Apabila anda klik atau ketik mana-mana kawalan dalam galeri kecuali imej, Galeri Dipilih dipaparkan seperti sebelum ini. Apabila anda klik atau ketik imej, Imej Dipilih dipaparkan.

   Gunakan kawalan individu dalam galeri untuk mengambil tindakan yang berbeza daripada tindakan lalai galeri.

   

6. Pada skrin yang sama, tambah kawalan Butang, dan tetapkan sifat OnSelect ke formula ini:

   Pilih( Gallery1,2,Image1 )

7. Pilih butang semasa menekan kunci Alt.

   Pemberitahuan Imej Dipilih dipaparkan merentasi atas aplikasi anda. Klik butang mensimulasikan pemilihan imej dalam baris 2 untuk galeri.