Propiedad RequestedTheme

Application.RequestedTheme Property

Obtiene o establece un valor que determina la preferencia claro-oscuro para el tema general de una aplicación.

Sintaxis


public ApplicationTheme RequestedTheme { get; set; }


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

Valor de propiedades

Tipo: ApplicationTheme

Valor de la enumeración.

Comentarios

Las aplicaciones de la Tienda Windows admiten dos temas integrados: "Claro" y "Oscuro". De forma predeterminada, la aplicación se ejecuta con el tema "Oscuro" (en el archivo themeresources.xaml, el nombre de clave para los recursos "Oscuro" es "Valor predeterminado"). Puede establecer la propiedad RequestedTheme de la aplicación para especificar qué tema se utiliza.

El tema puede establecerse solo cuando se inicia la aplicación, no mientras se ejecuta. Al intentar establecer RequestedTheme mientras se ejecuta la aplicación produce una excepción (NotSupportedException para el código Microsoft .NET). Si proporciona al usuario la opción de elegir un tema que forma parte de interfaz de usuario de la aplicación, debe guardar el valor en los datos de la aplicación y aplicarlo cuando se reinicie la aplicación.

Hay también un tema "HighContrast" que utiliza valores del sistema, pero las aplicaciones y el código de la aplicación utilizan otra técnica para cambiar la aplicación al contraste alto. La propiedad RequestedTheme se ignora si el usuario se está ejecutando en modo de contraste alto. Vea Compatibilidad con el modo de contraste alto y Ejemplo de estilo de contraste alto en XAML.

Aunque la aplicación no puede intercambiar los temas en tiempo de ejecución, el usuario sí que puede realizar esta operación (a partir de Windows 8.1). Por ejemplo, un usuario puede habilitar un tema de contraste alto mientras la aplicación se está ejecutando, mediante las teclas de método abreviado Alt+Mayús+Impr Pant. Si esto sucede, el sistema de recursos XAML volverá a calcular los valores de recurso para cualquier uso de ThemeResource. Los recursos adecuados para el tema como colores y pinceles después utilizan los valores adecuados para el tema actual, aunque no fuera la aplicación que solicitó ese tema originalmente.

Una aplicación puede cambiar valores específicos de tema en tiempo de ejecución una vez aplicada la propiedad Application.RequestedTheme si usa la propiedad FrameworkElement.RequestedTheme y establece valores en elementos específicos de la interfaz de usuario.

Los recursos específicos del tema se definen normalmente en un diccionario de recursos independiente en XAML. Este diccionario de recursos procede de la propiedad ThemeDictionaries del ResourceDictionary primario que se utiliza para las plantillas de control. El diccionario de recursos del sistema predeterminado para los recursos específicos de un tema se denomina ThemeResources.xaml. Busque este archivo en la ruta de acceso \include\winrt\xaml\design en el Kit de desarrollo de software de Windows (SDK) para la ubicación de instalación de Windows 8.

Requisitos

Cliente mínimo admitido

Windows 8

Servidor mínimo admitido

Windows Server 2012

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

Application
FrameworkElement.RequestedTheme
Ejemplo de tema XAML solicitado
Compatibilidad con el modo de contraste alto

 

 

Mostrar:
© 2017 Microsoft