d77e30386a
git-svn-id: https://svn.code.sf.net/p/nsis/code/NSIS/trunk@3118 212acab6-be3b-0410-9dea-997c60f758d6
908 lines
40 KiB
HTML
908 lines
40 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<title>NSIS Modern User Interface</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii" />
|
|
<style type="text/css">
|
|
/*<![CDATA[*/
|
|
|
|
body
|
|
{
|
|
padding: 10px;
|
|
background-color: #F0F0F0;
|
|
font-size: 13px;
|
|
font-family: Verdana, Arial, Helvetica, sans-serif;
|
|
font-weight: normal;
|
|
}
|
|
|
|
p
|
|
{
|
|
font-size: 100%;
|
|
margin: 20px;
|
|
}
|
|
|
|
.center
|
|
{
|
|
text-align: center;
|
|
}
|
|
|
|
table
|
|
{
|
|
margin: auto;
|
|
text-align: left;
|
|
background-color: #FFFFFF;
|
|
}
|
|
|
|
.maintable
|
|
{
|
|
border: 2px solid #376EAB;
|
|
}
|
|
|
|
.parameter
|
|
{
|
|
font-weight: bold;
|
|
color: #6586AC;
|
|
}
|
|
|
|
h1
|
|
{
|
|
font-size: 165%;
|
|
color: #7A7272;
|
|
font-weight: normal;
|
|
}
|
|
|
|
h2
|
|
{
|
|
font-size: 150%;
|
|
font-weight: bold;
|
|
color: #303030;
|
|
margin: 20px;
|
|
}
|
|
|
|
h3
|
|
{
|
|
font-size: 125%;
|
|
margin: 20px;
|
|
font-weight: bold;
|
|
color: #2B5885;
|
|
}
|
|
|
|
pre {
|
|
font-size: 100%;
|
|
margin: 20px;
|
|
}
|
|
|
|
div
|
|
{
|
|
margin: 20px;
|
|
}
|
|
|
|
.footer
|
|
{
|
|
font-size: 75%;
|
|
text-align: right;
|
|
color: #909090;
|
|
margin: 5px;
|
|
}
|
|
|
|
a:link, a:visited, a:active
|
|
{
|
|
color: #294F75;
|
|
text-decoration: none;
|
|
}
|
|
|
|
a:hover
|
|
{
|
|
color: #182634;
|
|
text-decoration: underline;
|
|
}
|
|
|
|
/*]]>*/
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div class="center">
|
|
<table width="750" class="maintable" cellspacing="0" cellpadding="0">
|
|
<tr>
|
|
<td>
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tr>
|
|
<td><img src="Readme.gif" width="750" height="80" alt="" /></td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<div>
|
|
<h1>Introduction</h1>
|
|
<p>NSIS 2 makes it is possible to create installers with a custom user interface. The Modern UI is
|
|
an interface with a style like the wizards of recent Windows versions.</p>
|
|
<p>This new interface also features new pages (Welcome, Finish, Start Menu) and a description area
|
|
on the components page. The interface and the graphics can be customized using the provided
|
|
settings.</p>
|
|
<p>Using the Modern UI macros and language files, writing scripts with a modern interface is easy.
|
|
This document contains information about writing Modern UI scripts and a reference of all
|
|
settings.</p>
|
|
<p><strong>Important:</strong> Because the Modern UI has its own macro system, its own default
|
|
settings and a lot of new features, the interface configuration works differently. So you should
|
|
not use commands like LicenseText, Icon, CheckBitmap, InstallColors etc.</p>
|
|
<h1>Screenshots</h1>
|
|
<p><img src="Screenshot.png" width="503" height="393" alt="" /></p>
|
|
<p><img src="Screenshot2.png" width="503" height="393" alt="" /></p>
|
|
<h1>How to use</h1>
|
|
<p>The Modern UI has a macro system, so all the code to control the interface has already been
|
|
written for you.</p>
|
|
<p>If you want to start a new Modern UI script or upgrade an older script with the Classic UI,
|
|
follow the steps below.</p>
|
|
<p>Taking a look at the <a href="#examples">example</a> scripts will also help you to learn more
|
|
about the Modern UI.</p>
|
|
<h2>Syntax</h2>
|
|
<p>Some defines (e.g. MUI_COMPONENTSPAGE_SMALLDESC) don't need a value, they are true/false
|
|
settings. Others (e.g. MUI_UI) can be used to define a specific value.</p>
|
|
<p>Parameters are specified in this format: <span class="parameter">required (option1 | option2)
|
|
[optional]</span></p>
|
|
<p>You should put all parameters in one string.</p>
|
|
<pre>
|
|
!define MUI_COMPONENTSPAGE_SMALLDESC ;No value
|
|
!define MUI_UI "myUI.exe" ;Value
|
|
!define MUI_INSTFILESPAGE_COLORS "FFFFFF 000000" ;Multiple settings
|
|
</pre>
|
|
<p>If you want a certain value (e.g. a text) to be language-specific, set a language string (using
|
|
LangString) and define $(STRINGNAME) as value. Use a license language string (LicenseLangString)
|
|
for the license text.</p>
|
|
<p>If you want to add " to a Modern UI string, you should always escape it: $\" because the Modern
|
|
UI macros use " separate parameters.</p>
|
|
<h2>1. Header file</h2>
|
|
<pre>
|
|
!include "MUI.nsh"
|
|
</pre>
|
|
<p>MUI.nsh is in the Include directory, so you don't have to specify a path.</p>
|
|
<h2>2. Interface Settings</h2>
|
|
<p>Interface settings should be set before inserting page macros. Page interface settings apply to
|
|
all pages of a certain type.</p>
|
|
<h3>General Interface Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_ICON</strong> <span class="parameter">icon_file</span><br />
|
|
The icon of the installer.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Graphics\Icons\modern-install.ico</em></p>
|
|
<p><strong>MUI_UNICON</strong> <span class="parameter">icon_file</span><br />
|
|
The icon of the uninstaller.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Graphics\Icons\modern-uninstall.ico</em></p>
|
|
<p><strong>MUI_HEADERIMAGE</strong><br />
|
|
Display an image on the header of a page.</p>
|
|
<div>
|
|
<p><strong>MUI_HEADERIMAGE_BITMAP</strong> <span class="parameter">bmp_file</span><br />
|
|
Bitmap image to display on the header of installers pages (recommended size: 150x57 pixels).<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Graphics\Header\nsis.bmp</em></p>
|
|
<p><strong>MUI_HEADERIMAGE_UNBITMAP</strong> <span class="parameter">bmp_file</span><br />
|
|
Bitmap image to display on the header of uninstaller pages (recommended size: 150x57 pixels).<br />
|
|
<em>Default: Installer header bitmap</em></p>
|
|
<p><strong>MUI_HEADERIMAGE_NOSTRETCH</strong><br />
|
|
Do not stretch the installer header bitmap to fit the size of the field. Use this option only if
|
|
you have an image that does not use the whole space. If you have a full size bitmap that fits
|
|
exactly, you should not use this option because the size of the field will be different if the user
|
|
has a custom DPI setting.</p>
|
|
<p><strong>MUI_HEADERIMAGE_UNNOSTRETCH</strong><br />
|
|
Do not stretch the uninstaller header bitmap to fit the size of the field. Use this option only if
|
|
you have an image that does not use the whole space. If you have a full size bitmap that fits
|
|
exactly, you should not use this option because the size of the field will be different if the user
|
|
has a custom DPI setting.</p>
|
|
<p><strong>MUI_HEADERIMAGE_RIGHT</strong><br />
|
|
Display the header image on the right side instead of the left side.</p>
|
|
</div>
|
|
<p><strong>MUI_BGCOLOR</strong> <span class="parameter">(color: RRGGBBR hexadecimal)</span><br />
|
|
Background color for the header, Welcome- and Finish page.<br />
|
|
<em>Default: FFFFFF</em></p>
|
|
</div>
|
|
<h3>Interface Resource Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_UI</strong> <span class="parameter">ui_file</span><br />
|
|
The interface file with the dialog resources. Change this if you have made your own customized
|
|
UI.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\UIs\modern.exe</em></p>
|
|
<p><strong>MUI_UI_HEADERIMAGE</strong> <span class="parameter">ui_file</span><br />
|
|
The interface files with the dialog resource IDD_INST that contains a bitmap control and space for
|
|
the header bitmap.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\UIs\modern-headerbmp.exe</em></p>
|
|
<p><strong>MUI_UI_HEADERIMAGE_RIGHT</strong> <span class="parameter">ui_file</span><br />
|
|
The interface files with the dialog resource IDD_INST that contains a bitmap control and space for
|
|
the header bitmap on the right side.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\UIs\modern-headerbmpr.exe</em></p>
|
|
<p><strong>MUI_UI_COMPONENTSPAGE_SMALLDESC</strong> <span class="parameter">ui_file</span><br />
|
|
The interface files with a customized dialog resource IDD_SELCOM with a small description
|
|
area.<br />
|
|
<em>Default: {NSISDIR}\Contrib\UIs\modern-smalldesc.exe</em></p>
|
|
<p><strong>MUI_UI_COMPONENTSPAGE_NODESC</strong> <span class="parameter">ui_file</span><br />
|
|
The interface files with a customized dialog resource IDD_SELCOM without a description area.<br />
|
|
<em>Default: {NSISDIR}\Contrib\UIs\modern-nodesc.exe</em></p>
|
|
</div>
|
|
<h3>Welcome/Finish Page Interface Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_WELCOMEFINISHPAGE_3LINES</strong><br />
|
|
Create a bigger area for the title on the Welcome- and Finish page, to allow displaying 3 lines of
|
|
text (with the default font).</p>
|
|
<p><strong>MUI_WELCOMEFINISHPAGE_BITMAP</strong> <span class="parameter">bmp_file</span><br />
|
|
Bitmap for the Welcome- and Finish page (recommended size: 164x314 pixels).<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Graphics\Wizard\win.bmp</em></p>
|
|
<div>
|
|
<p><strong>MUI_WELCOMEFINISHPAGE_NOSTRETCH</strong><br />
|
|
Do not stretch the bitmap for the Welcome and Finish page to fit the size of the field. Use this
|
|
option only if you have an image that does not use the whole space. If you have a full size bitmap
|
|
that fits exactly, you should not use this option because the size of the field will be different
|
|
if the user has a custom DPI setting.</p>
|
|
</div>
|
|
</div>
|
|
<h3>Welcome/Finish Page InstallOptions INI Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_WELCOMEFINISHPAGE_INI</strong> <span class="parameter">ini_file</span><br />
|
|
InstallOptions INI file for the Welcome- and Finish page.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Modern UI\ioSpecial.ini</em></p>
|
|
<p><strong>MUI_WELCOMEFINISHPAGE_INI_3LINES</strong> <span class="parameter">ini_file</span><br />
|
|
InstallOptions INI file for the Welcome- and Finish page with space for 3 lines of title text (with
|
|
the default font).<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Modern UI\ioSpecial3.ini</em></p>
|
|
</div>
|
|
<h3>Uninstaller Welcome/Finish Page InstallOptions INI Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_UNWELCOMEFINISHPAGE_3LINES</strong><br />
|
|
Create a bigger area for the title on the uninstaller Welcome- and Finish page, to allow displaying
|
|
3 lines of text (with the default font).</p>
|
|
<p><strong>MUI_UNWELCOMEFINISHPAGE_BITMAP</strong> <span class="parameter">bmp_file</span><br />
|
|
Bitmap for the Welcome- and Finish page (recommended size: 164x314 pixels).<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Graphics\Wizard\win.bmp</em></p>
|
|
<div>
|
|
<p><strong>MUI_UNWELCOMEFINISHPAGE_NOSTRETCH</strong><br />
|
|
Do not stretch the bitmap for the Welcome and Finish page to fit the size of the field. Use this
|
|
option only if you have an image that does not use the whole space. If you have a full size bitmap
|
|
that fits exactly, you should not use this option because the size of the field will be different
|
|
if the user has a custom DPI setting.</p>
|
|
</div>
|
|
</div>
|
|
<h3>Uninstaller Welcome/Finish Page Interface INI File Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_UNWELCOMEFINISHPAGE_INI</strong> <span class="parameter">ini_file</span><br />
|
|
InstallOptions INI file for the uninstaller Welcome- and Finish page.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Modern UI\ioSpecial.ini</em></p>
|
|
<p><strong>MUI_WELCOMEFINISHPAGE_INI_3LINES</strong> <span class="parameter">ini_file</span><br />
|
|
InstallOptions INI file for the Welcome- and Finish page with space for 3 lines of title text (with
|
|
the default font).<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Modern UI\ioSpecial3.ini</em></p>
|
|
</div>
|
|
<h3>License Page Interface Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_LICENSEPAGE_BGCOLOR</strong> <span class="parameter">(/windows | /grey | (color:
|
|
RRGGBB hexadecimal))</span><br />
|
|
The background color for the license textbox. Use /windows for the Windows text background color
|
|
(usually white). Use the /grey for the window background color (usually grey).<br />
|
|
<em>Default: /windows</em></p>
|
|
</div>
|
|
<h3>Components Page Interface Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_COMPONENTSPAGE_CHECKBITMAP</strong> <span class="parameter">bitmap_file</span><br />
|
|
The bitmap with images for the checks of the component select treeview.<br />
|
|
<em>Default: ${NSISDIR}\Contrib\Graphics\Checks\modern.bmp</em></p>
|
|
<p><strong>MUI_COMPONENTSPAGE_SMALLDESC</strong><br />
|
|
A small description area on the bottom of the page. Use this layout if you have a lot of sections
|
|
and don't need large descriptions.</p>
|
|
<p><strong>MUI_COMPONENTSPAGE_NODESC</strong><br />
|
|
No description area.</p>
|
|
</div>
|
|
<h3>Installation Page Interface Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_INSTFILESPAGE_COLORS</strong> <span class="parameter">(/windows | (foreground color:
|
|
RRGGBB hexadecimal) (background color: RRGGBB hexadecimal))</span><br />
|
|
The colors of the details screen. Use /windows for the default Windows colors.<br />
|
|
<em>Default: /windows</em></p>
|
|
<p><strong>MUI_INSTFILESPAGE_PROGRESSBAR</strong> <span class="parameter">("" | colored |
|
|
smooth)</span><br />
|
|
The style of the progress bar. Colored makes it use the MUI_INSTALLCOLORS.<br />
|
|
<em>Default: smooth</em></p>
|
|
</div>
|
|
<h3>Installer Finish Page Interface Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_FINISHPAGE_NOAUTOCLOSE</strong><br />
|
|
Do not automatically jump to the finish page, to allow the user to check the install log.</p>
|
|
</div>
|
|
<h3>Uninstaller Finish Page Interface Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_UNFINISHPAGE_NOAUTOCLOSE</strong><br />
|
|
Do not automatically jump to the finish page, to allow the user to check the uninstall log.</p>
|
|
</div>
|
|
<h3>Abort Warning Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_ABORTWARNING</strong><br />
|
|
Show a message box with a warning when the user wants to close the installer.</p>
|
|
<div>
|
|
<p><strong>MUI_ABORTWARNING_TEXT</strong> <span class="parameter">text</span><br />
|
|
Texts to display on the abort warning messagebox.</p>
|
|
</div>
|
|
</div>
|
|
<h3>Uninstaller Abort Warning Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_UNABORTWARNING</strong><br />
|
|
Show a message box with a warning when the user wants to close the uninstaller.</p>
|
|
<div>
|
|
<p><strong>MUI_UNABORTWARNING_TEXT</strong> <span class="parameter">text</span><br />
|
|
Texts to display on the abort warning messagebox.</p>
|
|
</div>
|
|
</div>
|
|
<h2>3. Pages</h2>
|
|
<p>Insert the following macros to set the pages you want to use. The pages will appear in the order
|
|
you insert them in your script. You can also insert custom Page commands between the macros to add
|
|
custom pages. <a href="#customPages">More info about custom pages...</a></p>
|
|
<p>You can add multiple pages of certain types (for example, if you want the user to specify
|
|
multiple folders).</p>
|
|
<p>Examples:</p>
|
|
<pre>
|
|
!insertmacro MUI_PAGE_LICENSE "License.rtf"
|
|
!insertmacro MUI_PAGE_COMPONENTS
|
|
|
|
Var STARTMENU_FOLDER
|
|
!insertmacro MUI_PAGE_STARTMENU "Application" $STARTMENU_FOLDER
|
|
</pre>
|
|
<p>You need the page ID for the Start Menu Folder page when using the Start Menu Folder macros. The
|
|
Start Menu Forder will be stored in the specified variable.</p>
|
|
<p><strong>Installer Pages</strong><br />
|
|
MUI_PAGE_WELCOME<br />
|
|
MUI_PAGE_LICENSE <span class="parameter">text/rtf_file</span><br />
|
|
MUI_PAGE_COMPONENTS<br />
|
|
MUI_PAGE_DIRECTORY<br />
|
|
MUI_PAGE_STARTMENU <span class="parameter">page_id variable</span><br />
|
|
MUI_PAGE_INSTFILES<br />
|
|
MUI_PAGE_FINISH</p>
|
|
<p><strong>Uninstaller Pages</strong><br />
|
|
MUI_UNPAGE_WELCOME<br />
|
|
MUI_UNPAGE_CONFIRM<br />
|
|
MUI_UNPAGE_LICENSE <span class="parameter">text/rtf_file</span><br />
|
|
MUI_UNPAGE_COMPONENTS<br />
|
|
MUI_UNPAGE_DIRECTORY<br />
|
|
MUI_UNPAGE_INSTFILES<br />
|
|
MUI_UNPAGE_FINISH</p>
|
|
<p>Page Settings apply to a single page and should be set before inserting a page macro. Example:</p>
|
|
<pre>
|
|
;Add a directory page to let the user specify a plug-ins folder
|
|
;Store the folder in $PLUGINS_FOLDER
|
|
|
|
Var PLUGINS_FOLDER
|
|
!define MUI_DIRECTORYPAGE_VARIABLE $PLUGINS_FOLDER
|
|
!insertmacro MUI_PAGE_DIRECTORY
|
|
</pre>
|
|
<h3>Page Settings</h3>
|
|
<div>
|
|
<h3>General Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_PAGE_HEADER_TEXT</strong> <span class="parameter">text</span><br />
|
|
Text to display on the header of the page.</p>
|
|
<p><strong>MUI_PAGE_HEADER_SUBTEXT</strong> <span class="parameter">text</span><br />
|
|
Subtext to display on the header of the page.</p>
|
|
</div>
|
|
<h3>Welcome Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_WELCOMEPAGE_TITLE</strong> <span class="parameter">title</span><br />
|
|
Title to display on the top of the page.</p>
|
|
<p><strong>MUI_WELCOMEPAGE_TEXT</strong> <span class="parameter">text</span><br />
|
|
Text to display on the page. Use \r\n for a newline.</p>
|
|
</div>
|
|
<h3>License Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_LICENSEPAGE_TEXT_TOP</strong> <span class="parameter">text</span><br />
|
|
Text to display on the top of the page.</p>
|
|
<p><strong>MUI_LICENSEPAGE_TEXT_BOTTOM</strong> <span class="parameter">text</span><br />
|
|
Text to display on the bottom of the page.</p>
|
|
<p><strong>MUI_LICENSEPAGE_BUTTON</strong> <span class="parameter">button_text</span><br />
|
|
Text to display on the 'I Agree' button.</p>
|
|
<p><strong>MUI_LICENSEPAGE_CHECKBOX</strong><br />
|
|
Display a checkbox the user has to check to agree with the license terms.</p>
|
|
<div>
|
|
<p><strong>MUI_LICENSEPAGE_CHECKBOX_TEXT</strong> <span class="parameter">text</span><br />
|
|
Text to display next to the checkbox to agree with the license terms.</p>
|
|
</div>
|
|
<p><strong>MUI_LICENSEPAGE_RADIOBUTTONS</strong><br />
|
|
Display two radiobuttons to allow the user to choose between accepting the license terms or
|
|
not.</p>
|
|
<div>
|
|
<p><strong>MUI_LICENSEPAGE_RADIOBUTTONS_TEXT_ACCEPT</strong> <span class=
|
|
"parameter">text</span><br />
|
|
Text to display next to the checkbox to accept the license terms.</p>
|
|
<p><strong>MUI_LICENSEPAGE_RADIOBUTTONS_TEXT_DECLINE</strong> <span class=
|
|
"parameter">text</span><br />
|
|
Text to display next to the checkbox to dicline the license terms.</p>
|
|
</div>
|
|
</div>
|
|
<h3>Components Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_COMPONENTSPAGE_TEXT_TOP</strong> <span class="parameter">text</span><br />
|
|
Text to display on the top of the page.</p>
|
|
<p><strong>MUI_COMPONENTSPAGE_TEXT_COMPLIST</strong> <span class="parameter">text</span><br />
|
|
Text to display on next to the components list.</p>
|
|
<p><strong>MUI_COMPONENTSPAGE_TEXT_INSTTYPE</strong> <span class="parameter">text</span><br />
|
|
Text to display on next to the installation type combo box.</p>
|
|
<p><strong>MUI_COMPONENTSPAGE_TEXT_DESCRIPTION_TITLE</strong> <span class=
|
|
"parameter">text</span><br />
|
|
Text to display on the of the top of the description box.</p>
|
|
<p><strong>MUI_COMPONENTSPAGE_TEXT_DESCRIPTION_INFO</strong> <span class=
|
|
"parameter">text</span><br />
|
|
Text to display inside the description box when no section is selected.</p>
|
|
</div>
|
|
<h3>Directory Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_DIRECTORYPAGE_TEXT_TOP</strong> <span class="parameter">text</span><br />
|
|
Text to display on top of the page.</p>
|
|
<p><strong>MUI_DIRECTORYPAGE_TEXT_DESTINATION</strong> <span class="parameter">text</span><br />
|
|
Text to display on the destination folder frame.</p>
|
|
<p><strong>MUI_DIRECTORYPAGE_VARIABLE</strong> <span class="parameter">variable</span><br />
|
|
Variable in which to store the selected folder.<br />
|
|
<em>Default: $INSTDIR</em></p>
|
|
</div>
|
|
<h3>Start Menu Folder Page Settings</h3>
|
|
<div>
|
|
<p>Put the code to write the shortcuts (using CreateShortcut) between the MUI_STARTMENU_WRITE_BEGIN
|
|
and MUI_STARTMENU_WRITE_END macros:</p>
|
|
<pre>
|
|
!insertmacro MUI_STARTMENU_WRITE_BEGIN page_id
|
|
...create shortcuts...
|
|
!insertmacro MUI_STARTMENU_WRITE_END
|
|
</pre>
|
|
<p>The page ID should be the ID of the page on which the user has selected the folder for the
|
|
shortcuts you want to write.</p>
|
|
<p><strong>MUI_STARTMENUPAGE_TEXT_TOP</strong> <span class="parameter">text</span><br />
|
|
Text to display on the top of the page.</p>
|
|
<p><strong>MUI_STARTMENUPAGE_TEXT_CHECKBOX</strong> <span class="parameter">text</span><br />
|
|
Text to display next to the checkbox to disable the Start Menu folder creation.</p>
|
|
<p><strong>MUI_STARTMENUPAGE_DEFAULTFOLDER</strong> <span class="parameter">folder</span><br />
|
|
The default Start Menu Folder.</p>
|
|
<p><strong>MUI_STARTMENUPAGE_NODISABLE</strong><br />
|
|
Do not display the checkbox to disable the creation of Start Menu shortcuts.</p>
|
|
<p><strong>MUI_STARTMENUPAGE_REGISTRY_ROOT</strong> <span class="parameter">root</span><br />
|
|
<strong>MUI_STARTMENUPAGE_REGISTRY_KEY</strong> <span class="parameter">key</span><br />
|
|
<strong>MUI_STARTMENUPAGE_REGISTRY_VALUENAME</strong> <span class=
|
|
"parameter">value_name</span><br />
|
|
The registry key to store the Start Menu folder. The page will use it to remember the users
|
|
preference. You should also use it in the uninstaller to remove the Start Menu folders. Don't
|
|
forget to remove this key in the uninstaller.</p>
|
|
<p>In the uninstaller, use the MUI_STARTMENU_GETFOLDER macro to get the Start Menu folder:</p>
|
|
<pre>
|
|
!insertmacro MUI_STARTMENU_GETFOLDER page_id $R0
|
|
Delete "$SMPROGRAMS\$R0\Your Shortcut.lnk"
|
|
</pre></div>
|
|
<h3>Installation Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_INSTFILESPAGE_FINISHHEADER_TEXT</strong> <span class="parameter">text</span><br />
|
|
Text to display on the header of the installation page when the installation has been completed
|
|
(won't be displayed when using a Finish page without MUI_(UN)FINISHPAGE_NOAUTOCLOSE).</p>
|
|
<p><strong>MUI_INSTFILESPAGE_FINISHHEADER_SUBTEXT</strong> <span class=
|
|
"parameter">text</span><br />
|
|
Subext to display on the header of the installation page when the installation has been completed
|
|
(won't be displayed when using a Finish page without MUI_(UN)FINISHPAGE_NOAUTOCLOSE).</p>
|
|
<p><strong>MUI_INSTFILESPAGE_ABORTHEADER_TEXT</strong> <span class="parameter">text</span><br />
|
|
Text to display on the header of the installation page when the installation has been aborted.</p>
|
|
<p><strong>MUI_INSTFILESPAGE_ABORTHEADER_SUBTEXT</strong> <span class="parameter">text</span><br />
|
|
Subext to display on the header of the installation page when the installation has been
|
|
aborted.</p>
|
|
</div>
|
|
<h3>Finish Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_FINISHPAGE_TITLE</strong> <span class="parameter">title</span><br />
|
|
Title to display on the top of the page.</p>
|
|
<p><strong>MUI_FINISHPAGE_TEXT</strong> <span class="parameter">text</span><br />
|
|
Text to display on the page. Use \r\n for a newline.</p>
|
|
<p><strong>MUI_FINISHPAGE_BUTTON</strong> <span class="parameter">text</span><br />
|
|
Text to display on the Finish button.</p>
|
|
<p><strong>MUI_FINISHPAGE_TEXT_REBOOT</strong> <span class="parameter">text</span><br />
|
|
Text to display on the finish page when asking for a sytem reboot. Use \r\n for a newline.</p>
|
|
<p><strong>MUI_FINISHPAGE_TEXT_REBOOTNOW</strong> <span class="parameter">text</span><br />
|
|
Text to display next to the 'Reboot now' option button.</p>
|
|
<p><strong>MUI_FINISHPAGE_TEXT_REBOOTLATER</strong> <span class="parameter">text</span><br />
|
|
Text to display next to the 'Reboot later' option button.</p>
|
|
<p><strong>MUI_FINISHPAGE_RUN</strong> <span class="parameter">exe_file</span><br />
|
|
Application which the user can select to run using a checkbox. You don't need to put quotes around
|
|
the filename when it contains spaces.</p>
|
|
<div>
|
|
<p><strong>MUI_FINISHPAGE_RUN_TEXT</strong> <span class="parameter">text</span><br />
|
|
Texts to display next to the 'Run program' checkbox.</p>
|
|
<p><strong>MUI_FINISHPAGE_RUN_PARAMETERS</strong> <span class="parameter">parameters</span><br />
|
|
Parameters for the application to run. Don't forget to escape double quotes in the value (use
|
|
$\").</p>
|
|
<p><strong>MUI_FINISHPAGE_RUN_NOTCHECKED</strong><br />
|
|
Do not check the 'Run program' checkbox by default</p>
|
|
<p><strong>MUI_FINISHPAGE_RUN_FUNCTION</strong> <span class="parameter">function_name</span><br />
|
|
Call a function instead of executing an application (define MUI_FINISHPAGE_RUN without parameters).
|
|
You can use the function to exectute multiple applications or you can change the checkbox name and
|
|
use it for other things.</p>
|
|
</div>
|
|
<p><strong>MUI_FINISHPAGE_SHOWREADME</strong> <span class="parameter">file/url</span><br />
|
|
File or website which the user can select to view using a checkbox. You don't need to put quotes
|
|
around the filename when it contains spaces.</p>
|
|
<div>
|
|
<p><strong>MUI_FINISHPAGE_SHOWREADME_TEXT</strong> <span class="parameter">text</span><br />
|
|
Texts to display next to the 'Show Readme' checkbox.</p>
|
|
<p><strong>MUI_FINISHPAGE_SHOWREADME_NOTCHECKED</strong><br />
|
|
Do not check the 'Show Readme' checkbox by default</p>
|
|
<p><strong>MUI_FINISHPAGE_SHOWREADME_FUNCTION</strong> <span class=
|
|
"parameter">function_name</span><br />
|
|
Call a function instead of showing a file (define MUI_FINISHPAGE_SHOWREADME without parameters).
|
|
You can use the function to show multiple files or you can change the checkbox name and use it for
|
|
other things.</p>
|
|
</div>
|
|
<p><strong>MUI_FINISHPAGE_LINK</strong> <span class="parameter">link_text</span><br />
|
|
Text for a link on the which the user can click to view a website or file.</p>
|
|
<div>
|
|
<p><strong>MUI_FINISHPAGE_LINK_LOCATION</strong> <span class="parameter">file/url</span><br />
|
|
Website or file which the user can select to view using the link. You don't need to put quotes
|
|
around the filename when it contains spaces.</p>
|
|
<p><strong>MUI_FINISHPAGE_LINK_COLOR</strong> <span class="parameter">(color: 0xBBGGRR
|
|
hexadecimal)</span><br />
|
|
Text color for the link on the Finish page.<br />
|
|
<em>Default: 0x800000</em></p>
|
|
</div>
|
|
<p><strong>MUI_FINISHPAGE_NOREBOOTSUPPORT</strong><br />
|
|
Disables support for the page that allows the user to reboot the system. Define this option to save
|
|
some space if you are not using the /REBOOTOK flag or SetRebootFlag.</p>
|
|
</div>
|
|
<h3>Uninstall Confirm Page Settings</h3>
|
|
<div>
|
|
<p><strong>MUI_UNCONFIRMPAGE_TEXT_TOP</strong> <span class="parameter">text</span><br />
|
|
Text to display on the top of the page.</p>
|
|
<p><strong>MUI_UNCONFIRMPAGE_TEXT_LOCATION</strong> <span class="parameter">text</span><br />
|
|
Text to display next to the uninstall location text box.</p>
|
|
</div>
|
|
<h3>Advanced Page Settings</h3>
|
|
<div>
|
|
<p>You can add custom code to the page functions of your Modern UI pages. <a href=
|
|
"#customFunctions">More info...</a></p>
|
|
</div>
|
|
</div>
|
|
<h2>4. Custom functions</h2>
|
|
<p>If you want add your own code to functions inserted by the Modern UI (e.g. the .onGUIInit
|
|
function and the page functions), create your own function and let the Modern UI functions call
|
|
them.</p>
|
|
<p><a href="#customFunctions">More info...</a></p>
|
|
<h2>5. Language files</h2>
|
|
<p>Insert the Modern UI language files for the languages to want to include.</p>
|
|
<pre>
|
|
!insertmacro MUI_LANGUAGE "English"
|
|
</pre>
|
|
<p>The Modern UI language files load the NLF language files, so you should not use
|
|
LoadLanguageFile.</p>
|
|
<h3>Language Selection Dialog</h3>
|
|
<div>
|
|
<p>If you want the installer to display a language selection dialog (have a look at the <a href=
|
|
"../../Examples/Modern%20UI/MultiLanguage.nsi">MultiLanguage.nsi</a> example), insert the
|
|
MUI_LANGDLL_DISPLAY macro in the .onInit function.</p>
|
|
<pre>
|
|
Function .onInit
|
|
|
|
!insertmacro MUI_LANGDLL_DISPLAY
|
|
|
|
FunctionEnd
|
|
</pre>
|
|
<h3>Language Selection Dialog Settings</h3>
|
|
<div>
|
|
<p>To remember to users preference, you can define a registry key.<br />
|
|
<strong>Note:</strong> These defines should be set before inserting the instfiles page macro.</p>
|
|
<p><strong>MUI_LANGDLL_REGISTRY_ROOT</strong> <span class="parameter">root</span><br />
|
|
<strong>MUI_LANGDLL_REGISTRY_KEY</strong> <span class="parameter">key</span><br />
|
|
<strong>MUI_LANGDLL_REGISTRY_VALUENAME</strong> <span class="parameter">value_name</span><br />
|
|
The registry key to store the language. The users preference will be remembered. You can also use
|
|
it in the uninstaller to display the right language. Don't forget to remove this key in the
|
|
uninstaller.</p>
|
|
<p>In the uninstaller, insert the MUI_UNGETLANGUAGE macro in un.onInit to get the stored language
|
|
preference.</p>
|
|
<pre>
|
|
Function un.onInit
|
|
|
|
!insertmacro MUI_UNGETLANGUAGE
|
|
|
|
FunctionEnd
|
|
</pre></div>
|
|
<h3>Language Selection Dialog Interface Settings</h3>
|
|
<div>
|
|
<p>To customize the language selection dialog interface, use these defines before inserting the
|
|
MUI_LANGDLL_DISPLAY macro.</p>
|
|
<p><strong>MUI_LANGDLL_WINDOWTITLE</strong> <span class="parameter">text</span><br />
|
|
The window title of the language selection dialog.</p>
|
|
<p><strong>MUI_LANGDLL_INFO</strong> <span class="parameter">text</span><br />
|
|
The text to display on the language selection dialog.</p>
|
|
<p><strong>MUI_LANGDLL_ALWAYSSHOW</strong><br />
|
|
Always show the language selection dialog, even if a language has been stored in the registry. The
|
|
language stored in the registry will be selected by default.</p>
|
|
</div>
|
|
</div>
|
|
<h2>6. Reserve files</h2>
|
|
<p>If you are using BZIP2 (solid) compression, it's important that files which are being extracted
|
|
in init- or page functions function are located before other files in the data block, because this
|
|
will make your installer faster.</p>
|
|
<p>If there are File commands in your sections or functions above the init- or page functions, add
|
|
the reserve file macros above your sections and functions.</p>
|
|
<pre>
|
|
ReserveFile "ioFile.ini" ;Your own InstallOptions INI files
|
|
!insertmacro MUI_RESERVEFILE_INSTALLOPTIONS ;InstallOptions plug-in
|
|
!insertmacro MUI_RESERVEFILE_LANGDLL ;Language selection dialog
|
|
</pre>
|
|
<h2>7. Your own sections and functions</h2>
|
|
<p>Add your installer sections and functions. See the NSIS Users Manual for details.</p>
|
|
<p>Information about section- and function code for Start Menu shortcut creation and language
|
|
selection can be found above.</p>
|
|
<h2>8. Descriptions for the sections</h2>
|
|
<p>The descriptions of sections will be displayed on the components page, when the user hovers the
|
|
mouse over a section. If you don't want to use descriptions, use the MUI_COMPONENTSPAGE_NODESC
|
|
interface setting.</p>
|
|
<p>To set a description for a section, you have to add an additional parameter to the Section
|
|
commmand with a name for the define that should contain the section number.</p>
|
|
<pre>
|
|
Section "Section Name 1" Section1
|
|
...
|
|
SectionEnd
|
|
</pre>
|
|
<p>Use these macros to set the descriptions:</p>
|
|
<pre>
|
|
LangString DESC_Section1 ${LANG_ENGLISH} "Description of section 1."
|
|
LangString DESC_Section2 ${LANG_ENGLISH} "Description of section 2."
|
|
|
|
!insertmacro MUI_FUNCTION_DESCRIPTION_BEGIN
|
|
!insertmacro MUI_DESCRIPTION_TEXT ${Section1} $(DESC_Section1)
|
|
!insertmacro MUI_DESCRIPTION_TEXT ${Section2} $(DESC_Section2)
|
|
!insertmacro MUI_FUNCTION_DESCRIPTION_END
|
|
</pre>
|
|
<p>For the uninstaller, use the MUI_UNFUNCTION_DESCRIPTION_BEGIN and
|
|
MUI_UNFUNCTIONS_DESCRIPTION_END macros</p>
|
|
<pre>
|
|
ReserveFile "ioFile.ini" ;Your own InstallOptions INI files
|
|
ReserveFile "${NSISDIR}\Contrib\Graphics\Header\nsis.bmp" ;Your header bitmap
|
|
|
|
!insertmacro MUI_RESERVEFILE_INSTALLOPTIONS ;InstallOptions
|
|
!insertmacro MUI_RESERVEFILE_LANGDLL ;LangDLL (language selection dialog)
|
|
!insertmacro MUI_RESERVEFILE_STARTMENU ;Start Menu Folder page
|
|
</pre>
|
|
<h1><a name="customPages" id="customPages">Custom pages</a></h1>
|
|
<h2>Custom page commands</h2>
|
|
<p>If you want add custom pages to your installer, you should insert your own page commands between
|
|
the page macros.</p>
|
|
<pre>
|
|
!insertmacro MUI_PAGE_WELCOME
|
|
Page custom FunctionName ;Custom page
|
|
!insertmacro MUI_PAGE_COMPONENTS
|
|
|
|
;Uninstaller
|
|
!insertmacro MUI_UNPAGE_CONFIRM
|
|
UninstPage custom un.FunctionName ;Custom page
|
|
!insertmacro MUI_UNPAGE_INSTFILES
|
|
</pre>
|
|
<h2>Call InstallOptions</h2>
|
|
<p>InstallOptions is a plug-in that displays custom pages that you can create using INI files.</p>
|
|
<p>Have a look at the <a href="../InstallOptions/Readme.html">InstallOptions documentation</a> for
|
|
info about creating InstallOptions INI files.</p>
|
|
<p>First, you have to extract your InstallOptions INI File in the .onInit function (un.onInit for
|
|
the uninstaller) using the MUI_INSTALLOPTIONS_EXTRACT macro.</p>
|
|
<pre>
|
|
Function .onInit
|
|
!insertmacro MUI_INSTALLOPTIONS_EXTRACT "ioFile.ini"
|
|
FunctionEnd
|
|
</pre>
|
|
<p>If your INI File is located in another directory, use MUI_INSTALLOPTIONS_EXTRACT_AS. The second
|
|
parameter is the filename for the temporary plug-ins directory, use this filename as parameter for
|
|
the other InstallOptions macros.</p>
|
|
<pre>
|
|
Function .onInit
|
|
!insertmacro MUI_INSTALLOPTIONS_EXTRACT_AS "..\ioFile.ini" "ioFile.ini"
|
|
FunctionEnd
|
|
</pre>
|
|
<p>You can call Instal Options in the function defined with the Page or UninstPage command using
|
|
the MUI_INSTALLOPTIONS_DISPLAY macro. Use the MUI_HEADER_TEXT macro to set the text in the white
|
|
box.</p>
|
|
<pre>
|
|
LangString TEXT_IO_TITLE ${LANG_ENGLISH} "Install Options Page Title"
|
|
LangString TEXT_IO_SUBTITLE ${LANG_ENGLISH} "A subtitle"
|
|
|
|
Function FunctionName ;FunctionName defined with Page command
|
|
!insertmacro MUI_HEADER_TEXT "$(TEXT_IO_TITLE)" "$(TEXT_IO_SUBTITLE)"
|
|
!insertmacro MUI_INSTALLOPTIONS_DISPLAY "ioFile.ini"
|
|
FunctionEnd
|
|
</pre>
|
|
<p>For custom fonts and colors, macros for the initDialog and show functions of InstallOptions are
|
|
also available.</p>
|
|
<pre>
|
|
Var HWND
|
|
Var DLGITEM
|
|
Var FONT
|
|
|
|
LangString TEXT_IO_TITLE ${LANG_ENGLISH} "Install Options Page Title"
|
|
LangString TEXT_IO_SUBTITLE ${LANG_ENGLISH} "A subtitle"
|
|
|
|
Function FunctionName ;FunctionName defined with Page command
|
|
|
|
!insertmacro MUI_HEADER_TEXT "$(TEXT_IO_TITLE)" "$(TEXT_IO_SUBTITLE)"
|
|
|
|
!insertmacro MUI_INSTALLOPTIONS_INITDIALOG "ioFile.ini"
|
|
Pop $HWND ;HWND of dialog
|
|
|
|
GetDlgItem $DLGITEM $HWND 1200 ;1200 + Field number - 1
|
|
|
|
;$DLGITEM contains the HWND of the first field
|
|
CreateFont $FONT "Tahoma" 10 700
|
|
SendMessage $DLGITEM ${WM_SETFONT} $FONT 0
|
|
|
|
!insertmacro MUI_INSTALLOPTIONS_SHOW
|
|
|
|
FunctionEnd
|
|
</pre>
|
|
<p>If you need the InstallOptions return value (success, back, cancel, error), use the
|
|
MUI_INSTALLOPTIONS_DISPLAY_RETURN or MUI_INSTALLOPTIONS_SHOW_RETURN macro. The return value will be
|
|
added to the stack, so you can use the Pop command to get it.</p>
|
|
<p>Use these macros to read or write INI file values:</p>
|
|
<pre>
|
|
!insertmacro MUI_INSTALLOPTIONS_READ $VAR "ioFile.ini" "Field #" "Value Name"
|
|
!insertmacro MUI_INSTALLOPTIONS_WRITE "ioFile.ini" "Field #" "Value Name" "Value"
|
|
</pre>
|
|
<p>For example, you can use the MUI_INSTALLOPTIONS_READ macro in a section to get the user
|
|
input:</p>
|
|
<pre>
|
|
!insertmacro MUI_INSTALLOPTIONS_READ $R0 "ioFile.ini" "Field 1" "State"
|
|
</pre>
|
|
<p>For more details about InstallOptions, validation of user input etc., check the <a href=
|
|
"../InstallOptions/Readme.html">InstallOptions documentation</a>.</p>
|
|
<h1><a name="examples" id="examples">Examples</a></h1>
|
|
<p>Basic: <a href="../../Examples/Modern%20UI/Basic.nsi">Basic.nsi</a><br />
|
|
Welcome/Finish page: <a href=
|
|
"../../Examples/Modern%20UI/WelcomeFinish.nsi">WelcomeFinish.nsi</a><br />
|
|
Multiple languages: <a href="../../Examples/Modern%20UI/MultiLanguage.nsi">MultiLanguage.nsi</a><br />
|
|
Header image: <a href="../../Examples/Modern%20UI/HeaderBitmap.nsi">HeaderBitmap.nsi</a><br />
|
|
Custom pages: <a href="../../Examples/Modern%20UI/InstallOptions.nsi">InstallOptions.nsi</a><br />
|
|
Start Menu Folder page: <a href="../../Examples/Modern%20UI/StartMenu.nsi">StartMenu.nsi</a></p>
|
|
<h1>Customize the dialogs</h1>
|
|
<p>To change elements on the dialogs, use customized UI resource files (see Interface settings).
|
|
You can change your copies of the original files (in the Contrib\UIs folder) by using an
|
|
application such as <a href="http://www.users.on.net/johnson/resourcehacker/">Resource
|
|
Hacker</a>.</p>
|
|
<p>The 'Please wait while Setup is loading...' text on the splash screen that is being displayed
|
|
while the installer is starting (Verifying installer, Unpacking data) can be changed by using a
|
|
customized UI resource file (MUI_UI setting) with a modified dialog 111.<br />
|
|
The 'Verifying installer' and 'Unpacking data' texts are defined in the language header file of the
|
|
NSIS exehead (Source\exehead\lang.h). To change them, you have to edit this file and recompile
|
|
NSIS.</p>
|
|
<p>To modify the Welcome- and Finish dialog, use a custom INI file (MUI_SPECIALINI setting) or
|
|
write to the INI file in the custom page functions.</p>
|
|
<h1><a name="customFunctions" id="customFunctions">Customize Modern UI Functions</a></h1>
|
|
<p>If you want add your own code to functions inserted by the Modern UI, such as the .onGUIInit
|
|
function and the Page functions, create your own function and let the Modern UI functions call
|
|
them. Use the defines to define the name of your functions.</p>
|
|
<p>Example:</p>
|
|
<pre class="text">
|
|
!define MUI_CUSTOMFUNCTION_GUIINIT myGuiInit
|
|
|
|
Function myGUIInit
|
|
...your own code...
|
|
FunctionEnd
|
|
</pre>
|
|
<h3>General Custom Functions</h3>
|
|
<div>
|
|
<p>These defines should be set before inserting a the language macros.</p>
|
|
<p><strong>MUI_CUSTOMFUNCTION_GUIINIT</strong> <span class="parameter">function</span><br />
|
|
<strong>MUI_CUSTOMFUNCTION_UNGUIINIT</strong> <span class="parameter">function</span><br />
|
|
<strong>MUI_CUSTOMFUNCTION_ABORT</strong> <span class="parameter">function</span><br />
|
|
<strong>MUI_CUSTOMFUNCTION_UNABORT</strong> <span class="parameter">function</span></p>
|
|
</div>
|
|
<h3>Page Custom Functions</h3>
|
|
<div>
|
|
<p>These defines should be set before inserting a page macro.</p>
|
|
<p><strong>MUI_PAGE_CUSTOMFUNCTION_PRE</strong> <span class="parameter">function</span><br />
|
|
<strong>MUI_PAGE_CUSTOMFUNCTION_SHOW</strong> <span class="parameter">function</span><br />
|
|
<strong>MUI_PAGE_CUSTOMFUNCTION_LEAVE</strong> <span class="parameter">function</span></p>
|
|
<p><strong>Notes:</strong></p>
|
|
<ul>
|
|
<li>The StartMenu page does not have a Show function</li>
|
|
<li>In the Pre function of the Welcome- and Finish page, you can write to the InstallOptions INI
|
|
file of the page (ioSpecial.ini)</li>
|
|
<li>In the Show function of Welcome- and Finish page, $MUI_HWND contains the HWND of the inner
|
|
dialog</li>
|
|
</ul>
|
|
</div>
|
|
<h1>Version history</h1>
|
|
<ul>
|
|
<li>1.67 - November 9, 2003
|
|
<ul>
|
|
<li>Support for uninstaller Welcome- and Finish pages</li>
|
|
<li>Improved and changed text settings</li>
|
|
<li>ID for Start Menu Folder pages, easier to use multiple pages</li>
|
|
<li>Renamed a few settings</li>
|
|
<li>Default header image</li>
|
|
<li>Support for uninstaller abort warning</li>
|
|
<li>Setting for 3 line text on Welcome- and Finish page</li>
|
|
<li>Langauge file backwards compatibility: English for missing strings</li>
|
|
<li>Support for different uninstaller header image</li>
|
|
<li>Language selection dialog not displayed if installer is silent</li>
|
|
<li>Cancel button on Finish page when there are options</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<li>1.66 - October 7, 2003
|
|
<ul>
|
|
<li>New system for page settings and custom pages</li>
|
|
<li>Support for uninstaller components page</li>
|
|
<li>Support for multiple pages of the same type</li>
|
|
<li>New possition for interface settings</li>
|
|
<li>Changed macro, setting names</li>
|
|
<li>Updated langauge system, new language files and settings</li>
|
|
<li>Removed MUI_PRODUCT and MUI VERSION. Use Name command now.</li>
|
|
<li>Removed MUI_BRANDINGTEXT. Use BrandingText command now.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<li>1.65 - August 12, 2003
|
|
<ul>
|
|
<li>New page configuration system, no different system for installers with custom pages</li>
|
|
<li>Default windows color for the license text background</li>
|
|
<li>Example script updates (new format, user variables)</li>
|
|
<li>Improved registry storage for Start Menu folder</li>
|
|
<li>ReserveFile macro for StartMenu plug-in</li>
|
|
<li>Option to always show the language selection dialog (even if a language has been stored in the
|
|
registry)</li>
|
|
<li>Checkboxes on Finish page can be used to call a function</li>
|
|
<li>Support for custom leave functions for Start Menu Folder, Welcome and Finish pages</li>
|
|
<li>Support for a link on the Finish page</li>
|
|
<li>New macro to get Start Menu folder in uninstaller</li>
|
|
<li>Options to disable bitmap stretching</li>
|
|
<li>Components page description box info text: always displayed when mouse is outside box, disabled
|
|
style</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<ul>
|
|
<li>1.64 - April 27, 2003
|
|
<ul>
|
|
<li>Support for license page with checkbox or radiobuttons to let the user accept the agreement or
|
|
not</li>
|
|
<li>Macros for finish headers don't have to be inserted anymore</li>
|
|
<li>Language preference stored when installation has completed, no problems anymore when the users
|
|
selects the wrong language</li>
|
|
<li>Header text for aborted installation</li>
|
|
<li>New macros: get language for uninstaller, delete shortcuts</li>
|
|
<li>Language specific fonts</li>
|
|
<li>Welcome/Finish page INI files can be modified in pre functions</li>
|
|
<li>More texts can be customized</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p><a href="Changelog.txt">Complete version history</a></p>
|
|
<h1>Credits</h1>
|
|
<p>Made by Joost Verburg.<br />
|
|
Icons designed by Nikos Adamamas, aka adni18.<br />
|
|
Thanks to Amir Szekely, aka KiCHiK, for his work on NSIS to make this possible.</p>
|
|
<h1>Help</h1>
|
|
<p>Please post questions at the <a href="http://forums.winamp.com/forumdisplay.php?forumid=65">NSIS
|
|
Forum</a>.</p>
|
|
<h1>License</h1>
|
|
<pre>
|
|
Copyright © 2002-2003 Joost Verburg
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
warranty. In no event will the authors be held liable for any damages
|
|
arising from the use of this software.
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
including commercial applications, and to alter it and redistribute
|
|
it freely, subject to the following restrictions:
|
|
|
|
1. The origin of this software must not be misrepresented;
|
|
you must not claim that you wrote the original software.
|
|
If you use this software in a product, an acknowledgment in the
|
|
product documentation would be appreciated but is not required.
|
|
2. Altered versions must be plainly marked as such,
|
|
and must not be misrepresented as being the original software.
|
|
3. This notice may not be removed or altered from any distribution.
|
|
</pre></div>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<div class="footer">©2002-2003 Joost Verburg</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</body>
|
|
</html>
|