Sdílet prostřednictvím

Funkce Confirm

  • Článek

Platí pro: Modelem řízené aplikace

Zobrazí se potvrzovací dialogové okno pro uživatele.

Description

Poznámka:

V současné době je funkce Confirm dostupná pouze při psaní příkazů Power Fx pro modelem řízené aplikace.

Funkce Confirm zobrazí v horní části aktuální obrazovky dialogové okno. K dispozici jsou dvě tlačítka: tlačítko pro potvrzení a tlačítko pro zrušení, které se v lokalizované verzi zobrazí jako „OK“ a „Zrušit“. Uživatel jej musí potvrdit nebo zrušit, než se dialogové okno zavře a funkce vrátí hodnotu. Kromě tlačítka dialogového okna lze tlačítko zrušit vybrat také klávesou Esc nebo jinými gesty, která jsou specifická pro platformu.

Parametr Message se zobrazí v těle dialogového okna. Pokud je zpráva velmi dlouhá, může být zkrácena nebo se zobrazí posuvník.

Pomocí parametru OptionsRecord zadáte možnosti pro dialogové okno. Ne všechny možnosti jsou k dispozici na každé platformě a jsou zpracovány na základě nejlepšího úsilí. Tyto možnosti nejsou podporovány v aplikacích plátna.

Pole možnosti Description
ConfirmButton Text, který se má zobrazit na tlačítku pro potvrzení nahrazující výchozí lokalizovaný text „OK“.
Tlačítko Storno Text, který se má zobrazit na tlačítku pro zrušení nahrazující výchozí lokalizovaný text „Zrušit“.
Titul Text, který se zobrazuje jako název dialogového okna. K zobrazení tohoto textu lze použít větší, tlustší písmo než písmo zprávy. Pokud je text velmi dlouhý, bude zkrácen.
Titulky Text, který se zobrazuje jako titulek dialogového okna. K zobrazení tohoto textu lze použít větší, tlustší písmo než písmo zprávy. Pokud je text velmi dlouhý, bude zkrácen.

Potvrdit vrátí pravdu pokud bylo vybráno tlačítko potvrdit , nepravda jinak.

Pomocí funkce Notify zobrazíte v horní části aplikace banner se zprávou, který není třeba zavřít.

Syntaxe

Potvrdit( Zpráva [, OptionsRecord ] )

  • Zpráva – Povinné. Zpráva, která se zobrazí uživateli.
  • OptionsRecord – Volitelné. Obsahuje rozšířené možnosti pro dialogové okno. Ne všechny možnosti jsou k dispozici na každé platformě a jsou zpracovány na základě „nejlepšího úsilí“.

Příklady

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Jednoduché potvrzovací dialogové okno, které uživatele žádá o potvrzení odstranění záznamu před jeho odebráním. Dokud uživatel nestiskne tlačítko „OK“, záznam nebude odstraněn.

If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )

Stejné dialogové okno jako v posledním příkladu, ale přidává text nadpisu.

Set( FavColor, 
     If( Confirm( "What is your favorite color?", 
                  { ConfirmButton: "Red", CancelButton: "Green" } 
         ), 
         "Red", 
         "Green" 
     ) 
)

Požádá uživatele o jeho oblíbenou barvu a výsledek zachytí do globální proměnné. Výsledek, který bude umístěn do FavColor, bude textový řetězec „Red“ (červená) nebo „Green“ (zelená). Výchozí volba pro potvrzení je „Red“. Toto funguje pouze na platformách, které podporují možnosti ConfirmButton a CancelButton.

Confirm( "There was a problem, please review your order." )

Zobrazí zprávu podobně jako funkce Notify, ale je modální a vyžaduje, aby uživatel pro pokračování vybral tlačítko. Používejte v situacích, kdy je důležité, aby uživatel zprávu potvrdil, než bude pokračovat. V této situaci není důležité, které tlačítko bylo vybráno, a výsledek se nekontroluje.