FrameworkElement.RequestedTheme Property

Ottiene o imposta il tema dell'interfaccia utente utilizzato dall'oggetto UIElement (e i relativi elementi figlio) per determinare le risorse. Il tema dell'interfaccia utente specificato con RequestedTheme può eseguire l'override dell'elemento RequestedThemedi livello app.

Sintassi


public ElementTheme RequestedTheme { get; set; }


<uiElement RequestedTheme="elementThemeMemberName" .../>

Valore della proprietà

Type: ElementTheme

Valore dell'enumerazione, ad esempio Light.

Note

La modifica del valore della proprietà RequestedTheme è in realtà la modifica del comportamento di ricerca delle risorse per il modello predefinito dell'elemento. Se si modifica il valore in Light il modello utilizza i valori da ResourceDictionary codificato come "Luce" nella raccolta ThemeDictionaries. L'impostazione diversa del tema dell'interfaccia utente rispetto al tema dell'applicazione è spesso utile per i controlli mobili come i menu e i riquadri a comparsa.

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

Il valore RequestedTheme impostato su un FrameworkElement erediterà tutti gli elementi nidificati all'interno dell'elemento in cui è impostato RequestedTheme, ma questa ereditarietà può essere sottoposta a override di nuovo mediante un'impostazione RequestedTheme esplicita. Ad esempio, nell'esempio di XAML, il padre StackPanel imposta il tema su Light e il valore eredita il primo elemento figlio TextBlock, ma non il secondo TextBlock perché sta impostando il valore su Dark anziché


<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à Contrasto elevato. Vedere Supporto di temi a contrasto elevato e Esempio di stile di contrasto elevato XAML.

Requisiti

Client supportato minimo

Windows 8.1

Server supportato minimo

Windows Server 2012 R2

Spazio dei nomi

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadati

Windows.winmd

Vedere anche

FrameworkElement
Application.RequestedTheme
Esempio di tema richiesto da XAML
Estensione del markup ThemeResource

 

 

Mostra:
© 2015 Microsoft