|
Значение по умолчанию: |
(пустое)
|
Эта директива определяет имя файла изображения, которое будет установлено в качестве фона на всех страницах мастера установки, но не страницах деинсталлятора. При указании файлов поддерживается маска имён, но сами файлы изображений должны находиться в исходном каталоге сценария, в противном случае к изображениям необходимо указывать полные пути. При использовании приставки "compiler:", компилятор будет искать эти файлы в собственном каталоге.
Поддерживаются изображения в формате .bmp и .png, включая прозрачность в этих изображениях. Используйте директиву WizardImageBackColor для настройки цвета фона. Возможно использование .bmp файлов с прозрачностью (дополнительную информацию смотрите в разделе WizardImageAlphaFormat). Также можно использовать директиву WizardBackImageOpacity для увеличения прозрачности.
Размер области, в которой выводится изображение, зависит от системных настроек DPI и используемых параметров шрифта, а также значений директив WizardSizePercent и WizardKeepAspectRatio. Если для WizardKeepAspectRatio установлено значение yes (по умолчанию), сохраняется соотношение сторон 497:360. Указанное изображение должно иметь такое же соотношение сторон.
Можно использовать изображение любого размера. Если изображения слишком малы или слишком велики, чтобы поместиться в заданные границы, то они будут растянуты или сжаты. Рекомендуется указывать изображение размером более 596x432 пикселей. Это позволяет избежать размытости и нечеткости изображения на системах с высоким уровнем PDI.
Если одно изображение большого размера при разных настройках DPI не даёт удовлетворительного результата, можно указать несколько файлов, разделив их запятыми. Программа установки автоматически выберет из них то, которое лучше всего соответствует размеру области изображения. При условии использования настроек шрифта, значений WizardSizePercent и WizardKeepAspectRatio по умолчанию размер области изображения с различными настройками DPI будет составлять (в пикселях):
| 100% | 596x432 |
| 125% | 796x576 |
| 150% | 994x720 |
| 175% | 1193x864 |
| 200% | 1272x922 |
| 225% | 1471x1066 |
| 250% | 1630x1148 |
(Можно заметить, что размер в 200% не соответствует удвоенному размеру в 100%. Это обусловлено тем, что коэффициент масштабирования основан на размере шрифта, который используется при настройке DPI, а не на самом DPI).
Если для директивы задано пустое значение, фоновое изображение не используется.
В противном случае, если для директивы WizardStyle или WizardStyleFile не указан стиль, автоматически активируется стиль windows11 с модификаторами excludelightcontrols и hidebevels. Заметьте, что в светлом режиме стиль windows11 использует для фона не совсем белый цвет. Чтобы вернуть прежний вид, установите для WizardBackColor значение white.
Чтобы скрыть изображения мастера и оставить только изображение фона, укажите директивам WizardImageFile и WizardSmallImageFile пустые значения. В качестве альтернативы установите для директивы WizardImageOpacity, например, значение 150, что сделает эти изображения частично прозрачными.
Используйте функцию WizardSetBackImage для установки, обновления или удаления фонового изображения во время выполнения.
; Использование раздельных изображений фона для светлой и тёмной темы WizardBackImageFile=MyBackImage.png WizardBackImageFileDynamicDark=MyBackImage_Dark.png ; Скрываем большое и малое изображения мастера WizardImageFile= WizardSmallImageFile= ; Использование одного изображения фона для светлой и тёмной темы WizardBackImageFile=MyBackImage.png WizardBackImageFileDynamicDark=MyBackImage.png ; Применяем прозрачность к изображению фона, чтобы оно ; хорошо смотрелось как в светлой, так и в тёмной теме WizardBackImageOpacity=150 ; Оставляем большое и малое изображения мастера, применив прозрачность, ; чтобы они равномерно сливались с изображением фона WizardImageOpacity=150 ; Использование фонового изображения в мастере установки, ; а также фонового цвета в других окнах и деинсталляторе WizardBackImageFile=MyBackImage.png WizardBackImageFileDynamicDark=MyBackImage.png WizardBackColor=#ffc0cb WizardBackColorDynamicDark=#570c22 ; На страницах мастера смешиваем изображение фона и цвет WizardBackImageOpacity=150
WizardImageFile
WizardSmallImageFile
WizardBackColor
WizardBackImageOpacity
WizardImageAlphaFormat
WizardImageStretch