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 индекс обработчика команд для этой команды cancel/close, чтобы при закрытии диалогового окна с помощью некомитетного действия, например нажатия клавиши ESC, API возвращал нужный обработчик команд. Примечание Как правило, следует избегать создания диалогов, которые можно закрыть таким образом, чтобы повторно запускать один и тот же вопрос или отправлять одно и то же сообщение снова и снова. Они делают приложение шумным и, как правило, раздражает пользователей.
-1	Пользователь должен принять явное решение, например коснуться определенной кнопки в диалоговом окне. Это гарантирует, что пользователь не сможет закрыть диалоговое окно с помощью некоммерческого действия, такого как нажатие клавиши ESC.
-2	**Не рекомендуется**. Диалоговое окно не закрывается, когда пользователь нажимает клавишу ESC или во время активации входящего контракта; Однако если приложение повторно использует окно main приложения при реагировании на входящие активации, обработчики команд диалогового окна больше не будут действительными. Так как API не обрабатывает такое поведение, мы не рекомендуем использовать это значение.

Обработка ошибок при закрытии при активации контрактаЕсли приложение получает активацию входящего контракта (например, из "Поиск", "Общий доступ", "Параметры", "Устройства" или контракты средства выбора файлов) во время отображения диалогового окна, диалоговое окно закрывается программным способом, независимо от значения свойства, заданного для CancelCommandIndex.

Чтобы помочь в обработке этого случая, API возвращает фиктивный обработчик команд. Затем вы можете решить, как обрабатывать ошибку и реагировать на нее.