Vybrat funkci

Platí pro: aplikace plátna modelem řízené aplikace

Tato funkce simuluje akci výběru ovládacího prvku, která vyhodnotí vzorec OnSelect.

Popis

Funkce Select napodobuje akci výběru ovládacího prvku, jako když uživatel klikne nebo klepne na ovládací prvek. Výsledkem je vyhodnocení vzorce OnSelect pro cílový ovládací prvek.

Funkci Select použijte k rozšíření akce výběru na nadřazený ovládací prvek. Tento typ rozšíření se používá jako výchozí chování třeba v galeriích. Ve výchozím nastavení je vlastnost OnSelect libovolného ovládacího prvku v ovládacím prvku Gallery nastavená na Select( Nadřízený ovládací prvek ). Tímto způsobem můžete nastavit hodnotu vlastnosti OnSelect samotného ovládacího prvku galerie. Vzorec se vyhodnotí bez ohledu na to, kde uživatel v galerii klikne nebo klepne.

Pokud chcete, aby jeden nebo více ovládacích prvků galerie z ní prováděly různé akce, nastavte vlastnost OnSelect u těchto ovládacích prvků na jinou než výchozí hodnotu. Pokud chcete, aby ovládací prvky prováděly stejnou akci jako samotná galerie, nechte u většiny ovládacích prvků galerie výchozí hodnoty vlastností OnSelect.

Funkce Select zařadí cíl vlastnosti OnSelect do fronty k pozdějšímu zpracování po vyhodnocení aktuálního vzorce. Funkce Select okamžitě nevyhodnotí cílovou vlastnost OnSelect ani Select nečeká na vyhodnocení OnSelect.

Funkci Select nemůžete použít pro různé obrazovky.

Funkci Select můžete použít jenom u ovládacích prvků, které mají vlastnost OnSelect.

Funkci Select můžete použít jenom ve vzorcích chování.

Ovládací prvek nemůže sám sebe vybrat funkcí Select, ať už přímo nebo nepřímo prostřednictvím jiných ovládacích prvků.

Funkci Select lze také použít s galerií. Dá se například použít k určení řádku nebo sloupce, který se má v galerii vybrat, a ovládacího prvku, který se má vybrat v tomto řádku nebo sloupci galerie. Když vyberete nějaký řádek nebo sloupec, výběr galerie se změní a vyhodnotí se vzorec OnSelect u ovládacího prvku galerie. Pokud je zadán ovládací prvek v tomto řádku nebo sloupci, vyhodnotí se vzorec OnSelect pro podřízený ovládací prvek.

Syntaxe

Select( Ovládací prvek )

• Ovládací prvek – povinný argument. Ovládací prvek, který se vybere jménem uživatele.

Select( ovládací prvek, řádek nebo sloupec, podřízený ovládací prvek )

• Ovládací prvek – povinný argument. Ovládací prvek, který se vybere jménem uživatele.
• Řádek nebo sloupec – nepovinné. Číslo řádku nebo sloupce (počínaje hodnotou 1) v ovládacím prvku galerie, který se má vybrat jménem uživatele.
• Podřízený ovládací prvek – nepovinné. Podřízený ovládací prvek ovládacího prvku určeného v parametru „ovládací prvek“, který se má vybrat.

Příklady

• Tlačítko

  Select(button1)

• Galerie

  Select(Gallery1, 1)

  Simuluje uživatele, který vybírá řádek 1 nebo sloupec 1 v galerii Gallery1.

• Galerie

  Select(Gallery1, 1, ChildControl1)

  Simuluje uživatele, který vybírá podřízený ovládací prvek ChildControl1 v řádku 1 nebo sloupci 1 v galerii Gallery1.

Základní použití

1. Přidejte ovládací prvek Button a přejmenujte ho na Button1, pokud se jmenuje jinak.

2. Vlastnost OnSelect ovládacího prvku Button1 nastavte na tento vzorec:

   Notify( "Hello World" )

3. Na stejnou obrazovku přidejte druhý ovládací prvek Button a do jeho vlastnosti OnSelect nastavte tento vzorec:

   Select( Button1 )

4. Podržte stisknutou klávesu Alt a vyberte druhé tlačítko.

   Nahoře v aplikaci se zobrazí oznámení. Oznámení vygenerovala vlastnost OnSelect ovládacího prvku Button1.

   

Ovládací prvek Gallery

1. Přidejte ovládací prvek svislé Gallery, který obsahuje další ovládací prvky.

   

2. Do vlastnosti OnSelect galerie nastavte tento vzorec:

   Notify( "Je vybraná galerie" )

3. Přidržte klávesu Alt a klikněte nebo klepněte na pozadí galerie nebo na jiný ovládací prvek galerie.

   Při všech akcích se nahoře v aplikaci zobrazí oznámení Je vybraná galerie.

   Vlastnost OnSelect galerie slouží k zadání výchozí akce, která se provede, když uživatel klikne nebo klepne na některou položku galerie.

4. Do vlastnosti OnSelect ovládacího prvku obrázku nastavte tento vzorec:

   Notify( "Je vybraný obrázek", Success )

5. Přidržte klávesu Alt a klikněte nebo klepněte na různé prvky galerie.

   Když kliknete nebo klepnete na jiný ovládací prvek galerie, než je obrázek, zobrazí se původní oznámení Je vybraná galerie. Když kliknete nebo klepnete na obrázek, zobrazí se Je vybraný obrázek.

   Pokud chcete provést jiné než výchozí akce galerie, použijte jednotlivé ovládací prvky galerie.

   

6. Na stejnou obrazovku přidejte ovládací prvek Button a do jeho vlastnosti OnSelect nastavte tento vzorec:

   Select( Gallery1,2,Image1 )

7. Zatímco držíte klávesu Alt, vyberte tlačítko.

   Nahoře v aplikaci se zobrazí oznámení, že byl vybrán obrázek. Simulované kliknutí na tlačítko, kterým se vybere obrázek v řádku 2 galerie