Custimising UI Library Dialog, I cant understand value of order attribute of publish element

[AsladaGSX]

I'm beginner of MSI Installer, WixToolset and English language, sorry.

I cant understand document of Order attribute of Publish element.
I test below with changing Order attribute value.

    <UI Id="UI">
      <ui:WixUI Id="WixUI_InstallDir" InstallDirectory="INSTALLFOLDER" />
      <UIRef Id="WixUI_ErrorProgressText" />
      <UIRef Id="NetworkSettingsDlg" />
      <Publish Dialog="InstallDirDlg" Control="Next" Order="3" Event="NewDialog" Value="NetworkSettingsDlg" />
    </UI>

Order=-1 case.

error WIX0123: The Publish/@Order attribute's value, '-1', is not in the range of legal values. Legal values for this attribute are from 0 to 2

oh, i see. Legal values is from 0 to 2? mmm...

Order=0. compilation is succeeded with this value, and i use dark.exe for build msi file and resuls below.

            <Dialog Id="InstallDirDlg" X="50" Y="50" Width="370" Height="270" Title="[ProductName] Setup">
                <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Text="&amp;Next" TabSkip="no" Default="yes">
                    <Publish Event="NewDialog" Value="NetworkSettingsDlg">1</Publish>
                    <Publish Event="CheckTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
                </Control>

CheckTargetPath, setTargetPath, NewDialog Elements order = 1,3,4.
and Inserted Publish Element's order = 0.
sorted by Order value. beautiful.

Order=1. compilation is succeeded with this value, and i use dark.exe for build msi file and resuls below.

            <Dialog Id="InstallDirDlg" X="50" Y="50" Width="370" Height="270" Title="[ProductName] Setup">
                <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Text="&amp;Next" TabSkip="no" Default="yes">
                    <Publish Event="CheckTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="NewDialog" Value="NetworkSettingsDlg">1</Publish>
                    <Publish Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
                </Control>

Inserted Publish element is after CheckTargetPath Publish element has same order value '1' too.

Order=2. compilation is succeeded with this value, and i use dark.exe for build msi file and resuls same as Order=1 case.
sorted by Order value. ok.

Order=3. this value is not legal values of Order=-1 case's error message. Compilation is succeeded. mmm.

            <Dialog Id="InstallDirDlg" X="50" Y="50" Width="370" Height="270" Title="[ProductName] Setup">
                <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Text="&amp;Next" TabSkip="no" Default="yes">
                    <Publish Event="CheckTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="NewDialog" Value="NetworkSettingsDlg">1</Publish>
                    <Publish Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
                </Control>

Inserted Publish element is before SetTargetPath Publish element has same order value '3' too.
Its different action from Order=1 case. ...???
I think inserted publish element will be ordered after SetTargetPath Publish element.

Order=4.

            <Dialog Id="InstallDirDlg" X="50" Y="50" Width="370" Height="270" Title="[ProductName] Setup">
                <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Text="&amp;Next" TabSkip="no" Default="yes">
                    <Publish Event="CheckTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="NewDialog" Value="NetworkSettingsDlg">1</Publish>
                    <Publish Event="NewDialog" Value="VerifyReadyDlg">1</Publish>

Same act from Order=3 case. Inserted Publish element is ordered before NewDialog VerifyReadyDlg Publish element has same order value '4'.
and pushing Next button shows VerifyReadyDlg (not expected results).

Order=5.

            <Dialog Id="InstallDirDlg" X="50" Y="50" Width="370" Height="270" Title="[ProductName] Setup">
                <Control Id="Next" Type="PushButton" X="236" Y="243" Width="56" Height="17" Text="&amp;Next" TabSkip="no" Default="yes">
                    <Publish Event="CheckTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="SetTargetPath" Value="[WIXUI_INSTALLDIR]">1</Publish>
                    <Publish Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
                    <Publish Event="NewDialog" Value="NetworkSettingsDlg">1</Publish>

sorted by Order value. and pushing Next button shows NetworkSettingsDlg (expected results).

experiment is over.

In the end, I couldn't understand the legitimate behavior of this attribute.
What is expected behavior?

Using:
WIx in Heatwave extention for VisualStudio 2022.

> C:\Users\user\.nuget\packages\wixtoolset.sdk\6.0.0\tools\net472\x64\wix.exe --version
6.0.0+8c7432e

dark.exe is in WiX Toolset v3.11

[robmen]

Are you sure that first error message wasn't cut off? Based on the code, it should look like:

error WIX0123: The Publish/@Order attribute's value, '-1', is not in the range of legal values. Legal values for this attribute are from 0 to 2147483647

[AsladaGSX]

The console was still open and the error message was still there.
error message is wrapped after 2. next line starts with 147483647.
sorry.

[AsladaGSX]

I am still interested in the random order Publish elements are placed in.