如何阻止WiX Toolset(v5)安装器双击标题栏时窗口上移？

1. 使用默认WixUI模板的解决方式 #

默认WixUI系列模板（如WixUI_Minimal、WixUI_InstallDir）的对话框默认允许最大化操作，双击标题栏会触发系统的最大化/还原逻辑，导致窗口移位。你可以通过覆盖默认对话框的属性来禁用该行为：

<UI>
  <UIRef Id="WixUI_Minimal" />
  <!-- 覆盖主安装对话框 -->
  <DialogRef Id="InstallDirDlg">
    <Property Id="InstallDirDlg_NoResize" Value="yes" />
    <Property Id="InstallDirDlg_WindowStyle" Value="13565952" /> <!-- 对应WS_POPUP | WS_CAPTION | WS_SYSMENU | WS_MINIMIZEBOX -->
  </DialogRef>
  <!-- 覆盖欢迎对话框（如果需要） -->
  <DialogRef Id="WelcomeDlg">
    <Property Id="WelcomeDlg_NoResize" Value="yes" />
    <Property Id="WelcomeDlg_WindowStyle" Value="13565952" />
  </DialogRef>
</UI>

WindowStyle的数值是去掉WS_MAXIMIZEBOX样式后的组合值，这样双击标题栏不会触发系统默认的最大化/还原动作，窗口将保持固定位置。NoResize="yes"同时禁用了拖拽调整窗口大小的功能。

2. 自定义对话框的解决方式 #

如果是你自行定义的对话框，直接在<Dialog>元素中设置对应属性即可：

<Dialog Id="MyCustomInstallDlg" Width="370" Height="270" Title="自定义安装程序" NoResize="yes" WindowStyle="13565952">
  <!-- 对话框控件定义 -->
  <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUINext)" />
  <Control Id="Back" Type="PushButton" X="180" Y="243" Width="56" Height="17" Text="!(loc.WixUIBack)" />
  <Control Id="Cancel" Type="PushButton" X="304" Y="243" Width="56" Height="17" Cancel="yes" Text="!(loc.WixUICancel)">
    <Publish Event="SpawnDialog" Value="CancelDlg">1</Publish>
  </Control>
</Dialog>

3. 进阶：自定义动作彻底禁用双击行为（特殊场景） #

如果上述方法无法满足需求，可通过Win32自定义动作子类化窗口，拦截双击标题栏的消息：

1. 编写导出函数的DLL：

#include <windows.h>
#include <msiquery.h>

UINT __stdcall DisableTitleBarDoubleClick(MSIHANDLE hInstall)
{
    HWND hWnd = MsiGetActiveWindow(hInstall);
    if (hWnd != NULL)
    {
        WNDPROC oldProc = (WNDPROC)SetWindowLongPtr(hWnd, GWLP_WNDPROC, (LONG_PTR)[](HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam) -> LRESULT {
            if (msg == WM_NCLBUTTONDBLCLK)
            {
                // 拦截双击标题栏消息，不执行默认逻辑
                return 0;
            }
            return CallWindowProc((WNDPROC)GetWindowLongPtr(hwnd, GWLP_USERDATA), hwnd, msg, wParam, lParam);
        });
        SetWindowLongPtr(hWnd, GWLP_USERDATA, (LONG_PTR)oldProc);
    }
    return ERROR_SUCCESS;
}

2. 在WiX中引用并触发该动作：

<Binary Id="CustomActions.dll" SourceFile="你的DLL路径/CustomActions.dll" />
<CustomAction Id="DisableTitleBarDoubleClick" BinaryKey="CustomActions.dll" DllEntry="DisableTitleBarDoubleClick" Execute="immediate" Return="check" />

<UI>
  <UIRef Id="WixUI_Minimal" />
  <Publish Dialog="WelcomeDlg" Control="Next" Event="DoAction" Value="DisableTitleBarDoubleClick">1</Publish>
</UI>

最佳实践总结 #

• 优先使用WiX内置的对话框属性设置（NoResize和WindowStyle），这是最简洁的现代方案，无需额外代码。
• 基于默认WixUI模板开发时，通过覆盖对话框属性修改样式，避免直接修改WixUI源文件。
• 自定义动作仅用于特殊场景，大部分常规需求通过前两种方法即可解决。

内容的提问来源于stack exchange，提问作者prashant