Windows Dev Center

Application.RequestedTheme Property

Ottiene o imposta un valore che determina la preferenza chiaro-scuro per il tema globale di un'applicazione.

Sintassi


public ApplicationTheme RequestedTheme { get; set; }


<application RequestedTheme="applicationThemeMemberName" .../>

Valore della proprietà

Type: ApplicationTheme

Valore dell'enumerazione.

Note

Le applicazioni Windows Store supportano due temi incorporati, "chiaro" e "scuro". Per impostazione predefinita, l'applicazione viene eseguita con il tema "Scuro" (nel file themeresources.xaml, il nome della chiave per le risorse "Scuro" è "Impostazione predefinita"). È possibile impostare la proprietà RequestedTheme dell'applicazione per specificare quale tema utilizzare.

Il tema può essere impostato solo quando l'applicazione viene avviata, non mentre è in esecuzione. Se si tenta di impostare RequestedTheme mentre l'applicazione è in fase di esecuzione, viene generata un'eccezione (NotSupportedException per il codice Microsoft .NET). Se si fornisce all'utente la possibilità di selezionare un tema che fa parte dell'interfaccia utente di un'applicazione, è necessario salvare l'impostazione nei dati dell'applicazione e applicarla quando l'applicazione viene riavviata.

Esiste anche un tema "HighContrast" che utilizza i valori di sistema, ma le applicazioni e il codice dell'applicazione utilizzano una tecnica diversa per il passaggio dell'applicazione al contrasto elevato. 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.

Anche se l'app non può passare ad altri temi in fase di esecuzione, tale operazione può essere effettuata dall'utente (a partire da Windows 8.1). Ad esempio, un utente potrebbe abilitare un tema a contrasto elevato mentre l'applicazione è in esecuzione, utilizzando il tasto di scelta rapido Alt+Shift+PrtScn. In questo caso, il sistema di risorse XAML ricalcolerà i valori delle risorse per qualsiasi utilizzo di ThemeResource. Le risorse del tema appropriate come, ad esempio, i colori e pennelli utilizzano valori appropriati per il tema corrente, anche se in origine tale tema non è stato richiesto dall'applicazione.

Un'app può modificare i valori specifici del tema in fase di esecuzione dopo l'applicazione di Application.RequestedTheme, se utilizza la proprietà FrameworkElement.RequestedTheme e imposta i valori sugli elementi specifici dell'interfaccia utente.

Le risorse che sono quelle specifiche del tema vengono in genere definite in un dizionario risorse separato in XAML. Questo dizionario risorse deriva dalla proprietà ThemeDictionaries del ResourceDictionary primario utilizzato per i modelli di controllo. Il dizionario predefinito delle risorse di sistema per le risorse specifiche del tema è denominato ThemeResources.xaml. Individuare il file nel percorso \include\winrt\xaml\design nel percorso di installazione di Windows Software Development Kit (SDK) per Windows 8.

Requisiti

Client supportato minimo

Windows 8

Server supportato minimo

Windows Server 2012

Spazio dei nomi

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

Metadati

Windows.winmd

Vedere anche

Application
FrameworkElement.RequestedTheme
Esempio di tema richiesto da XAML
Supporto di temi a contrasto elevato

 

 

Mostra:
© 2015 Microsoft