FrameworkElement.RequestedTheme Propriété

Définition

Espace de noms:

Windows.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 thème 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 valeur RequestedTheme modifie efficacement le comportement de recherche de ressource pour le modèle par défaut de l’élément. Si vous remplacez la valeur par Light , 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 propriété RequestedTheme 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 valeur RequestedTheme que vous définissez sur un Élément 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 explicite de RequestedTheme. 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 propriété RequestedTheme est ignorée si l’utilisateur 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. Sur Windows Phone, l’utilisation de la valeur ElementTheme.Default entraîne une requête pour le thème système, tel que défini par l’utilisateur.

Voir aussi

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