Споделяне чрез


Потвърдете функцията

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

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

Описание

Бележка

В момента функцията Confirm е налична само при писане на Power Fx команди за приложения, базирани на модел.

Функцията Потвърждаване показва диалогов прозорец в горната част на текущия екран. Предвидени са два бутона: бутон за потвърждение и бутон за отказ , които по подразбиране са локализирани версии съответно на "OK" и "Cancel". Потребителят трябва да потвърди или отмени, преди диалоговият прозорец да бъде отхвърлен и функцията да се върне. Освен диалоговия бутон, отказът може да бъде избран и с клавиша Esc или други жестове, които са специфични за платформата.

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

Използвайте параметъра OptionsRecord, за да зададете опции за диалоговия прозорец. Не всички опции са налични на всяка платформа и се обработват на база „най-добри усилия“. Тези опции не се поддържат в приложения за платно.

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

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

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

Синтаксис

Потвърдете( Съобщение [, OptionsRecord ] )

  • Съобщение - Задължително. Съобщение за показване на потребителите.
  • ОпцииЗапис- По избор. Предоставете настройки на опциите за диалоговия прозорец. Не всички опции са налични на всяка платформа и се обработват на база „най-добри усилия“.

Примери

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

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

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." )

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