Confirm funkcija

Taikoma: Drobės programėlės Modeliu pagrįstos programėlės

Naudokite šią funkciją, kad vartotojui būtų rodomas patvirtinimo dialogo langas.

Aprašą

Funkcija Confirm dabartinio ekrano viršuje rodo dialogo langą su dviem mygtukais: patvirtinimo mygtuku ir atšaukimo mygtuku. Modeliu pagrįstose programėlėse šie mygtukai pagal numatytuosius parametrus yra lokalizuotos atitinkamai "Gerai" ir "Atšaukti". Confirm taip pat galima drobės programose, skirtose rodyti paprastą patvirtinimo dialogo langą ir grąžinti Bulio logikos rezultatą.

Prieš atmesdami dialogo langą, vartotojas turi pasirinkti vieną iš mygtukų. Be mygtuko Atšaukti pasirinkimo, dialogo langą galima išjungti naudojant konkrečios platformos gestus (pvz., klavišą "Esc" arba spustelėjimus už dialogo lango ribų). Drobės programėlėse šis atmetimo kelias laikomas jokiu veiksmu (t. y. jis grąžina blank).

Pastaba.

Drobės programėlėse Confirm funkcija naudoja dialogo langą Sklandus. Įsitikinkite, kad įjungti modernūs valdikliai; kitu atveju rodomas vietinės naršyklės dialogo langas.

Sintaksė

Confirm( Message [, OptionsRecord ] )
  • Žinutė - būtina. Rodytinas pranešimas vartotojui.
  • OptionsRecord - Pasirinktinai. Pateikite dialogo lango parinkčių parametrus. Toliau rasite galimas parinktis.

Parinktys

Norėdami tinkinti patvirtinimo dialogo langą, naudokite parametrą Parinktysįrašas :

Parinktis Aprašą
Mygtukas Patvirtinti Tekstas, rodomas patvirtinimo mygtuke, pakeičiantis numatytąjį lokalizuotą "Gerai" arba "Confirm" tekstą.
Mygtukas "Atšaukti" Tekstas, rodomas atšaukimo mygtuke, pakeičiantis numatytąjį lokalizuotą tekstą "Atšaukti".
Pareigos Tekstas, rodomas kaip dialogo lango pavadinimas. Rodomas didesniu, paryškintesniu šriftu nei pranešimas. Jis gali būti sutrumpintas, jei labai ilgas.
Paantraštė Tekstas, rodomas kaip dialogo lango paantraštė. Rodomas tarp pavadinimo ir pranešimo. Jis gali būti sutrumpintas, jei labai ilgas.

Numatytasis veikimo būdas

Mygtukų žymos: Jei nepateikiate pasirinktinių mygtukų etikečių, Confirm naudoja lokalizuotą numatytąjį mygtuko tekstą:

  • Drobės programose (peržiūros versijoje) numatytosios reikšmės yra "Confirm" ir "Atšaukti" (lokalizuotos).
  • Modeliu pagrįstose programėlėse numatytosios reikšmės yra "Gerai" ir "Atšaukti" (lokalizuotos).

Grąžinama reikšmė:Confirm grąžina true , jei vartotojas pasirenka patvirtinimo mygtuką, ir false kitu atveju.

Pavyzdžiai

Modeliu pagrįstos programos

Paprastas patvirtinimas prieš pašalinant įrašą

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

Rodo patvirtinimo dialogo langą su numatytaisiais mygtukais. Jei vartotojas pasirenka patvirtinimo mygtuką, įrašas pašalinamas.

Patvirtinimas su pasirinktiniu pavadinimu

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

Prieš pašalinant įrašą, įtraukiamas pavadinimas į patvirtinimo dialogo langą.

Vartotojo nuostatų pasirinktinių mygtukų žymos

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

Naudoja pasirinktines mygtukų žymas, kad užfiksuotų paprastą nuostatą. Rezultatas saugomas visuotiniame kintamajame FavColor.

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

Rodo modalinį pranešimą, kurį vartotojas turi patvirtinti prieš tęsdamas. Grąžinama reikšmė nepažymėta.

Drobės programos

Confirm prieš naikindami

Naudokite Confirm norėdami išvengti atsitiktinio įrašų panaikinimo:

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

Rodo patvirtinimo dialogo langą su pavadinimo, paantraštės ir pasirinktinių mygtukų žymomis. Įrašas panaikinamas tik tada, jei vartotojas pasirenka Naikinti.

Confirm prieš įrašant formą

Naudokite Confirm vartotojo ketinimams patikrinti prieš pateikdami duomenis:

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

Rodo patvirtinimo dialogo langą prieš pateikiant formą. Forma pateikiama tik tada, jei vartotojas patvirtina.

Saugoti kelių veiksmų rezultatą kintamuoju

Išsaugokite patvirtinimo rezultatą, kurį naudosite keliose tolesnėse operacijose:

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

Bulio logikos rezultatas saugomas varConfirmed ir gali būti keletą kartų nurodytas sąlyginei logikai.

Visiškas tinkinimas naudojant visas parinktis

Rodyti visas galimas tinkinimo parinktis:

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

Rodo visiškai tinkintą dialogo langą su pavadinimo, paantraštės, pranešimo ir pasirinktinių mygtukų žymomis.

DUK apie „“

Ar galiu paslėpti mygtuką Atšaukti?

Nr. Dabartiniame dizaine visada rodomi ir mygtukai Atšaukti, Confirm ir Atšaukti. Vartotojai turi turėti galimybę atmesti arba atšaukti dialogo langą.

Ar galiu įtraukti trečią mygtuką arba daugiau nei dvi parinktis?

Nr. Confirm palaiko lygiai dvi parinktis: patvirtinti veiksmą ir atšaukimo veiksmą. Scenarijams, kuriems reikia kelių pasirinkimų, apsvarstykite galimybę naudoti kitą vartotojo sąsajos modelį, pvz., pasirinktinį ekraną arba išplečiamąjį valdiklį.

Ar Confirm blokuoja kitas operacijas?

Taip. Confirm rodomas kaip modalusis dialogo langas, kurį vartotojas turi išjungti, kad galėtų sąveikauti su kitomis programos dalimis.

Taip pat žiūrėkite

Pranešti – ekrano viršuje rodomas ne modalusis reklaminės juostos pranešimas, kurio vartotojui nereikia išjungti.

  • Last updated on