Wix 3升级至Wix 5后UI异常：打印按钮报错、自定义对话框不显示

问题1：LicenseAgreementDlg打印按钮无操作报错 #

升级后触发报错：“LicenseAgreementDlg的打印按钮未在ControlEvent表中定义事件，是一个无操作按钮”

原因 #

Wix 5对内置对话框的ControlEvent处理更严格，Wix 3中默认绑定的打印事件在Wix 5中需要显式声明。你的第一种UI配置引用了LicenseAgreementDlg，但未给打印按钮添加对应的事件触发逻辑。

修复方法 #

在<UI Id="WixUI_EAS">节点内添加打印按钮的Publish事件：

<Publish Dialog="LicenseAgreementDlg" Control="Print" Event="DoAction" Value="WixUIPrintEula" />

该事件会调用Wix内置的WixUIPrintEula动作处理协议打印。

问题2：自定义对话框无法显示 #

第二种配置中，自定义的MyCustomDialog无法在UI流程中出现。

原因 #

使用<ui:WixUI Id="WixUI_InstallDir" />引用内置UI序列时，内置的InstallDirDlg→VerifyReadyDlg的Next按钮事件优先级高于你自定义的Publish语句，导致跳转逻辑被覆盖。

修复方法 #

提供两种可行解决方案：

方式1：禁用内置UI的默认Next按钮事件

通过ui:WixUI的Suppress属性去掉内置的InstallDirDlg的Next事件，让自定义跳转生效：

<ui:WixUI Id="WixUI_InstallDir" Suppress="InstallDirDlg_Next" />

方式2：完全自定义UI序列（推荐）

如果需要更多自定义空间，建议手动引用所需内置对话框并定义完整导航逻辑，避免内置UI默认行为冲突。修改后的配置示例：

<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs" xmlns:ui="http://wixtoolset.org/schemas/v4/wxs/ui">
    <Fragment>
        <UI Id="MyCustomUI">
            <TextStyle Id="WixUI_Font_Normal" FaceName="Tahoma" Size="8" />
            <Property Id="DefaultUIFont" Value="WixUI_Font_Normal" />
            <Property Id="WIXUI_INSTALLDIR" Value="INSTALLFOLDER"/>

            <!-- 引用所需内置对话框 -->
            <DialogRef Id="WelcomeDlg" />
            <DialogRef Id="InstallDirDlg" />
            <DialogRef Id="VerifyReadyDlg" />
            <DialogRef Id="ExitDialog" />
            <DialogRef Id="ErrorDlg" />
            <DialogRef Id="FatalError" />

            <!-- 自定义对话框 -->
            <Dialog Id="MyCustomDialog" Width="370" Height="270" Title="[ProductName] Setup">       
                <Control Id="BannerBitmap" Type="Bitmap" X="0" Y="0" Width="370" Height="44" TabSkip="no" Text="!(loc.LicenseAgreementDlgBannerBitmap)" />
                <Control Id="BannerLine" Type="Line" X="0" Y="44" Width="370" Height="0" />
                <Control Id="BottomLine" Type="Line" X="0" Y="234" Width="370" Height="0" />
                <Control Id="Description" Type="Text" X="25" Y="23" Width="340" Height="15" Transparent="yes" NoPrefix="yes" Text="Set general setup options" />
                <Control Id="Title" Type="Text" X="15" Y="6" Width="200" Height="15" Transparent="yes" NoPrefix="yes" Text="{\WixUI_Font_Title}General Options" />
                <Control Id="RestoreConfig" Type="CheckBox" X="20" Y="71" Width="330" Height="18" CheckBoxValue="1" Property="RESTORECONFIGFILE" Text="Reset all settings and configuration files to factory defaults" />
                <Control Id="Back" Type="PushButton" X="180" Y="243" Width="56" Height="17" Text="!(loc.WixUIBack)" />
                <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Default="yes" Text="!(loc.WixUINext)" />
                <Control Id="Cancel" Type="PushButton" X="304" Y="243" Width="56" Height="17" Cancel="yes" Text="!(loc.WixUICancel)" />                     
            </Dialog>

            <!-- 完整导航逻辑 -->
            <Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="InstallDirDlg" />
            
            <Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="WelcomeDlg" />
            <Publish Dialog="InstallDirDlg" Control="Next" Event="NewDialog" Value="MyCustomDialog" />
            
            <Publish Dialog="MyCustomDialog" Control="Back" Event="NewDialog" Value="InstallDirDlg" />
            <Publish Dialog="MyCustomDialog" Control="Next" Event="NewDialog" Value="VerifyReadyDlg" />
            
            <Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="MyCustomDialog" />
            <Publish Dialog="VerifyReadyDlg" Control="Cancel" Event="NewDialog" Value="ExitDialog" />
            
            <Publish Dialog="ExitDialog" Control="Finish" Event="EndDialog" Value="Return" Order="999" />
        </UI>
        <UIRef Id="WixUI_Common" />
    </Fragment>
</Wix>

这种方式完全掌控UI流程，避免内置逻辑干扰。

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