Confirm funkcija

Attiecas uz: Audekla programmas Modeļa vadītas programmas

Izmantojiet šo funkciju, lai lietotājam parādītu apstiprinājuma dialoglodziņu.

Apraksts

Funkcija Confirm parāda dialoglodziņu pašreizējā ekrāna augšpusē ar divām pogām: apstiprināšanas pogu un atcelšanas pogu. Modeļa vadītās programmās šīs pogas pēc noklusējuma ir attiecīgi lokalizētas "OK" un "Cancel" versijas. Confirm ir pieejams arī audekla programmās, lai parādītu vienkāršu apstiprinājuma dialogu un atgrieztu Būla rezultātu.

Lietotājam ir jāizvēlas viena no pogām, pirms dialogs tiek aizvērts. Papildus pogas Atcelt atlasīšanai dialogu var aizvērt, izmantojot platformai specifiskus žestus (piemēram, taustiņu Esc vai noklikšķinot ārpus dialoga). Audekla programmās šis atlaišanas ceļš tiek uzskatīts par nevienu darbību (tas ir, tas atgriež blank).

Piezīmes

Audekla programmās Confirm funkcija izmanto dialoglodziņu Fluent. Pārliecinieties, vai ir iespējotas modernas vadīklas; Pretējā gadījumā tiek parādīts vietējās pārlūkprogrammas dialoglodziņš.

Sintakse

Confirm( Message [, OptionsRecord ] )
  • Ziņojums - Obligāts. Lietotājam rādāmais ziņojums.
  • OptionsRecord - neobligāti. Norādiet dialoglodziņam opciju iestatījumus. Pieejamās opcijas skatiet zemāk.

Opcijas

Izmantojiet parametru OptionsRecord , lai pielāgotu apstiprinājuma dialoglodziņu:

Iespēja Apraksts
ConfirmButton Teksts, kas jāparāda uz apstiprināšanas pogas, aizstājot noklusējuma lokalizēto "OK" vai "Confirm" tekstu.
CancelButton Teksts, kas jāparāda uz atcelšanas pogas, aizstājot noklusējuma lokalizēto tekstu "Atcelt".
Virsraksts Teksts, kas jāparāda kā dialoga nosaukums. Tiek parādīts lielākā, treknrakstākā fontā nekā ziņojums. Tas var būt saīsināts, ja tas ir ļoti garš.
Apakšvirsraksts Teksts, kas jāparāda kā dialoga apakšvirsraksts. Tiek parādīts starp virsrakstu un ziņojumu. Tas var būt saīsināts, ja tas ir ļoti garš.

Noklusētā uzvedība

Pogu etiķetes: Ja nenorādāt pielāgotas pogu etiķetes, Confirm tiek izmantots lokalizēts noklusējuma pogas teksts:

  • Audekla programmās (priekšskatījums) noklusējuma iestatījumi ir "Confirm" un "Atcelt" (lokalizēts).
  • Modeļa vadītās programmās noklusējuma iestatījumi ir "OK" un "Cancel" (lokalizēts).

Atgrieztā vērtība:Confirm Atgriežas true , ja lietotājs atlasa pogu Apstiprināt un false citādi.

Piemēri

Modeļa vadītas programmas

Vienkāršs apstiprinājums pirms ieraksta noņemšanas

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

Parāda apstiprinājuma dialogu ar noklusējuma pogām. Ja lietotājs atlasa apstiprināšanas pogu, ieraksts tiek noņemts.

Apstiprinājums ar pielāgotu nosaukumu

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

Pirms ieraksta noņemšanas apstiprinājuma dialoglodziņam pievieno virsrakstu.

Pielāgotas pogu etiķetes lietotāja vēlmēm

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

Izmanto pielāgotas pogu etiķetes, lai tvertu vienkāršu preferenci. Rezultāts tiek saglabāts globālajā mainīgajā .FavColor

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

Parāda modālu ziņojumu, kas lietotājam ir jāapstiprina pirms turpināšanas. Atgrieztā vērtība nav pārbaudīta.

Pamatnes programmas

Confirm pirms dzēšanas

Izmantojiet Confirm , lai novērstu nejaušu ierakstu dzēšanu:

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

Parāda apstiprinājuma dialoglodziņu ar virsraksta, subtitru un pielāgotu pogu etiķetēm. Ieraksts tiek dzēsts tikai tad, ja lietotājs atlasa Dzēst.

Confirm Pirms veidlapas saglabāšanas

Izmantojiet Confirm , lai pārbaudītu lietotāja nodomu pirms datu iesniegšanas:

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

Pirms veidlapas iesniegšanas tiek parādīts apstiprinājuma dialoglodziņš. Veidlapa tiek iesniegta tikai tad, ja lietotājs to apstiprina.

Saglabājiet rezultātu mainīgajā vairākām darbībām

Saglabājiet apstiprinājuma rezultātu, lai to izmantotu vairākās pakārtotajās operācijās:

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

Būla rezultāts tiek saglabāts varConfirmed un uz to var atsaukties vairākas reizes nosacījumloģikai.

Pilnīga pielāgošana ar visām iespējām

Parādiet visas pieejamās pielāgošanas iespējas:

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

Parāda pilnībā pielāgotu dialoglodziņu ar virsraksta, subtitru, ziņojumu un pielāgotu pogu etiķetēm.

Bieži uzdotie jautājumi

Vai es varu paslēpt pogu Atcelt?

Nē. Pašreizējā noformējumā vienmēr ir redzamas gan pogas, Confirm gan Atcelt. Lietotājiem ir jābūt iespējai aizvērt vai atcelt dialogu.

Vai varu pievienot trešo pogu vai vairāk nekā divas opcijas?

Nē. Confirm Atbalsta tieši divas iespējas: apstiprināšanas darbību un atcelšanas darbību. Scenārijiem, kuros nepieciešamas vairākas izvēles iespējas, apsveriet iespēju izmantot citu lietotāja interfeisa modeli, piemēram, pielāgotu ekrānu vai nolaižamo vadīklu.

Vai Confirm bloķē citas darbības?

Jā. Confirm Tiek parādīts kā modāls dialoglodziņš, kas lietotājam ir jānoraida, lai viņš varētu mijiedarboties ar citām programmas daļām.

Skatiet arī:

Paziņot — ekrāna augšdaļā tiek parādīts nemodāls reklāmkaroga ziņojums, kas neprasa lietotāja atlaišanu.

  • Last updated on