MessageDialog.CancelCommandIndex Propiedad

Definición

Espacio de nombres:

Windows.UI.Popups

Obtiene o establece el índice del comando que desea usar como comando cancel. Este es el comando que se activa cuando los usuarios presionan la tecla ESC.

Agregue los comandos antes de establecer el índice.

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

Valor de propiedad

UInt32

unsigned int

uint32_t

Índice del comando cancel.

Comentarios

Use diálogos de mensaje para enviar mensajes críticos o bloquear mensajes y preguntas de la aplicación.

Valor

Cuándo se usa

≥ 0

El cuadro de diálogo ofrece una opción predeterminada segura que equivale a la cancelación, como "Cancelar" o "Cerrar". Establezca CancelCommandIndex en el índice del controlador de comandos para ese comando cancel/close, para que cuando el usuario descarte el cuadro de diálogo a través de una acción no confirmada, como presionar ESC, la API devuelve el controlador de comandos que desea. Nota: Por lo general, debe evitar crear diálogos que se puedan descartar de esta manera y que vuelvan a iniciarse haciendo la misma pregunta o enviando el mismo mensaje de nuevo y de nuevo. Hacen que la aplicación sea ruidosa y tienden a molestar a los usuarios.

-1El usuario debe tomar una decisión explícita, como pulsar un botón específico en el cuadro de diálogo. Esto garantiza que el usuario no pueda descartar el cuadro de diálogo a través de una acción no confirmada, como presionar ESC. -2**No recomendado**. El cuadro de diálogo no se descarta cuando el usuario presiona ESC o durante una activación del contrato entrante; Sin embargo, si la aplicación vuelve a usar la ventana principal de la aplicación al responder a las activaciones entrantes, los controladores de comandos del cuadro de diálogo ya no serán válidos. Dado que la API no controla este comportamiento, se recomienda no usar este valor.

Control de errores sobre el despido mediante una activación de contratoSi la aplicación recibe una activación de contrato entrante (como buscar, compartir, configuración, dispositivos o los contratos del selector de archivos) mientras se muestra el cuadro de diálogo, el cuadro de diálogo se descarta mediante programación, independientemente del valor de propiedad que se haya establecido para CancelCommandIndex.

Para ayudarle a controlar este caso, la API devuelve un controlador de comandos ficticio. A continuación, puede decidir cómo controlar y reaccionar ante el error.