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

Confirm функция

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

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

Описание

Заметка

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

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

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

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

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

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

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

Синтаксис

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

  • Last updated on