Formato file tema

Questo documento illustra il formato dei file tema (tema). Un file con estensione theme è un file di testo .ini diviso in sezioni, che specificano gli elementi visivi visualizzati in un desktop di Windows. I nomi di sezione vengono racchiusi tra parentesi quadre ([]) nel file .ini.

Un nuovo formato di file, con estensione themepack, è stato introdotto con Windows 7 per consentire agli utenti di condividere i temi. I temi possono essere selezionati nella Pannello di controllo personalizzazione solo in Windows 7 Home Premium o versione successiva o solo in Windows Server 2008 R2 quando il componente Desktop è installato.

In questo articolo vengono illustrati gli argomenti seguenti.

• Creazione di un file di tema
• Descrizione di un file di tema
  • [Tema] Sezione
  • [sezione Pannello di controllo\Colors]
  • [Pannello di controllo\Cursors] Sezione
  • [sezione Pannello di controllo\Desktop]
  • [Presentazione] Sezione
  • [Metriche] Sezione
  • [Stili di visualizzazione] Sezione
  • [Suoni] e [AppEvents] Sezioni (suoni)
  • [Avvio] Sezione
  • [MasterThemeSelector] Sezione
• Esempio di un file di tema
• Installazione di file di tema
• Pacchetti di temi
• Argomenti correlati

Creazione di un file di tema

Un file con estensione theme consente di modificare l'aspetto di determinati elementi desktop. È possibile creare o modificare un file con estensione theme in due modi:

• Modificare le impostazioni di personalizzazione o visualizzazione in Pannello di controllo e salvare le impostazioni come file con estensione theme. Per istruzioni, vedere la Guida di Windows.
• Creare manualmente un file con estensione theme per un maggiore livello di controllo sui dettagli del tema.

Per rendere disponibile il tema ad altri utenti, è necessario fornire il file con estensione theme, nonché l'immagine di sfondo, lo screen saver e i file di icone. È possibile eseguire questa operazione con un pacchetto di temi.

Descrizione di un file di tema

I file di tema hanno una serie di sezioni obbligatorie e facoltative. Di seguito vengono descritte le sezioni dei file con estensione theme e vengono forniti esempi di come specificare le modifiche per i diversi elementi.

[Tema] Sezione

La sezione [Tema] identifica il nome del tema personalizzato e specifica il logo del marchio e le icone del desktop del tema.

La prima parte della sezione [Theme] contiene i due elementi seguenti:

Il resto della sezione [Tema] specifica le icone personalizzate per le funzionalità desktop, ad esempio Computer, Documenti, Rete e Cestino. Se non si specificano icone desktop personalizzate, il desktop visualizza le icone del desktop predefinite del sistema.

Di seguito sono riportati due esempi di come un file con estensione theme imposta l'icona Computer .

[CLSID\{20D04FE0-3AEA-1069-A2D8-08002B30309D}\DefaultIcon]
DefaultValue=%ProgramFiles%\Fabrikam\Computer.ico

; Computer
[CLSID\{20D04FE0-3AEA-1069-A2D8-08002B30309D}\DefaultIcon]
DefaultValue=%ProgramFiles%\Fabrikam\MyApp.exe,0

Di seguito sono riportati i valori per le icone del desktop predefinite in Windows 7.

; Computer
[CLSID\{20D04FE0-3AEA-1069-A2D8-08002B30309D}\DefaultIcon]
DefaultValue=%SystemRoot%\System32\imageres.dll,-109

; Documents
[CLSID\{59031A47-3F72-44A7-89C5-5595FE6B30EE}\DefaultIcon]
DefaultValue=%SystemRoot%\System32\shell32.dll,-235

; Network
[CLSID\{F02C1A0D-BE21-4350-88B0-7367FC96EF3C}\DefaultIcon]
DefaultValue=%SystemRoot%\System32\imageres.dll,-25

; Recycle Bin
[CLSID\{645FF040-5081-101B-9F08-00AA002F954E}\DefaultIcon]
Full=%SystemRoot%\System32\imageres.dll,-54
Empty=%SystemRoot%\System32\imageres.dll,-55

[sezione Pannello di controllo\Colors]

Il colore degli elementi, ad esempio barre di scorrimento, testo e pulsanti, è personalizzabile. Il file con estensione theme specifica i valori RGB da modificare per questi elementi. I valori sostituiscono i valori predefiniti dello stile di visualizzazione e vengono usati quando il tema è basato su temi windows classici, Windows 7 Basic o a contrasto elevato.

Di seguito è riportato un esempio di come vengono impostati i colori.

[Control Panel\Colors]
ActiveTitle=10 36 106
Background=166 202 240
Hilight=10 36 106
HilightText=255 255 255
TitleText=255 255 255
Window=255 255 255
WindowText=0 0 0
Scrollbar=212 208 200
InactiveTitle=128 128 128
Menu=212 208 200
WindowFrame=0 0 0
MenuText=0 0 0
ActiveBorder=212 208 200
InactiveBorder=212 208 200
AppWorkspace=128 128 128
ButtonFace=212 208 200
ButtonShadow=128 128 128
GrayText=128 128 128
ButtonText=0 0 0
InactiveTitleText=212 208 200
ButtonHilight=255 255 255
ButtonDkShadow=64 64 64
ButtonLight=212 208 200
InfoText=0 0 0
InfoWindow=255 255 225
GradientActiveTitle=166 202 240
GradientInactiveTitle=192 192 192

[Pannello di controllo\Cursors] Sezione

Un tema può anche modificare l'aspetto dei cursori. A tale scopo, creare .cur file per sostituire i cursori di Windows predefiniti. L'esempio seguente proviene da un file con estensione theme che definisce i cursori per un tema denominato Sports.

[Control Panel\Cursors]
Arrow=%SystemRoot%\sports_arrow.cur
Help=%SystemRoot%\sports_help.cur
AppStarting=%SystemRoot%\sports_wait.ani
Wait=%SystemRoot%\sports_busy.ani
NWPen=%SystemRoot%\sports_pen.cur
No=%SystemRoot%\sports_no.cur
SizeNS=%SystemRoot%\sports_size_ns.cur
SizeWE=%SystemRoot%\sports_size_we.cur
Crosshair=%SystemRoot%\sports_cross.cur
IBeam=%SystemRoot%\sports_beam.cur
SizeNWSE=%SystemRoot%\sports_size_nwse.cur
SizeNESW=%SystemRoot%\sports_size_nesw.cur
SizeAll=%SystemRoot%\sports_move.cur
UpArrow=%SystemRoot%\sports_up.cur
DefaultValue=Windows default

[sezione Pannello di controllo\Desktop]

È possibile creare uno sfondo desktop personalizzato e specificare un percorso del file di immagine. Nell'esempio seguente viene illustrato come modificare l'aspetto del desktop.

[Control Panel\Desktop]
Wallpaper=%WinDir%\web\wallpaper\Windows\img0.jpg
; The path to the wallpaper picture can point to a 
; .bmp, .gif, .jpg, .png, or .tif file.

TileWallpaper=0
; 0: The wallpaper picture should not be tiled 
; 1: The wallpaper picture should be tiled 

WallpaperStyle=2
; 0:  The image is centered if TileWallpaper=0 or tiled if TileWallpaper=1
; 2:  The image is stretched to fill the screen
; 6:  The image is resized to fit the screen while maintaining the aspect 
      ratio. (Windows 7 and later)
; 10: The image is resized and cropped to fill the screen while maintaining 
      the aspect ratio. (Windows 7 and later)

[Presentazione] Sezione

Windows 7 e versioni successive.

Lo sfondo del tema può essere una presentazione di diapositive archiviate localmente o di immagini gestite da un feed RSS. La sezione [Presentazione] del file contiene gli attributi seguenti:

Negli esempi seguenti viene illustrato come un file con estensione theme specifica la presentazione per includere un set di immagini archiviate in locale.

[Slideshow]
Interval=1800000
Shuffle=1
ImagesRootPath=%SystemRoot%\Web\Wallpaper

[Slideshow]
Interval=1800000
Shuffle=1
ImagesRootPath=%ProgramFiles%\fabrikam\wallpaper
Item0Path=%ProgramFiles%\fabrikam\wallpaper\ocean.jpg
Item1Path=%ProgramFiles%\fabrikam\wallpaper\mountain.jpg
Item2Path=%ProgramFiles%\fabrikam\wallpaper\river.jpg

L'esempio seguente è un modello per un file con estensione theme che crea una presentazione di sfondo desktop usando immagini da un feed RSS. Seguire questa procedura per personalizzare il modello:

1. Copiare l'esempio seguente e incollarlo in un editor di testo.
2. Sostituire {themename} con il nome che si desidera visualizzare nella raccolta temi Pannello di controllo personalizzazione.
3. Sostituire {rssfeedurl} con il percorso completo di un feed RSS compatibile.
4. Salvare le modifiche come file con l'estensione ".theme".

[Theme]
DisplayName={themename}

[Slideshow]
Interval=1800000
Shuffle=1
RssFeed={rssfeedurl}

[Control Panel\Desktop]
TileWallpaper=0
WallpaperStyle=10
Pattern=

[Control Panel\Cursors]
AppStarting=%SystemRoot%\cursors\aero_working.ani
Arrow=%SystemRoot%\cursors\aero_arrow.cur
Crosshair=
Hand=%SystemRoot%\cursors\aero_link.cur
Help=%SystemRoot%\cursors\aero_helpsel.cur
IBeam=
No=%SystemRoot%\cursors\aero_unavail.cur
NWPen=%SystemRoot%\cursors\aero_pen.cur
SizeAll=%SystemRoot%\cursors\aero_move.cur
SizeNESW=%SystemRoot%\cursors\aero_nesw.cur
SizeNS=%SystemRoot%\cursors\aero_ns.cur
SizeNWSE=%SystemRoot%\cursors\aero_nwse.cur
SizeWE=%SystemRoot%\cursors\aero_ew.cur
UpArrow=%SystemRoot%\cursors\aero_up.cur
Wait=%SystemRoot%\cursors\aero_busy.ani
DefaultValue=Windows Aero
Link=

[VisualStyles]
Path=%SystemRoot%\resources\themes\Aero\Aero.msstyles
ColorStyle=NormalColor
Size=NormalSize
ColorizationColor=0X6B74B8FC
Transparency=1

[MasterThemeSelector]
MTSM=DABJDKT

[Metriche] Sezione

È possibile specificare le metriche di sistema in un file con estensione theme. Le metriche di sistema sono le dimensioni di vari elementi di visualizzazione, ad esempio la larghezza del bordo della finestra, l'altezza dell'icona o la larghezza della barra di scorrimento. I valori NonclientMetrics e IconMetrics sono strutture binarie definite da NONCLIENTMETRICS e ICONMETRICS in winuser.h. Di seguito è riportato un esempio di come modificare le metriche di sistema.

[Control Panel\Desktop\WindowMetrics]

[Metrics]
IconMetrics=76 0 0 0 139 0 0 0 139 0 0 0 1 0 0 0 245
255 255 255 0 0 0 0 0 0 0 0 0 0 0 0 144 1 0 0 0 0 0 0
0 0 0 0 84 97 104 111 109 97 0 119 0 0 7 0 0 0 0 0 216
31 7 0 28 52 1 1 216 31 7 0 176 36 1 1 
NonclientMetrics=84 1 0 0 1 0 0 0 16 0 0 0 16 0 0 0 18
0 0 0 18 0 0 0 245 255 255 255 0 0 0 0 0 0 0 0 0 0 0 0
188 2 0 0 0 0 0 0 0 0 0 0 84 97 104 111 109 97 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 12 0 0 0
15 0 0 0 245 255 255 255 0 0 0 0 0 0 0 0 0 0 0 0 188 2
0 0 0 0 0 0 0 0 0 0 84 97 104 111 109 97 0 0 80 37 11
0 0 0 0 0 140 221 6 0 227 115 247 119 2 40 11 0 7 0 0
0 18 0 0 0 18 0 0 0 245 255 255 255 0 0 0 0 0 0 0 0 0
0 0 0 144 1 0 0 0 0 0 0 0 0 0 0 84 97 104 111 109 97 0
0 0 0 0 0 60 222 6 0 50 71 252 119 120 1 7 0 76 73 252
119 8 6 7 0 245 255 255 255 0 0 0 0 0 0 0 0 0 0 0 0
144 1 0 0 0 0 0 0 0 0 0 0 84 97 104 111 109 97 0 119 0
0 7 0 120 1 7 0 120 1 7 0 40 37 11 0 120 1 7 0 120 1 7
0 245 255 255 255 0 0 0 0 0 0 0 0 0 0 0 0 144 1 0 0 0
0 0 0 0 0 0 0 84 97 104 111 109 97 0 0 92 1 0 0 136 4
0 0 40 37 1 1 0 0 7 0 184 221 6 0 46 75 232 119 

[Stili di visualizzazione] Sezione

È possibile fornire informazioni specifiche relative alle dimensioni e al colore degli elementi desktop nei file con estensione msstyles. Le sezioni di colore e dimensioni dei file con estensione theme possono essere sostituite da file con estensione msstyles che consentono di modificare gli elementi desktop in modo più dettagliato. Questi file vengono specificati nella sezione stili di visualizzazione di un file con estensione theme. Di seguito è riportato un esempio di sezione stili di visualizzazione.

[VisualStyles]
Path=%ResourceDir%\Themes\Aero\Aero.msstyles
ColorStyle=NormalColor
Size=NormalSize

L'aggiunta di un elemento Path a un file con estensione msstyles è facoltativa. Se si specifica un percorso, è necessario rimuovere le metriche e le sezioni di colore dal file con estensione theme. Quando queste sezioni vengono rimosse, i colori, i tipi di carattere e le dimensioni per un tema provengono dal file msstyles e corrispondono alla finalità dell'autore msstyles. Se non si rimuove la metrica e le sezioni di colore, windows o applicazioni possono avere problemi di disegno.

Windows Vista/Windows 7: quando il percorso punta a Aero.msstyles, è possibile specificare il colore di vetro desiderato, come illustrato nell'esempio seguente.

Windows 7: quando il percorso punta a Aero.msstyles, è anche possibile specificare il valore di Trasparenza desiderato, come illustrato nell'esempio seguente.

[VisualStyles]
Path=%SystemRoot%\resources\Themes\Aero\Aero.msstyles
ColorStyle=NormalColor
Size=NormalSize
ColorizationColor=0X7298844C
Transparency=1

Se i valori ColorizationColor e Transparency corrispondono esattamente a un colore di sistema, il Pannello di controllo personalizzazione visualizza il nome di sistema per il colore. In caso contrario, il colore viene etichettato come "Personalizzato".

Di seguito viene illustrata una sezione VisualStyles per il tema Windows 7 Basic.

[VisualStyles]
Path=%ResourceDir%\Themes\Aero\Aero.msstyles
Composition=0
ColorStyle=NormalColor
Size=NormalSize
ColorizationColor=0x6B74B8FC
Transparency=1

Di seguito è illustrata una sezione VisualStyles per il tema classico di Windows.

[VisualStyles]
Path=
ColorStyle=@themeui.dll,-854
Size=@themeui.dll,-2019
Transparency=0

Di seguito viene illustrata una sezione VisualStyles per un tema Nero a contrasto elevato.

[VisualStyles]
Path=
ColorStyle=@themeui.dll,-852
Size=@themeui.dll,-2019
Transparency=0

[Suoni] e [AppEvents] Sezioni (suoni)

L'utente può selezionare l'icona Suono in Pannello di controllo per associare suoni agli eventi che si verificano nelle applicazioni. Ad esempio, un file .wav può essere riprodotto all'apertura di un'applicazione. Un file con estensione theme può specificare .wav file per sostituire quelli predefiniti. L'esempio seguente illustra come farlo.

[AppEvents\Schemes\Apps\.Default\SystemExclamation]
DefaultValue=%WinDir%\media\chord.wav

[AppEvents\Schemes\Apps\.Default\SystemExit]
DefaultValue=%WinDir%\media\tada.wav

[AppEvents\Schemes\Apps\.Default\SystemHand]
DefaultValue=%WinDir%\media\chord.wav

[AppEvents\Schemes\Apps\.Default\SystemQuestion]
DefaultValue=%WinDir%\media\chord.wav

[AppEvents\Schemes\Apps\.Default\SystemStart]
DefaultValue=%WinDir%\media\The Microsoft Sound.wav

[AppEvents\Schemes\Apps\Explorer\EmptyRecycleBin]
DefaultValue=%WinDir%\media\ding.wav

Windows 7 e versioni successive: è possibile specificare un nome di combinazione audio anziché elencare ogni suono separatamente.

[Sounds]
; "Quirky" sound scheme
SchemeName=@%SystemRoot%\System32\mmres.dll,-819

Il valore SchemeName specifica il nome della combinazione audio o il nome della combinazione di suoni localizzata, come illustrato nell'esempio precedente.

[Avvio] Sezione

Nel file con estensione theme è possibile specificare lo screen saver per Windows da usare. Nell'esempio riportato di seguito viene illustrata questa situazione.

[boot]
SCRNSAVE.EXE=%WinDir%\System32\bubbles.scr

[MasterThemeSelector] Sezione

La sezione del selettore del tema master del file con estensione theme deve essere sempre inclusa come tag che indica che il file è valido. Non è disponibile una scelta di valori per questo parametro. Di seguito viene illustrato quanto segue.

[MasterThemeSelector]
MTSM=DABJDKT

Esempio di un file di tema

L'esempio seguente mostra un file con estensione theme completo.

[Theme]
DisplayName=My Current Theme
BrandImage=c:\Fabrikam\brand.png

; Computer
[CLSID\{20D04FE0-3AEA-1069-A2D8-08002B30309D}\DefaultIcon]
DefaultValue=%SystemRoot%\System32\imageres.dll,-109

; Documents
[CLSID\{59031A47-3F72-44A7-89C5-5595FE6B30EE}\DefaultIcon]
DefaultValue=%SystemRoot%\System32\shell32.dll,-235

; Network
[CLSID\{F02C1A0D-BE21-4350-88B0-7367FC96EF3C}\DefaultIcon]
DefaultValue=%SystemRoot%\System32\imageres.dll,-25

; Recycle Bin
[CLSID\{645FF040-5081-101B-9F08-00AA002F954E}\DefaultIcon]
Full=%SystemRoot%\System32\imageres.dll,-54
Empty=%SystemRoot%\System32\imageres.dll,-55

[Control Panel\Cursors]
Arrow=
Help=
AppStarting=
Wait=
NWPen=
No=
SizeNS=
SizeWE=
Crosshair=
IBeam=
SizeNWSE=
SizeNESW=
SizeAll=
UpArrow=
DefaultValue=Windows default

[Control Panel\Desktop]
Wallpaper=%ProgramFiles%\fabrikam\wallpaper\ocean.jpg
TileWallpaper=0
WallpaperStyle=2
Pattern=
ScreenSaveActive=0

[AppEvents\Schemes\Apps\.Default\.Default]
DefaultValue=%WinDir%\media\ding.wav

[AppEvents\Schemes\Apps\.Default\AppGPFault]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\Maximize]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\MenuCommand]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\MenuPopup]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\Minimize]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\Open]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\RestoreDown]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\RestoreUp]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\RingIn]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\Ringout]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\SystemAsterisk]
DefaultValue=%WinDir%\media\chord.wav

[AppEvents\Schemes\Apps\.Default\SystemDefault]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\SystemExclamation]
DefaultValue=%WinDir%\media\chord.wav

[AppEvents\Schemes\Apps\.Default\SystemExit]
DefaultValue=

[AppEvents\Schemes\Apps\.Default\SystemHand]
DefaultValue=%WinDir%\media\chord.wav

[AppEvents\Schemes\Apps\.Default\SystemQuestion]
DefaultValue=%WinDir%\media\chord.wav

[AppEvents\Schemes\Apps\.Default\SystemStart]
DefaultValue=

[AppEvents\Schemes\Apps\Explorer\EmptyRecycleBin]
DefaultValue=%WinDir%\media\ding.wav

[AppEvents\Schemes\Apps\.Default\Close]
DefaultValue=

[Slideshow]
Interval=1800000
Shuffle=1
ImagesRootPath=%ProgramFiles%\fabrikam\wallpaper
Item0Path=%ProgramFiles%\fabrikam\wallpaper\ocean.jpg
Item1Path=%ProgramFiles%\fabrikam\wallpaper\mountain.jpg
Item2Path=%ProgramFiles%\fabrikam\wallpaper\river.jpg

[boot]
SCRNSAVE.EXE=%WinDir%\System32\bubbles.scr

[MasterThemeSelector]
MTSM=DABJDKT
ThemeColorBPP=4

[VisualStyles]
Path=%SystemRoot%\resources\Themes\Aero\Aero.msstyles
ColorStyle=NormalColor
Size=NormalSize
ColorizationColor=0x856E3BA1
Transparency=1

Installazione di file di tema

Quando Windows viene inizializzato, il sistema operativo enumera le sottodirectory di primo livello di %WinDir%\Resources\ per identificare i temi disponibili. I file di tema predefiniti del sistema si trovano in %WinDir%\Resources\Themes. I file del tema utente vengono archiviati in %LOCALAPPDATA%\Microsoft\Windows\Themes (o %SystemDrive%\Users\<username>\AppData\Local\Microsoft\Windows\Themes).

Un file con estensione theme ha associazioni di file; pertanto, le applicazioni del programma di installazione del tema possono chiamare ShellExecute in un file con estensione theme per aprire la finestra Personalizzazione in Pannello di controllo al tema specificato.

Pacchetti di temi

Windows 7 e versioni successive. Un pacchetto di temi è un file di .cab che contiene non solo il file con estensione theme, ma anche i file necessari per implementare il tema in un altro computer, ad esempio file audio e immagini. Gli utenti possono creare pacchetti di tema tramite il Pannello di controllo di personalizzazione.

I tipi di file supportati includono quanto segue:

Gli asset come i suoni devono essere posizionati alla radice del .cab e a cui si fa riferimento direttamente nei file con estensione theme. Ad esempio, se si dispone di un file denominato Alert.wav nella radice del .cab, è possibile usarlo nello schema audio:

[AppEvents\Schemes\Apps\.Default\SystemAsterisk]
DefaultValue=Alert.wav

Le immagini dello sfondo devono essere gestite in modo diverso. Devono estrarre in una DesktopBackground\ cartella e fare riferimento ai file con estensione theme da tale sottodirectory. Ad esempio, se si dispone di uno sfondo denominato BestDesktop.jpg, assicurarsi che estraa in DesktopBackground\e farvi riferimento nel .cab come segue:

[Control Panel\Desktop]
; Note the extra `DesktopBackground\` directory.
Wallpaper=DesktopBackground\BestDesktop.jpg

Argomenti correlati

Panoramica degli stili di visualizzazione