Izberite funkcijo

Velja za: Aplikacije Canvas Aplikacije, ki temeljijo na modelu

Simulira dejanje izbiranja v kontrolniku, ki povzroči vrednotenje formule OnSelect.

Opis

Funkcija Select simulira dejanje izbiranja v kontrolniku, kot da bi uporabnik kliknil ali tapnil kontrolnik. Posledično se ovrednoti formula OnSelect v ciljnem kontrolniku.

Uporabite funkcijo Select, da razširite dejanje izbiranja v nadrejeni kontrolnik. Ta vrsta razširjanja je privzeto delovanje na primer v galerijah. Lastnost OnSelect kateregakoli kontrolnika v kontrolniku Gallery je privzeto nastavljena na Select( Parent). Tako lahko nastavite vrednost OnSelect kontrolnika galerije in ta formula bo ovrednotena ne glede na to, kje v galeriji uporabnik klikne ali tapne.

Če želite, da eden ali več kontrolnikov v galeriji izvaja drugačna dejanja od same galerije, nastavite lastnost OnSelect za te kontrolnike na nekaj drugega kot privzeto vrednost. Privzete vrednosti za lastnosti OnSelect večine kontrolnikov v galeriji lahko pustite, če želite, da izvedejo isto dejanje kot sama galerija.

Funkcija Select premakne ciljno formulo OnSelect v čakalno vrsto za poznejšo obdelavo, ki se lahko zgodi po končanem vrednotenju trenutne formule. Funkcija Select ne povzroči takojšnjega vrednotenja ciljne formule OnSelect, prav tako pa funkcija Select ne čaka, da je vrednotenje formule OnSelect dokončano.

Funkcije Select ne morete uporabljati na več zaslonih.

Funkcijo Select lahko uporabljate samo s kontrolniki, ki imajo lastnost OnSelect.

Funkcijo Select lahko uporabljate samo v formulah za delovanje.

Kontrolnik ne more uporabiti funkcije Select zase neposredno ali posredno prek drugih kontrolnikov.

Funkcijo za izbiranje lahko uporabite tudi z galerijo. Uporabite jo lahko na primer za določanje vrstice ali stolpca, ki bosta izbrana v galeriji, in kontrolnika, ki bo izbran v tej vrstici ali stolpcu galerije. Ko izberete vrstico ali stolpec, se izbira galerije spremeni in formula OnSelect v kontrolniku galerije se ovrednoti. Če je naveden kontrolnik v vrstici ali stolpcu, je formula OnSelect za podrejeni kontrolnik ovrednotena.

Sintaksa

Select( Control )

• Control – obvezno. Kontrolnik za izbiro v imenu uporabnika.

Select( Control, Row or column, Child Control )

• Control – obvezno. Kontrolnik za izbiro v imenu uporabnika.
• Row or column – ni obvezno. Številka vrstice ali stolpca (začenši z 1) v kontrolniku galerije, ki bosta izbrana v imenu uporabnika.
• Child Control – ni obvezno. Podrejeni kontrolnik kontrolnika, določenega v parametru »control«, ki bo izbran

Primeri

• Gumb

  Select(button1)

• Galerija

  Select(Gallery1, 1)

  Simulira uporabnika, ki v Gallery1 izbere vrstico 1 ali stolpec 1.

• Galerija

  Select(Gallery1, 1, ChildControl1)

  Simulira uporabnika, ki v vrstici 1 ali stolpcu 1 kontrolnika Gallery1 izbere ChildControl1.

Osnovna uporaba

1. Dodajte kontrolnik Button in ga preimenujte v Button1, če ima drugo ime.

2. Lastnost OnSelect gumba Button1 nastavite na to formulo:

   Notify( "Hello World" )

3. Na istem zaslonu dodajte še en kontrolnik Button in nastavite njegovo lastnost OnSelect na to formulo:

   Select( Button1 )

4. Medtem ko držite tipko Alt, izberite drugi gumb.

   Na vrhu aplikacije se prikaže obvestilo. To obvestilo je ustvarila lastnost OnSelect gumba Button1:

   

Kontrolnik galerije

1. Dodajte navpični kontrolnik Gallery, ki vsebuje druge kontrolnike.

   

2. Nastavite lastnost OnSelect galerije na to formulo:

   Notify( "Gallery Selected" )

3. Medtem ko držite tipko Alt, kliknite ali tapnite ozadje galerije ali kateregakoli kontrolnika v galeriji.

   Vsa dejanja bodo prikazala obvestilo Galerija je izbrana na vrhu aplikacije.

   Uporabite lastnost OnSelect galerije, da določite privzeto dejanje, ko uporabnik klikne ali tapne element v galeriji.

4. Nastavite lastnost OnSelect kontrolnika slike na to formulo:

   Notify( "Image Selected", Success )

5. Medtem ko držite tipko Alt, kliknite ali tapnite različne elemente galerije.

   Ko kliknete ali tapnete katerikoli kontrolnik v galeriji, razen slike, se prikaže obvestilo Galerija je izbrana kot prej. Ko kliknete ali tapnete sliko, se prikaže obvestilo Slika je izbrana.

   Uporabite posamezne kontrolnike v galeriji, da izvedete dejanja, ki se razlikujejo od privzetega dejanja galerije.

   

6. Na istem zaslonu dodajte kontrolnik Button in nastavite njegovo lastnost OnSelect na to formulo:

   Select( Gallery1,2,Image1 )

7. Medtem ko držite tipko Alt, izberite gumb.

   Na vrhu aplikacije se prikaže obvestilo Slika je izbrana. Klik gumba je simuliral izbiro slike v 2. vrstici galerije.