FrameworkElement.RequestedTheme Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit le thème d’interface utilisateur utilisé par l’élément UIElement (et ses éléments enfants) pour la détermination des ressources. Le thème d’interface utilisateur que vous spécifiez avec RequestedTheme peut remplacer le RequestedTheme au niveau de l’application.

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" .../>

Valeur de propriété

ElementTheme

Valeur de l’énumération, par exemple Light.

Remarques

La modification de la RequestedTheme valeur modifie en fait le comportement de recherche de ressource pour le modèle par défaut de l’élément. Si vous remplacez la valeur Light par , le modèle utilise les valeurs du ResourceDictionary qui est clé comme « Light » dans la collection ThemeDictionaries . Définir le thème de l’interface utilisateur différemment du thème de l’application est souvent approprié pour les contrôles flottants tels que les menus et les menus volants.

Vous pouvez modifier la valeur de la RequestedTheme propriété pour un élément donné au moment de l’exécution. Cela contraste avec la propriété Application.RequestedTheme , qui lève une exception si vous essayez de la définir pendant l’exécution de l’application.

La RequestedTheme valeur que vous définissez sur un FrameworkElement héritera de tous les éléments imbriqués dans l’élément où RequestedTheme est défini, mais cet héritage peut être remplacé par une nouvelle définition RequestedTheme explicite. Par exemple, dans cet exemple XAML, le StackPanel parent définit le thème sur Light, et cette valeur hérite du premier élément enfant TextBlock , mais pas du second TextBlock , car il définit la valeur sur à Dark la place.

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

La RequestedTheme propriété est ignorée si l’utilisateur s’exécute en mode contraste élevé. Consultez Thèmes à contraste élevé et Exemple de style à contraste élevé XAML.

Notes

Sur Windows, la définition de RequestedTheme sur ElementTheme.Default entraîne toujours « Dark » comme thème.

Voir aussi

• RequestedTheme
• Exemple de thème demandé XAML
• Extension de balisage {ThemeResource}