Bekräfta funktion
Gäller för: Modellbaserade appar
Visa dialogruta för bekräftelse för användaren.
Description
Kommentar
För närvarande är funktionen Confirm endast tillgänglig när kommandon skrivs Power Fx för modellbaserade appar.
Funktionen Confirm visar en dialogruta överst på den aktuella skärmen. Det finns två knappar: en bekräfta-knapp och en avbryt-knapp som standard i lokaliserade versioner av OK och avbryt. Användaren måste bekräfta eller avbryta innan dialogfönstret ignoreras och funktionen returneras. Förutom dialogknappen kan du även välja Avbryt med Esc-tangenten eller andra alternativ som är plattformsspecifika.
Parametern Meddelande visas i dialogfönstrets brödtext. Om meddelandet är mycket långt trunkeras det antingen eller så blir det en rullningslist.
Ange parametern OptionsRecord för dialogfönstret med hjälp av parametern. Alla alternativ är inte tillgängliga på alla plattformar och hanteras på grundval av bästa möjliga insats. Dessa alternativ stöds inte i arbetsyteapp.
Fältalternativ | Description |
---|---|
BekräftaKnapp | Texten som ska visas på bekräfta-knappen och ersätter standardtexten med lokaliserad OK-text. |
Avbryta-knapp | Texten som ska visas på avbryt-knappen och ersätter standardtexten med lokaliserad avbryt-text. |
Titel | Den text som visas som dialogfönstrets rubrik. Ett större, fetare teckensnitt än meddelandeteckensnittet kan användas för att visa texten. Texten kommer att trunkeras om den är lång. |
Textremsa | Den text som visas som dialogfönstrets undertext. Ett större, fetare teckensnitt än meddelandeteckensnittet kan användas för att visa texten. Texten kommer att trunkeras om den är lång. |
Confirm returnerar true om bekräftelseknappen har valts, annars false .
Med funktionen Notify för att visa en meddelandebanner högst upp i appen som inte behöver avvisas.
Syntax
Bekräfta ( Meddelande [, AlternativSpela in ] )
- Meddelande – Obligatoriskt. Meddelande som ska visas för användaren.
- OptionsRecord - Valfritt. Ange alternativinställningar för dialogrutan. Alla alternativ är inte tillgängliga på alla plattformar och hanteras på grundval av bästa möjliga insats.
Exempel
If( Confirm( "Are you sure?" ), Remove( ThisItem ) )
Enkel bekräftelsedialogruta där användaren uppmanas bekräfta att en post tas bort innan den tas bort. Om inte användaren trycker på OK tas inte posten bort.
If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )
Samma dialogruta som i det sista exemplet, men rubriktexten läggs till.
Set( FavColor,
If( Confirm( "What is your favorite color?",
{ ConfirmButton: "Red", CancelButton: "Green" }
),
"Red",
"Green"
)
)
Ber användaren om sin favorit färg och samlar in resultatet i en global variabel. Resultatet placeras i FavColor textsträngen i Röd eller Grön. Som bekräftelse är "Röd" standardinställningen. Detta fungerar endast på plattformar som har stöd för alternativen ConfirmButton och CancelButton.
Confirm( "There was a problem, please review your order." )
Visar ett meddelande ungefär som funktionen Notify gör, men är modal och kräver att användaren väljer en knapp för att fortsätta. Använd där det är viktigt att användaren bekräftar meddelandet innan han eller hon fortsätter. I det här fallet är den knapp som valdes inte viktig och resultatet kontrolleras inte.