适用于: 模型驱动应用
向用户显示确认对话框。
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”是默认值。 这仅适用于支持 ConfirmButton 和 CancelButton 选项的平台。
Confirm( "There was a problem, please review your order." )
显示一条消息,与 Notify 函数非常类似,但它是模态的,需要用户选择按钮才能继续。 当用户在继续之前确认消息的行为很重要时使用。 在这种情况下,选择哪个按钮并不重要,也不会检查结果。