Del via

Confirm-funksjonen

  • Artikkel

Gjelder for: Modelldrevne apper

Viser en bekreftelsesdialogboks til brukeren.

Description

Merk

Confirm-funksjonen er for øyeblikket bare tilgjengelig når du skriver Power Fx-kommandoer for modelldrevne apper.

Confirm-funksjonen viser en dialogboks over gjeldende skjerm. Det finnes to knapper: en bekreftelsesknapp og en avbruddsknapp, som henholdsvis vises som lokaliserte versjoner av «OK» og «Avbryt» som standard. Brukeren må bekrefte eller avbryte før dialogboksen lukkes og funksjonen returneres. Avbryt kan også velges med ESC-tasten eller andre bevegelser som er plattformspesifikke, i tillegg til å velges i dialogboksen.

Parameteren Message vises i brødteksten i dialogboksen. Hvis meldingen er svært lang, kan den bli avkortet, eller det kan vises et rullefelt.

Bruk parameteren OptionsRecord til å angi alternativer for dialogboksen. Ikke alle alternativer er tilgjengelige på alle plattformer og håndteres basert på beste forsøk. Disse alternativene støttes ikke i lerretsapper.

Alternativfelt Bekrivelse
Bekreft-knapp Teksten som skal vises på bekreftelsesknappen, og som erstatter den lokaliserte standardteksten «OK».
Avbryt-knapp Teksten som skal vises på avbruddsknappen, og som erstatter den lokaliserte standardteksten «Avbryt».
Tittel Teksten som skal vises som tittelen for dialogboksen. En større, fetere skrift enn meldingsskriften kan brukes til å vise denne teksten. Teksten blir avkortet hvis den er lang.
Undertittel Teksten som skal vises som undertittelen for dialogboksen. En større, fetere skrift enn meldingsskriften kan brukes til å vise denne teksten. Teksten blir avkortet hvis den er lang.

Bekreft returnerer sann hvis bekreftelsesknappen ble valgt, usann ellers.

Bruk Notify-funksjonen til å vise et meldingsbanner som ikke trenger å avvises, øverst i appen.

Syntaks

Bekreft( Melding [, OptionsRecord ] )

  • Melding - Obligatorisk. Meldingen som skal vises til brukeren.
  • OptionsRecord - Valgfritt. Bruk alternativinnstillinger for dialogboksen. Ikke alle alternativer er tilgjengelige på alle plattformer og håndteres basert på «beste forsøk».

Eksempler

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

En enkel bekreftelsesdialogboks der brukeren blir bedt om å bekrefte sletting av en oppføring før den fjernes. Oppføringen slettes bare hvis brukeren klikker på OK-knappen.

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

Samme dialogboks som i forrige eksempel, men med titteltekst tilføyd.

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

Spør brukere om favorittfargen deres og registrerer resultatet i en global variabel. Resultatet som legges i FavColor, blir tekststrengen «Rødt» eller «Grønt». Som bekreftelsesvalg er «Rødt» standardvalget. Dette fungerer bare på plattformer som støtter alternativene ConfirmButton og CancelButton.

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

Viser en melding på lignende måte som Notify-funksjonen, men er modal og krever at brukeren velger en knapp for å fortsette. Bruk når det er viktig at brukeren erkjenner meldingen før vedkommende går videre. I slike situasjoner er det ikke viktig å velge hvilken knapp som ble valgt, og resultatet blir ikke kontrollert.