Confirm funkcija

Velja za: Aplikacije na platnu , ki jih poganja model

To funkcijo uporabite, če želite uporabniku prikazati potrditveno pogovorno okno.

Description

Funkcija Confirm prikaže pogovorno okno na vrhu trenutnega zaslona z dvema gumboma: gumb za potrditev in gumb za preklic. V aplikacijah, ki temeljijo na modelu, so ti gumbi privzeto lokalizirani različici »V redu« in »Prekliči«. Confirm je na voljo tudi v aplikacijah platna za prikaz preprostega pogovornega okna za potrditev in vračanje logičnih rezultatov.

Uporabnik mora izbrati enega od gumbov, preden je pogovorno okno opuščeno. Poleg tega, da izberete gumb Prekliči, lahko pogovorno okno opustite s potezami, specifičnimi za platformo (na primer s tipko Esc ali klikom zunaj pogovornega okna). V aplikacijah na platnu se ta pot zavrnitve obravnava kot nobeno dejanje (to pomeni, da vrne blank).

opomba,

V aplikacijah na platnu funkcija Confirm uporablja pogovorno okno Fluent. Prepričajte se , da so omogočeni sodobni kontrolniki; v nasprotnem primeru se prikaže izvorno pogovorno okno brskalnika.

Sintaksa

Confirm( Message [, OptionsRecord ] )
  • Sporočilo - Obvezno. Sporočilo za prikaz uporabniku.
  • OptionsRecord - Izbirno. Podajte nastavitve možnosti za pogovorno okno. Spodaj si oglejte razpoložljive možnosti.

Možnosti

S parametrom OptionsRecord prilagodite pogovorno okno za potrditev:

Možnost Description
ConfirmButton Besedilo, ki bo prikazano na gumbu za potrditev in bo zamenjalo privzeto lokalizirano besedilo »V redu« ali »Confirm«.
CancelButton Besedilo, ki bo prikazano na gumbu »Prekliči«, ki bo zamenjalo privzeto lokalizirano besedilo »Prekliči«.
Naslov Besedilo, ki bo prikazano kot naslov pogovornega okna. Prikazana je v večji, bolj spajkani pisavi kot sporočilo. Lahko se prireže, če zelo dolgo.
Podnaslov Besedilo, ki bo prikazano kot podnaslov pogovornega okna. Prikazano med naslovom in sporočilom. Lahko se prireže, če zelo dolgo.

Privzeto vedenje

Oznake gumbov: Če ne navedete oznak gumbov po meri, uporablja Confirm lokalizirano privzeto besedilo gumba:

  • V aplikacijah na platnu (predogled) sta privzeti vrednosti »Confirm« in » Prekliči« (lokalizirano).
  • V aplikacijah, ki temeljijo na modelu, sta privzeti vrednosti »V redu« in » Prekliči« (lokalizirano).

Vrnjena vrednost:Confirm vrne true , če uporabnik izbere gumb za potrditev, sicer false pa.

Primeri

Aplikacije, ki temeljijo na modelu

Preprosta potrditev pred odstranjevanjem zapisa

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

Prikaže potrditveno pogovorno okno s privzetimi gumbi. Če uporabnik izbere gumb za potrditev, je zapis odstranjen.

Potrditev z naslovom po meri

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

Preden odstranite zapis, doda naslov v potrditveno pogovorno okno.

Oznake gumbov po meri za uporabniške nastavitve

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

Uporabi oznake gumbov po meri za zajem preprostih nastavitev. Rezultat je shranjen v globalni spremenljivki FavColor.

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

Prikaže modalno sporočilo, ki ga mora uporabnik potrditi, preden nadaljuje. Vrnjena vrednost ni potrjena.

Aplikacije na osnovi delovnega območja

Confirm pred brisanjem

Uporablja Confirm se za preprečevanje nenamernega brisanja zapisov:

// Button.OnSelect
If(
    Confirm(
        "Are you sure you want to delete this record?",
        {
            Title: "Delete confirmation",
            Subtitle: "This action can't be undone.",
            ConfirmButton: "Delete",
            CancelButton: "Cancel"
        }
    ),
    Remove(YourDataSource, Gallery1.Selected);
    Notify("Record deleted.", NotificationType.Success)
)

Prikaže potrditveno pogovorno okno z naslovom, podnaslovom in oznakami gumbov po meri. Zapis je izbrisan le, če uporabnik izbere Izbriši.

Confirm preden shranite obrazec

Uporabite Confirm za preverjanje namena uporabnika pred pošiljanjem podatkov:

// Save button.OnSelect
If(
    Confirm(
        "Do you want to save these changes?",
        { Title: "Save changes" }
    ),
    SubmitForm(EditForm1);
    ResetForm(EditForm1);
    Notify("Changes saved successfully.", NotificationType.Success)
)

Prikaže potrditveno pogovorno okno pred pošiljanjem obrazca. Obrazec je poslan le, če uporabnik to potrdi.

Rezultat shranjevanja je spremenljivka za več dejanj

Shranite rezultat potrditve za uporabo v več postopkih na nižji stopnji:

// Button.OnSelect
Set(
    varConfirmed,
    Confirm("Do you want to proceed with this operation?")
);

If(
    varConfirmed,
    Notify("Processing your request...", NotificationType.Information);
    /* Additional operations */,
    Notify("Operation canceled.", NotificationType.Warning)
)

Logični rezultat je shranjen v in varConfirmed ga je mogoče večkrat sklicevati za pogojno logiko.

Popolno prilagajanje z vsemi možnostmi

Pokaži vse razpoložljive možnosti prilagajanja:

// Button.OnSelect
If(
    Confirm(
        "This is the main message that describes what the user needs to confirm.",
        {
            Title: "Action Required 🔔",
            Subtitle: "Please choose one of the options below.",
            ConfirmButton: "Yes, proceed",
            CancelButton: "No, cancel"
        }
    ),
    Notify("User confirmed!", NotificationType.Success),
    Notify("User canceled.", NotificationType.Warning)
)

Prikaže popolnoma prilagojeno pogovorno okno z naslovom, podnaslovom, sporočilom in oznakami gumbov po meri.

Pogosta vprašanja

Ali lahko skrijem gumb »Prekliči«?

Ne. V trenutnem načrtu sta vedno prikazana gumba Confirm in Gumba Prekliči. Uporabniki morajo imeti možnost, da opuščajo ali prekličejo pogovorno okno.

Ali lahko dodam tretji gumb ali več kot dve možnosti?

Ne. Confirm podpira natanko dve možnosti: dejanje za potrditev in dejanje preklica. Za scenarije, ki zahtevajo več izbir, razmislite o uporabi drugačnega vzorca uporabniškega vmesnika, kot je zaslon po meri ali kontrolnik spustnega seznama.

Ali Confirm blokira druge operacije?

Da. Confirm prikaže kot modalno pogovorno okno, ki ga mora uporabnik opustiti, preden lahko komunicira z drugimi deli aplikacije.

Glejte tudi

Obvesti – na vrhu zaslona prikaže nemodalno sporočilo pasice, ki ne zahteva zavrnitve uporabnika.

  • Last updated on