Funkce Choices
Platí pro:
aplikace plátna modelem řízené aplikace
Vrátí tabulku možných hodnot pro vyhledávací sloupec.
Description
Funkce Choices vrátí tabulku možných hodnot pro vyhledávací sloupec.
Funkci Choices můžete použít k poskytnutí seznamu voleb, ze kterých si může uživatel vybírat. Tato funkce se často používá společně s ovládacím prvkem Combo box ve formulářích pro úpravy.
Pro účely vyhledávání odpovídá tabulka, kterou vrací funkce Choices, cizí tabulce, která je hledání přidružená. Když použijete funkci Choices, eliminujete potřebu přidávat cizí tabulku jako další zdroj dat. Funkce Choices vrací všechny sloupce cizí tabulky.
Vzhledem k tomu, že funkce Choices vrací tabulku, můžete použít funkce Filter, Sort, AddColumns a všechny ostatní funkce pro práci s tabulkou určené k filtrování, řazení a tvarování tabulky.
V tuto chvíli nemůžete funkci Choicesdelegovat. Pokud toto omezení představuje ve vaší aplikaci problém, přidejte cizí tabulku, jako je zdroj dat, a použijte ji přímo.
Funkce Choices nevyžaduje, aby názvy sloupců byly řetězce uzavřené ve dvojitých uvozovkách, na rozdíl od funkcí ShowColumns, Search a dalších funkcí tabulek. Zadejte vzorec, jako kdybyste odkazovali přímo na sloupec.
Odkazy na sloupce musí být nasměrovány přímo na zdroj dat. Pokud je třeba zdroj dat Accounts a vyhledávání SLA, odkaz na sloupec by byl Accounts.SLA. Odkaz nejde předat prostřednictvím funkce, proměnné nebo ovládacího prvku. Pokračujme v tomto příkladu. Pokud zdroj dat Accounts zásobuje ovládací prvek Gallery, použijte vzorec Gallery.Selected.SLA k odkazování na SLA vybraného účtu. Tento odkaz ale byl předán prostřednictvím ovládacího prvku, a proto nemůže být předán funkci Columns. Musíte použít Accounts.SLA.
V současnosti můžete použít vyhledávací sloupce pouze s SharePoint a Microsoft Dataverse.
Syntaxe
Choices( odkaz na sloupec [, filtr textu ] )
- odkaz na sloupec – povinné. Vyhledávací sloupec zdroje dat. Název sloupce neuzavírejte do dvojitých uvozovek. Odkaz musí směřovat přímo na sloupec zdroje dat a nesmí se předávat přes funkci nebo ovládací prvek.
- filtr textu – volitelně. Filtruje seznam voleb tak, že vrací pouze volby, které začínají textem zadaným v parametru filtr textu. Pokud je zadán prázdný řetězec, budou vráceny všechny volby.
Příklady
Funkce Choices pro vyhledávání
Vytvořte databázi v Dataverse a vyberte políčko Zahrňte ukázkové aplikace a data.
Vytvoří se mnoho tabulek, jako například Accounts.
Poznámka: Názvy tabulek jsou v make.powerapps.com v jednotném čísle a v Power Apps Studio v množném čísle.
Tabulka Accounts má sloupec Primary Contact, který slouží k vyhledávání v tabulce Contacts.
Pro každý účet existuje kontakt určený jako primární kontakt, nebo je primární kontakt prázdný.
Generování aplikace z tabulky Accounts.
V seznamu obrazovek a ovládacích prvků u levého okraje přejděte dolů, dokud se nezobrazí položka EditScreen1 a pod ní pak vyberte EditForm1.
Na kartě Vlastnosti v pravém podokně vyberte Upravit pole.
V podokně Pole vyberte + Přidat pole.
Vyhledejte pole Primary Contact, zaškrtněte jeho políčko a poté vyberte Přidat.
Pole Primary Contact se zobrazí v dolní části formuláře. Pokud pole zobrazuje chybu, vyberte Zdroje dat na kartě Zobrazení vyberte tři tečky (...) pro zdroj dat Accounts a poté vyberte Aktualizovat.
(Volitelné) Přetáhněte pole Primary Contact ze spodní části do horní části seznamu polí.
Na kartě Primary Contact vyberte ovládací prvek Combo box.
Vlastnost Items tohoto ovládacího prvku je nastavena na vzorec, který identifikuje sloupec podle jeho zobrazovaného názvu jako v prvním příkladu, nebo jeho logického názvu jako v druhém příkladu:
Choices( Accounts.'Primary Contact' )
Choices( Accounts.primarycontactid )
Pro ilustraci si můžeme prohlédnout kompletní tabulku vrácenou funkcí Choices v ovládacím prvku Data table. Na kartě Domů vyberte Nová obrazovka a pak vyberte Prázdná.
Na kartě Vložení vyberte Data table.
Nastavte vlastnost Items ovládacího prvku Data table na tento vzorec:
Choices( Accounts.'Primary Contact' )
Uprostřed ovládacího prvku Data table vyberte odkaz, který začíná Vyberte pole... a poté zaškrtněte políčka u polí, která chcete zobrazit (například jméno a příjmení).
