Confirm Funkce

Platí pro: Modelem řízené aplikace plátna

Pomocí této funkce zobrazíte uživateli potvrzovací dialogové okno.

Description

Funkce Confirm zobrazí v horní části aktuální obrazovky dialogové okno se dvěma tlačítky: potvrzením a tlačítkem zrušit . V modelem řízených aplikacích jsou tato tlačítka výchozí pro lokalizované verze OK a Zrušit. Confirm je také k dispozici v aplikacích plátna pro zobrazení jednoduchého potvrzovacího dialogového okna a vrácení logického výsledku.

Uživatel musí před zavřeným dialogem zvolit jedno z tlačítek. Kromě výběru tlačítka Storno je možné dialogové okno zavřít pomocí gest specifických pro platformu (například klávesou Esc nebo kliknutím mimo dialogové okno). V aplikacích plátna se tato cesta pro zavření považuje za žádnou akci (to znamená, že se vrátí blank).

Poznámka:

V aplikacích plátna používá Confirm funkce dialogové okno Fluent. Ujistěte se, že jsou povolené moderní ovládací prvky; v opačném případě se zobrazí dialogové okno nativního prohlížeče.

Syntaxe

Confirm( Message [, OptionsRecord ] )
  • Zpráva – Povinné. Zpráva, která se zobrazí uživateli.
  • OptionsRecord – Volitelné. Obsahuje rozšířené možnosti pro dialogové okno. Dostupné možnosti najdete níže.

Možnosti

K přizpůsobení potvrzovací dialogového okna použijte parametr OptionsRecord :

Možnost Description
ConfirmButton Text, který se má zobrazit na tlačítku potvrzení, nahradí výchozí lokalizovaný text "OK" nebo "Confirm".
Tlačítko Storno Text, který se má zobrazit na tlačítku zrušit, nahradí výchozí lokalizovaný text Zrušit.
Titulek Text, který se má zobrazit jako název dialogového okna. Zobrazuje se ve větším, tučném písmu než zpráva. Pokud je to velmi dlouhé, může to být zkrácené.
Titulky Text, který se má zobrazit jako podnadpis dialogového okna. Zobrazí se mezi názvem a zprávou. Pokud je to velmi dlouhé, může to být zkrácené.

Výchozí chování

Popisky tlačítek: Pokud nezadáte vlastní popisky tlačítek, Confirm použije se lokalizovaný výchozí text tlačítka:

  • V aplikacích plátna (Preview) jsou výchozí hodnoty "Confirm" a "Zrušit" (lokalizované).
  • V modelem řízených aplikacích jsou výchozí hodnoty OK a Storno (lokalizované).

Návratová hodnota:Confirm vrátí true , pokud uživatel vybere tlačítko potvrdit a false jinak.

Příklady

Modelem řízené aplikace

Jednoduché potvrzení před odebráním záznamu

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

Zobrazí potvrzovací dialog s výchozími tlačítky. Pokud uživatel vybere tlačítko potvrdit, záznam se odebere.

Potvrzení s vlastním názvem

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

Před odebráním záznamu přidá název do potvrzovací dialogového okna.

Vlastní popisky tlačítek pro předvolbu uživatele

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

Používá vlastní popisky tlačítek k zachycení jednoduché předvolby. Výsledek je uložen v globální proměnné FavColor.

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

Zobrazí modální zprávu, kterou uživatel musí před pokračováním potvrdit. Vrácená hodnota není zaškrtnutá.

Aplikace plátna

Confirm před odstraněním

Slouží Confirm k zabránění náhodnému odstranění záznamů:

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

Zobrazí potvrzovací dialogové okno s popisky nadpisu, titulku a vlastního tlačítka. Záznam se odstraní pouze v případě, že uživatel vybere delete.

Confirm před uložením formuláře

Slouží Confirm k ověření záměru uživatele před odesláním dat:

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

Zobrazí potvrzovací dialogové okno před odesláním formuláře. Formulář se odešle pouze v případě, že uživatel potvrdí.

Uložení výsledku v proměnné pro více akcí

Uložte výsledek potvrzení pro použití v několika podřízených operacích:

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

Logický výsledek je uložený a varConfirmed lze na to odkazovat vícekrát pro podmíněnou logiku.

Úplné přizpůsobení se všemi možnostmi

Předveďte všechny dostupné možnosti přizpůsobení:

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

Zobrazí plně přizpůsobené dialogové okno s názvem, titulkem, zprávou a vlastními popisky tlačítek.

FAQs

Můžu skrýt tlačítko Zrušit?

Ne. Aktuální návrh vždy zobrazuje Confirm tlačítka Zrušit i tlačítko Storno. Uživatelé musí mít možnost zavřít nebo zrušit dialogové okno.

Můžu přidat třetí tlačítko nebo více než dvě možnosti?

Ne. Confirm podporuje přesně dvě možnosti: akci potvrzení a akci zrušení. U scénářů vyžadujících více možností zvažte použití jiného vzoru uživatelského rozhraní, jako je vlastní obrazovka nebo ovládací prvek rozevíracího seznamu.

Blokuje Confirm jiné operace?

Ano. Confirm zobrazí se jako modální dialogové okno, které uživatel musí zavřít, aby mohl pracovat s ostatními částmi aplikace.

Viz také

Notify – Zobrazí nemodální bannerovou zprávu v horní části obrazovky, která nevyžaduje zavření uživatele.

  • Last updated on