The UserPathPanel allows the user to select a path similar to the installation path. Like the installation path, this panel will allow the directory to be created if it does not already exist. It can also be pre-loaded with a path and set to only display if a certain pack is selected using the following variables:
Once chosen, the IzPack variable UserPathPanelVariable is set to the user's choice.
The text for these keys is specified in language resource files as described in the section on Internationalizing resources.
The headline of the panel (the one with the white background).
GUI only: This is a standard translation for all type of graphical panels, if the <guiprefs> modifier useHeadingForSummary is set "yes".This has no effect on console installations.
The summary caption text of the panel.
GUI only: This is a standard translation for all type of graphical panels, if the <guiprefs> modifier useHeadingForSummary is not set or different to "yes". This has no effect on console installations.
|Select the path:||The label text above the directory edit field.|
|Browse...||The label text of the directory chooser button.|
|The directory already exists! Are you sure you want to install here and possibly overwrite existing files?||Warning message if the directory specified already exists.|
|You have not specified a target location! Is this correct?||Warning message given when the user has not selected a target but has pressed OK.|
|This directory can not be written! Please choose another directory!||Warning that IzPack can not create files in the selected location.|
|The target directory will be created:|
|This file is not a directory! Please choose a directory!|
|Intro text with an explanation, rarely used, is empty by default.|
|Mult-line intro text with an explanation, rarely used, not set by default.|
|The chosen directory should exist.|
Messages for the UserPathPanel can be customized by creating a custom lang pack and overriding the values (attribute values wrapped for readability):
To change the text "Select the data path: " to "Select the folder where My Application should store it data: ", UserPathPanel.info should be specified in a language resource file for each language supported.
The UserPathPanelText.xml file which is the default language resource, should look something like this:
A similar UserPathPanelText.xml.fra file needs to be created to specify the French translation.
The following nested configuration options are possible against the panel definition:
|Parameter Name||Description||Default Value|
|Whether the path given by the user must exist before leaving the panel||false|