source: release-kits/lirk3/bin/ant-installer/web/lookandfeels.html@ 14982

Last change on this file since 14982 was 14982, checked in by oranfry, 16 years ago

initial import of LiRK3
File size: 12.2 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4 <title>Ant Installer</title>
5 <link href="style.css" type="text/css" rel="stylesheet">
6 <link href="css/nav.css" rel="stylesheet" type="text/css">
7 <link rel="SHORTCUT ICON" type="image/png" href="images/antinstaller-icon.png">
8 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
9 <meta name="keywords"
10 content="Ant, installer, AntInstall, gui, console, input, parameters, properties, swing, user interface, validation, configuration">
11 <script type="text/javascript" src="js/menu.js"></script>
12 <script type="text/javascript" src="js/sstree.js"></script>
13 <script type="text/javascript" src="js/winfix.js"></script>
14</head>
15<body onload="collapseAll('contents-panel', ['ol']); "><div id="tpallcontent">
16<table cellspacing="0" width="100%">
17 <tbody>
18 <tr class="tpheader">
19 <th class="tpleft">
20 <a target="_top" href="index.html" title="home"><img src="images/ant-install-small.png" alt="AntInstaller" id="logo" width="76" height="50"/></a>
21 <script type="text/javascript">winFix();</script>
22 </th>
23 <th class="tptop" valign="bottom">
24 <img src="space.gif" height="1" width="440" alt="spacer"/><br/>
25
26 <table>
27 <tr>
28 <td valign="top">
29 <div class="tpheadertitle">AntInstaller</div>
30 <!--img src="images/ant-install-title.png" alt="AntInstaller"/-->
31 </td>
32 <td width="100%" align="right" valign="bottom" nowrap="NOWRAP">
33 <div class="tpraised">
34 <a class="tpbutton" target="_top" href="index.html">home</a>
35 <a class="tpbutton" target="_top" href="http://sourceforge.net/project/showfiles.php?group_id=123466&amp;package_id=134917">download</a>
36 <a class="tpbutton" target="_top" href="http://sf.net">sourceforge</a>
37 <a class="tpbutton" target="_top" href="manual-ant.html">antmanual</a>
38 <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&amp;atid=696615">RFEs</a>
39 <a class="tpbutton" target="_top" href="http://sourceforge.net/tracker/?group_id=123466&amp;atid=696612">Bugs</a></div>
40 </td>
41 </tr>
42 </table>
43 </th>
44 </tr>
45 <tr class="tpbody">
46 <td class="tpleft" valign="bottom">
47 <br/>
48 <div id="logoset">
49 <a target="_top" href="http://sourceforge.net"><img src="http://sourceforge.net/sflogo.php?group_id=123466&amp;type=2" alt="SourceForge.net Logo" border="0" height="37" width="125"></a>
50 <br/><br/>
51 <a target="_top" href="http://sourceforge.net/donate/index.php?group_id=123466">
52 <img src="http://sourceforge.net/images/project-support.jpg" alt="donate to AntInstaller"/>
53 </a>
54 </div>
55 </td>
56 <td class="tpright" valign="top">
57 <div class="tpcontent">
58 <!--[segment-content] page content start -->
59
60 <h2>Look And Feel</h2>
61
62 The Swing GUI can be shown with a configurable appearance using Java's pluggable look and feel feature. AntInstaller includes a look and feel by <a href="http://www.jgoodies.com/">JGoodies</a> which is now licenced under a BSD license.<br/><br/>
63
64 Since JGoodies is under a good open source license it has been possible to make minor modifications to
65 the code to enable antialiasing of text components. This is more resource intensive but looks a lot better.
66 In order not to clash with the original JGoodies code the modifications have be repackaged as <code>org.tp23.jgoodies.*</code>
67 so both UIs can be on the classpath at the sametime. In AntInstaller the antialiasing can be activated with the antialiased attribute
68 in the installer element. <br/><br/>
69
70 When designing a cross platform installer remember that Micro$oft look and feels will not run on other platforms and will throw exceptions. Some of the JGoodies look and feels have the same issue, so check first.<br/><br/>
71
72 There is small look and feel included with AntInstaller that is a simple modification of the MetalLookAndFeel that uses a monochrome theme and less use of bold fonts, the font size is also reduced one point. This look and feel has been included to enable installers to be delivered with a consistent look on multiple platforms and have space on the buttons and labels to show the default English text in the installer. The download size is also reduced. For more space for text the width of the installer can be increased with the <code>wide</code> attribute of the <a href="manual.html#installer">installer</a> element in the configuration file.<br/>
73 The purple theme has been removed because it looks naf! (sorry Sun but its true).
74 <br/><br/>
75
76 <h2>Setting the look and feel</h2>
77
78 To set the look and feel for the swing GUI the <code>lookAndFeel</code> attribute of the <code>installer</code> element in <code>antinstall-config.xml</code> should be set. The value of the lookAndFeel attribute should be a fully qualified class name or one of the following values that have special treatment.
79 <ul>
80 <li><code>null</code> - No alterations are made to the look and feel.</li>
81 <li><code>greymetal</code> - The monochrome metal look and feel is used. Equivalent to <code>org.tp23.antinstaller.renderer.swing.plaf.ModMetalLookAndFeel</code>.</li>
82 <li><code>native</code> - The native look and feel of the computer on which the installer is run is used. The value is that returned by <code>UIManager.getSystemLookAndFeelClassName()</code>.</li>
83 <li><code>jgoodies</code> - The JGoodies look and feel <code>org.tp23.jgoodies.plaf.plastic.PlasticXPLookAndFeel</code> is used.</li>
84 </ul>
85
86 If the lookAndFeel attribute is missing <code>org.tp23.jgoodies.plaf.plastic.PlasticXPLookAndFeel</code> is the default.<br/><br/>
87
88 If the default look and feel or greymetal is specified in the configuration the <a href="installertask.html">Ant task</a> will include the correct classes automatically in the self-extracting or non-extracting Jar. If a custom look and feel is to be used the classes must be added specifically to the classpath or inside the Jar.<br/><br/>
89
90 If the self-extracting jar is used, in order to show the progress panel with the correct look and feel, the value in the configuration file can not be used since it is not yet loaded. An additional element <code>Look-And-Feel</code> to the <code>META-INF/MANIFEST.mf</code> file should be added.<br/>
91 Provided the installer is build with the <a href="installertask.html">Ant task</a> this is handled automaticaly.
92
93 <h2>Screenshots</h2>
94 JGoodies - <code>org.tp23.jgoodies.plaf.plastic.PlasticXPLookAndFeel</code><br/>
95 <img src="images/jgoodies.xp.snapshot.png" alt="JGoodies screenshot"/><br/><br/>
96
97 Metouia - <code>net.sourceforge.mlf.metouia.MetouiaLookAndFeel</code><br/>
98 <img src="images/metouia.snapshot.png" alt="Metouia screenshot"/><br/><br/>
99
100 Grey Metal - <code>org.tp23.antinstaller.renderer.swing.plaf.ModLookAndFeel</code><br/>
101 <img src="images/greymetal.snapshot.png" alt="Greymetal screenshot"/><br/><br/>
102
103<!-- content end [segment-end]-->
104 </div>
105 </td>
106 </tr>
107 </tbody>
108</table>
109<div id="contents-panel">
110<!--[segment-file://contents-include.html] menu start -->
111<div id="contents-menu">
112<ol class="sidebar" id="root">
113 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Site map</b>
114 <ol>
115 <li class="sidebar"><a href="introduction.html">Introduction</a></li>
116 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><b>Developer References</b>
117 <ol>
118 <li class="sidebar"><a href="quickstart.html">Quick Start</a></li>
119 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html">Manual</a>
120 <ol class="init-hidden">
121 <li class="sidebar"><a href="manual.html#config">antinstall-config.xml</a></li>
122 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#page">Pages</a>
123 <ol class="init-hidden">
124 <li class="sidebar"><a href="manual.html#pagesplash">Splash Page</a></li>
125 <li class="sidebar"><a href="manual.html#pagetext">Text Page</a></li>
126 <li class="sidebar"><a href="manual.html#pagelicense">License Page</a></li>
127 <li class="sidebar"><a href="manual.html#pageinput">Input Page</a></li>
128 <li class="sidebar"><a href="manual.html#pageprogress">Progress Page</a></li>
129 </ol>
130 </li>
131 <li class="panel"><a href="#default" class="folder" onclick="toggle(this)"></a><a href="manual.html#inputtypes">Input types</a>
132 <ol class="init-hidden">
133 <li class="sidebar"><a href="manual.html#app-root">Application Root</a></li>
134 <li class="sidebar"><a href="manual.html#checkbox">Checkbox</a></li>
135 <li class="sidebar"><a href="manual.html#comment">Comment</a></li>
136 <li class="sidebar"><a href="manual.html#date">Date</a></li>
137 <li class="sidebar"><a href="manual.html#directory">Directory</a></li>
138 <li class="sidebar"><a href="manual.html#file">File</a></li>
139 <li class="sidebar"><a href="manual.html#large-select">Large Select</a></li>
140 <li class="sidebar"><a href="manual.html#password">Password Text</a></li>
141 <li class="sidebar"><a href="manual.html#password-confirm">Confirm Password</a></li>
142 <li class="sidebar"><a href="manual.html#select">Select</a></li>
143 <li class="sidebar"><a href="manual.html#target">Target</a></li>
144 <li class="sidebar"><a href="manual.html#target-select">Target Select</a></li>
145 <li class="sidebar"><a href="manual.html#text">Unvalidated Text</a></li>
146 <li class="sidebar"><a href="manual.html#validated">Validated Text</a></li>
147 <li class="sidebar"><a href="manual.html#extvalidated">Externally Validated Text</a></li>
148 </ol>
149 </li>
150 <li class="sidebar"><a href="manual.html#extractor">Self Extractor</a></li>
151 <li class="sidebar"><a href="manual.html#non-extractor">Non Extractor</a></li>
152 <li class="sidebar"><a href="manual.html#scripts">Start Scripts</a></li>
153 <li class="sidebar"><a href="manual.html#refs">Dynamic References</a></li>
154 <li class="sidebar"><a href="manual.html#pagedisplay">Page Displaying</a></li>
155 </ol>
156 </li>
157 <li class="sidebar"><a href="installertask.html">Installer Ant task</a></li>
158 <li class="sidebar"><a href="validationofconfig.html">Validation of config</a></li>
159 <li class="sidebar"><a href="lookandfeels.html">LookAndFeels</a> <br/>(inc screenshots)</li>
160 <li class="sidebar"><a href="classpathresources.html">Resources/Classpath issues</a></li>
161 <li class="sidebar"><a href="i18n.html">Internationalisation</a></li>
162 <li class="sidebar"><a href="auto.html">Automated installs</a></li>
163 <li class="sidebar"><a href="installtypes.html">Multiple install types</a></li>
164 <li class="sidebar"><a href="posttargets.html">Post display targets</a></li>
165 <li class="sidebar"><a href="icons.html">Button Icons</a></li>
166 <li class="sidebar"><a href="antinstall-config-example.html">Example antinstall-config.xml</a></li>
167 </ol>
168 </li>
169 <li class="sidebar"><a href="manual-ant.html">Ant Manual</a></li>
170 <li class="sidebar"><a href="antlinks.html">Ant links</a></li>
171 <li class="sidebar"><a href="userusage.html">User usage</a></li>
172 <li class="sidebar"><a href="licenses.html">Licenses</a></li>
173 <li class="sidebar"><a href="potentialuses.html">Potential uses</a></li>
174 <li class="sidebar"><a href="roadmap.html">Road Map</a></li>
175 <li class="sidebar"><a href="wanted.html">Wanted</a></li>
176 <li class="sidebar"><a href="dtds.html">DTDs</a></li>
177 <li class="sidebar"><a href="changelog.html">Changelog</a></li>
178 <li class="sidebar"><a href="http://sourceforge.net/projects/antinstaller">Project page on SourceForge</a></li>
179 <li class="sidebar"><a href="java2html/antinstaller/index.html">Java2HTML (main)</a></li>
180 <li class="sidebar"><a href="java2html/ext/index.html">Java2HTML (extensions)</a></li>
181 <li class="sidebar"><a href="http://antinstaller.cvs.sourceforge.net/antinstaller">Public CVS over HTTP</a></li>
182 <li class="sidebar"><a href="http://sourceforge.net/sendmessage.php?touser=616485">Contact AntInstaller Admin</a></li>
183 </ol>
184 </li>
185</ol>
186<br/>
187<br/>
188</div>
189
190
191<!-- menu end [segment-end]-->
192</div>
193<div id="contents-options">
194<a id="toggle" href="#" onclick="toggleMenu(); return false;">show menu</a>
195</div>
196
197</div>
198</body>
199</html>
Note: See TracBrowser for help on using the repository browser.