Формат файла темы

В этом документе рассматривается формат файлов Theme (.theme). Файл темы — это текстовый файл .ini, разделенный на разделы, которые указывают визуальные элементы, отображаемые на рабочем столе Windows. Имена разделов упаковываются в квадратные скобки ([]) в файле .ini.

В Windows 7 появился новый формат файла,themepack, помогающий пользователям предоставлять общий доступ к темам. Темы можно выбрать на панели управления персонализацией только в Windows 7 Home Premium или более поздней версии или только в Windows Server 2008 R2 при установке компонента Desktop.

В этой статье рассматриваются следующие разделы.

• создание файла темы
• описание файла темы
  • [Тема] Раздел
  • [Панель управления\Цвета] Раздел
  • [Панель управления\Курсоры] Раздел
  • [Панель управления\Рабочий стол] Раздел
  • [Слайд-шоу] Раздел
  • [Метрики] Раздел
  • [Визуальные стили] Раздел
  • Разделы [Sounds] и [AppEvents] (Звуки)
  • [Boot] Раздел
  • [MasterThemeSelector] Раздел
• пример файла темы
• установка файлов тем
• Пакеты Тем
• связанные темы

Создание файла темы

Файл темы позволяет изменить внешний вид некоторых элементов рабочего стола. Вы можете создать или изменить файл темы двумя способами:

• Измените параметры персонализации или отображения на панели управления и сохраните параметры в виде файла темы. Инструкции см. в справке Windows.
• Создайте файл темы вручную для более высокого уровня управления сведениями о теме.

Чтобы сделать тему доступной для других пользователей, необходимо предоставить файл темы, а также фоновое изображение, заставку экрана и файлы с значками. Это можно сделать с помощью пакета тем .

Описание файла темы

Файлы темы имеют ряд обязательных и необязательных разделов. Ниже описаны разделы файлов .theme и приведены примеры, как задавать изменения для различных элементов.

[Тема] Секция

Раздел [Тема] указывает название вашей пользовательской темы и задаёт логотип бренда и значки на рабочем столе.

Первая часть раздела [Тема] содержит следующие два элемента:

В остальной части раздела [Тема] указаны пользовательские значки для классических функций, таких как компьютер, мои документы, сеть и корзина. Если не указывать настраиваемые значки рабочего стола, на рабочем столе отображаются системные значки рабочего стола по умолчанию.

Ниже приведены два примера того, как файл темы задает значок компьютера.

[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

Ниже приведены значения значков рабочего стола по умолчанию в 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

[Панель управления\Цвета] Секция

Цвет элементов, таких как полосы прокрутки, текст и кнопки, можно настроить. Файл темы указывает значения RGB, которые нужно изменить для этих элементов. Значения переопределяют значения по умолчанию визуального стиля и используются, если ваша тема основана на классической теме Windows, Windows 7 Basic или темах высокой контрастности.

Ниже приведен пример настройки цветов.

[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

[Панель управления\Курсоры] Секция

Тема также может изменить внешний вид курсоров. Для этого необходимо создать .cur файлы для замены курсоров Windows по умолчанию. В следующем примере представлен файл темы .theme, который определяет курсоры для темы с именем 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

[Панель управления\Рабочий стол] Секция

Вы можете создать пользовательский фон рабочего стола и указать путь к файлу изображения. В следующем примере показано, как изменить внешний вид рабочего стола.

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

[Слайд-шоу] Раздел

Windows 7 и новее.

Фон темы может быть слайд-шоу любого из изображений, хранящихся локально или образов, обслуживаемых RSS-каналом. Раздел [Слайд-шоу] файла содержит следующие атрибуты:

В следующих примерах показано, как файл темы указывает слайд-шоу для включения набора изображений, хранящихся локально.

[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

В следующем примере представлен шаблон для файла темы, создающего фоновый слайд-шоу рабочего стола с помощью изображений из RSS-канала. Выполните следующие действия, чтобы настроить шаблон:

1. Скопируйте следующий пример и вставьте его в текстовый редактор.
2. Замените {themename} именем, которое вы хотите отображать в коллекции тем панели управления персонализацией.
3. Замените {rssfeedurl} на полный путь к совместимому RSS-каналу.
4. Сохраните изменения в виде файла с расширением ".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

[Метрики] Секция

Системные метрики можно указать в файле темы. Системные метрики — это измерения различных элементов отображения, таких как ширина границы окна, высота значка или ширина полосы прокрутки. Значения NonclientMetrics и IconMetrics — это двоичные структуры, определенные nonCLIENTMETRICS и ICONMETRICS в winuser.h. Ниже приведен пример изменения системных метрик.

[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 

[Визуальные стили] Секция

Вы можете указать конкретные сведения о размере и цвете элементов рабочего стола в файлах .msstyles. Разделы цвета и размера файлов темы можно заменить msstyles-файлами, которые позволяют изменять элементы рабочего стола более подробно. Эти файлы указаны в разделе визуальных стилей файла темы. Ниже приведен пример раздела визуальных стилей.

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

Добавление элемента Path в msstyles-файл является необязательным. Если вы предоставляете путь, следует удалить метрики и цветовые разделы из файла темы.theme. При удалении этих разделов цвета, шрифты и размеры темы приходят из msstyles-файла и соответствуют намерению автора msstyles. Неудаление метрик и цветовых разделов может привести к возникновению проблем с отображением в Windows или приложениях.

Windows Vista или Windows 7: Если путь указывает на Aero.msstyles, можно указать нужный цвет стекла, как показано в следующем примере.

Windows 7: Если путь указывает на Aero.msstyles, можно также указать требуемое значение прозрачности, как показано в следующем примере.

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

Если значения ColorizationColor и Прозрачность точно соответствуют системному цвету, панель управления персонализацией отображает системное имя для цвета. В противном случае цвет помечен как "Пользовательский".

Ниже показан раздел VisualStyles для темы Windows 7 Basic.

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

Ниже показан раздел VisualStyles для классической темы Windows.

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

Ниже показан раздел VisualStyles для черной темы высокой контрастности.

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

Разделы [Звуки] и [AppEvents] (Звуки)

Пользователь может выбрать значок Звук в панели управления, чтобы связать звуки с событиями, происходящими в приложениях. Например, файл .wav может воспроизводиться при открытии приложения. Файл темы может указать .wav файлы для замены файлов по умолчанию. В следующем примере показано, как это сделать.

[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 и более поздних версий: имя звуковой схемы можно указать вместо перечисления каждого звука отдельно.

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

Значение SchemeName указывает имя звуковой схемы или локализованное имя звуковой схемы, как показано в приведенном выше примере.

[Загрузочный] Раздел

В файле темы можно указать средство сохранения экрана для Windows, используемое. В следующем примере показано следующее.

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

[MasterThemeSelector] Секция

Раздел селектора главной темы файла темы всегда должен быть включен в виде тега, указывающего, что файл действителен. У вас нет выбора значений для этого параметра. Ниже показано следующее.

[MasterThemeSelector]
MTSM=DABJDKT

Пример файла темы

В следующем примере показан полный файл темы.

[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

Установка файлов темы

При инициализации Windows операционная система перечисляет подкаталоги первого уровня %WinDir%\Resources\, чтобы определить доступные темы. Файлы темы по умолчанию системы находятся в %WinDir%\Resources\Theme. Файлы темы пользователя хранятся в %LOCALAPPDATA%\Microsoft\Windows\Theme (или %SystemDrive%\Users\<имени пользователя>\AppData\Local\Microsoft\Windows\Theme).

Файл темы имеет связи с файлами; Таким образом, приложения установщика тем могут вызывать ShellExecute в файле темы, чтобы открыть окно персонализации на панели управления для указанной темы.

Пакеты тем

Windows 7 и более поздних версий. Пакет темы — это .cab-файл, содержащий не только ФАЙЛ ТЕМЫ, но и файлы, необходимые для реализации темы на другом компьютере, например звуковые файлы и изображения. Пользователи могут создавать пакеты тем с помощью панели управления персонализации.

Поддерживаемые типы файлов включают следующие:

Ресурсы, такие как звуки, должны размещаться в корне .cab и указываться непосредственно в .theme файлах. Например, если у вас есть файл с именем Alert.wav в корне .cab, его можно использовать в звуковой схеме:

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

Изображения обоев должны обрабатываться по-разному. Их следует распаковать в папку DesktopBackground\ и ссылаться на них в файлах тем в этом подкаталоге. Например, если у вас есть обои с именем BestDesktop.jpg, убедитесь, что он извлекает DesktopBackground\и ссылается на него в .cab, как показано ниже.

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

Связанные разделы

Обзор визуальных стилей