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를 누르거나 들어오는 계약 활성화 중에 대화 상자가 해제되지 않습니다. 그러나 들어오는 활성화에 응답할 때 앱이 기본 앱 창을 다시 사용하는 경우 대화 상자의 명령 처리기는 더 이상 유효하지 않습니다. API는 이 동작을 처리하지 않으므로 이 값을 사용하지 않는 것이 좋습니다.

계약 활성화에 의한 해고 시 오류 처리대화 상자가 표시되는 동안 앱이 들어오는 계약 활성화(예: 검색, 공유, 설정, 디바이스 또는 파일 선택기 계약)를 받으면 CancelCommandIndex에 대해 설정된 속성 값에 관계없이 대화 상자가 프로그래밍 방식으로 해제됩니다.

이 경우를 처리하는 데 도움이 되도록 API는 더미 명령 처리기를 반환합니다. 그런 다음 오류를 처리하고 대응하는 방법을 결정할 수 있습니다.