[Setup]: WizardStyle

Допустимые значения:	Перечень следующих значений, разделённых пробелами: `classic` `modern` `light` `dark` `dynamic` `polar` `slate` `windows11` `zircon` `includetitlebar` `excludelightbuttons`
Значение по умолчанию:	`classic`

Описание

Эта директива управляет визуальным стилем и внешним видом программы установки и удаления.

Базовые стили:

classic: использует на страницах мастера фон серого цвета и применяется по умолчанию, если не указан.
modern: использует на страницах мастера фон белого цвета и скрывает горизонтальную линии между панелью заголовка и содержимым страниц.

Также поддерживаются дополнительные визуальные стили:

light: принудительно использует светлый стиль оформления и применяется по умолчанию, если не указан.
dark: принудительно использует тёмный стиль оформления.
dynamic: автоматически переключается между светлым и тёмным стилями в зависимости от системных настроек Windows.

Дополнительно поддерживаются предустановленные стили:

polar: использует светло-голубой вместо серого или белого для светлого внешнего вида и тёмно-голубой вместо чёрного для тёмного внешнего вида.
slate: использует средне-серый цвет как для светлого, так и для тёмного внешнего вида.
windows11: включает светлый аналог для предустановленного тёмного стиля.
zircon: альтернативный стиль только для светлого внешнего вида с акцентами голубого цвета.

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

includetitlebar: включает стилевое оформление для заголовка и границ окон программы установки (не-клиентская область), если активен пользовательский стиль (по умолчанию используется светлый или тёмный стиль системы).
excludelightbuttons: отключает стилизацию всех кнопок (включая кнопки командных ссылок, используемые в диалоговых окнах задач), когда активен светлый стиль.

Примеры:

WizardStyle=modern dynamic – будет использоваться современный внешний вид, а стиль будет автоматически адаптирован к настройкам светлого или тёмного режима системы.

WizardStyle=modern dark polar includetitlebar – будет использоваться современный внешний вид, тёмная тема, предустановленный стиль polar, включая заголовок и границы окна.

Поведение в тёмном режиме

Если принудительно используется тёмный (dark) или динамический тёмный (dynamic с тёмным режимом Windows) стиль, происходят следующие изменения:

Основной значок программы установки и удаления заменяется своей тёмной версией, если он не был переопределён директивой SetupIconFile.
Примечание: Windows может временно отображать другой значок из-за кэширования значков, это нормально.
Другие значки в программе установки и удаления также заменяются своими версиями для тёмного стиля. На них не влияет кэш значков Windows.
Изображение мастера заменяется своей тёмной версией, если оно не были переопределено с помощью директивы WizardImageFile.
Цвет фона изображения мастера настраивается для тёмного стиля, если он не был переопределён пользовательскими значениями директивой WizardImageBackColor.
Малое изображение мастера заменяется своей тёмной версией, если оно не были переопределено с помощью директивы WizardSmallImageFile.
Все цвета в файлах RTF удаляются и заменяются цветами тёмного стиля.
Если includetitlebar не используется: заголовок и границы становятся тёмными, чтобы соответствовать внешнему виду системы, если система это позволяет.

Особенности динамического режима

При использовании режима dynamic необходимо учитывать следующие дополнительные моменты:

Основной значок, отображаемый Windows, всегда будет светлой версией.
Настройка светлого или тёмного стиля системы проверяется только один раз, при запуске.
Для указания изображений и цветов, используемых специально для динамического тёмного стиля, доступны следующие директивы:
Стандартные директивы WizardImageFile, WizardSmallImageFile, WizardImageBackColor, WizardSmallImageBackColor и WizardStyleFile используются для настройки динамического светлого стиля.

Примечание: принудительная установка тёмного стиля (dark) НЕ используется настройки DynamicDark, а использует стандартные настройки.

Другие особенности

Стиль по умолчанию можно настроить, указав файл VCL стиля с помощью директивы WizardStyleFile. Когда активен принудительный светлый (light) или динамический тёмный (dynamic со светлым режимом Windows) стиль, стилем по умолчанию будет системный светлый стиль. В противном случае стилем по умолчанию будет предустановленный тёмный стиль.
Пользовательские стили (включая предустановленный тёмный стиль) НЕ активируются, если в системе пользователя используется высококонтрастная тема или используется параметр командной строки '/NOSTYLE'.
Когда активен пользовательский стиль (включая предустановленный тёмный стиль), происходит три дополнительных события. Во-первых, все текстовые надписи, за исключением той, которая связана с сообщением BeveledLabel, получают прозрачный фон вместо непрозрачного. Во-вторых, программа установки и удаления использует собственную реализацию окон сообщений Windows и диалоговых окон задач. В-третьих, свойства цвета, установленные с помощью программирования в секции [Code], обычно игнорируются, поскольку приоритет имеют цвета стиля.
Включение принудительного тёмного стиля (dark) увеличивает размер файла установки примерно на 220 КБ. Включение динамического тёмного стиля (dynamic) добавляет ещё примерно 75 КБ. Включение динамического тёмного стиля и добавление настраиваемого светлого стиля (например, dynamic windows11) добавляет примерно 120 КБ.
Сообщения, отображаемые так называемым "загрузчиком", никогда не будут стилизованы. Обычно такие сообщения не отображаются, если только не был включён запрос на запуск с помощью директивы DisableStartupPrompt.