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:

...

• useButtonIcons: possible are "yes" or "no". Default is "yes". If it is set to "no", all buttons which are created via the ButtonFactory contains no icon also a icon id was submitted. Directly created buttons are not affected.
• useLabelIcons Possible are "yes" or "no". Default is "yes". If it is set to "no", all labels which are created via the LabelFactory contains no icon also a icon id was submitted. Directly created labels are not affected.
• labelFontSize A float value used as a multiplier for the font size on labels created via the LabelFactory and IzPanel. Directly created labels are not affected.
• layoutAnchor This is the layout anchor for IzPanels. Valid are "NORTH", "NORTHWEST", "SOUTHWEST", "SOUTH" and "CENTER". Only panels which are using the layout helper of IzPanels are supported. These are not all standard panels. At developing custom panels it is recommended to use the layout helper with an IzPanelLayout. Note: The anchor definition will be used for all panels!
• Gaps There are a number of defined gaps between different components of a IzPanel that can be applied to a IzPanelLayout. The gaps can be set also via the element '<modifier>' of '<guiprefs>'. It is possible to declare different values for X and Y axis. This will be determined in the key word name. X Gaps are insert after Y gaps under the control for which the gap was declared. Following key words are defined:
  
  • labelXGap | labelYGap The gap in pixels between two labels in X or Y direction.
  • textXGap | textYGap The gap in pixels between two text fields.
  • controlXGap | controlYGap The gap in pixels between two controls other than label or textfield.
  • paragraphYGap The gap in pixels for a paragraph. A paragraph will be created in the panel source for controls which should be separated. paragraphXGap is declared, but not used.???
  • labelToTextXGap | labelToTextYGap The gap in pixels between a label (left or top) and a text field (right or bottom).
  • labelToControlXGap | labelToControlYGap The gap in pixels between a label (left or top) and a control other than a label or a textfield.
  • textToLabelXGap | textToLabelYGap The gap in pixels between a text field (left or top) and a label.
  • controlToLabelXGap | controlToLabelYGap The gap in pixels between a control other than a label or a text field and a label.
  • controlToTextXGap | controlToTextYGap The gap in pixels between a control other than a label or a text field and a text field.
  • textToControlXGap | textToControlYGap The gap in pixels between a text field and a control other than a label or a text field .
  • firstYGap The gap in pixels between the top border and the first control.
  • fillerNXGap | fillerNYGap The gap in pixels created by the layout manager to do what???. Fillers are used by some panels. N is a number between 1 and 5 to specify a different filler e.g. filler3XGap or filler1YGap.
  • allXGap | allYGap The gap in pixels between all controls in X or Y direction. If this is declared, this is the default for all gaps for which no own declaration has been defined.

• layoutYStretchType | layoutXStretchType This is the type of stretch that will be applied. The IzPanelLayout manager permits stretch factors for controls to be specified. This means, that a control will be stretched if there is space in the line. The amount of stretching will be determined by the stretch factor. But what to do if the whole stretch factor for a line or column is not 1.0? To determine this these settings are exist. Valid values are
  
  • RELATIVE The values will be normalized ????
  • ABSOLUTE  The values will be used as they are. A part of the line will be clipped if the sum is greater than 1.0.
  • NO No stretch will be performed. 
• layoutFullLineStretch | layoutFullColumnStretch There are controls which should be stretched. Beside fixed values there are the symbolic values FULL_LINE_STRETCH and FULL_COLUMN_STRETCH which are computed at layout. E.g. MultiLineLabels has this stretch factor for x direction. But what to do if a centered layout is chosen? With a control like this the lines will be stretch to the hole size. With this settings it can be changed. E.g. a factor of 0.7 creates a nice centered layout. The default is 1.0, valid are 0.0 up to 1.0.

...

The PacksPanel dialog supports the modifier doNotShowPackSizeColumn. With doNotShowPackSizeColumn set to true, the third column will not be shown. This does not affect the display of the required size of all packs.

...

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

...