Поділитися через

Функція Confirm (підтвердження)

  • Стаття

Застосовується до: додатків на основі моделі

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

Опис

Нотатка

Наразі функція «Підтвердити » доступна лише під час написання Power Fx команд для програм, керованих моделлю.

Функція «Підтвердити » відображає діалогове вікно у верхній частині поточного екрана. Передбачено дві кнопки: кнопка підтвердження та кнопка скасування , які за замовчуванням використовуються для локалізованих версій «OK» та «Cancel» відповідно. Користувач має підтвердити або скасувати, перш ніж діалогове вікно закриється на функція поверне значення. Окрім діалогової кнопки, скасувати також можна за допомогою клавіші Esc або інших жестів, які є специфічними для платформи.

Параметр «Повідомлення» відображається в тілі діалогового вікна. Якщо повідомлення довге, його може бути обрізано або надано смугу прокручування.

Використовуйте параметр OptionsRecord , щоб вказати параметри для діалогового вікна. Не всі параметри доступні на кожній платформі. Вони обробляються за принципом «максимально можливо». Ці параметри не підтримуються в програмах полотна.

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

Confirm повертає true , якщо була вибрана кнопка підтвердження , false в іншому випадку.

Використовуйте функцію «Сповіщення », щоб відобразити банер із повідомленням у верхній частині програми, який не потрібно закривати.

Синтаксис

Confirm( Повідомлення [, OptionsRecord ] )

  • Повідомлення - обов'язкове. Повідомлення, яке потрібно відобразити для користувача.
  • OptionsRecord - Необов'язковий. Надайте параметри параметрів для діалогового вікна. Не всі параметри доступні на кожній платформі. Вони обробляються за принципом «максимально можливо».

Приклади

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 буде текстовий рядок «Червоний» або «Зелений». Як варіант підтвердження , за замовчуванням використовується "Червоний". Це працює лише на платформах, які підтримують опції ConfirmButton і CancelButton .

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

Відображає повідомлення подібно до функції Notify , але є модальним і вимагає від користувача вибрати кнопку, щоб продовжити. Використовуйте, коли важливо, щоб користувач підтвердив повідомлення, перш ніж продовжити. У цій ситуації не важливо, яка кнопка була обрана, і результат не перевіряється.