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

取消命令的索引。

注解

使用消息对话框从应用发送关键或阻止消息和问题。

值	何时使用
≥ 0	对话框提供与取消等效的安全默认选项，例如“取消”或“关闭”。 将 CancelCommandIndex 设置为该取消/关闭命令的命令处理程序的索引，以便当用户通过非通用操作（如按 ESC）关闭对话框时，API 将返回所需的命令处理程序。 注意 通常，应避免创建可以这样关闭的对话，并重新启动询问同一问题或一次又一次地发送相同的消息。 它们会使应用变得嘈杂，并往往会惹恼用户。

-1用户需要做出明确的决定，例如点击对话框中的特定按钮。 这可确保用户无法通过非通用操作（如按 ESC）关闭对话。 -2**不建议使用**。当用户按下 ESC 或在传入的合同激活期间，对话框不会关闭;但是，如果应用在响应传入激活时重新使用main应用窗口，则对话框的命令处理程序将不再有效。 由于 API 不处理此行为，因此建议不要使用此值。

合同激活解除时的错误处理如果应用在显示对话框时从搜索、共享、设置、设备或文件选取器合约) 收到传入合同激活 (，则无论为 CancelCommandIndex 设置的属性值如何，该对话框都会以编程方式关闭。

为了帮助你处理这种情况，API 返回了一个虚拟命令处理程序。 然后，你可以决定如何处理和响应错误。