1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
|
JGoodies Forms, Version 1.0.5
Release Notes
INTRODUCTION
This maintenance release fixes bugs, adds features, and brings
minors improvements for the code, documentation and tutorial.
NEW FEATURES
o Added FormLayout#setColumnSpec(int, ColumnSpec)
o Added FormLayout#setRowSpec(int, ColumnSpec)
BUGS FIXED
o Titled separator on Aqua not aligned along the label's font baseline.
o Button minimum width too wide on MacLayoutStyle.
o Related gap too narrow in MacLayoutStyle.
o DefaultFormBuilder ignores the current row span set by #setRowSpan.
o AbstractFormBuilder#createLeftAdjustedConstraints(int)
ignores the current row span.
o DefaultComponentFactory can register L&fChangeHandler multiple times.
OTHER CHANGES
o Code: Builders avoid the creation of obsolete FlowLayout instances.
o Code: Overhauled builder constructors; marked some as deprecated.
o Code: Changed separators created by the DefaultComponentFactory
to be opaque.
o Code: Renamed DefaultUnitConverter#LAFChangeHandler to
LookAndFeelChangeHandler.
o Code: Removed unused code in class BoundedSize.
o Code: Minor code cleanup: removed unused else.
o Tut.: Added pitfall example for vertically non-filled component.
o Tut.: Added pitfall example for the ever-growing text area.
o Docs: Improved FormDebugPanel's constructor JavaDocs.
o Docs: Added overview information to the JavaDocs.
o Docs: Refreshed links to visual builders that support the FormLayout.
o Docs: Refreshed some FAQ items.
o Docs: Added FAQ #2.6: How to remove a component from the layout?
o Docs: Added FAQ #3.6: Why do some text areas grow and never shrink?
o Docs: Added a reference to the SWT port by the SwtForms project.
o Docs: Added a reference to Gerald Rosenberg's JFormComposer.
o Docs: Clarified the semantics and use case for CellConstraint insets.
o Docs: Indicated that FormFactory factory methods may be removed.
o Dist: Corrected implementation title and vendor in the JAR manifest.
o Dist: Added project name tag to the ANT build file.
o Dist: Overhauled the README.html.
---------------------------------------------------------------------------
Find below the change history for older releases.
JGoodies Forms, Version 1.0.4
Release Notes
INTRODUCTION
This maintenance release fixes bugs, comes with a simpler API,
and provides more JavaDoc examples for frequently used methods.
API INCOMPATIBILITIES
o ColumnSpec and RowSpec are now immutable. This won't affect
the typical Forms usage, but may affect visual builder tools.
o Removed method ButtonStackBuilder#addGriddedNarrow(JComponent)
VISUAL INCOMPATIBILITIES
o In rare cases the container size may be smaller than before.
Bug #4 has been fixed (see below). In 1.0.4 the container
will be expanded only if components span cols/rows that can grow.
In 1.0.3 the container could be expanded if *any* col/row grows.
So some wrong 1.0.3 container expansions won't happen in 1.0.4.
NEW FEATURES
o Added the CellConstraints#xyw method set.
o Added FormLayoutUtils to the Extras.
BUGS FIXED
o DefaultUnitConverter#setDefaultDialogFont throws NPE.
o DefaultUnitConverter#setAverageCharacterWidthTestString throws NPE.
o Invalid sample code in PanelBuilder JavaDocs.
o (Bug #4) In some cases components that span multiple columns/rows
can expand the container size, although none of the spanned
columns/rows are allowed to grow.
OTHER CHANGES
o Extended and corrected JavaDoc class comments.
o Added examples to the JavaDocs of frequently used methods.
o Refreshed README and FAQ
o Refreshed whitepaper to demonstrate CellConstraints#xyw.
o Added two HTML pages: Visual Builders and References.
---------------------------------------------------------------------------
Find below the change history for older releases.
JGoodies Forms, Version 1.0.3
Release Notes
INTRODUCTION
This maintenance release contains new core classes, adds methods,
and comes with improved JavaDocs and an extended tutorial and FAQ.
The DefaultFormBuilder has been moved from the extras to the core.
Also, the support for the Mac OS X has been improved significantly:
the DefaultComponentFactory has been adjusted for the Aqua look&feel,
the new MacLayoutStyle describes the Mac and Aqua styles guide lines,
and the ButtonBarBuilder and ButtonBarFactory now honor a button order.
VISUAL INCOMPATIBILITIES
On the Mac OS X platform Forms 1.0.3 changes the button order;
other platforms are not affected. In most cases this will improve
the user experience of your applications. It is recommended to
check your ButtonBarBuilder invocation to use a fixed left to right
order where necessary.
ButtonBarBuilder methods that create sequences of buttons now honor
the LayoutStyle's button order. On Mac OS X this is right to left.
Builder methods that add individual buttons are not affected.
See the ButtonOrderExample in the tutorial for details on how to
use or ignore the LayoutStyle's button order.
API INCOMPATIBILITIES
o Removed deprecated methods from the ButtonBarBuilder class:
#addGriddedNarrow(JButton)
#addGriddedNarrowButtons(JButton[])
#addGriddedGrowingNarrow(JComponent)
NEW FEATURES
o Moved DefaultFormBuilder and I15dPanelBuilder to the core.
o FormLayout is serializable.
o AbstractFormBuilder#appendLabelComponentGapColumn()
o AbstractFormBuilder#appendParagraphGapRow()
o AbstractFormBuilder#setComponentFactory(...) now public
o I15dPanelBuilder#addI15dLabel(String, CellConstraints,
Component, CellConstraints)
o LayoutStyle#getTabbedDialogMarginX()
o LayoutStyle#getTabbedDialogMarginY()
o LayoutStyle#getButtonBarPad()
o LayoutStyle#isLeftToRightButtonOrder()
o FormFactory#LABEL_COMPONENT_COLSPEC
o MacLayoutStyle
o AbstractFormBuilder#createLeftAdjustedConstraints(int)
o ColumnSpec#decodeSpecs(String encodedColumnSpecs) (final)
o RowSpec#decodeSpecs(String encodedRowSpecs) (final)
o FormSpec.DefaultAlignment now visible (final)
o Borders.EmptyBorder provides methods for the 4 sizes.
BUGS FIXED
o PanelBuilder fails to build right-to-left if column span > 1.
o DefaultFormBuilder fails to build right-to-left if column span > 1.
o Deserialization fails in 1.0.3 preview.
KNOWN ISSUES
o In some cases components that span multiple columns/rows
can expand the container size, although none of the spanned
columns/rows are allowed to grow. See the FAQ for details.
OTHER CHANGES
o Code: Added safety check for invalid constraints in PanelBuilder
#add(JLabel, CellConstraints, Component, CellConstraints)
#add(String, CellConstraints, Component, CellConstraints)
o Code: DefaultComponentFactory#setTextAndMnemonic(JLabel) now private
o Code: DefaultUnitConverter refers indirectly to ToolKit#getFontMetrics
o Code: Marked ButtonStackBuilder#addGriddedNarrow as deprecated
o JavaDocs: Extended and corrected
o JavaDocs: Clarified some semantics
o Docs: Fixed spelling and grammar errors
o Docs: Extended and reorganized the FAQ
o Tutorial: Improved alignment texts in custom row and custom areas example
o Tutorial: Added ButtonOrderExample
o Tutorial: Added ComponentOrientationExample
o Tutorial: Added OrientationUtils to ComponentOrientationExample
--------------------------------------------------------------------------
Find below the change history for older releases.
JGoodies Forms, Version 1.0.2
Release Notes
INTRODUCTION
This release is a maintenance update that fixes bugs, comes with
a new example and a slightly improved and extended documentation.
DISTRIBUTION CHANGES
o Added a list of FAQ.
o Added JavaDoc version tags to all class comments.
NEW FEATURES
o DefaultUnitConverter provides bound Bean properties for the
default dialog font and the average character width test string.
BUGS FIXED
o Fixed broken button font lookup in DefaultUnitConverter
that failed to find a font for GTKLookAndFeel, and more
generally, SynthLookAndFeel subclasses.
o Fixed #minimumLayoutSize that measured components that span
multiple columns/rows with the preferredSize, now the minimumsize.
o Patched the container expansion forced by components that span
multiple columns/rows for the case that no column or row can grow.
This expansion shall be performed if and only if the component spans
an area that can grow. The old behavior performed this action ALWAYS;
the patch check whether A column/row can grow;
the upcoming fix will check the growing behavior of the spanned area.
This problem is reflected by the FormLayout unit tests, where currently
one out of three tests fails, see FormLayoutTests.test*ExtraExpansion*
OTHER CHANGES
o Main: Removed the final marker from FormDebugPanel;
see the class comment for details
o Main: Removed FormDebugPanel features that are available
in the FormDebugUtils
o Main: Extended JavaDoc for the DefaultUnitConverter
o Main: Extended JavaDoc for the DefaultFormBuilder
o Main: Border.BUTTON_BAR_GAP_BORDER uses dlu only.
o Main: Faster conversion of sizes with a 0 value.
o Tutorial: Added example for custom areas with DefautFormBuilder
o Tutorial: Changed some text field widths from 'default' to 'min'
o Tutorial: Corrected frame titles
o Tests: Added tests for components that span multiple columns
o Tests: Specialized some exceptions in catch clauses
o Docs: Improved grouping diagrams
o Docs: Fixed invalid link to a tutorial pdf
o All code: Documented empty blocks.
---------------------------------------------------------------------------
Find below the change history for older releases.
JGoodies Forms, Version 1.0.1
Release Notes
INTRODUCTION
This release is primarily a documentation and distribution update;
it fixes a bug (with maximum sizes) and contains no API changes.
DISTRIBUTION CHANGES
o Added tips & tricks
o Added a tutorial
o Added a programmer's reference
o Library sources ship as a single ZIP file
BUGS FIXED
o Main: Fixed broken maximum sizes that had the same effect as minimum
o Main: Fixed FormFactory.BUTTON_COLSPEC to use a lower, not upper bound
o Tutorial: Corrected FormDebugExample.main
OTHER CHANGES
o Main: Added sanity checks for invalid CellConstraints alignments
o Main: Minor code cleanup: removed obsolete casts and semicolons
o Main: Minor improvement: parameter names made more consistent
o Main: Library compiled against 1.3 but with Sun's javac 1.4.2
o Main: FormFactory.GROWING_BUTTON_COLSPEC honors LayoutStyle
o Main: All FormFactory specs are now unmodifyable
o Tutorial: Added Quick Start example
o Tutorial: Added example for component sizes
o Tutorial: Added example for custom rows and DefaultFormBuilder
o Test: Added tests for invalid CellConstraints alignments
o Test: Added tests for bounded sizes
o Docs: Removed comparison with HIGLayout from the whitepaper
o Docs: Some throws clauses added to the JavaDocs
o Build: process reflects the distribution changes
---------------------------------------------------------------------------
1.0 (July-18-2003)
o Compiled with Sun javac 1.3.1_08
o Distribution changed:
+ forms.pdf renamed to whitepaper.pdf
+ demo removed
+ build overhauled
+ readme.txt simplified
1.0rc (June-20-2003)
o Code is now available under the BSD license
o Fixed bug in DefaultFormBuilder.appendI15dTitle
o Corrected JavaDoc for ButtonStackBuilder
o Improved whitepaper
o Packaging reflects the new license
o Library jar is unobfuscated
o Library jar is unsigned
|
