Share via

Potvrdiť funkciu

  • Článok

Vzťahuje sa na: modelom riadené aplikácie

Zobrazenie potvrdzovacieho dialógového okna používateľovi.

Description

Poznámka

V súčasnosti je funkcia Confirm dostupná len pri písaní Power Fx príkazov pre modelom riadené aplikácie.

Funkcia Confirm zobrazí dialógové okno v hornej časti aktuálnej obrazovky. K dispozícii sú dve tlačidlá: tlačidlo potvrdenia a tlačidlo Zrušiť, ktoré sú predvolene nastavené na lokalizované verzie "OK" a "Zrušiť ". Používateľ musí potvrdiť alebo zrušiť predtým, ako sa dialógové okno zruší a funkcia sa vráti. Okrem tlačidla dialógového okna je možné zrušiť aj klávesom Esc alebo inými gestami, ktoré sú špecifické pre platformu.

Parameter Správa sa zobrazí v tele dialógového okna. Ak je správa dlhá, môže byť skrátená alebo môže byť k dispozícii posúvač.

Pomocou parametra OptionsRecord zadajte voľby dialógového okna. Nie všetky možnosti sú k dispozícii na každej platforme a sú riešené na základe najlepšieho úsilia. Tieto možnosti nie sú podporované v aplikáciách plátna.

Pole možnosti Description
Tlačidlo PotvrdenieTlačidlo Text, ktorý sa zobrazí na tlačidle potvrdenia , ktorý nahradí predvolený, lokalizovaný text "OK".
ZrušiťTlačidlo Text, ktorý sa má zobraziť na tlačidle zrušiť , nahrádza predvolený, lokalizovaný text "Zrušiť".
Názov Text, ktorý sa má zobraziť ako názov dialógového okna. Na zobrazenie tohto textu možno použiť väčšie, hrubšie písmo ako písmo správy. Text sa skráti, ak je dlhý.
Podtitul Text, ktorý sa má zobraziť ako podnadpis dialógového okna. Na zobrazenie tohto textu možno použiť väčšie, hrubšie písmo ako písmo správy. Text sa skráti, ak je dlhý.

Funkcia Confirm vráti hodnotu true , ak bolo tlačidlo potvrdenia vybraté,inak false .

Pomocou funkcie Upozorniť zobrazte banner správy v hornej časti aplikácie, ktorý nie je potrebné zrušiť.

Syntax

Confirm( Správa [, OptionsRecord ] )

  • Správa – povinné. Správa, ktorá sa zobrazí používateľovi.
  • OptionsRecord - Voliteľné. Zadajte nastavenia možností dialógového okna. Nie všetky možnosti sú k dispozícii na každej platforme a sú riešené na základe „najlepšieho úsilia“.

Príklady

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

Jednoduché dialógové okno s potvrdením, ktoré žiada používateľa o potvrdenie odstránenia záznamu pred jeho odstránením. Pokiaľ používateľ nestlačí tlačidlo "OK", záznam sa neodstráni.

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

Rovnaké dialógové okno ako v poslednom príklade, ale pridá text názvu.

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

Požiada používateľa o jeho obľúbenú farbu a výsledok zachytí do globálnej premennej. Výsledok, ktorý bude umiestnený vo FavColor , bude textový reťazec "Červená" alebo "Zelená". Ako potvrdená voľba je predvolená hodnota "Červená". Toto funguje iba na platformách, ktoré podporujú možnosti ConfirmButton a CancelButton .

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

Zobrazí správu podobne ako funkcia Upozorniť , ale je modálna a vyžaduje, aby používateľ vybral tlačidlo na pokračovanie. Túto možnosť používajte, keď je dôležité, aby používateľ správu pred pokračovaním potvrdil. V tejto situácii nie je dôležité, ktoré tlačidlo bolo vybraté a výsledok nie je skontrolovaný.