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

Функция Confirm

  • Статья

Применимо к: Приложениям на основе моделей

Отображение диалогового окна подтверждения для пользователя.

Описание

Заметка

В настоящее время функция Confirm доступна только при написании команд Power Fx для приложений на основе модели.

Функция Confirm отображает диалоговое окно поверх текущего экрана. Предусмотрены две кнопки: кнопка подтверждения и кнопка отмены, которые в локализованных версиях по умолчанию отображаются как «ОК» и «Отмена» соответственно. Пользователь должен подтвердить или отменить, прежде чем диалоговое окно будет закрыто и функция вернется. Помимо кнопки в диалоговом окне, отмена также может быть выбрана с помощью клавиши ESC или других жестов, зависящих от платформы.

Параметр Message отображается в тексте диалогового окна. Если сообщение длинное, оно может быть усечено, или может появиться полоса прокрутки.

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

Поле параметра Описание:
ПодтвердитьКнопка Текст для отображения на кнопке подтвердить, заменяющая локализованный по умолчанию текст «ОК».
Кнопка отмены Текст для отображения на кнопке отмена, заменяющая локализованный по умолчанию текст «Отмена».
Заголовок Текст для отображения в виде заголовка диалогового окна. Для отображения этого текста можно использовать более крупный и жирный шрифт, чем шрифт сообщения. Если текст длинный, он будет усечен.
Подзаголовок Текст для отображения в виде подзаголовок диалогового окна. Для отображения этого текста можно использовать более крупный и жирный шрифт, чем шрифт сообщения. Если текст длинный, он будет усечен.

Подтвердить возвращает true если была выбрана кнопка подтвердить , false в противном случае.

Используйте функцию Notify для отображения баннера с сообщением в верхней части приложения, который не нужно закрывать.

Синтаксис

Подтвердить( Сообщение [, ПараметрыЗапись ] )

  • Сообщение - Обязательно. Сообщение, отображаемое для пользователя.
  • 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, но это сообщение является модальным и требует от пользователя выбора кнопки для продолжения. Используйте ее в ситуациях, когда важно, чтобы пользователь подтвердил прочтение сообщения, прежде чем продолжить. В этой ситуации не важно, какая кнопка была выбрана, и результат не проверяется.