Create custom pages
+ +
+
+
+
+ You can create custom pages with the ExperienceUI. The new plugin system, introduced in NSIS 2.0, allows insertion of
+ custom pages at any point in the installer. If you can't find a page that does what you need it to do, you can write a
+ custom page using InstallOptions and use the ExperienceUI to extract and call it.
+
+ Creating a custom ExperienceUI page takes even less effort than writing the NSIS code to display it yourself. See the macros
+ below for more information.
+
+
+
+
InstallOptions Macros
+ +
+
+
+
+ XPUI_INSTALLOPTIONS_EXTRACT ini_file Extracts the INI file "ini_file" to the plugins directory. This enables the file to be initialized by the ExperienceUI. XPUI_INSTALLOPTIONS_EXTRACT_AS old_ini new_ini Extracts "old_ini" to the plugins directory as "new_ini". XPUI_INSTALLOPTIONS_DISPLAY ini_file Shows the custom InstallOptions page in "ini_file" in the installer window. If you need a handle for the dialog, it is stored in $XPUI_HWND. When you call this, all of the dialog controls are automatically skinned. XPUI_INSTALLOPTIONS_INITDIALOG ini_file Initializes InstallOptions by creating the dialog in "ini_file", but does not show the window. When you call this, all of the dialog controls are automatically skinned. Just like a regular InstallOptions call, either the window handle or an error string will be returned on the top of the stack. XPUI_INSTALLOPTIONS_SHOW Shows the dialog initialized with XPUI_INSTALLOPTIONS_INITDIALOG. Not anything more than a glorified "InstallOptions::show". XPUI_INSTALLOPTIONS_READ $VAR "ini.file" "INI Section" Value Reads value "Value" from section "INI Section" in INI file "ini.file" into $VAR. XPUI_INSTALLOPTIONS_WRITE "ini.file" "INI Section" ValueName String Sets value "ValueName" from section "INI Section" in file "ini.file" to "String".
Example Custom Page
+
+
+
+
+
+
+
+