Общая информация о файле конфигурации

Данный SFX модуль сохраняет все свойства стандартного SFX модуля архиватора 7-Zip и добавляет возможности, перечисленные в этой документации.

ВАЖНО! Следующие двухсимвольные последовательности в "значение_параметра" заменяются односимвольными:

Если надо указать обратный слеш (\) (например, в путях или тексте диалога), НЕОБХОДИМО использовать ДВОЙНОЙ (\\), а если "значение_параметра" или текст диалога содержит кавычки ("), НЕОБХОДИМО перед ними использовать обратный слеш (\") (правило "лидирующего слеша").

Двухсимвольные последовательности \n и \t зависят от регистра. Т.е., \N и \T НЕ будут заменяются односимвольными.

В момент выполнения модулем своей работы, помимо основных переменных среды (%SYSTEMDRIVE%, %PROGRAMFILES% и т.д.), доступны переменные, определяемые пользователем в параметрах 'SetEnvironment', а также дополнительные переменные, которые указывают на расположение на диске следующих папок:

Перечисленные выше переменные могут использоваться как в файле конфигурации, так и в других программах (.cmd, .bat файлах) запущенных из модуля.

Кроме этого можно использовать (только в файле конфигурации, но не в других программах, запущенных из модуля) следующие переменные модуля:

Все перечисленные переменные, кроме %%M, %%S, %%T и %%P НЕ зависят от регистра. %%M, %%S, %%T и %%P - зависят от регистра.

Все перечисленные переменные разбираются и подставляются в следующих параметрах:

Только переменные модуля %CommonDesktop%, %CommonDocuments%, %MyDocuments%, %MyDocs%, %UserDesktop%, %%M, %%S, %%T и %%P, а также переменные, определяемые пользователем в параметрах 'SetEnvironment', разбираются и подставляются (будут подставлены ЗНАЧЕНИЯ этих переменных) во всех строках параметров 'Shortcut' и 'ShortcutX'.

В остальных параметрах переменные среды и переменные модуля не используются и подставляются как обычные строки (будут подставлены ИМЕНА этих переменных).

Если в текстовых параметрах необходимо указать имя переменной, а не ее значение, то переменную нужно записать следующим образом:

Модуль также поддерживает относительные пути в следующих параметрах и ключах:

Для 'RunProgram' и всех вариантов 'AutoInstall'-ов МОЖНО/НУЖНО заключать путь и имя исполняемой программы в дополнительные кавычки.
МОЖНО, даже если имя и путь к исполняемому файлу НЕ СОДЕРЖАТ пробелов, НУЖНО, если СОДЕРЖАТ пробелы, т.к. имя и путь к исполняемому файлу формируются ПОСЛЕ разбора переменных среды. Например:

RunProgram="nowait:%ProgramFiles%\\test.exe /s"

В НАПИСАНИИ имя и путь к исполняемому файлу не содержит пробелов, но после подстановки оно МОЖЕТ содержать пробелы. Поэтому лучше всегда писать так:

RunProgram="nowait:\"%ProgramFiles%\\test.exe\" /s"

Префиксы и ключи исполняемой программы в дополнительные кавычки НЕ ВКЛЮЧАЮТСЯ.

Для 'ExecuteFile' необязательны дополнительные кавычки даже для имен с пробелами (т.к. в нем не может быть ключей командной строки). Т.е. предыдущий пример может быть записан так:

ExecuteFile="nowait:%ProgramFiles%\\test.exe"
ExecuteParameters="/s"

Многострочный текст допустим в диалогах следующих параметров:

В тексте допустимы любые символы. Слеши (\) и кавычки (") попадают под правило "лидирующего слеша" (см. выше), т.е. написав
 

HelpText="Так пишите (в скобках \"и кавычках\")\nА так пишите путь C:\\Windows\nА вот так используйте табуляцию\nПоз. 1\tПоз. 2\tПоз. 3\tПоз. 4"

получим следующее диалоговое окно:

help

Размеры окна диалога зависят от длины строк и их количества, и будут автоматически изменяться.

Прервать работу SFX архива можно:

При указанных выше действиях будет выведен диалог подтверждения отмены распаковки/установки, если он разрешен флагом 256 параметра 'GUIFlags'. Текст диалога отмены можно назначить параметром 'CancelPrompt'. Этот диалог НЕ будет выводиться в окне сообщения об ошибке и в окнах определяемых параметрами 'FinishMessage' и 'HelpText'.