Message-ID: <1334001058.647.1369180863119.JavaMail.firstname.lastname@example.org> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_646_1616793688.1369180863119" ------=_Part_646_1616793688.1369180863119 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
GUI Pref= erences -=C2=A0<guiprefs>
<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 Iz=
Pack.The attributes that can be specified are:<=
|Attribute Name||Description||Default Value|
|Indicates whether the window size can be changed= or not.||no|
|Sets the initial window width in pixels.||600|
|Sets the initial window height in = pixels.||480|
There are some options to modify the graphic use=
r interface. Most of them are managed with key/value pairs of the=C2=A0
<modifier> element which is a child of the =
<guiprefs>=C2=A0element in the installa=
tion description file.
<= guiprefs width=3D"600" height=3D"480" resizable=3D"no"> <modifier key=3D"useButtonIcons" value=3D"no"/> <modifier key=3D"useLabelIcons" value=3D"no"/> <modifier key=3D"labelGap" value=3D"2"/> <modifier key=3D"layoutAnchor" value=3D"NORTHWEST"/> <modifier key=3D"useHeadingPanel" value=3D"yes"/> <modifier key=3D"headingImageOnLeft" value=3D"yes"/> <modifier key=3D"headingLineCount" value=3D"1"/> <modifier key=3D"headingFontSize" value=3D"1.5"/> <modifier key=3D"headingBackgroundColor" value=3D"0x00ffffff"/> <modifier key=3D"headingPanelCounter" value=3D"text"/> <modifier key=3D"headingPanelCounterPos" value=3D"inHeading"/> </guiprefs>=09=09
Modifying the Language Selection Dialog
The language selec= tion dialog appears at the start of the installation before the first panel= occurs.
In additional to the picture in the language selection dialo= g, it is possible to modify flags and the way the language name is shown:= p>
useFlagsPossible are "yes&quo= t; or "no". Default is "yes". If it is set to "no&= quot;, no flag will be displayed in the language selection dialog. For &quo= t;no" it is recommended to define also 'langDisplayType' other then &q= uot;iso3".
langDisplayTypePossi= ble values are "iso3", "native" and "default"= . Default is "iso3". With "iso3" the text for a languag= e will be displayed as ISO 639-2:1998 code. With "native" the not= ation of the language will be used if possible, else the notation of the de= fault locale. Using "default" will be presented the language in t= he notation of the default locale of the VM.
There are some gr= aphic elements and behavior which are preferred by some people and deprecat= e by other. The following keys are related to the whole installation (all p= anels).
useButtonIcons: possible a= re "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.
useLabelIconsPossible= are "yes" or "no". Default is "yes". If it i= s 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.
labelFontSizeA float v= alue used as a multiplier for the font size on labels created via the Label= Factory and IzPanel. Directly created labels are not affected.
labelXGap | labe= lYGapThe gap in pixels between two labels in X or Y direct= ion.
textXGap | textYGapThe gap in p= ixels between two text fields.
controlXGap | controlY= GapThe gap in pixels between two controls other than label= or textfield.
paragraphYGapThe 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 | labelToTextYGapThe gap in pixels between= a label (left or top) and a text field (right or bottom).
The gap in pi= xels between a label (left or top) and a control other than a label or a te= xtfield.
labelToControlXGap | labelToControlYGap
textToLabelXGap | textToLabelYGap= code> 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 | controlToTextYGapThe gap in pixels between a control other than a label or a text = field and a text field.
textToControlXGap | textToCon= trolYGapThe gap in pixels between a text field and a contr= ol other than a label or a text field .
firstYGapThe gap in pixels between the top border and the first control= .
fillerNXGap | f= illerNYGapThe gap in p= ixels created by the layout manager to= do what???. Fillers are used by some panels.=C2=A0N=C2=A0is a number between 1 and 5 to specify a differen= t filler e.g. filler3XGap or filler1YGap.
allXGap | a= llYGapThe gap in pixels between all controls in X or Y dir= ection. If this is declared, this is the default for all gaps for which no = own declaration has been defined.
RELATIVE=The values will be normalized = ????
ABSOLUTE=C2=A0 The values= will be used as they are. A part of the line will be clipped if the sum is= greater than 1.0.
NONo stretch will= be performed.=C2=A0
layoutFullLineStretch = | layoutFullColumnStretchThere are controls which should b= e stretched. Beside fixed values there are the symbolic values FULL_LINE_ST= RETCH and FULL_COLUMN_STRETCH which are computed at layout. E.g. MultiLineL= abels has this stretch factor for x direction. But what to do if a centered layout is chosen? With a contr= ol 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. Th= e default is 1.0, valid are 0.0 up to 1.0.
It is pos=
sible to use an alternative frame title. Normally the title is "IzPack=
- Installation of " + '$APP_NAME'. If the langpack key
installer.reversetitle is defined, the value of that key will be used instead of the key
Some standard panels have headings (e.g. Shortcut= Panel). These headings are integrated in the IzPanel. In opposite to this following heading will be displayed in = a separated panel potential for all panels with the same design.(not= parsable in English) There is no need to modify existing Java classes. The= declaration of some key/value pairs is enough.
There can be one real= head and zero or more info lines. The headline will be written bold, the f= ont size can be changed. Info lines will be indented and written with the n= ormal used font. The heading message has to be written into the langpack (o= r custom langpack) file with the key '<panel class name>.headline'. E= xamples can be seen in eng.xml. May be the entries for standard panels are = not present in other languages. Messages for info lines have the key '<p= anel class name>.headinfo<info line number>'. First info line has = number zero. If no or empty headline messages will be declared in the chose= n language no heading panel will be shown. This behavior can be used to sup= press heading for special panels.
It is also possible to declare head= and info lines additional dependent on the 'panelid'. The result is, that = it is possible to declare different messages for panels which are shown mor= e than one time (e.g. the UserInputPanel. In this case the key for heading = is
<= span style=3D"font-size: 10.0pt;line-height: 13.0pt;">and for info lines
anel class=C2=A0name>.headinfo<info line number>.<panelid>
IDs are declared in the
> element. The standard strings are declared in the standard =
langpack file. For customized panels it is common to declare text in the cu=
stom language pack.
Then = the messages can be declared in 'CustomLangpack.xml_eng' like this:<= /p>
It is= possible to place an icon on the right side of the heading (see below to d= isplay on left side). To do this a simple resource entry will be needed:
guiprefs modifier keys used to modi=
fy heading (see above). Additionally it is possible to count the general no=
t hidden panels in the heading or navigation panel.
useHeadingPanelGeneral switch for heading. = If this key does not exist or does not have the value "yes" no he= ading panel will be shown.
headingImageOnLeftOption to allow displaying the heading image on the left of the he= ader instead of the default (right side). Only valid if heading panel is us= ed.
useHeadingForSummaryIn the langu= age files there are entries for the heading text ('Panel name.headline') and the summary caption ('Panel name.summaryCaption'). If this= modifier is set to "yes", the text of the heading will be also u= sed for the summary caption.
headingLineCountNumber of heading lines. If no info lines should be shown the valu= e should be one (not zero).
headingFontSize<= /code> A float value used as multiplier for the standard font size.
headingBackgroundColorBackground color of t= he heading panel as integer. Often used is 0x00ffffff (white).
h= eadingPanelCounterDraw a panel counting. Possible values a= re "text" or "progressbar". inHeading the progressbar w= ill be not the best choice.
headingPanelCounterPosDeclares where the counter will be shown. Possible are "= inHeading" or "inNavigationPanel". If "inNavigationPane= l" is chosen, the panel counter can be used also no heading was select= ed.
Example:=C2=A0Modifiers to create an IzPack installation with = heading, no button and label icons and a panel text counter in the heading = panel:
e resource file=C2=A0
<= langpack> ... <str id=3D"installer.reversetitle" txt=3D"$APP_NAME $APP_VER - IzPack = Wizard "/> ... </langpack>=09=09
Example:=C2=A0Changed key/value pairs to create IzPack installa= tion with heading, no button and label icons and a panel progressbar counte= r in the navigation panel.
The PacksPanel dialog supports the modifier=C2=A0d=
olumn=C2=A0set to true, the third column will not be shown.=
This does not affect the display of the required size of all packs.
The required size can be hidden by setting the
<= guiprefs width=3D"640" height=3D"480" resizable=3D"no"> ... <modifier key=3D"doNotShowPackSizeColumn" value=3D"true"/> <modifier key=3D"doNotShowRequiredSize" value=3D"yes"/> ... </guiprefs>=09=09
The P= acksPanel will not show the column with the sizes of each pack, but will sh= ow the total required space.
ancel dialog will be shown if the cancel button or the
In the standard di= alog, the title contains the question and the confirmation message.
ften, in other dialogs, the title is a common heading and the question will=
be called in the dialog as a message. The standard behavior will be modifi=
ed if the messages
installer.quit.reversetitleare are dec=
In the resource files=C2=A0
/code>> element specifies the path to the image to be used a a =
splash screen. The path is relative to t=
he installation root.
The i= mage can be any bitmap format such as png, jpg, jpeg, gif or bmp.
=C2=A0The look and feel can be specified =
on a per-OS basis. For instance you can use the native look and feels on Wi=
n32 and OS X but use a third-party one on Unix-like platforms. To do that, =
you have to add some <laf> child elements to the
laf: This ta=
g specifies a look and feel. It has a
tribute that defines the look and feel name.
laf element need=
s at least one
os child element.
laf element can also contain any number of
param elements to customize a look and feel. A
strong> elements has two attribues:
name and =
value. The valid names and values will depend=
on the laf being described.
=C2=A0The available look and feels are:
If you don't specify a look and feel for a particular operating s= ystem, then the default native one will be used: Windows on Windows, Aqua o= n Mac OS X and Metal on the Unix-like variants.
<insta= llation version=3D"5.0" xmlns:izpack=3D"http://izpack.org/schema/installation" xmlns:xsi=3D"http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=3D"http://izpack.org/schema/installation h= ttp://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=3D"800" height=3D"600" resizable=3D"no"> =C2=A0=C2=A0=C2=A0 <splash>images/peas_load.gif</splash> =C2=A0=C2=A0=C2=A0 <laf name=3D"substance"> =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 <os family=3D"windows" /> =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 <os family=3D"unix" /> =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 <param name=3D"variant" value=3D"mist-sil= ver" /> =C2=A0=C2=A0=C2=A0 </laf> <laf name=3D"substance"> =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 <os family=3D"mac" /> =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 <param name=3D"variant" value=3D"mist-aqu= a" /> =C2=A0=C2=A0=C2=A0 </laf> =C2=A0=C2=A0=C2=A0 <modifier key=3D"useHeadingPanel" value=3D"yes" /> =C2=A0 </guiprefs> </installation>=09=09
The Liquid Look and Feel supports the following =
yes means that it will render the frames in Liquid =
yes means that it w=
ill render the dialogs in Liquid style
The JGoodies Looks look and =
feel can be specified by using the
tributes. The values can be one of:
windows: use the Win=
plastic: use the basic Plastic look
se the Plastic XP look (default).
Here is a small sample:
The Substance look and feel toned-down themes can be=
specified using the
variant parameter, with the value being o=
|Attribute||Pu= shingPixels Theme Name|
The Substance web = site has been taken off line but is still available in the Substance projec= t source code found at.http://java.= net/projects/substance/sources/svn/show/trunk/www.
To view the ga=
llery of the different toned-down themes, you need to check out the source =
code and then navigate to the=C2=A0
www/docs/skins/toneddown.html file from your browser..
af> element can be restricted to operating system condit=
ions by a nested
<os> element, in which=
case the look and feel applies only in case the OS conditions apply
See=C2=A0OS Restrictions de=
scribes the use of
<os> in more detail.=