Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

GUI Preferences - <guiprefs>

This <guiprefs> element allows you to set the layout and behavior of the GUI when the installer runs. This information will not have any effect on the command-line installers that will be available in future versions of IzPack.The attributes that can be specified are:

Attribute NameDescriptionDefault Value
resizableIndicates whether the window size can be changed or not.no
widthSets the initial window width in pixels.600
heightSets the initial window height in pixels.480

...

The splash key modifier is used to indicate that the installer should show a splash screen.
The value of the splash key modifer represents the minimum amount of time to show the splash screen in milliseconds.
The image should be defined as a resource with the id of Splash.image.
The image can be any bitmap format such as png, jpg, jpeg, gif or bmp.
Note: Older installers using the <splash> tag will find that their splash image no longer appears. Please adapt this new syntax.

Code Block
langxml
titleSample IzPack installation descriptionlangxml
<installation version="5.0"
              xmlns:izpack="http://izpack.org/schema/installation"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://izpack.org/schema/installation http://izpack.org/schema/5.0/izpack-installation-5.0.xsd">

  <info>
    <appname>Test</appname>
    <appversion>0.0</appversion>
    <appsubpath>myapp</appsubpath>
    <javaversion>1.6</javaversion>
  </info>

  <guiprefs width="800" height="600" resizable="no">
	 <!-- Show the splashScreen for a minimum of 1000 milliseconds -->	
	 <modifier key="useSplashScreen" value="1000"/>	
  </guiprefs>

  <resources>
    <!--Define the splash screen image as a reading just like a heading image -->
    <res id="Splash.image" src="images/splash.png"/>
  </resources>
</installation>

...

 The available look and feels are:

  •  Kunststoff: kunststoff
  • Liquid: liquid (support removed in 5.0.7)
  • Metouia: metouia
  • JGoodies Looks: looks
  • Substance: substance
  • Windows: windows
  • Aqua: aqua
  • Metal: metal

 

If you don't specify a look and feel for a particular operating system, then the default native one will be used: Windows on Windows, Aqua on Mac OS X and Metal on the Unix-like variants.

Code Block
langxml
titleSample IzPack installation description
langxml
<installation version="5.0"
              xmlns:izpack="http://izpack.org/schema/installation"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://izpack.org/schema/installation http://izpack.org/schema/5.0/izpack-installation-5.0.xsd">

  <info>
    <appname>Test</appname>
    <appversion>0.0</appversion>
    <appsubpath>myapp</appsubpath>
    <javaversion>1.6</javaversion>
  </info>

  <guiprefs width="800" height="600" resizable="no">
    <splash>images/peas_load.gif</splash>
    <laf name="substance">
      <os family="windows" />
      <os family="unix" />
      <param name="variant" value="mist-silver" />
    </laf>
    <laf name="substance">
      <os family="mac" />
      <param name="variant" value="mist-aqua" />
    </laf>
    <modifier key="useHeadingPanel" value="yes" />
  </guiprefs>

</installation>

Liquid Look and Feel

The Liquid Look and Feel supports the following variant attributes:

decorate.frames: yes means that it will render the frames in Liquid style

decorate.dialogs: yes means that it will render the dialogs in Liquid style

Support for Liquid removed in 5.0.7.

JGoodies Looks

The JGoodies Looks look and feel can be specified by using the variant attributes. The values can be one of:

...