Confirm 函式

適用於： 模型驅動應用

向使用者顯示確認對話方塊。

Description

注意

目前只有在撰寫模型導向應用程式的 Power Fx 命令時，才能使用 Confirm 函式。

Confirm 函式會在目前畫面上方顯示對話方塊。 提供兩個按鈕：確認按鈕和取消按鈕，分別預設為當地語系化版本的「確定」和「取消」。 使用者必須確認或取消，才能解除對話方塊並傳回函式。 除了對話方塊按鈕之外，您也可以使用 Esc 鍵或特定平台的其他手勢選擇取消。

Message 參數會顯示在對話方塊的本文中。 如果訊息很長，可能會遭截斷，或提供捲軸。

使用 OptionsRecord 參數指定對話方塊的選項。 並非所有選項在每個平台上都能使用，而且會以最大努力進行處理。 畫布應用程式不支援這些選項。

選項欄位	描述
確認按鈕	要顯示在確認按鈕上的文字，取代預設的、當地語系化的「確定」文字。
取消按鈕	要顯示在取消按鈕上的文字，取代預設、當地語系化的「取消」文字。
標題	要顯示成對話方塊標題的文字。 比郵件字體更大、較粗的字體可以用來顯示此文字。 如果文字很長，就會遭截斷。
字幕	要顯示成對話方塊字幕的文字。 比郵件字體更大、較粗的字體可以用來顯示此文字。 如果文字很長，就會遭截斷。

如果選擇了確認按鈕，則 Confirm 返回 true ， 否則返回 false 。

您可以使用 Notify 函式，在應用程式的頂端顯示不需要關閉的訊息橫幅。

語法

確認（ 消息 [， 選項記錄 ]）

• 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 中的結果會是文字字串「紅色」或「綠色」。 做為確認選項，「紅色」是預設值。 這僅適用於支援 ConfirmButton 和 CancelButton 選項的平台。

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

顯示與 Notify 函式非常相似的訊息，但要強制回應，使用者必須選取按鈕才能繼續。 當使用者要在繼續之前認收訊息一事很重要時使用。 在這種情況下，選取哪一個按鈕並不重要，也不會檢查結果。