NSIS安装器Finish页Checkbox需Hover才显示及页面元素消失问题

常见问题原因 #

• 控件位置/尺寸和Finish页面原生控件（完成按钮、提示文本等）重叠，导致被遮挡，仅在鼠标hover触发控件重绘时才会显示，同时覆盖了原本的完成内容。
• 在onGUIEnd以外的错误时机创建控件，未利用NSIS提供的Finish页面专用回调初始化自定义控件，导致控件与页面原生元素的渲染逻辑冲突。
• 控件Z-order层级设置错误，被页面原生控件压在底层，无法正常显示。

正确实现方法 #

1. 基础版实现（适配默认Finish页面） #

通过Finish页面的专用回调创建控件，确保与原生元素不重叠：

!include "MUI2.nsh"

; 存储复选框句柄的变量
Var DesktopShortcutCheck

; 配置安装页面
!insertmacro MUI_PAGE_WELCOME
!insertmacro MUI_PAGE_INSTFILES
!insertmacro MUI_PAGE_FINISH

!insertmacro MUI_LANGUAGE "SimpChinese"

; Finish页面显示完成后的回调，在这里创建自定义控件
Function .onGUIEnd
  ; 获取Finish页面窗口句柄
  FindWindow $0 "#32770" "" $HWNDPARENT
  ; 创建复选框，注意坐标避开原生控件（示例放在完成按钮上方区域）
  CreateWindowEx 0 "Button" "创建桌面快捷方式" ${BS_AUTOCHECKBOX}|${WS_CHILD}|${WS_VISIBLE}|${WS_TABSTOP} 120 160 180 12 $0 1001 $INSTDIR
  Pop $DesktopShortcutCheck
  ; 默认勾选复选框
  SendMessage $DesktopShortcutCheck ${BM_SETCHECK} ${BST_CHECKED} 0
FunctionEnd

; 安装成功后根据复选框状态创建快捷方式
Function .onInstSuccess
  SendMessage $DesktopShortcutCheck ${BM_GETCHECK} 0 0 $0
  ${If} $0 == ${BST_CHECKED}
    ; 替换为你的程序路径和快捷方式名称
    CreateShortCut "$DESKTOP\我的软件.lnk" "$INSTDIR\MyApp.exe"
  ${EndIf}
FunctionEnd

2. MUI自定义Finish页面适配版 #

如果使用MUI的自定义Finish页面模板，推荐用官方指定的回调函数：

!include "MUI2.nsh"

Var DesktopShortcutCheck

; 指定Finish页面的显示回调
!define MUI_FINISHPAGE_CUSTOMFUNCTION_SHOW FinishPageShow
!insertmacro MUI_PAGE_WELCOME
!insertmacro MUI_PAGE_INSTFILES
!insertmacro MUI_PAGE_FINISH

!insertmacro MUI_LANGUAGE "SimpChinese"

Function FinishPageShow
  ; 创建复选框，坐标适配MUI默认布局
  CreateWindowEx 0 "Button" "创建桌面快捷方式" ${BS_AUTOCHECKBOX}|${WS_CHILD}|${WS_VISIBLE}|${WS_TABSTOP} 10 120 250 12 $HWNDPARENT 1001 $INSTDIR
  Pop $DesktopShortcutCheck
  SendMessage $DesktopShortcutCheck ${BM_SETCHECK} ${BST_CHECKED} 0
FunctionEnd

Function .onInstSuccess
  SendMessage $DesktopShortcutCheck ${BM_GETCHECK} 0 0 $0
  ${If} $0 == ${BST_CHECKED}
    CreateShortCut "$DESKTOP\我的软件.lnk" "$INSTDIR\MyApp.exe"
  ${EndIf}
FunctionEnd

关键注意事项 #

• 坐标调试：如果仍出现重叠问题，可以用Resource Hacker等工具查看Finish页面原生控件的位置，微调CreateWindowEx中的X/Y坐标和宽高数值。
• 层级修复：若控件仍被遮挡，可在创建后添加BringWindowToTop $DesktopShortcutCheck将其置顶，但优先通过调整坐标避免重叠更稳妥。

内容的提问来源于stack exchange，提问作者Tần Quảng