admin 管理员组

文章数量: 1086019


2024年3月13日发(作者:execution语法)

NSIS 的 Modern UI 教程

NSIS 2.0 版本支持定制的用户界面。所谓的 Modern UI(下称 MUI) 就是一种模仿最新的

Windows 界面风格的界面系统。MUI 改变了 NSIS 脚本的编写习惯,它使用 NSIS 的宏来表达,

指定 MUI 的属性需要使用宏。所以,诸如 LicenseText, Icon, CheckBitmap, InstallColors 在 MUI

中失去意义。

MUI 的内置向导页面

和安装程序有关的向导页面

MUI_PAGE_WELCOME 该向导页面显示欢迎信息

MUI_PAGE_LICENSE text/rtf_file 该向导页面显示软件授权申明

MUI_PAGE_COMPONENTS 该向导页面显示安装组件选择

MUI_PAGE_DIRECTORY 该向导页面显示安转目录选择

MUI_PAGE_STARTMENU page_id variable 该向导页面显示开始菜单目录选择

MUI_PAGE_INSTFILES 该向导页面显示安装进度

MUI_PAGE_FINISH 该向导页面显示安装结束

和卸载程序有关的向导页面

MUI_UNPAGE_WELCOME

MUI_UNPAGE_CONFIRM

MUI_UNPAGE_LICENSE text/rtf_file

MUI_UNPAGE_COMPONENTS

MUI_UNPAGE_DIRECTORY

MUI_UNPAGE_INSTFILES

MUI_UNPAGE_FINISH

页面的属性设定需要放在插入页面的宏之前。比如:

Var PLUGINS_FOLDER

!define MUI_DIRECTORYPAGE_VARIABLE $PLUGINS_FOLDER

!insertmacro MUI_PAGE_DIRECTORY

这段 nsi 脚本表示,将目录选择页面中用户选择的目录位置存放到变量 $PLUGINS_FOLDER 中

去。

以下是 MUI 各个内置向导页面属性说明:

所有页面适用的属性

MUI_PAGE_HEADER_TEXT text

显示在向导页头上的文字

MUI_PAGE_HEADER_SUBTEXT text

显示在向导页头上的文字,它是通常显示在 MUI_PAGE_HEADER_TEXT 之下,表示对

MUI_PAGE_HEADER_TEXT 的进一步解释。

对于使用 InstallOptions 的定制界面,使用宏 !insertmacro MUI_HEADER_TEXT "$(TEXT_IO_TITLE)"

"$(TEXT_IO_SUBTITLE)" 实现类似功能。

欢迎页面属性

MUI_WELCOMEPAGE_TITLE title

显示在欢迎向导页上的标题

MUI_WELCOMEPAGE_TITLE_3LINES

标题区的空格

MUI_WELCOMEPAGE_TEXT text

显示在欢迎向导页上的文字。使用rn换行。

通常这些属性不需要制定,省缺的值已经足够。

软件授权页面属性

在软件授权页面中可以定制用户接受软件授权许可的三种方式,一是按钮,二是 checkbox,三

是 radio。

MUI_LICENSEPAGE_TEXT_TOP text

显示在页面顶部的文字

MUI_LICENSEPAGE_TEXT_BOTTOM text

显示在页面底部的文字

MUI_LICENSEPAGE_BUTTON button_text

按钮方式时按钮上的文字

MUI_LICENSEPAGE_CHECKBOX

定义此宏表示用户需要钩选该 checkbox 来接受软件许可

MUI_LICENSEPAGE_CHECKBOX_TEXT text

在 checkbox 旁显示的文字

MUI_LICENSEPAGE_RADIOBUTTONS

定义此宏表示用户需要钩选相应的 radio box 来接受或拒绝软件许可

MUI_LICENSEPAGE_RADIOBUTTONS_TEXT_ACCEPT text

在 radio 旁显示的表示接受的文字

MUI_LICENSEPAGE_RADIOBUTTONS_TEXT_DECLINE text

在 radio 旁显示的表示拒绝的文字

安装组件选择页面属性

MUI_COMPONENTSPAGE_TEXT_TOP text

显示在页面顶部的文字

MUI_COMPONENTSPAGE_TEXT_COMPLIST text

显示在组件列表旁边的文字


本文标签: 页面 向导 显示 选择 属性