MessageDialog.CancelCommandIndex 屬性

定義

命名空間:

Windows.UI.Popups

取得或設定您想要用來作為取消命令的命令索引。 這是使用者按下 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 設定為該取消/關閉命令之命令處理常式的索引，如此一來，當使用者透過非一般動作關閉對話方塊時，API 會傳回您想要的命令處理常式。 注意 一般而言，您應該避免建立可透過這種方式關閉的對話方塊，以及重新開機詢問相同的問題，或再次傳送相同的訊息。 他們會讓應用程式變得雜雜，而且通常會對使用者產生雜訊。
-1	使用者必須做出明確的決策，例如點選對話方塊上的特定按鈕。 這可確保使用者無法透過非一般動作關閉對話方塊，例如按 ESC 鍵。
-2	**不建議**。當使用者按下 ESC 或在傳入合約啟用期間，不會關閉對話方塊;不過，如果應用程式在回應傳入啟用時重複使用主要應用程式視窗，對話方塊的命令處理常式將不再有效。 由於 API 不會處理此行為，因此不建議使用此值。

合約啟用關閉時發生錯誤處理如果應用程式收到傳入合約啟用 (，例如從 [搜尋]、[共用]、[設定]、[裝置] 或檔案選擇器合約) 顯示時，不論已針對 CancelCommandIndex 設定的屬性值為何，對話方塊都會以程式設計方式關閉。

為了協助您處理此案例，API 會傳回虛擬命令處理常式。 然後，您可以決定如何處理和回應錯誤。