Customization Possibilities

Current status: monitoring

Title
Image
Text
Icons
Buttons
1. Icons on buttons
Panel

Element

Option

Possible/Answer

IzPack Panels

Custom Panels

Comment

Screen shot / Example

Window Title

Custom text

YES

Change the value of corresponding variables: installer.title or installer.reversetitle \footnote 1

Text formating:

size
bold
italic
color

OS dependent

YES

Text formatting of the window title depends on the operating system's settings.

IzPack Title and Subtitle

Custom text

YES

Title 0..1, Subtitle 0..n. (hmm!?)
Panel titles can be switched by the guiprefs modifier useHeadingPanel (global). To change the panel title for the IzPack panel modify the corresponding language pack variable <PanelName>.headline (e.g.: <str id="HelloPanel.headline" txt="This is my custom title"/>).

Text formating:

size
TODO font (don't think so)

YES

Font size (global)

<guiprefs> 
	... 
	<modifier key="headingFontSize" value="3.0"/> 
	... 
</guiprefs>

Color:

Background
Foreground

YES

Font size (global)

<guiprefs> 
	... 
	<modifier key="headingBackgroundColor" value="0x00FF7F7F"/>
	<modifier key="headingForegroundColor" value="0x000000FF"/>
	... 
</guiprefs>

Image:

Left
Right

YES

Image right side

<resources> 
	... 
	<res id="Heading.image" src="images/heading_image.png"/>
	... 
</resources>

Image left side

<guiprefs> 
	... 
	<modifier key="headingImageOnLeft" value="yes"/>
	... 
</guiprefs>

<resources> 
	... 
	<res id="Heading.image" src="images/heading_image.png"/>
	... 
</resources>

Installation progress:

text
progressbar

YES

Installation progress

<guiprefs> 
	... 
	<modifier key="layoutAnchor" value="NORTWEST"/>
	... 
</guiprefs>

Image

Are images on panels mandatory

NO

Custom image per panel

YES

To specify a custom image per panel add a resource tag with id Installer.image.n. Notice the the last n. This should be replace by a sequence number of desired panel.

<resources>
	...
	<res id="Installer.image.0" src="images/novatec_logo2.png" />
    <res id="Installer.image.2" src="images/novatec_logo3.png" />
	...
</resources>

WIth this setting the installer with 4 panels will act like so:

Number	Panel	Image
0	Panel 1	novatec_logo2.png
1	Panel 2	novatec_logo2.png
2	Panel 3	novatec_logo3.png
3	Panel 4	novatec_logo3.png

Multiple images per panel

NO

Allowed positions

Left side

is the size of the image predefined

NO

Panel

Custom text

YES

NO

YES

Text formating (e.g.: size, bold, italic, color...)

YES(size)

Size: Use guiprefs modifier labelFontSize (global).

Layout variations:

NORTH
NORTHWEST
SOUTHWEST
SOUTH
CENTER (default)

YES (global)

Layout

<guiprefs> 
	... 
	<modifier key="layoutAnchor" value="NORTWEST"/>
	... 
</guiprefs>

NORTHWEST	NORTH
	CENTER
SOUTHWEST	SOUTH

Icons

Visibility

yes (default)
no

YES (global)

Icon visibility switch

<guiprefs> 
	... 
	<modifier key="useLabelIcons" value="no"/>
	... 
</guiprefs>

size

Buttons

Custom text

NO

Icons visibility variable:

yes (dafault)
no

YES (global)

Icon visibility switch

<guiprefs> 
	... 
	<modifier key="useButtonIcons" value="yes"/>
	... 
</guiprefs>

Custom buttons

YES

NO

YES

Custom gui items

label

YES

NO

YES

radio button

YES

NO

YES

check button

YES

NO

YES

push button

YES

NO

YES

icon...

YES

NO

YES

IzPack Installer Dialog

Size:

width
height
resizable
- yes
- no

YES (global for all panals)

<guiprefs width="640" height="480" resizable="yes">
	...
</guiprefs>

Message Box

Option

Possible/Answer

Comment

Screen shot/Example

Custom title

YES

To get a custom window title or message modify the corresponding language pack. You can use IzPack variables.

Custom title

<langpack>
  ...
  <str id="installer.quit.reversetitle" txt="$APP_NAME $APP_VER"/>
  ...
</langpack>

Custom text

YES

Modify the corresponding language pack

Custom title

<langpack>
  ...
  <str id="installer.quit.reversemessage" txt="Are you sure you want to cancel installation?"/>
  ...
</langpack>

Text formatting:

size
font
color

NO

Language Box

Option	Possible/Answer	Comment
Custom title	NO
Custom text	NO
Icon visibility: yes (default) no	YES	<guiprefs> ... <modifier key="useFlags" value="no"/> ... </guiprefs>
Custom icon for a flag	YES	Change the the corresponding icon in /bin/langpacks/flags/
Display type variable: iso3(default) native	YES	<guiprefs> ... <modifier key="langDisplayType" value="native"/> ... </guiprefs>

temporary footnotes:

If the langpack key installer.reversetitle is defined, the value of that key will be used instead of the key installer.title. With installer.reversetitle option you can use IzPack variables to customize the title of a panel. The installer.title option has following static format: ${installer.title} + ${appname}.