FrameworkElement.RequestedTheme Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene o imposta il tema dell'interfaccia utente utilizzato dall'UIElement (e dai relativi elementi figlio) per la determinazione delle risorse. Il tema dell'interfaccia utente specificato con RequestedTheme può eseguire l'override del livello di app RequestedTheme.

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à

ElementTheme

Valore dell'enumerazione, ad esempio Light.

Commenti

La modifica del valore modifica in modo efficace il RequestedTheme comportamento di ricerca delle risorse per il modello predefinito dell'elemento. Se si modifica il valore Light in, 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à per qualsiasi elemento specificato in fase di RequestedTheme esecuzione. In contrasto con la proprietà Application.RequestedTheme , che genera un'eccezione se si tenta di impostarlo durante l'esecuzione dell'app.

Il RequestedTheme valore impostato su un FrameworkElement erediterà gli elementi annidati all'interno dell'elemento in cui RequestedTheme è impostata, ma tale ereditarietà può essere sostituita in modo esplicito impostando RequestedTheme di nuovo. In questo esempio XAML, ad esempio, StackPanel padre imposta il tema su Lighte 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 RequestedTheme proprietà 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.

Nota

In Windows, impostando RequestedTheme su ElementTheme.Default , verrà sempre restituito il tema "Dark".

Vedi anche

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