diff --git a/Contrib/Modern UI/Readme.html b/Contrib/Modern UI/Readme.html index 73a6be4b..d56a2fc8 100644 --- a/Contrib/Modern UI/Readme.html +++ b/Contrib/Modern UI/Readme.html @@ -139,14 +139,14 @@ follow these steps:

should insert. Most defines (i.e. MUI_WELCOMEPAGE) don't need a value, there are true/false settings. Others (i.e. MUI_FINISHPAGE_RUN) can be used to define a specific - value, the value type is given next to the define name: - MUI_FINISHPAGE_RUN [exe_file]. - When there multiple values or optional flags, put them all - between the quotes.

+ value: the value type is given next to the define name: + MUI_DEFINE (required) (option1 | option2) [optional]. + When there are multiple values or optional flags, put them all + between the quotes of a define value.

 !define MUI_WELCOMEPAGE ;No value
 !define MUI_FINISHPAGE_RUN "$INSTDIR\Application.exe" ;Value
-!define MUI_FONTSTYLE_HEADER "700 /ITALIC"
+!define MUI_FONTSTYLE_HEADER "700 /ITALIC" ;Multiple values

All defines are optional.

3a. General settings

@@ -178,17 +178,17 @@ follow these steps:

-

MUI_STARTMENUPAGE_VARIABLE [variable]
+

MUI_STARTMENUPAGE_VARIABLE (variable)
Variable to store the current Start Menu Folder. Default is $9. - You cannot use this variable in your script (or you should Push/Pop it).e.

-

MUI_STARTMENUPAGE_DEFAULTFOLDER [folder]
+ You cannot use this variable in your script (or you should Push/Pop it).

+

MUI_STARTMENUPAGE_DEFAULTFOLDER (folder)
The default Start Menu Folder. Use $(LANGSTRINGNAME) as value is you want to use a language string.

MUI_STARTMENUPAGE_NODISABLE
Do not display the checkbox to disable the creation of Start Menu shortcuts.

-

MUI_STARTMENUPAGE_REGISTRY_ROOT [root], - MUI_STARTMENUPAGE_REGISTRY_KEY [key], MUI_STARTMENUPAGE_REGISTRY_VALUENAME [value_name]
+

MUI_STARTMENUPAGE_REGISTRY_ROOT (root), + MUI_STARTMENUPAGE_REGISTRY_KEY (key), MUI_STARTMENUPAGE_REGISTRY_VALUENAME (value_name)
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 @@ -200,17 +200,17 @@ follow these steps:

If the reboot flag is set, a page that allows the user to reboot the system will be displayed (this option can be disabled).

-

MUI_FINISHPAGE_RUN [exe_file]
+

MUI_FINISHPAGE_RUN (exe_file)
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.

-

MUI_FINISHPAGE_RUN_PARAMETERS [parameters]
+

MUI_FINISHPAGE_RUN_PARAMETERS (parameters)
Parameters for the application to run. Don't forget to escape double quotes in the value (use $\").

MUI_FINISHPAGE_RUN_NOTCHECKED
Do not check the 'Run program' checkbox by default

-

MUI_FINISHPAGE_SHOWREADME [file/url]
+

MUI_FINISHPAGE_SHOWREADME (file/url)
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. Use $(LANGSTRINGNAME) as value is you want to use a language string.

@@ -242,55 +242,54 @@ follow these steps:

UninstPage commands to add your own pages.

3b. Interface settings

-

If a defualt value is specified after the define name and values, the default will - be used when the value has not been defined.

-

MUI_UI [ui_file] (${NSISDIR}\Contrib\UIs\modern.exe)
- The interface file with the dialog resources. Change this if you have made your own customized UI.

-

MUI_UI_HEADERBITMAP [ui_file], MUI_UI_HEADERBITMAP_RIGHT [ui_file] - (${NSISDIR}\Contrib\UIs\modern-headerbmp(r).exe)
+

For UI elements that are enabled by default, the default value will be used when a setting + has not been defined.

+

MUI_UI (ui_file)
+ The interface file with the dialog resources. Change this if you have made your own customized UI.
+ Default: ${NSISDIR}\Contrib\UIs\modern.exe

+

MUI_UI_HEADERBITMAP (ui_file), MUI_UI_HEADERBITMAP_RIGHT (ui_file)
The interface files with the dialog resource IDD_INST that contains a bitmap control and space for - the header bitmap.

+ the header bitmap.
Default: ${NSISDIR}\Contrib\UIs\modern-headerbmp(r).exe

MUI_UI_SMALLDESCRIPTION, MUI_UI_NODESCRIPTION (${NSISDIR}\Contrib\UIs\modern-(small/no)desc.exe)
The interface files with a customized dialog resource IDD_SELCOM for a small or no description area.

-

MUI_ICON [icon_file] (${NSISDIR}\Contrib\Icons\modern-install.ico)
- The icon of the installer.

-

MUI_UNICON [icon_file] (${NSISDIR}\Contrib\Icons\modern-uninstall.ico)
- The icon of the uninstaller.

-

MUI_CHECKBITMAP [bitmap_file] (${NSISDIR}\Contrib\Icons\modern.bmp)
- The bitmap with images for the checks of the component select treeview.

-

MUI_FONT [font_name], MUI_FONTSIZE [font_size] (MS Shell Dlg, 8)
- The font for the normal texts.

-

MUI_FONT_HEADER [font_name], MUI_FONTSIZE_HEADER [font_size], MUI_FONTSTYLE_HEADER - [weight] [/ITALIC] [/UNDERLINE] [/STRIKE] - (MS Shell Dlg, 8, 700)
- The font for the title in the header.

-

MUI_FONT_TITLE [font_name], MUI_FONTSIZE_TITLE [font_size], MUI_FONTSTYLE_TITLE - [weight] [/ITALIC] [/UNDERLINE] [/STRIKE] - (Verdana, 12, 700)
- The font for the title on the Welcome and Finish page.

-

MUI_INSTALLCOLORS [foreground color, RRBBGG] [background color, RRGGBB] - (/windows)
The colors of the details screen. Use /windows instead of the colors to use the Windows - colors (the default).

-

MUI_PROGRESSBAR (smooth)
- The style of the progress bar ("colored" to use the MUI_INSTALLCOLORS or "" for an old-school - windows look).

-

MUI_HEADERBITMAP [bmp_file] (not defined)
- Bitmap to display in the white header. With the default DPI, a bitmap with a size 150x57 won't have to be resized. - An example of a header bitmap is ${NSISDIR}\Contrib\Icons\modern-header.bmp, but can also make one with your own - logo.

+

MUI_ICON (icon_file)
+ The icon of the installer.
Default: ${NSISDIR}\Contrib\Icons\modern-install.ico

+

MUI_UNICON (icon_file)
+ The icon of the uninstaller.
Default: ${NSISDIR}\Contrib\Icons\modern-uninstall.ico

+

MUI_CHECKBITMAP (bitmap_file)
+ The bitmap with images for the checks of the component select treeview.
+ Default: ${NSISDIR}\Contrib\Icons\modern.bmp

+

MUI_FONT (font_name), MUI_FONTSIZE (font_size)
+ The font for the normal texts.
Defaults: MS Shell Dlg, 8

+

MUI_FONT_HEADER (font_name), MUI_FONTSIZE_HEADER (font_size), MUI_FONTSTYLE_HEADER + (weight) [/ITALIC] [/UNDERLINE] [/STRIKE]
The font for the title in the header.
+ Defaults: MS Shell Dlg, 8, 700

+

MUI_FONT_TITLE (font_name), MUI_FONTSIZE_TITLE (font_size), MUI_FONTSTYLE_TITLE + (weight) [/ITALIC] [/UNDERLINE] [/STRIKE]
+ The font for the title on the Welcome and Finish page.
Defaults: Verdana, 12, 700

+

MUI_INSTALLCOLORS (/windows | (foreground color: RRBBGG) + (background color: RRGGBB)) +
The colors of the details screen. Use /windows instead of the colors to use the Windows + colors (the default).
Default: /windows

+

MUI_PROGRESSBAR ("" | colored | smooth)
+ The style of the progress bar. Colored makes it use the MUI_INSTALLCOLORS.
Default: smooth

+

MUI_HEADERBITMAP (bmp_file)
+ Bitmap to display in the white header. With the default DPI, a bitmap with a size 150x57 + won't have to be resized. An example of a header bitmap is ${NSISDIR}\Contrib\Icons\modern-header.bmp, + but can also make one with your own logo.

-

MUI_HEADERBITMAP_RIGHT (not defined)
- If you have defines MUI_HEADERBITMAP, define this setting if you want the header image to be displayed on the right - side of the header instead of the left side.

+

MUI_HEADERBITMAP_RIGHT
+ Display the header image on the right side instead of the left side.

-

MUI_SPECIALINI [ini_file] (${NSISDIR}\Contrib\Modern UI\ioSpecial.ini)
- Install Options INI File for the Welcome and Finish page.

-

MUI_SPECIALBITMAP [bmp_file] (${NSISDIR}\Contrib\Icons\modern-wizard.bmp)
- Bitmap for the Welcome and Finish page.

-

MUI_BGCOLOR [color 0xBBGGRR] (0xFFFFFF)
- Background color for the header, Welcome page and Finish page.

-

MUI_RTL_UI (not defined)
+

MUI_SPECIALINI (ini_file)
+ Install Options INI File for the Welcome and Finish page.
+ Default: ${NSISDIR}\Contrib\Modern UI\ioSpecial.ini

+

MUI_SPECIALBITMAP (bmp_file)
+ Bitmap for the Welcome and Finish page.
Default: ${NSISDIR}\Contrib\Icons\modern-wizard.bmp

+

MUI_BGCOLOR (color: 0xBBGGRR)
+ Background color for the header, Welcome page and Finish page.
Default: 0xFFFFFF

+

MUI_RTL_UI
Right-to-left interface.

4. Define custom functions (optional)

If you want add your own code to functions inserted by the