FrameworkElement.RequestedTheme Proprietà

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

Valore della proprietà

Valore dell'enumerazione, ad esempio Light.

Commenti

La modifica del valore RequestedTheme modifica in modo efficace il comportamento di ricerca della risorsa per il modello predefinito dell'elemento. Se si modifica il valore in Light , il modello usa i valori dell'oggetto ResourceDictionary chiave come "Light" nell'insieme ThemeDictionaries . L'impostazione del tema dell'interfaccia utente in modo diverso dal tema dell'app è spesso appropriata per i controlli mobili, ad esempio i menu e i riquadri a comparsa.

È possibile modificare il valore della proprietà RequestedTheme per qualsiasi elemento specificato in fase di esecuzione. In contrasto con la proprietà Application.RequestedTheme , che genera un'eccezione se si tenta di impostarlo durante l'esecuzione dell'app.

Il valore RequestedTheme impostato in un FrameworkElement erediterà tutti gli elementi annidati all'interno dell'elemento in cui RequestedTheme è impostato, ma l'ereditarietà può essere sostituita in modo esplicito impostando RequestedTheme. In questo esempio XAML, ad esempio, StackPanel padre imposta il tema su Light e tale valore eredita al primo elemento figlio TextBlock, ma non al secondo TextBlock perché imposta il valore su Dark.

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

La proprietà RequestedTheme viene ignorata se l'utente è in esecuzione in modalità a contrasto elevato. Vedere Temi a contrasto elevato e esempio di stile a contrasto elevato XAML.

Si applica a

Vedi anche

• RequestedTheme
• Esempio di tema richiesto da XAML
• Estensione di markup {ThemeResource}