MessageDialog.CancelCommandIndex Propriedade

Definição

Namespace:

Windows.UI.Popups

Obtém ou define o índice do comando que você deseja usar como o comando cancel. Esse é o comando que é acionado quando os usuários pressionam a tecla ESC.

Adicione os comandos antes de definir o í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 da propriedade

UInt32

unsigned int

uint32_t

O índice do comando cancel.

Comentários

Use caixas de diálogo de mensagem para enviar mensagens críticas ou de bloqueio e perguntas do aplicativo.

Valor	Quando usar
≥ 0	A caixa de diálogo oferece uma opção padrão segura equivalente ao cancelamento, como "Cancelar" ou "Fechar". Defina CancelCommandIndex como o índice do manipulador de comando para esse comando cancel/close, de modo que, quando o usuário ignorar a caixa de diálogo por meio de uma ação não comunicada, como pressionar ESC, a API retornará o manipulador de comando desejado. Observação Em geral, você deve evitar criar caixas de diálogo que podem ser descartadas dessa maneira e que relançam fazer a mesma pergunta ou enviar a mesma mensagem várias vezes. Eles tornam o aplicativo barulhento e tendem a irritar os usuários.
-1	O usuário precisa tomar uma decisão explícita, como tocar em um botão específico na caixa de diálogo. Isso garante que o usuário não possa ignorar a caixa de diálogo por meio de uma ação não comunicada, como pressionar o ESC.
-2	**Não recomendado**. A caixa de diálogo não é descartada quando o usuário pressiona ESC ou durante uma ativação de contrato de entrada; no entanto, se o aplicativo reutiliza a janela main aplicativo ao responder a ativações de entrada, os manipuladores de comando da caixa de diálogo não serão mais válidos. Como a API não lida com esse comportamento, recomendamos não usar esse valor.

Tratamento de erro na demissão por ativação de contratoSe o aplicativo receber uma ativação de contrato de entrada (como de Pesquisar, Compartilhar, Configurações, Dispositivos ou contratos do seletor de arquivos) enquanto a caixa de diálogo estiver sendo exibida, a caixa de diálogo será descartada programaticamente, independentemente do valor da propriedade que foi definido para CancelCommandIndex.

Para ajudá-lo a lidar com esse caso, a API retorna um manipulador de comando fictício. Você, então, pode decidir como lidar e reagir ao erro.