Confirm функция

Отнася се за: Приложения за платно, базирани на модел приложения

Използвайте тази функция, за да покажете диалогов прозорец за потвърждение на потребителя.

Описание

Функцията Confirm показва диалогов прозорец в горната част на текущия екран с два бутона: бутон за потвърждение и бутон за отказ . В приложенията, управлявани от модел, тези бутони по подразбиране за локализирани версии на "OK" и "Отказ" съответно. Confirm е налична и в приложенията за платно за показване на прост диалогов прозорец за потвърждение и връщане на булев резултат.

Потребителят трябва да избере един от бутоните, преди диалоговият прозорец да бъде отхвърлен. Освен да изберете бутона Отказ, диалоговият прозорец може да бъде отхвърлен чрез специфични за платформата жестове (като например клавиша Esc или щракване извън диалоговия прозорец). В приложенията за платно този път за отхвърляне се третира като без действие (т.е. връща blankсе ).

Бележка

В приложенията за платно функцията Confirm използва диалоговия прозорец Fluent. Уверете се, че модерните контроли са разрешени; в противен случай се показва диалоговият прозорец на вградения браузър.

Синтаксис

Confirm( Message [, OptionsRecord ] )

Съобщение - Задължително. Съобщение за показване на потребителите.
OptionsRecord - По избор. Предоставете настройки за опции за диалоговия прозорец. Вижте по-долу за наличните опции.

Опции

Използвайте параметъра OptionsRecord , за да персонализирате диалоговия прозорец за потвърждение:

Опция	Описание
Бутон за потвърждение	Текстът, който трябва да се покаже на бутона за потвърждение, замествайки локализирания текст "OK" или "Confirm" по подразбиране.
Бутон за отказ	Текстът, който трябва да се покаже на бутона "Отказ", заместващ локализирания текст "Отказ" по подразбиране.
Заглавие	Текстът за показване като заглавие на диалоговия прозорец. Показва се с по-голям, по-получер шрифт от съобщението. Тя може да бъде отрязана, ако е много дълга.
Подзаглавие	Текстът за показване като подзаглавие на диалоговия прозорец. Показва се между заглавието и съобщението. Тя може да бъде отрязана, ако е много дълга.

Поведение по подразбиране

Етикети на бутони: Ако не предоставите етикети на бутони по избор, Confirm използва локализиран текст на бутон по подразбиране:

В приложенията за платно (предварителен преглед) настройките по подразбиране са "Confirm" и "Отказ" (локализирани).
В приложенията, управлявани от модел, настройките по подразбиране са "OK" и "Отказ" (локализирани).

Върната стойност:Confirm връща true , ако потребителят избере бутона за потвърждение и false в противен случай.

Примери

Приложения, управлявани от модел

Просто потвърждение преди премахване на запис

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

Показва диалогов прозорец за потвърждение с бутони по подразбиране. Ако потребителят избере бутона за потвърждение, записът се премахва.

Потвърждение със заглавие по избор

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

Добавя заглавие в диалоговия прозорец за потвърждение, преди да премахне запис.

Custom button labels for user preference

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

Използва етикети на бутони по избор, за да улови просто предпочитание. Резултатът се съхранява в глобалната променлива FavColor.

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

Показва модално съобщение, което потребителят трябва да потвърди, преди да продължи. Върнатата стойност не е отметната.

Приложения за платно

Confirm преди изтриване

Използвайте Confirm , за да предотвратите случайно изтриване на записи:

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

Показва диалогов прозорец за потвърждение с етикети на заглавие, подзаглавие и бутон по избор. Записът се изтрива само ако потребителят избере Изтрий.

Confirm преди записване на формуляр

Използвайте Confirm , за да проверите намерението на потребителя, преди да подадете данни:

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

Показва диалогов прозорец за потвърждение преди подаване на формуляра. Формулярът се подава само ако потребителят потвърди.

Резултат от хранилището в променлива за множество действия

Съхранете резултата от потвърждението, който да се използва в няколко операции надолу по веригата:

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

Булевият резултат се съхранява в varConfirmed и може да бъде адресиран няколко пъти за условна логика.

Пълно персонализиране с всички опции

Покажете всички налични опции за персонализиране:

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

Показва напълно персонализиран диалогов прозорец със заглавие, подзаглавие, съобщение и етикети на бутони по избор.

ЧЗВ

Мога ли да скрия бутона "Отказ"?

Не. Текущият проект винаги показва бутоните Confirm "Отказ". Потребителите трябва да имат възможността да отхвърлят или отменят диалоговия прозорец.

Мога ли да добавя трети бутон или повече от две опции?

Не. Confirm поддържа точно две опции: действие за потвърждаване и действие за отмяна. За сценарии, изискващи няколко възможности за избор, помислете за използване на различна схема на потребителския интерфейс, като например екран по избор или контрола на падащо меню.

Блокира ли Confirm други операции?

Да. Confirm се показва като модален диалогов прозорец, който потребителят трябва да отхвърли, преди да може да взаимодейства с други части на приложението.

Вижте също

Notify – Показва немодално банерно съобщение в горната част на екрана, което не изисква изключване от потребител.

Обратна връзка

Тази страница полезна ли беше?

Last updated on 2026-02-10