Functie Confirm

Van toepassing op: Modelgestuurde apps

Geef een bevestigingsvenster weer voor de gebruiker.

Omschrijving

Notitie

Op dit moment is de functie Confirm alleen beschikbaar bij het schrijven van Power Fx-opdrachten voor modelgestuurde apps.

Met de functie Confirm wordt een dialoogvenster boven aan het huidige scherm weergegeven. Er zijn twee knoppen: een knop confirm en een knop cancel, die standaard respectievelijk gelokaliseerde versies van OK en Annuleren zijn. De gebruiker moet bevestigen of annuleren voordat het dialoogvenster wordt gesloten en de functie terugkeert. Naast de dialoogknop kan cancel ook worden geselecteerd met de toets Esc of andere gebaren die platformspecifiek zijn.

De parameter Message wordt weergegeven in de hoofdtekst van het dialoogvenster. Als het bericht lang is, kan het worden ingekort of wordt er een schuifbalk weergegeven.

Gebruik de parameter OptionsRecord om opties voor het dialoogvenster op te geven. Niet alle opties zijn beschikbaar op elk platform en worden afgehandeld op basis van "best effort". Deze opties worden niet ondersteund in canvas-apps.

Optieveld	Omschrijving
ConfirmButton	De tekst die moet worden weergegeven op de bevestigen knop, ter vervanging van de standaard, gelokaliseerde "OK" tekst.
CancelButton	De tekst die moet worden weergegeven op de Annuleren-knop, ter vervanging van de standaard, gelokaliseerde "Annuleren" tekst.
Titel	De tekst die wordt weergegeven als de titel van het dialoogvenster. Een groter, vetter lettertype dan het berichtlettertype kan worden gebruikt om deze tekst weer te geven. De tekst wordt afgekapt als deze te lang is.
Subtitle	De tekst die wordt weergegeven als de subtitel van het dialoogvenster. Een groter, vetter lettertype dan het berichtlettertype kan worden gebruikt om deze tekst weer te geven. De tekst wordt afgekapt als deze te lang is.

Confirm retourneert true als de knop confirm is geselecteerd, anders false.

Gebruik de functie Notify om een banner boven aan de app weer te geven die niet hoeft te worden afgesloten.

Syntaxis

Confirm( Message [, OptionsRecord ] )

• Message - vereist. Het bericht dat wordt weergegeven aan de gebruiker.
• OptionsRecord - optioneel. Geef optie-instellingen voor het dialoogvenster op. Niet alle opties zijn beschikbaar op elk platform en worden afgehandeld op basis van "best effort".

Voorbeelden

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

Eenvoudig bevestigingsvenster waarin de gebruiker wordt gevraagd het verwijderen van een record te bevestigen voordat deze wordt verwijderd. Tenzij de gebruiker OK selecteert, wordt de record niet verwijderd.

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

Hetzelfde dialoogvenster als het laatste voorbeeld, maar hierin is titeltekst toegevoegd.

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

Vraagt de gebruiker naar zijn favoriete kleur en legt het resultaat vast in een globale variabele. Het resultaat dat wordt geplaatst in FavColor is de teksttekenreeks Rood of Groen. Als keuze voor confirm is Rood de standaardinstelling. Dit werkt alleen op platforms die ondersteuning bieden voor de opties ConfirmButton en CancelButton.

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

Hiermee wordt een bericht weergegeven net als de functie Notify, maar deze is modaal en vereist dat de gebruiker een knop selecteert om door te gaan. Gebruik dit in situaties waarin het belangrijk is dat de gebruiker het bericht bevestigt voordat hij verder gaat. In deze situatie is het niet belangrijk welke knop is geselecteerd en wordt het resultaat niet gecontroleerd.