FrameworkElement.RequestedTheme Property

Obtiene o establece el tema de la UI utilizado por UIElement (y sus elementos secundarios) para la determinación de recursos. El tema de la UI que se especifica con RequestedTheme puede reemplazar el RequestedTheme de nivel de la aplicación.

Sintaxis


public ElementTheme RequestedTheme { get; set; }


<uiElement RequestedTheme="elementThemeMemberName" .../>

Valor de propiedades

Tipo: ElementTheme

Valor de la enumeración como, por ejemplo, Light.

Comentarios

Cambiar el valor de RequestedTheme cambia el comportamiento de búsqueda de recursos de la plantilla de elementos predeterminada. Si cambia el valor a Light, la plantilla usará los valores del ResourceDictionary que se pasan con clave como "Luz" en la colección ThemeDictionaries. Establecer un tema de interfaz de usuario distinto del tema de la aplicación suele ser adecuado para los controles flotantes como menús.

Puede cambiar el valor de la propiedad RequestedTheme para cualquier elemento dado en tiempo de ejecución. Eso contrasta con la propiedad Application.RequestedTheme, que produce una excepción si intenta establecerla mientras la aplicación está en ejecución.

El valor de RequestedTheme que se establece en un objeto FrameworkElement se heredará en cualquier elemento que esté anidado en el elemento en el que se ha establecido la propiedad RequestedTheme, pero esa herencia puede invalidarse explícitamente volviendo a establecer RequestedTheme. Por ejemplo, en este ejemplo de XAML, el StackPanel principal establece el tema en Light y ese valor hereda al primer elemento secundario TextBlock pero no al segundo TextBlock porque está estableciendo el valor en Dark en su lugar.


<StackPanel RequestedTheme="Light">
  <TextBlock>Text using light theme.</TextBlock>
  <TextBlock RequestedTheme="Dark">Text using dark theme.</TextBlock>
</StackPanel>

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.

Requisitos

Cliente mínimo admitido

Windows 8.1

Servidor mínimo admitido

Windows Server 2012 R2

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

FrameworkElement
Application.RequestedTheme
Ejemplo de tema XAML solicitado
Extensión de marcado ThemeResource

 

 

Mostrar:
© 2014 Microsoft