FrameworkElement.RequestedTheme Propriété

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é

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

Remarques

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

Vous pouvez modifier la valeur de la propriété pour n’importe quel élément donné au moment de l’exécution RequestedTheme . Contrairement à 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 il est défini, mais cet héritage peut être remplacé en définissant RequestedTheme explicitement à nouveau. Par exemple, dans cet exemple XAML, le StackPanel parent définit le thème Lightsur , et cette valeur hérite du premier élément enfant TextBlock , mais pas à la seconde TextBlock , car elle définit la valeur à 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 les thèmes à contraste élevé et l’exemple de style de contraste élevé XAML.

Voir aussi

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