MessageDialog.CancelCommandIndex 属性

定义

获取或设置要用作取消命令的命令的索引。 这是当用户按 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 返回了一个虚拟命令处理程序。 然后,你可以决定如何处理和响应错误。

适用于