Versions Compared

Key

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

...

AttributeDescriptionRequired
classnameThe class name of the panel. The attribute value is case-sensitive, meaning that if the case in the installation file differs from the case in the class file, the compiler will throw an IllegalArgumentExceptionYes
idA unique identifier for a panel which can be used to reference this panel in userinput panel definitions.No
conditionThe id of a condition that has to evaluate to true in order for this panel to appear. If this attribute is not specified. the panel is always shown.No
jarThe jar file where the classes for this panel can be found. If this attribute is empty or unspecified, the classes for this panel must be merged using the <jar> tag.No
topBuffer

Represents the percentage of left over vertical space to place on top of the components. Setting topBuffer=0 is useful if you don't want your panel to be moved up or down during dynamic validation (showing and hiding components within the same panel). The topBuffer attribute may also represent the number of pixels to place on top of the components rather than the percentage of left over space if the rigid attribute is set to true.
Default: 25 

No
rigid

When set to true, the topBuffer will represent the number of pixels to place on top of the components rather than a percentage. This is useful to avoid components moving up and down during dynamic validation (showing and hiding components within the same panel), and where you would still like a gap to be placed on top of the components.

Default: false

No
allowClose

Determines whether confirmation is required when quitting the installer from this panel and panels defined before this panel.  Set to true to allow closing the installer via the Quit or Done button without confirmation on this panel, but require confirmation on previous panels without this attribute.  Set to false to prompt for confirmation when Quit or Done is pressed on this and previous panels without this attribute.  Do not set this for any panel to use classic behavior, which is to prompt for confirmation until the files are copied unless the Previous and Next buttons are both disabled.

The above seems complex, but all that's required to force confirmation when quitting from all but the last panel is to specify allowClose="true" on the last and only the last panel, as seen in the following example.

Code Block
languagexml
titleExample
<panels>
  <panel classname="HTMLHelloPanel"/>
  <panel classname="HTMLInfoPanel"/>
  <panel classname="HTMLLicencePanel"/>
  <panel classname="TargetPanel"/>
  <panel classname="PacksPanel"/>
  <panel classname="InstallPanel"/>
  <panel classname="ShortcutPanel"/>
  <panel classname="SimpleFinishPanel" allowClose="true"/>
</panels>

Default: unspecified

Since: IzPack 5.0 RC5

No

Nested Elements 

Configuration

...