FrameworkElement.RequestedTheme Proprietà

Definizione

Spazio dei nomi:

Windows.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 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.

Nota

In Windows, impostando RequestedTheme su ElementTheme.Default , verrà sempre restituito il tema "Dark". In Windows Phone, usando il valore ElementTheme.Default verrà visualizzata una query per il tema di sistema, come impostato dall'utente.

Vedi anche

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