Funkcia Select

Platí pre: aplikácie Canvas

Simuluje vybratú akciu ovládacieho prvku, čím sa vyhodnotí vzorec OnSelect.

Popis

Funkcia Select simuluje akciu výberu ovládacieho prvku, akoby používateľ klikol alebo ťukol na ovládací prvok. V dôsledku toho sa vzorec OnSelect v cieľovom ovládacom prvku vyhodnotí.

Používa Select sa na šírenie vybratej akcie do nadradeného ovládacieho prvku. Tento typ šírenia je predvoleným správaním napríklad v galériách. Predvolene je vlastnosť OnSelect ľubeného ovládacieho prvku v ovládacom prvku Galérianastavená naSelect hodnotu ( Parent ). Takýmto spôsobom môžete nastaviť hodnotu vlastnostiOnSelect samotného ovládacieho prvku galérie a tento vzorec bude vyhodnotený bez ohľadu na to, kde v galérii používateľ môže klikať alebo ťukať.

Ak chcete, aby jeden alebo viacero prvkov v galérii vykonávalo rôzne akcie zo samotnej galérie, nastavte vlastnosť OnSelect týchto prvkov na inú ako predvolenú hodnotu. Vlastnosť OnSelect väčšiny ovládacích prvkov galérie môžete nechať na predvolenej hodnote, ak chcete, aby vykonávali tú istú akciu ako samotná galéria.

Select zaradí cieľovú vlastnosť OnSelect do frontu na neskoršie spracovanie, ktoré sa môže vyskytnúť po dokončení vyhodnocovania aktuálneho vzorca. Select Nespôsobuje okamžité vyhodnotenie cieľovej vlastnosti OnSelect , ani nečaká Select na dokončenie vyhodnocovania vlastnosti OnSelect .

Nemôžete použiť Select na viacerých obrazovkách.

Môžete používať Select iba s ovládacími prvkami, ktoré majú vlastnosť OnSelect .

Môžete ich použiť Select iba vo vzorcoch správania.

Ovládací prvok sa nemôže Select priamo ani nepriamo použiť v iných ovládacích prvkoch.

Funkciu Select možno použiť aj s galériou. Môžete ju použiť napríklad na zadanie riadka alebo stĺpca, ktorý sa má označiť v galérii, a ako ovládací prvok, ktorý sa má označiť v danom riadku alebo stĺpci galérie. Po výbere riadka alebo stĺpca sa zmení výber galérie a vyhodnotí sa vzorec OnSelect v ovládacom prvku galérie. Ak je v rámci riadka alebo stĺpca uvedený ovládací prvok, vyhodnotí sa vzorec OnSelect pre podriadený ovládací prvok.

Syntax

Select( Ovládací prvok )

• Ovládanie – povinné. Výber ovládacieho prvku v mene používateľa.

Select( Ovládací prvok, Riadok alebo Stĺpec, Podriadený ovládací prvok )

• Ovládanie – povinné. Výber ovládacieho prvku v mene používateľa.
• Riadok alebo stĺpec – Nevyžaduje sa. Číslo riadka alebo stĺpca (od 1) v ovládacom prvku galérie, ktorý sa má označiť v mene používateľa.
• Child Control - Nevyžaduje sa. Podriadený ovládací prvok identifikovaného ovládacieho prvku v parametri „ovládacieho prvku”, ktorý sa má vybrať.

Príklady

• Tlačidlo

  Select(button1)

• Galéria

  Select(Gallery1, 1)

  Simuluje používateľa, ktorý vyberie riadok 1 alebo stĺpec 1 v galérii Gallery1.

• Galéria

  Select(Gallery1, 1, ChildControl1)

  Simuluje používateľa, ktorý vyberie podriadený ovládací prvok ChildConttrol1 v riadku 1 alebo stĺpci 1 v galérii Gallery1.

Základné použitie

1. Pridajte ovládací prvok Tlačidlo a premenujte ho na Button1, ak má iný názov.

2. Nastavte vlastnosť OnSelect ovládacieho prvku Button1 na tento vzorec:

   Upozorniť ("Ahoj svet")

3. Na tej istej obrazovke pridajte druhý ovládací prvok Tlačidlo a nastavte jeho vlastnosť OnSelect na tento vzorec:

   Select( Tlačidlo1 )

4. Podržte kláves Alt a stlačte druhé tlačidlo.

   V hornej časti aplikácie sa zobrazí oznámenie. Toto oznámenie vygenerovala vlastnosť OnSelect prvku Button1.

   

Ovládací prvok Galéria

1. Pridanie zvislého ovládacieho prvku Galéria, ktorý obsahuje iné ovládacie prvky.

   

2. Vlastnosť OnSelect galérie nastavte na tento vzorec:

   Upozorniť ("Galéria vybratá")

3. Podržte kláves Alt a kliknite alebo ťuknite na pozadie galérie alebo na ľubovoľný ovládací prvok galérie.

   Všetky akcie zobrazia oznámenie Galéria vybratá v hornej časti aplikácie.

   Pomocou vlastnosti galérie OnSelect určite predvolenú akciu, ktorá sa vykoná, keď používateľ klikne alebo ťukne na položku v galérii.

4. Nastavte vlastnosť OnSelect ovládacieho prvku obrázka podľa tohto vzorca:

   Notify( "Obrázok vybratý", NotificationType.Success )

5. Podržte kláves Alt a kliknite alebo ťuknite na rôzne prvky v galérii.

   Keď kliknete alebo ťuknete na ľubovoľný ovládací prvok v galérii s výnimkou obrázka, zobrazí sa oznámenie Galéria vybratá, ako predtým. Keď kliknite alebo ťuknete na obrázok, zobrazí sa oznámenie Obrázok vybratý.

   Na vykonávanie akcií iných ako predvolená akcia galérie použite ovládacie prvky v galérii.

   

6. Na tej istej obrazovke pridajte ovládací prvok Tlačidlo a nastavte jeho vlastnosť OnSelect na tento vzorec:

   Select( Gallery1,2,Image1 )

7. Podržte kláves Alt a vyberte tlačidlo.

   V hornej časti aplikácie sa zobrazí oznámenie Obrázok vybratý. Kliknite na tlačidlo simulovalo výber obrázka v riadku 2 galérie.