ContentDialog.DefaultButton 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

대화 상자의 단추가 기본 동작임을 나타내는 값을 가져오거나 설정합니다.

public:
 property ContentDialogButton DefaultButton { ContentDialogButton get(); void set(ContentDialogButton value); };

ContentDialogButton DefaultButton();

void DefaultButton(ContentDialogButton value);

public ContentDialogButton DefaultButton { get; set; }

var contentDialogButton = contentDialog.defaultButton;
contentDialog.defaultButton = contentDialogButton;

Public Property DefaultButton As ContentDialogButton

속성 값

ContentDialogButton

열거형 값입니다. 기본값은 None입니다.

Windows 요구 사항

디바이스 패밀리	Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)

설명

필요에 따라 기본 단추로 세 가지 단추 중 하나를 식별하도록 선택할 수 있습니다. 기본 단추를 지정하면 다음과 같은 결과가 발생합니다.

• 단추가 강조색 단추 시각적 처리를 수신합니다.
• 단추가 Enter 키에 자동으로 응답합니다.
  • 사용자가 키보드에서 ENTER 키를 누르면 기본 단추와 연결된 클릭 처리기가 실행되고 ContentDialogResult 가 기본 단추와 연결된 값을 반환합니다.
  • 사용자가 ENTER 키를 처리하는 컨트롤에 포커스를 두면 기본 단추가 Enter 키를 누르는 데 응답하지 않습니다.
• 대화 상자의 콘텐츠에 포커스가 있는 UI가 포함되어 있지 않으면 대화 상자가 열리면 단추가 자동으로 포커스를 받습니다.

버전 호환성

DefaultButton 속성은 Windows 10 버전 1703 이전에는 사용할 수 없습니다. Microsoft Visual Studio에서 앱의 '최소 플랫폼 버전' 설정이 이 페이지의 뒷부분에 있는 요구 사항 블록에 표시된 '도입된 버전'보다 작은 경우 이를 고려하여 앱을 디자인하고 테스트해야 합니다. 자세한 내용은 버전 적응 코드를 참조하세요.

앱이 이전 버전의 Windows 10 실행되는 경우 예외를 방지하려면 XAML에서 이 속성을 설정하거나 런타임 검사 수행하지 않고 사용하지 마세요. 이 예제에서는 ApiInformation 클래스를 사용 하 여 설정 하기 전에이 속성의 존재에 대 한 검사 하는 방법을 보여 집니다.

<ContentDialog x:Name="contentDialog1" Loaded="ContentDialog_Loaded">
    ...
</ContentDialog>

private void ContentDialog_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ContentDialog", "DefaultButton"))
    {
        contentDialog1.DefaultButton = ContentDialogButton.Primary;
    }
}