FrameworkElement.RequestedTheme Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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.