MessageDialog.CancelCommandIndex プロパティ

定義

名前空間:

Windows.UI.Popups

cancel コマンドとして使用するコマンドのインデックスを取得または設定します。 これは、ユーザーが Esc キーを押したときに発生するコマンドです。

インデックスを設定する前に、コマンドを追加します。

public:
 property unsigned int CancelCommandIndex { unsigned int get(); void set(unsigned int value); };

uint32_t CancelCommandIndex();

void CancelCommandIndex(uint32_t value);

public uint CancelCommandIndex { get; set; }

var uInt32 = messageDialog.cancelCommandIndex;
messageDialog.cancelCommandIndex = uInt32;

Public Property CancelCommandIndex As UInteger

プロパティ値

UInt32

unsigned int

uint32_t

cancel コマンドのインデックス。

注釈

メッセージ ダイアログを使用して、アプリから重要なメッセージやブロックしているメッセージや質問を送信します。

値	使用する場合
≥ 0	ダイアログには、"キャンセル" や "閉じる" など、取り消しと同等の安全な既定の選択肢が用意されています。 CancelCommandIndex を、その cancel/close コマンドのコマンド ハンドラーのインデックスに設定します。これにより、ユーザーが ESC キーを押すなどの非コミット アクションを使用してダイアログを閉じると、API は目的のコマンド ハンドラーを返します。 Note 一般に、この方法で無視できるダイアログを作成したり、同じ質問をしたり、同じメッセージを何度も送信したりして再起動することは避ける必要があります。 彼らはアプリを騒々しくし、ユーザーを困らせる傾向があります。
-1	ユーザーは、ダイアログの特定のボタンをタップするなどの明示的な決定を行う必要があります。 これにより、Esc キーを押すような非コミット アクションを使用してダイアログを閉じることはできません。
-2	**推奨されません**。ダイアログは、ユーザーが Esc キーを押したとき、または着信コントラクトのアクティブ化中に閉じません。ただし、アプリが受信アクティブ化に応答するときにメイン アプリ ウィンドウを再利用した場合、ダイアログのコマンド ハンドラーは無効になります。 API はこの動作を処理しないため、この値を使用しないことをお勧めします。

コントラクトのアクティブ化による無視時のエラー処理ダイアログの表示中にアプリが受信コントラクトのアクティブ化 (検索、共有、設定、デバイス、ファイル ピッカー コントラクトなど) を受け取った場合、CancelCommandIndex に設定されているプロパティ値に関係なく、ダイアログはプログラムによって無視されます。

この場合の処理に役立つよう、API はダミーのコマンド ハンドラーを返します。 その後、エラーを処理して対応する方法を決定できます。