Del via

Funktionen Confirm

  • Artikel

Gælder for: Modelbaserede apps

Vis en bekræftelsesdialogboks for brugeren.

Description

Bemærk

På nuværende tidspunkt er funktionen Bekræft kun tilgængelig, når du skriver Power Fx-kommandoer til modelbaserede apps.

Funktionen Bekræft viser en dialogboks oven på det aktuelle skærmbillede. Der findes to knapper: en bekræft-knap og en annullér-knap, der som standard bruger oversatte versioner af henholdsvis "OK" og "Annuller". Brugeren skal bekræfte eller annullere, før dialogboksen afvises, og funktionen vises igen. Ud over dialogknappen kan annullér-knappen også vælges med Esc-tasten eller andre funktioner, der er platformspecifikke.

Parameteren Meddelelse vises i dialogboksens brødtekst. Hvis meddelelsen er lang, vil den enten blive afkortet, eller der vises et rullepanel.

Brug parameteren OptionsRecord til at angive indstillinger for dialogboksen. Ikke alle indstillinger er tilgængelige på alle platforme og håndteres bedst muligt. Disse indstillinger understøttes ikke i lærredsapps.

Felt med indstillinger Beskrivelse
Bekræft knap Den tekst, der skal vises på bekræftelsesknappen. Den erstatter den oversatte standardtekst "OK".
Annuller knap Den tekst, der skal vises på annulleringsknappen. Den erstatter den oversatte standardtekst "Annuller".
Titel Den tekst, der skal vises som titlen på dialogboksen. Der bruges muligvis en større skrift og federe skrift end meddelelsesskrifttypen til at få vist denne tekst. Hvis teksten er lang, afkortes den.
Undertekst Den tekst, der skal vises som undertitlen på dialogboksen. Der bruges muligvis en større skrift og federe skrift end meddelelsesskrifttypen til at få vist denne tekst. Hvis teksten er lang, afkortes den.

Bekræft returnerer sand, hvis bekræftelsesknappen blev valgt, falsk ellers.

Brug funktionen Notify til at få vist et banner øverst i appen, der ikke behøver at blive lukket.

Syntaks

Bekræft( Meddelelse [, OptionsRecord ] )

  • Besked - Påkrævet. Meddelelse, der skal vises til brugeren.
  • OptionsRecord - Valgfrit. Angiv mulige indstillinger for dialogboksen. Ikke alle indstillinger er tilgængelige på alle platforme og håndteres "bedst muligt".

Eksempler

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

En simpel bekræftelsesdialogboks, hvor brugeren bliver bedt om at bekræfte sletning af en post, før den fjernes. Medmindre brugeren trykker på "OK"-knappen, slettes posten ikke.

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

Samme dialogboks som det sidste eksempel, men der tilføjes en Titeltekst.

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

Beder brugeren om at angive den foretrukne farve og henter resultatet til en global variabel. Det resultat, der anbringes i FavColor, er tekststrengen "Rød" eller "Grøn". Som bekræft-valg er "Rød" standardindstillingen. Det fungerer kun på platforme, der understøtter indstillingerne ConfirmButton og CancelButton.

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

Viser en meddelelse på samme måde, som funktionen Notify gør, men er modal og kræver, at brugeren vælger en knap for at fortsætte. Bruges i situationer, hvor det er vigtigt, at brugeren accepterer meddelelsen, inden brugeren fortsætter. I denne situation er den knap, der blev valgt, ikke vigtig, og resultatet kontrolleres ikke.