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 Name | Description | Default Value |
---|---|---|
resizable | Indicates whether the window size can be changed or not. | no |
width | Sets the initial window width in pixels. | 600 |
height | Sets the initial window height in pixels. | 480 |
Example:
Code Block | ||
---|---|---|
| ||
<guiprefs width="800" height="600" resizable="no"/> |
...
Nested Elements
<modify> - Modifying the GUI
...
Code Block | ||
---|---|---|
| ||
<guiprefs width="600" height="480" resizable="no"> <modifier key="useButtonIcons" value="no"/> <modifier key="useLabelIcons" value="no"/> <modifier key="labelGap" value="2"/> <modifier key="layoutAnchor" value="NORTHWEST"/> <modifier key="useHeadingPanel" value="yes"/> <modifier key="headingImageOnLeft" value="yes"/> <modifier key="headingLineCount" value="1"/> <modifier key="headingFontSize" value="1.5"/> <modifier key="headingBackgroundColor" value="0x00ffffff"/> <modifier key="headingPanelCounter" value="text"/> <modifier key="headingPanelCounterPos" value="inHeading"/> </guiprefs> |
Modifying the Language Selection Dialog
...
Code Block | ||
---|---|---|
| ||
<langpack> ... <str id="UserInputPanel.one.headline.one" txt="User Data one"/> <str id="UserInputPanel.two.headline.two" txt="User Data two"/> <str id="UserInputPanel.headinfo0.one" txt="Info 1 one"/> <str id="UserInputPanel.headinfo1.one" txt="Info 2 one"/> <str id="UserInputPanel.headinfo0.two" txt="Info 1 two"/> <str id="UserInputPanel.headinfo1.two" txt="Info 2 two"/> ... <langpack> |
It is possible to place an icon on the right side of the heading (see below to display on left side). To do this a simple resource entry will be needed:
...
Code Block | ||
---|---|---|
| ||
<resources> ... <res id="Heading.image" src="[path to the image in the source tree]"/> ... </resources> |
There are some guiprefs
modifier keys used to modify heading (see above). Additionally it is possible to count the general not hidden panels in the heading or navigation panel.
...
In the resource file <ISO3>.xml
or 'CustomLangpack.xml_<ISO3>
, add:
...
Code Block | ||
---|---|---|
| ||
<langpack> ... <str id="installer.reversetitle" txt="$APP_NAME $APP_VER - IzPack Wizard "/> ... </langpack> |
Example: Changed key/value pairs to create IzPack installation with heading, no button and label icons and a panel progressbar counter in the navigation panel.
Code Block | ||
---|---|---|
| ||
<guiprefs width="640" height="480" resizable="no"> <modifier key="useButtonIcons" value="no"/> <modifier key="useLabelIcons" value="no"/> <modifier key="layoutAnchor" value="NORTHWEST"/> <modifier key="labelGap" value="2"/> <modifier key="useHeadingPanel" value="yes"/> <modifier key="headingLineCount" value="1"/> <modifier key="headingFontSize" value="1.5"/> <modifier key="headingBackgroundColor" value="0x00ffffff"/> <modifier key="headingPanelCounter" value="progressbar"/> <modifier key="headingPanelCounterPos" value="inNavigationPanel"/> </guiprefs> |
PackSize
...
The Substance look and feel toned-down themes can be specified using the variant
parameter, with the value being one of:
Attribute | PushingPixels Theme Name |
---|---|
| org.pushingpixels.substance.api.skin.SubstanceBusinessLookAndFeel |
business | org.pushingpixels.substance.api.skin.SubstanceBusinessLookAndFeel |
sahara | org.pushingpixels.substance.api.skin.SubstanceSaharaLookAndFeel |
| org.pushingpixels.substance.api.skin.SubstanceBusinessBlueSteelLookAndFeel |
| org.pushingpixels.substance.api.skin.SubstanceBusinessBlackSteelLookAndFeel |
creme | org.pushingpixels.substance.api.skin.SubstanceCremeLookAndFeel |
creme-coffee | org.pushingpixels.substance.api.skin.SubstanceCremeCoffeeLookAndFeel |
graphite | org.pushingpixels.substance.api.skin.SubstanceGraphiteLookAndFeel |
moderate | org.pushingpixels.substance.api.skin.SubstanceModerateLookAndFeel |
| org.pushingpixels.substance.api.skin.SubstanceNebulaLookAndFeel |
nebula-brick-wall | org.pushingpixels.substance.api.skin.SubstanceNebulaBrickWallLookAndFeel |
autumn | org.pushingpixels.substance.api.skin.SubstanceAutumnLookAndFeel |
mist-silver | org.pushingpixels.substance.api.skin.SubstanceMistSilverLookAndFeel |
mist-aqua | org.pushingpixels.substance.api.skin.SubstanceMistAquaLookAndFeel |
dust | org.pushingpixels.substance.api.skin.SubstanceDustLookAndFeel |
dust-coffee | org.pushingpixels.substance.api.skin.SubstanceDustCoffeeLookAndFeel |
gemini | org.pushingpixels.substance.api.skin.SubstanceGeminiLookAndFeel |
mariner | org.pushingpixels.substance.api.skin.SubstanceMarinerLookAndFeel |
officesilver | org.pushingpixels.substance.api.skin.SubstanceOfficeSilver2007LookAndFeel |
officeblue | org.pushingpixels.substance.api.skin.SubstanceOfficeBlue2007LookAndFeel |
officeblack | org.pushingpixels.substance.api.skin.SubstanceOfficeBlack2007LookAndFeel |
The Substance web site has been taken off line but is still available in the Substance project source code found at.http://java.net/projects/substance/sources/svn/show/trunk/www.
...