Potrditev funkcije

Velja za: Aplikacije, ki temeljijo na modelu

Uporabniku prikažite potrditveno pogovorno okno.

Description

opomba,

Trenutno je funkcija Confirm na voljo samo pri pisanju Power Fx ukazov za aplikacije, ki temeljijo na modelu.

Funkcija Confirm prikaže pogovorno okno na vrhu trenutnega zaslona. Na voljo sta dva gumba: gumb za potrditev in gumb za preklic , ki privzeto uporabljata lokalizirane različice »OK« oziroma "Prekliči". Uporabnik se mora odločiti za potrditev ali preklic, preden je pogovorno okno opuščeno, in funkcija se bo vrnila. Poleg gumba za pogovorno okno lahko prekliči izberete tudi s tipko Esc ali drugimi potezami, ki so specifične za platformo.

Parameter Message je prikazan v telesu pogovornega okna. Če je sporočilo dolgo, je lahko odrezano ali pa je na voljo drsni trak.

S parametrom OptionsRecord določite možnosti za pogovorno okno. Vsaka platforma ne ponuja vseh možnosti, te pa so na voljo v tolikšni meri, kot je le mogoče. Te možnosti niso podprte v aplikacijah platna.

Polje za možnosti	Description
ConfirmButton	Besedilo za prikaz na gumbu za potrditev , ki nadomesti privzeto, lokalizirano besedilo »OK«.
CancelButton	Besedilo za prikaz na gumbu prekliči , ki nadomesti privzeto, lokalizirano besedilo »Prekliči«.
Naslov	Besedilo, ki bo prikazano kot naslov pogovornega okna. Za prikaz tega besedila se lahko uporabi večja, krepkejša pisava kot v sporočilu. Če je besedilo dolgo, bo odrezano.
Podnaslov	Besedilo, ki bo prikazano kot podnaslov pogovornega okna. Za prikaz tega besedila se lahko uporabi večja, krepkejša pisava kot v sporočilu. Če je besedilo dolgo, bo odrezano.

Potrdi vrne true če je bil izbran gumb za potrditev false sicer.

Uporabite funkcijo Obvesti za prikaz pasice s sporočilom na vrhu aplikacije, ki je ni treba zapustiti.

Sintaksa

Potrdi( Sporočilo [, OptionsRecord ] )

• Sporočilo - Obvezno. Sporočilo za prikaz uporabniku.
• OptionsRecord - Izbirno. Podajte nastavitve možnosti za pogovorno okno. Vsaka platforma ne ponuja vseh možnosti, te pa so na voljo v tolikšni meri, kot je le mogoče.

Primeri

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

Enostavno potrditveno pogovorno okno, ki od uporabnika zahteva, da potrdi izbris zapisa, preden se ta odstrani. Zapis ne bo izbrisan, razen če uporabnik pritisne gumb "OK".

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

Enako pogovorno okno kot zadnji primer, vendar je dodano besedilo naslova.

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

Uporabnika sprašuje po njegovi najljubši barvi, rezultat pa zajame v globalno spremenljivko. Rezultat, ki bo postavljen v FavColor bo besedilni niz "Red" ali "Green". Kot potrdi izbiro je privzeta "rdeča". To deluje samo na platformah, ki podpirajo možnosti ConfirmButton in CancelButton .

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

Prikaže sporočilo podobno kot funkcija Obvesti , vendar je modalno in od uporabnika zahteva, da za nadaljevanje izbere gumb. Uporabite, ko je pomembno, da uporabnik potrdi sporočilo, preden nadaljuje. V tem primeru ni pomembno, kateri gumb je bil izbran, rezultat pa ni preverjen.