Application.RequestedTheme Property

응용 프로그램의 전체적인 테마에 대한 명암 기본 설정을 결정하는 값을 가져오거나 설정합니다.

구문


public ApplicationTheme RequestedTheme { get; set; }


<application RequestedTheme="applicationThemeMemberName" .../>

속성 값

형식: ApplicationTheme

열거형의 값입니다.

설명

Windows 스토어 앱에서 지원하는 기본 제공 테마는 "밝게"와 "어둡게"입니다. 기본적으로 앱은 "어둡게" 테마(themeresources.xaml 파일에서 "어둡게" 리소스의 키 이름은 "기본값"임)를 사용하여 실행됩니다. 앱의 RequestedTheme 속성을 설정하여 사용된 테마를 지정할 수 있습니다.

테마는 앱이 실행되고 있는 동안이 아니라 앱을 시작할 때에만 설정할 수 있습니다. 실행 중인 앱에 대해 RequestedTheme를 설정하려고 하면 예외(Microsoft .NET 코드용 NotSupportedException)가 throw됩니다. 앱 UI의 일부인 테마를 선택하는 옵션을 사용자에게 제공하는 경우 해당 설정을 앱 데이터에 저장하고 앱이 다시 시작될 때 적용해야 합니다.

시스템 값을 사용하는 "HighContrast" 테마도 있지만 앱과 앱 코드는 앱을 고대비로 전환하는 데 다른 기술을 사용합니다. 고대비로 실행되는 경우 RequestedTheme 속성은 무시됩니다. 고대비 테마 지원XAML 고대비 스타일 샘플을 참조하십시오.

앱이 런타임에 테마를 전환할 수는 없지만 사용자는 전환할 수 있습니다(Windows 8.1부터 시작). 예를 들어 앱이 실행될 때 Alt+Shift+PrtScn 키 바로 가기를 사용하여 사용자가 고대비 테마를 사용하도록 설정할 수 있습니다. 이 경우 XAML 리소스 시스템은 ThemeResource 사용에 대한 리소스 값을 다시 계산합니다. 색과 브러시 등 테마에 적합한 리소스는 해당 테마를 원래 요청한 앱이 아닌 경우에도 현재 테마에 적합한 값을 사용합니다.

앱은 Application.RequestedTheme이 적용된 후 FrameworkElement.RequestedTheme 속성을 사용하고 UI의 특정 요소에 대한 값을 설정하는 경우 런타임에 특정 테마 값을 변경할 수 있습니다.

테마별 리소스는 일반적으로 XAML에서 별도의 리소스 사전에 정의됩니다. 이 리소스 사전은 컨트롤 템플릿에 사용되는 주 ResourceDictionaryThemeDictionaries 속성에서 가져옵니다. 테마별 리소스에 대한 기본 시스템 리소스 사전을 ThemeResources.xaml이라고 합니다. 이 파일은 Windows 8 설치 위치의 Windows SDK(소프트웨어 개발 키트)에서 \include\winrt\xaml\design 경로 아래에 있습니다.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

Namespace

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadata

Windows.winmd

참고 항목

Application
FrameworkElement.RequestedTheme
XAML 요청 테마 샘플
고대비 테마 지원

 

 

표시:
© 2014 Microsoft