次の方法で共有

Confirm 関数

  • [アーティクル]

適用対象: モデル駆動型アプリ

ユーザーに確認ダイアログ ボックスを表示します。

Description

Note

現時点では、Confirm 関数は、モデル駆動型アプリの Power Fx コマンドを記述する場合にのみ使用できます。

この Confirm 関数は、現在の画面の上にダイアログ ボックスを表示します。 確認 ボタンと キャンセル ボタンの 2 つのボタンが用意されており、デフォルトではそれぞれローカライズ バージョンの「OK」と「キャンセル」になっています。 ダイアログ ボックスが閉じられて関数が戻る前に、ユーザーは確認またはキャンセルする必要があります。 キャンセル は、ダイアログ ボタン以外にも、Esc キーや、プラットフォーム固有のその他のジェスチャーでも選択できます。

Message パラメータはダイアログ ボックスの本体に表示されます。 メッセージが長い場合は、切り捨てられたり、スクロール バーが表示されたりすることがあります。

OptionsRecord パラメーターを使用し、ダイアログ ボックスのオプションを指定します。 すべてのオプションがすべてのプラットフォームで利用できるわけではなく、ベスト エフォート方式で処理されます。 これらのオプションは、キャンバス アプリではサポートされていません。

オプション フィールド Description
確認ボタン 確認ボタンに表示するテキスト、デフォルトのローカライズされた「OK」テキストを置き換えます。
キャンセルボタン キャンセル ボタンに表示するテキスト、デフォルトのローカライズされた「キャンセル」テキストを置き換えます。
タイトル ダイアログ ボックスのタイトルとして表示するテキスト。 このテキストを表示するには、メッセージ フォントよりも大きく太字のフォントを使用できます。 テキストが長い場合、切り捨てられます。
字幕 ダイアログ ボックスのサブタイトルとして表示するテキスト。 このテキストを表示するには、メッセージ フォントよりも大きく太字のフォントを使用できます。 テキストが長い場合、切り捨てられます。

Confirm は、 確認 ボタンが選択された場合は true を返し、 それ以外の場合は falseを返します。

Notify 関数を使用し、無視する必要のないメッセージ バナーをアプリの上部に表示します。

構文

確認( メッセージ [, オプション記録 ] )

  • メッセージ - 必須。 ユーザーに表示するメッセージ。
  • 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." )

Notify 関数と同じようにメッセージを表示しますが、これはモーダルであり、続行するにはユーザーがボタンを選択する必要があります。 続行する前に、ユーザーがメッセージを確認することが重要な場合に使用します。 この状況では、どのボタンが選択されたかは重要ではなく、結果はチェックされません。