AppBar.LightDismissOverlayMode 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

밝은 해제 UI 외부의 영역이 어둡게 표시되는지 여부를 지정하는 값을 가져오거나 설정합니다.

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

LightDismissOverlayMode LightDismissOverlayMode();

void LightDismissOverlayMode(LightDismissOverlayMode value);

public LightDismissOverlayMode LightDismissOverlayMode { get; set; }

var lightDismissOverlayMode = appBar.lightDismissOverlayMode;
appBar.lightDismissOverlayMode = lightDismissOverlayMode;

Public Property LightDismissOverlayMode As LightDismissOverlayMode

<appBar LightDismissOverlayMode="lightDismissOverlayModeMemberName" />

속성 값

LightDismissOverlayMode

광 해제 UI 외부 영역이 어둡게 표시되는지 여부를 지정하는 열거형의 값입니다. 기본값은 Auto입니다.

Windows 요구 사항

디바이스 패밀리	Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)

설명

명령 모음의 MenuFlyout 또는 보조 메뉴와 같은 일시적인 UI는 외부를 클릭하거나 탭하면 닫힙니다. 이를 빠른 해제라고 합니다. "오버레이"는 광 해제 UI 외부 영역을 나타냅니다.

기본적으로 "오버레이"는 Xbox에서 어둡게 표시되며 다른 장치 패밀리에서는 어둡게 표시되지 않습니다. LightDismissOverlayMode를 켜 기로 설정하여 앱이 모든 디바이스 패밀리에서 "오버레이" 영역을 어둡게 만들거나 끄 기로 설정하여 모든 디바이스 패밀리의 "오버레이" 영역을 어둡게 하지 않도록 할 수 있습니다.

버전 호환성

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

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

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded"/>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBar", "LightDismissOverlayMode"))
    {
        commandBar1.LightDismissOverlayMode = LightDismissOverlayMode.On;
    }
}