Confirm funktsioon

Kehtib järgmise kohta: Lõuendirakendused Mudelipõhised rakendused

Selle funktsiooni abil saate kasutajale kuvada kinnituse dialoogiboksi.

Kirjeldus

Funktsioon Confirm kuvab praeguse kuva ülaservas dialoogiboksi kahe nupuga: kinnitamisnupp ja loobumisnupp. Mudelipõhistes rakendustes on need nupud vaikimisi lokaliseeritud versioonidele vastavalt "OK" ja "Cancel". Confirm on saadaval ka lõuendirakendustes lihtsa kinnitusdialoogi kuvamiseks ja loogikatulemi tagastamiseks.

Enne dialoogi sulgemist peab kasutaja valima ühe nuppudest. Lisaks nupu Loobu valimisele saab dialoogi sulgeda platvormikohaste žestide kaudu (nt paoklahv Esc või väljaspool dialoogi klõpsamine). Lõuendirakendustes käsitletakse seda suletavat teed toiminguta (st see tagastab).blank

Märkus.

Lõuendirakendustes Confirm kasutab funktsioon dialoogi Fluent. Veenduge, et tänapäevased juhtelemendid oleks lubatud; vastasel korral kuvatakse brauseri omadialoog.

Süntaks

Confirm( Message [, OptionsRecord ] )
  • Sõnum - nõutav. Sõnum kasutajale kuvamiseks.
  • OptionsRecord - valikuline. Pakkuge dialoogiboksi suvandisätteid. Saadaolevad suvandid leiate altpoolt.

Suvandid

Kinnitusdialoogi kohandamiseks kasutage parameetrit Suvandid_kirje .

Suvand Kirjeldus
ConfirmButton Kinnitamisnupul kuvatav tekst, mis asendab lokaliseeritud vaiketeksti "OK" või "Confirm".
TühistaButton Tühistamisnupul kuvatav tekst asendab vaikimisi lokaliseeritud teksti "Loobu".
Tiitel Dialoogiboksi tiitlina kuvatav tekst. Kuvatakse sõnumist suuremas paksus kirjas. See võib olla kärbitud, kui see on väga pikk.
Alapealkiri Dialoogi alapealkirjana kuvatav tekst. Kuvatakse pealkirja ja sõnumi vahel. See võib olla kärbitud, kui see on väga pikk.

Vaikekäitumine

Nupusildid: Kui te ei sisesta kohandatud nupusilte, Confirm kasutatakse lokaliseeritud vaikenuputeksti.

  • Lõuendirakendustes (eelversioon) on vaikeväärtused "Confirm" ja "Loobu" (lokaliseeritud).
  • Mudelipõhistes rakendustes on vaikeväärtused "OK" ja "Loobu" (lokaliseeritud).

Tagastusväärtus:Confirm tagastab, true kui kasutaja valib kinnitamisnupu ja false muul juhul.

Näited

Mudelipõhised rakendused

Lihtne kinnitus enne kirje eemaldamist

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

Kuvab kinnitusdialoogi vaikenuppudega. Kui kasutaja valib kinnitamisnupu, eemaldatakse kirje.

Kohandatud pealkirjaga kinnitus

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

Lisab kinnitusdialoogi tiitli enne kirje eemaldamist.

Kasutajaeelistuste kohandatud nupusildid

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

Kasutab lihtsa eelistuse jäädvustamiseks kohandatud nupusilte. Tulem talletatakse globaalses muutujas FavColor.

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

Kuvab modaalsõnumi, mille kasutaja peab enne jätkamist kinnitama. Tagastusväärtust pole märgitud.

Lõuendirakendused

Confirm enne kustutamist

Kasutage Confirm seda kirjete juhusliku kustutamise vältimiseks.

// 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)
)

Kuvab tiitli-, alapealkirja- ja kohandatud nupusiltide kinnitusdialoogi. Kirje kustutatakse ainult juhul, kui kasutaja valib käsu Kustuta.

Confirm enne vormi salvestamist

Sobib Confirm kasutaja kavatsuste valideerimiseks enne andmete edastamist:

// 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)
)

Kuvab enne vormi edastamist kinnitusdialoogi. Vorm esitatakse ainult juhul, kui kasutaja seda kinnitab.

Store result in a variable for multiple actions

Salvestage kinnitustulem kasutamiseks mitmes järgmises toimingus:

// 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)
)

Kahendmuutuja tulem salvestatakse varConfirmed ja sellele saab tingimusloogika korral mitu korda viidata.

Täielik kohandamine kõigi suvandite abil

Tutvusta kõiki saadaolevaid kohandamissuvandeid:

// 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)
)

Kuvab täielikult kohandatud dialoogi pealkirja, alapealkirja, sõnumi ja kohandatud nupusiltide abil.

KKK

Kas nuppu Loobu saab peita?

Ei. Praeguses kujunduses kuvatakse alati nii nupud kui ka Confirm Loobu. Kasutajad peavad saama dialoogi sulgeda või tühistada.

Kas saan lisada kolmanda nupu või rohkem kui kaks suvandit?

Ei. Confirm toetab täpselt kahte võimalust: toimingu kinnitamine ja tühistamine. Mitut valikut nõudvate stsenaariumide puhul kaaluge mõne muu kasutajaliidese mustri (nt kohandatud kuva või ripploendi juhtelemendi) kasutamist.

Kas Confirm blokeerite muid toiminguid?

Jah. Confirm kuvab modaaldialoogi, mille kasutaja peab enne rakenduse teiste osadega suhtlemist sulgema.

Vt ka

Teavita – ekraani ülaosas kuvatakse mittemodaalse ribateate, mis ei nõua kasutaja sulgemist.

  • Last updated on