Themes
The Themes setting includes settings to customize elements of the Windows visual style, including the window glass color, desktop background, and brand icon.
To customize the Windows default theme, you must include the settings: DesktopBackground and ThemeName. You may also optionally include the settings: BrandIcon, UWPAppsUseLightTheme, and WindowColor.
In addition to customizing the Windows default theme, you can also create additional custom themes using .theme files. See instructions in the MSDN topic: Creating and Installing Theme Files. Theme files can’t be used as the Windows default, however, users can choose to apply one of your custom themes from their Personalization settings if desired.
Child Elements
| Setting | Description |
|---|---|
| BrandIcon | Specifies the path to a graphic file that is incorporated in the theme preview in the user’s Personalization settings. |
| CustomDefaultThemeFile | This setting is deprecated. To customize the Windows default theme, simply define the DesktopBackground and ThemeName settings. You may also optionally include the settings: BrandIcon, ScreenSaver, UWPAppsUseLightTheme, and WindowColor. Note: While you can add additional custom themes to a Windows installation using a .theme file, .theme files can no longer be used as the default theme. Only the elements listed here can be customized in the Windows default theme. |
| DesktopBackground | Specifies the path to a graphic file that is used for the desktop background. |
| ScreenSaver | Specifies the path to a screen-saver file. Note: This setting is now removed. Lockscreen features and policies are preferred over using ScreenSaver. We recommend using automatic power plans to dim the screen. This can help reduce system power consumption. |
| ThemeName | Specifies the name of the customized Windows default theme. |
| UWPAppsUseLightTheme | Specifies whether dark mode is applied to UWP apps. By default, the classic Windows color mode (light theme) is used. |
| WindowColor | Specifies the color of the window borders and the color of various other elements in the system, most notably colors in the Start menu, common controls, active-underline for open apps in the taskbar, and Quick Action tiles in the notification area. |
Valid Configuration Passes
Parent Hierarchy
Applies To
For a list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-Shell-Setup.
XML Example
The following XML output shows how to set a customized theme.
Microsoft. Windows. Themes Пространство имен
Набор тем, определенных в Windows Presentation Foundation. Provides exposure to the set of themes defined by Windows Presentation Foundation. В подсистеме WPF тема представляет собой набор определенных на системном уровне ресурсов, которые обеспечивают внешний вид по умолчанию элементов управления и других визуальных элементов приложения. In WPF, a theme is a set of resources, defined at the system level, which provide the default appearance for controls and other visual elements of an application. Темы WPF созданы с использованием стилей и включают следующие: Luna, Aero, Royale и Classic. WPF themes are created using styles and include Luna, Aero, Royale, and Classic. Эти темы используются только в клиентской области WPF-приложения. Внешним видом границы окна и кнопок, составляющих хром окна, управляет служба тем Win32. Only the client area of a WPF application uses these themes; the appearance of the window border and buttons that form the window chrome is controlled by the Win32 theme service.
Классы
Придает элементам Bullet платформы Windows Presentation Foundation (WPF) внешний вид, соответствующий теме. Creates the theme-specific look for Windows Presentation Foundation (WPF) Bullet elements. Свойство Bullet определяет внешний вид элементов управления CheckBox и RadioButton. A Bullet defines the appearance of CheckBox and RadioButton elements.
Придает элементам Button .NET Framework внешний вид, соответствующий теме. Creates the theme-specific look for .NET Framework Button elements.
Придает типам Decorator характерный внешний вид, соответствующий классической (Classic) теме. Creates the theme-specific look for Decorator types, for use with the Classic theme.
Придает внешний вид, соответствующий теме, заголовкам объекта DataGrid в .NET Framework 4.5. Creates the theme specific-look for headers in .NET Framework 4.5 DataGrid.
Придает элементам ListBox .NET Framework внешний вид, соответствующий теме. Creates the theme-specific look for .NET Framework ListBox elements.
Предоставляет информацию о языке и региональных параметрах, которая используется темами операционной системы, созданными на платформе .NET Framework. Provides culture-specific information used by the .NET Framework system themes.
Создает объект Brush, который используется для рисования элемента управления ProgressBar. Creates the Brush used to draw the ProgressBar.
Создает объект DrawingBrush, используемый для рисования подсветки элемента управления ProgressBar. Creates a DrawingBrush used to draw the highlighting for the ProgressBar.
Придает элементам ScrollBar .NET Framework внешний вид, соответствующий теме. Creates the theme-specific look for .NET Framework ScrollBar elements.
Создает характерный вид темы добавлением эффектов тени. Creates a theme specific look for drop shadow effects.
Перечисления
Указывает тип объекта Border для рисования. Specifics the type of Border to draw.
Описывает глифы, которые используются для представления элемента Thumb. Describes the glyphs used to represent the Thumb.
Представляет возможные варианты цветового оформления тем Microsoft. Represents possible color variants for the Microsoft themes.