Yet Another WiX Tutorial Part 3: Customizing the UI dialogs

WiX_thumb Introduction

In a previous post I showed you how to use the UIExtensions library to add predefined user interfaces to you installer. These UIExtensions are easy to use, but what if none of these suit your needs. It is possible to customize the selected UI Extension and it is quit easy to do.

The following example will show you have to remove the LicenseAgreementDlg from the UI sequence of the WixUI_InstallDir extension.

Steps

Get the source code for the UIExtension

First thing you need to do is get the sources for the version of WiX you are using. After you have downloaded them, you van browse to the UIExtension folder to get the wxs fragment file that contains the extension

<SOURCE FOLDER>\src\ext\UIExtension\wixlib

When you open the extension WiX file (in this case WixUI_InstallDir) you will see a fragment with the ID used by the UIRef node.

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">

    <Fragment>

        <UI Id="WixUI_InstallDir">

The fragment contain a set of DialogRef nodes that refer to dialogs defined in fragment files in the same folder, and a series of Publish nodes, that define to order of the dialogs.

Add the fragment to you WiX script

Now select the complete UI node and add it to you WiX script.

<UI Id="WixUI_InstallDir">

	<TextStyle Id="WixUI_Font_Normal" FaceName="Tahoma" Size="8" />

	<TextStyle Id="WixUI_Font_Bigger" FaceName="Tahoma" Size="12" />

	<TextStyle Id="WixUI_Font_Title" FaceName="Tahoma" Size="9" Bold="yes" />

	<Property Id="DefaultUIFont" Value="WixUI_Font_Normal" />

	<Property Id="WixUI_Mode" Value="InstallDir" />

	<DialogRef Id="BrowseDlg" />

	<DialogRef Id="DiskCostDlg" />

	<DialogRef ... />

	

	<Publish Dialog="BrowseDlg" Control="OK" Event="DoAction" Value="WixUIValidatePath" Order="3">1</Publish>

	<Publish Dialog="BrowseDlg" Control="OK" Event="SpawnDialog" Value="InvalidDirDlg" Order="4"><![CDATA[WIXUI_INSTALLDIR_VALID<>"1"]]></Publish>

	<Publish> ... </Publish>

</UI>




Change the Dialog order



Now find the part where the LicenseAgreementDlg is Published. If you look at the dialog published before and the dialog Published after the LicenseAgreementDlg you will see that they are filling in events for two important controls, Next and Back.



<Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>

and

<Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>



To skip the LicenseAgreementDlg, we need to change the values of the Publish node to the appropriate dialog values.



<Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="InstallDirDlg">1</Publish>

and

<Publish Dialog="InstallDirDlg" Control="Back" Event="NewDialog" Value="WelcomeDlg">1</Publish>

Notice that we changed the values of the Publish node from LicenseAgreementDlg to the previous and next dialog ID. You can now remove the LicenseAgreementDlg Publish nodes if you want, or leave them to change back later. 


Happy Coding. 
  
Martijn.
  




































Comments








Post a Comment













Popular posts from this blog









Integrating WinMerge in Visual Studio




















Image







I've been using WinMerge for a long time now because i think it's the best, FREE, comparison and merge tool available today. What i really don't like is the comparison tool that ships with Visual Studio.   For instance, the following line has a difference, but what is the difference exactly. You can figure out what it is by really staring at the line OR use WinMerge instead.        The cool part about VS2008 is that you can configure a lot of things, and this also count for customizing tools.   To intergrate WinMerge follow these simple steps.           Go to tools -> options -> source control -> visual studio team foundation server -> "configure user tools" button.             Click Add             Choose the following settings                Extension: .*         Operation: Compare         Compare: C:\Program Files\WinMerge\WinMergeU.exe         Arguments: %1 %2       Now if you compare the files, you get the nice interface of WinMerge and can see di...








Read more










Encrypted Cookies using ASP.NET




















Image







 Introduction   In order to store use specific information during a ASP.Net session you have to option to place state data in a browser cookie . These cookie are send in plain text and using various tool it is possible to read the content of these cookies.   Although reading might not always be a problem, the ability to change the content of a cookie is a big thread. Tampering with the cookie is actually very easy, and i will demonstrate this using a Firefox extension called TamperData .   Tampering a Cookie   Setup   I started by creating a small ASP.NET application that checks the presence of our cookie. If not sets, a cookie is create and filled in the page load. After that i print the values on the page.     1: protected  void  Page_Load( object  sender, EventArgs e)   2: {   3:     if  (Request.Cookies[" __IGUZA.NET "] == null )   4:     {   5:         HttpCookie cookie = new  HttpCookie(" __IGUZA.NET ");   6:         cookie[" SomeKey "] = " Some...








Read more