Valitse toiminto

Soveltuu: Pohjaan perustuvat sovellukset Mallipohjaiset sovellukset

Simuloi valintatoiminnon käyttämistä ohjausobjektiin, aiheuttaen OnSelect-kaavan laskennan.

Kuvaus

Select-funktio simuloi ohjausobjektin valittua toimintoa aivan kuin käyttäjä olisi klikannut tai napauttanut ohjausobjektia. Tämän vuoksi kohdeohjausobjektin OnSelect-kaava lasketaan.

Käytä Select-funktiota levittääksesi valittu toiminto pääohjausobjektiin. Tämän tyyppinen välitys on oletusarvon mukaista esimerkiksi valikoimissa. Oletuksena kaikkien Gallery -ohjausobjektien OnSelect-ominaisuus arvoksi on määritetty Select( Parent ). Näin voit määrittää valikoima-ohjausobjektin OnSelect-ominaisuuden arvon itse, ja kyseinen kaava lasketaan riippumatta siitä, missä kohtaa valikoimaa käyttäjä on klikannut tai napauttanut.

Jos haluat yhden tai useamman valikoima-ohjausobjektin suorittavan eri toimintoja itse valikoimasta, aseta niiden OnSelect -ominaisuuden arvoksi muu kuin oletusarvo. Voit jättää useimpien valikoima-ohjausobjektien OnSelect-ominaisuuden arvoksi oletusarvon, jos haluat niiden suorittavan saman toiminnon kuin itse valikoima.

Select laittaa OnSelect-kohteen jonoon myöhempää käsittelyä varten, joka voi tapahtua sen jälkeen, kun nykyisen kaavan laskeminen on lopetettu. Select ei aiheuta OnSelect-kohteen välitöntä laskemista, eikä Select myöskään odota, että OnSelect lopettaa laskemisen.

Et voi käyttää Select-funktiota kaikissa näytöissä.

Voit käyttää Select-funktiota vain ohjausobjekteissa, joissa on OnSelect-ominaisuus.

Voit käyttää Select-funktiota vain toimintakaavoissa.

Ohjausobjekti ei voi Valita itseään suoraan tai epäsuorasti muiden ohjausobjektien kautta.

Select-funktiota voidaan käyttää myös valikoiman kanssa. Sen avulla voidaan esimerkiksi määrittää valikoimasta valittava rivi tai sarake sekä ohjausobjekti, joka valitaan valikoiman kyseiseltä riviltä tai kyseisestä sarakkeesta. Kun valitset rivin tai sarakkeen, valikoiman valinta muuttuu ja valikoiman ohjausobjektissa oleva OnSelect-kaava lasketaan. Jos rivillä tai sarakkeessa on ohjausobjekti, aliohjausobjektin OnSelect-kaava lasketaan.

Syntaksi

Select( Control )

• Control – pakollinen. Ohjausobjektin valinta käyttäjän puolesta.

Select( Control, Row or column, Child Control )

• Control – pakollinen. Ohjausobjektin valinta käyttäjän puolesta.
• Row or column – ei pakollinen. Valikoiman ohjausobjektissa oleva rivin tai sarakkeen numero (alkaen numerosta 1), joka valitaan käyttäjän puolesta.
• Child Control – ei pakollinen. ”Ohjausobjekti”-parametrilla määritetyn ohjausobjektin valittava aliohjausobjekti.

Esimerkit

• Button

  Select(button1)

• Galleria

  Select(Gallery1, 1)

  Simuloi käyttäjää, joka valitsee valikoimassa Gallery1 olevan rivin 1 tai sarakkeen 1.

• Galleria

  Select(Gallery1, 1, ChildControl1)

  Simuloi käyttäjää, joka valitsee valikoimassa Gallery1 rivillä 1 tai sarakkeessa 1 olevan aliohjausobjektin ChildConttrol1.

Peruskäyttö

1. Lisää Button -ohjausobjekti ja nimeä se nimellä Button1, jos sillä on eri nimi.

2. Määritä Button1-painikkeen OnSelect-ominaisuudeksi tämä kaava:

   Notify( "Hello World" )

3. Lisää samassa ruudussa toinen Button-ohjausobjekti ja määritä sen OnSelect-ominaisuudeksi tämä kaava:

   Select( Button1 )

4. Pidät Alt-näppäintä pohjassa ja valitse toinen painike.

   Sovelluksesi yläreunaan tulee ilmoitus. Button1-painikkeen OnSelect-ominaisuus loi tämän ilmoituksen.

   

Gallery-ohjausobjekti

1. Lisää pystysuora Gallery-ohjausobjekti, joka sisältää muita ohjausobjekteja.

   

2. Määritä valikoiman OnSelect-ominaisuudeksi tämä kaava:

   Notify( "Gallery Selected" )

3. Pidä Alt-näppäintä pohjassa, napsauta tai napauta valikoiman taustaa tai mitä tahansa valikoima-ohjausobjektia.

   Kaikki toiminnot näyttävät Valikoima valittu -ilmoituksen sovelluksen yläreunassa.

   Käytä valikoiman OnSelect-ominaisuutta määrittääksesi oletusarvoisen toiminnon, joka suoritetaan, kun käyttäjä napsauttaa tai napauttaa kohdetta valikoimassa.

4. Määritä kuvanhallinnan OnSelect-ominaisuudeksi tämä kaava:

   Notify( "Image Selected", Success )

5. Pidä Alt-näppäintä pohjassa, napsauta tai napauta valikoiman eri elementtejä.

   Kun napsautat tai napautat mitä tahansa valikoiman ohjausobjektia, paitsi kuvaa, Valikoima valittu -ilmoitus tulee näkyviin. Kun napsautat tai napautat kuvaa, Kuva valittu -ilmoitus tulee näkyviin.

   Käytä valikoiman yksittäisiä ohjausobjekteja suorittaaksesi toimintoja, jotka eroavat valikoiman oletustoiminnosta.

   

6. Lisää samassa näytössä Button-ohjausobjekti ja määritä sen OnSelect-ominaisuudeksi tämä kaava:

   Select( Gallery1,2,Image1 )

7. Pidä Alt-näppäintä painettuna ja valitse painike.

   Sovelluksesi yläreunassa näkyy ilmoitus Kuva valittu. Painikkeen napsauttaminen simuloi valikoiman rivillä 2 olevan kuvan valitsemista.