Confirm 函数

适用于: 模型驱动应用

向用户显示确认对话框。

Description

备注

目前, Confirm 仅当为模型驱动应用编写 Power Fx 命令时,该函数才可用。

Confirm 函数在当前屏幕顶部显示一个对话框。 提供两个按钮:确认按钮和取消按钮,分别默认为本地化版本的“确定”和“取消”。 用户必须在对话框消除和函数返回之前确认或取消。 除了对话框按钮,还可以使用 Esc 键或其他特定于平台的手势选择取消

Message 参数显示在对话框的主体中。 如果消息较长,可能会被截断,或者提供滚动条。

使用 OptionsRecord 参数为对话框指定选项。 并非所有选项在每个平台上都可用,处理基于尽力原则。 画布应用中不支持这些选项。

选项字段 Description
确认按钮 要在确认按钮上显示的文本,替换默认的本地化后的“确定”文本。
取消按钮 要在取消按钮上显示的文本,替换默认的本地化后的“取消”文本。
职位 要作为对话框标题显示的文本。 可以使用比消息字体更大、更粗的字体来显示此文本。 如果文本长,则文本将被截断。
字幕 要作为对话框副标题显示的文本。 可以使用比消息字体更大、更粗的字体来显示此文本。 如果文本长,则文本将被截断。

Confirm如果选中了确认按钮,则返回 true,否则返回 false

使用 Notify 函数在应用顶部显示不需要关闭的消息横幅。

语法

Confirm消息 [, OptionsRecord ] )

  • Message - 必填。 要向用户显示的消息。
  • 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 中的结果将是文本字符串“Red”或“Green”。 作为确认选择项,“Red”是默认值。 这仅适用于支持 ConfirmButtonCancelButton 选项的平台。

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

显示一条消息,与 Notify 函数非常类似,但它是模态的,需要用户选择按钮才能继续。 当用户在继续之前确认消息的行为很重要时使用。 在这种情况下,选择哪个按钮并不重要,也不会检查结果。