Confirm funktsioon

Kehtib järgmise jaoks: mudelipõhised rakendused

Kasutajale kinnituse dialoogiboksi kuvamine.

Kirjeldus

Märkus.

Praegu Confirm on funktsioon saadaval ainult mudelipõhiste rakenduste Power Fx käskude kirjutamisel.

Funktsioon Confirm kuvab praeguse kuva ülaosas dialoogiboksi. Pakutakse kahte nuppu: kinnitamisnupp ja tühistamisnupp , mis vaikimisi kasutavad vastavalt "OK" ja "Cancel" lokaliseeritud versioone. Kasutaja peab enne dialoogiboksi hülgamist ja funktsiooni tagasipöördumist kinnitama või tühistama. Lisaks dialooginupule saab tühistamise valida ka paoklahviga või muude platvormispetsiifiliste žestidega.

Parameeter Sõnum kuvatakse dialoogiboksi kehas. Kui sõnum on pikk, võib seda kärpida või lisada kerimisriba.

Parameetri OptionsRecord abil saate määrata dialoogiboksi suvandid. Kõik suvandid pole igal platvormil saadavad ja neid käsitletakse "parima pingutuse" alusel. Neid suvandeid ei toetata lõuendirakendustes.

Suvand väli	Kirjeldus
ConfirmButton	Kinnitamisnupul kuvatav tekst, mis asendab vaikimisi lokaliseeritud "OK" teksti.
TühistaButton	Tühistamisnupul kuvatav tekst, mis asendab vaikimisi lokaliseeritud "Tühista" teksti.
Pealkiri	Dialoogiboksi pealkirjana kuvatav tekst. Selle teksti kuvamiseks võib kasutada suuremat või paksu fonti. Tekst kärbitakse, kui see on pikk.
Alapealkiri	Dialoogiboksi alapealkirjana kuvatav tekst. Selle teksti kuvamiseks võib kasutada suuremat või paksu fonti. Tekst kärbitakse, kui see on pikk.

Confirm tagastab väärtuse true , kui kinnitusnupp on valitud, muul juhul väär .

Kasutage funktsiooni Teavita, et kuvada rakenduse ülaosas sõnumiriba, millest pole vaja loobuda.

Süntaks

Confirm( Sõnum [, Suvandid_kirje ] )

• Sõnum - nõutav. Sõnum kasutajale kuvamiseks.
• OptionsRecord - valikuline. Pakkuge dialoogiboksi suvandisätteid. Kõik suvandid pole igal platvormil saadaval ja neid käsitletakse "parima pingutuse" alusel.

Näited

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

Lihtne kinnitusdialoog, milles palutakse kasutajal kinnitada kirje kustutamine enne selle eemaldamist. Kui kasutaja ei vajuta nuppu "OK", siis kirjet ei kustutata.

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

Sama dialoog nagu eelmises näites, kuid lisab pealkirja teksti.

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

Küsib kasutajalt oma lemmik värvi, mis hõivab tulemuse globaalseks muutujaks. FavColori paigutatud tulem on tekstistring "Punane" või "Roheline". Kinnitava valikuna on vaikimisi "Punane". See töötab ainult platvormidel, mis toetavad valikuid ConfirmButton ja CancelButton .

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

Kuvab teate sarnaselt funktsiooniga Teavita, kuid on modaalne ja nõuab, et kasutaja valiks jätkamiseks nupu. Kasutage siis, kui on oluline, et kasutaja enne jätkamist sõnumi ära tunneks. Sellises olukorras pole oluline, milline nupp valiti, ja tulemust ei kontrollita.