FrameworkElement.RequestedTheme Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml

Obtiene o establece el tema de la interfaz de usuario que usa UIElement (y sus elementos secundarios) para la determinación de recursos. El tema de la interfaz de usuario que especifique con RequestedTheme puede invalidar el requestedTheme de nivel de aplicación.

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

ElementTheme RequestedTheme();

void RequestedTheme(ElementTheme value);

public ElementTheme RequestedTheme { get; set; }

var elementTheme = frameworkElement.requestedTheme;
frameworkElement.requestedTheme = elementTheme;

Public Property RequestedTheme As ElementTheme

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

Valor de propiedad

ElementTheme

Valor de la enumeración, por ejemplo Light.

Comentarios

Cambiar el valor RequestedTheme está cambiando eficazmente el comportamiento de búsqueda de recursos para la plantilla predeterminada del elemento. Si cambia el valor a Light , la plantilla usa los valores de ResourceDictionary con clave "Light" en la colección ThemeDictionaries . Establecer el tema de la interfaz de usuario de forma diferente del tema de la aplicación suele ser adecuado para controles flotantes, como menús y controles flotantes.

Puede cambiar el valor de la propiedad RequestedTheme para cualquier elemento determinado en tiempo de ejecución. Esto contrasta con la propiedad Application.RequestedTheme , que produce una excepción si intenta establecerla mientras se ejecuta la aplicación.

El valor RequestedTheme establecido en frameworkElement heredará a los elementos anidados dentro del elemento en el que se establece RequestedTheme, pero esa herencia se puede invalidar estableciendo explícitamente RequestedTheme de nuevo. Por ejemplo, en este ejemplo XAML, el elemento primario StackPanel establece el tema en Light y ese valor hereda al primer elemento secundario TextBlock, pero no al segundo TextBlock porque establece 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 omite si el usuario se ejecuta en modo de contraste alto. Consulta Temas de contraste alto y ejemplo de estilo de contraste alto XAML.

Nota

En Windows, establecer RequestedTheme en ElementTheme.Default siempre dará como resultado que "Dark" sea el tema. En Windows Phone, el uso del valor ElementTheme.Default dará como resultado una consulta para el tema del sistema, tal y como lo establece el usuario.

Consulte también

• RequestedTheme
• Ejemplo de tema solicitado de XAML
• Extensión de marcado {ThemeResource}