Formato de arquivo de tema

Este documento discute o formato de arquivos de tema (.theme). Um arquivo .theme é um arquivo de texto .ini dividido em seções, que especificam elementos visuais que aparecem em uma área de trabalho do Windows. Os nomes de seção são colocados entre colchetes ([]) no arquivo .ini.

Um novo formato de arquivo, .themepack, foi introduzido com o Windows 7 para ajudar os usuários a compartilhar temas. Os temas podem ser selecionados no Painel de Controle de Personalização somente no Windows 7 Home Premium ou superior, ou somente no Windows Server 2008 R2 quando o componente Área de Trabalho estiver instalado.

Os tópicos a seguir são discutidos neste artigo.

• Criando um arquivo de tema
• Descrição de um arquivo de tema
  • [Tema] Secção
  • [Painel de Controle\Cores] Secção
  • [Painel de Controle\Cursores] Secção
  • [Painel de Controle\Área de Trabalho] Secção
  • [Apresentação de slides] Secção
  • [Métricas] Secção
  • [Estilos visuais] Secção
  • Seções [Sons] e [AppEvents] (Sons)
  • [Inicialização] Secção
  • [MasterThemeSelector] Secção
• Exemplo de um arquivo de tema
• Instalando arquivos de tema
• Pacotes de Temas
• Tópicos relacionados

Criando um arquivo de tema

Um arquivo .theme permite que você altere a aparência de determinados elementos da área de trabalho. Você pode criar ou modificar um arquivo .theme de duas maneiras:

• Modifique as configurações de personalização ou exibição no Painel de Controle e salve as configurações como um arquivo .theme. Consulte a Ajuda do Windows para obter instruções.
• Crie um arquivo .theme manualmente para um maior nível de controle sobre os detalhes do seu tema.

Para disponibilizar seu tema para outros usuários, você deve fornecer o arquivo .theme, bem como os arquivos de imagem de plano de fundo, proteção de tela e ícones. Você pode fazer isso com um pacote de temas.

Descrição de um arquivo de tema

Os arquivos de tema têm várias seções obrigatórias e opcionais. A seguir descrevem as seções de arquivos .theme e fornecem exemplos de como especificar alterações para os diferentes elementos.

[Tema] Secção

A secção [Tema] identifica o nome do seu tema personalizado e especifica o logótipo da marca e os ícones do ambiente de trabalho do seu tema.

A primeira parte da seção [Tema] contém os dois elementos a seguir:

O restante da seção [Tema] especifica ícones personalizados para recursos da área de trabalho, como Computador, Meus Documentos, Rede e Lixeira. Se você não especificar ícones personalizados da área de trabalho, a área de trabalho exibirá os ícones da área de trabalho padrão do sistema.

A seguir estão dois exemplos de como um arquivo .theme define o ícone Computador .

[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

A seguir estão os valores para os ícones da área de trabalho padrão no 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

[Painel de Controle\Cores] Secção

A cor dos elementos, como barras de rolagem, texto e botões, é personalizável. O arquivo .theme especifica os valores RGB a serem alterados para esses elementos. Os valores substituem os valores padrão do estilo visual e são usados quando o tema é baseado em temas do Windows Classic, Windows 7 Basic ou High Contrast.

A seguir está um exemplo de como as cores são definidas.

[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

[Painel de Controle\Cursores] Secção

Um tema também pode alterar a aparência dos cursores. Para fazer isso, você cria arquivos .cur para substituir os cursores padrão do Windows. O exemplo a seguir é de um arquivo .theme que define os cursores para um tema chamado 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

[Painel de Controle\Área de Trabalho] Secção

Você pode criar um plano de fundo da área de trabalho personalizado e especificar um caminho para o arquivo de imagem. O exemplo a seguir mostra como modificar a aparência da área de trabalho.

[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)

[Apresentação de slides] Secção

Windows 7 e posterior.

O plano de fundo do seu tema pode ser uma apresentação de slides de imagens armazenadas localmente ou de imagens servidas por um feed RSS. A seção [Slideshow] do arquivo contém os seguintes atributos:

Os exemplos a seguir mostram como um arquivo .theme especifica a apresentação de slides para incluir um conjunto de imagens armazenadas localmente.

[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

O exemplo a seguir é um modelo para um arquivo .theme que cria uma apresentação de slides de plano de fundo da área de trabalho usando imagens de um feed RSS. Siga estas etapas para personalizar o modelo:

1. Copie o exemplo a seguir e cole-o em um editor de texto.
2. Substitua {themename} pelo nome que você deseja que apareça na galeria de temas do Painel de Controle de Personalização.
3. Substitua {rssfeedurl} pelo caminho completo para um RSS feed compatível.
4. Salve as alterações como um arquivo com a extensão ".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

[Métricas] Secção

Você pode especificar métricas do sistema em um arquivo .theme. As métricas do sistema são as dimensões de vários elementos de exibição, como a largura da borda da janela, a altura do ícone ou a largura da barra de rolagem. Os valores NonclientMetrics e IconMetrics são estruturas binárias definidas por NONCLIENTMETRICS e ICONMETRICS em winuser.h. Veja a seguir um exemplo de como alterar as métricas do 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 

[Estilos visuais] Secção

Você pode fornecer informações específicas sobre o tamanho e a cor dos elementos da área de trabalho em arquivos .msstyles. As seções de cor e tamanho dos arquivos .theme podem ser substituídas por arquivos .msstyles que permitem modificar os elementos da área de trabalho com mais detalhes. Esses arquivos são especificados na seção de estilos visuais de um arquivo .theme. Veja a seguir um exemplo de uma seção de estilos visuais.

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

Adicionar um elemento Path a um arquivo .msstyles é opcional. Se você fornecer um caminho, deverá remover as seções de métricas e cores do arquivo .theme. Quando essas seções são removidas, as cores, fontes e tamanhos de um tema vêm do arquivo .msstyles e correspondem à intenção do autor .msstyles. A falha ao remover as seções de métrica e cor pode causar problemas de desenho no Windows ou nos aplicativos.

Windows Vista / Windows 7: Quando o caminho aponta para Aero.msstyles, você pode especificar a cor de vidro desejada, conforme mostrado no exemplo a seguir.

Windows 7: Quando o caminho aponta para Aero.msstyles, você também pode especificar o valor Transparency desejado, conforme mostrado no exemplo a seguir.

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

Se os valores ColorizationColor e Transparency corresponderem exatamente a uma cor do sistema, o Painel de Controle de Personalização exibirá o nome do sistema para a cor. Caso contrário, a cor será rotulada como "Personalizada".

A seguir é mostrada uma seção VisualStyles para o tema Windows 7 Basic.

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

A seguir é mostrada uma seção VisualStyles para o tema Clássico do Windows.

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

A seguir é mostrada uma seção VisualStyles para um tema Preto de Alto Contraste.

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

Seções [Sons] e [AppEvents] (Sons)

O usuário pode selecionar o ícone Som no Painel de Controle para associar sons a eventos que ocorrem em aplicativos. Por exemplo, um arquivo .wav pode ser reproduzido quando um aplicativo é aberto. Um arquivo .theme pode especificar arquivos .wav para substituir os padrão. O exemplo a seguir mostra como fazer isso.

[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 posterior: um nome de esquema de som pode ser especificado em vez de listar cada som separadamente.

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

O valor SchemeName especifica o nome do esquema de som ou o nome do esquema de som localizado, conforme mostrado no exemplo acima.

[Inicialização] Secção

No arquivo .theme, você pode especificar a proteção de tela para o Windows usar. O exemplo a seguir mostra a isso.

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

[MasterThemeSelector] Secção

A seção seletor de tema mestre do arquivo .theme sempre deve ser incluída como uma marca que indica que o arquivo é válido. Você não tem uma escolha de valores para esse parâmetro. O seguinte mostra isso.

[MasterThemeSelector]
MTSM=DABJDKT

Exemplo de um arquivo de tema

O exemplo a seguir mostra um arquivo .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

Instalando arquivos de tema

Quando o Windows é inicializado, o sistema operacional enumera os subdiretórios de primeiro nível de %WinDir%\Resources\ para identificar temas disponíveis. Os arquivos de tema padrão do sistema estão localizados em %WinDir%\Resources\Themes. Os arquivos de tema do usuário são armazenados em %LOCALAPPDATA%\Microsoft\Windows\Themes (ou %SystemDrive%\Users\username>\AppData\Local\Microsoft\Windows\<Themes).

Um arquivo .theme tem associações de arquivo; portanto, os aplicativos de instalação de tema podem chamar ShellExecute em um arquivo .theme para abrir a janela Personalização no Painel de Controle para o tema especificado.

Pacotes de Temas

Windows 7 e posterior. Um pacote de tema é um arquivo .cab que contém não apenas o arquivo .theme, mas também os arquivos necessários para implementar o tema em outro computador, como arquivos de som e imagens. Os usuários podem criar pacotes de temas por meio do Painel de Controle de Personalização.

Os tipos de arquivo suportados incluem o seguinte:

Ativos como sons devem ser colocados na raiz do .cab e referenciados em arquivos .theme diretamente. Por exemplo, se você tiver um arquivo chamado Alert.wav na raiz do seu .cab, poderá usá-lo em seu esquema de som:

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

As imagens de papel de parede devem ser tratadas de forma diferente. Eles devem extrair para uma DesktopBackground\ pasta e ser referenciados em arquivos .theme por esse subdiretório. Por exemplo, se você tiver um papel de parede chamado BestDesktop.jpg, certifique-se de que ele extraia para DesktopBackground\, e faça referência a ele em seu .cab da seguinte forma:

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

Tópicos relacionados

Visão geral de estilos visuais