Confirm функція

Застосовується до: Програми canvas Model-driven

Ця функція використовується для відображення діалогового вікна підтвердження для користувача.

Опис

У Confirm функції вгорі поточного екрана відображається діалогове вікно з двома кнопками: кнопкою "Підтвердити " та кнопкою " Скасувати ". У програмах на основі моделі ці кнопки за замовчуванням локалізовані версії "OK" і "Скасувати" відповідно. Confirm також доступна в програмах полотна для відображення простого діалогового вікна підтвердження та повернення логічного результату.

Користувач повинен вибрати одну з кнопок, перш ніж діалогове вікно буде закрито. Крім натискання кнопки Скасувати, діалогове вікно можна відхилити за допомогою рухів для конкретної платформи (наприклад, клавіші Esc або клацання за межами діалогового вікна). У програмах для полотна цей шлях звільнення розглядається як без дій (тобто повертається blank).

Нотатка

У програмах Confirm полотна функція використовує діалогове вікно Fluent. Переконайтеся, що сучасні елементи керування ввімкнуто; в іншому разі з'явиться діалогове вікно власного браузера.

Синтаксис

Confirm( Message [, OptionsRecord ] )
  • Повідомлення - Обов’язковий. Повідомлення, яке потрібно відобразити для користувача.
  • OptionsRecord - Необов’язковий. Надайте параметри параметрів для діалогового вікна. Доступні варіанти див. нижче.

Параметри

Щоб налаштувати діалогове вікно підтвердження, скористайтеся параметром OptionsRecord :

Варіант Опис
ConfirmButton Текст, який відображатиметься на кнопці підтвердження, заміняючи локалізований текст за замовчуванням "OK" або "Confirm".
Кнопка скасування Текст, який відображатиметься на кнопці "Скасувати", замінено локалізованим текстом за замовчуванням "Скасувати".
Назва Текст, який відображатиметься як заголовок діалогового вікна. Відображається більшим жирним шрифтом, ніж повідомлення. Він може бути скорочений, якщо дуже довго.
Субтитрів Текст, який відображатиметься як підзаголовок діалогового вікна. Відображається між заголовком і повідомленням. Він може бути скорочений, якщо дуже довго.

Поведінка за замовчуванням

Підписи кнопок: Якщо ви не надаєте спеціальні підписи кнопок, Confirm використовується локалізований стандартний текст кнопки:

  • У програмах для полотна (підготовча версія) за замовчуванням використовуються такі параметри: "Confirm" і "Скасувати" (локалізовано).
  • У програмах на основі моделі за замовчуванням використовуються "OK" і "Cancel" (локалізовано).

Повернуте значення:Confirm повертається true , якщо користувач вибере кнопку підтвердження та false в іншому випадку.

Приклади

Модельні програми

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

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

Відображення діалогового вікна підтвердження з стандартними кнопками. Якщо користувач вибере кнопку підтвердження, запис буде видалено.

Підтвердження з настроюваним заголовком

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

Додавання назви до діалогового вікна підтвердження перед видаленням запису.

Настроювані підписи кнопок для параметрів користувача

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