Home >> All >> com >> jgoodies >> forms >> [ tutorial Javadoc ]

•	com.jgoodies.forms.tutorial.basics.* (9)	•	com.jgoodies.forms.tutorial.building.* (13)
•	com.jgoodies.forms.tutorial.factories.* (2)	•	com.jgoodies.forms.tutorial.pitfalls.* (2)

• com.jgoodies.forms.tutorial: Javadoc index of package com.jgoodies.forms.tutorial.


Package Samples:

• com.jgoodies.forms.tutorial.pitfalls
• com.jgoodies.forms.tutorial.factories
• com.jgoodies.forms.tutorial.building
• com.jgoodies.forms.tutorial.basics

Classes:

• ComponentOrientationExample: Demonstrates how to build panels that honor or ignore the current component orientation: left-to-right vs. right-to-left. This example uses a utility class that may be moved to the extras or to the Forms core in a future version. The tricky part is the abstract definition of column specifications and cell constraints. The example below utilizes the OrientationUtils to flip column specification defaul alignments and to reverse the order of column specifications. Cell constraints need to be adjusted too; this example avoids the problem by using a builder that creates all cell constraints. You can ...
• RowCounterExample: Demonstrates the FormLayout with a PanelBuilder . Columns and rows are specified before the panel is filled with components. Unlike the PlainExample this class uses a local variable to keep track of the current row. The advantage over fixed numbers is, that it's easier to insert new rows later. This panel building style is simple and works quite well. However, you may consider using a more sophisticated form builder to fill the panel and/or add rows dynamically; see the DynamicRowsExample for this alternative.
• DefaultFormBuilderExample: Uses the FormLayout and the DefaultFormBuilder . Columns are specified before the panel is filled with components, rows are added dynamically. The builder is used to hold a cursor, to add rows dynamically, and to fill components. The builder's convenience methods are used to add labels and separators. This panel building style is recommended unless you have a more powerful builder or don't want to add rows dynamically. See the DynamicRowsExample for an implementation that specifies rows before the panel is filled with components.
• PlainExample: Demonstrates a pure use of the FormLayout. Columns and rows are specified before the panel is filled with components. And the panel is filled without a builder. This panel building style is simple but not recommended. Other panel building styles use a builder to fill the panel and/or create form rows dynamically. See the PanelBuilderExample for a slightly better panel building style that can use the builder to create text labels and separators.
• DynamicRowsExample: Combines the FormLayout with the PanelBuilder . Columns and rows are specified before the panel is filled with components. The builder's cursor is used to determine the location of the next component. And the builder's convenience methods are used to add labels and separators. This panel building style is intended for learning purposes only. The recommended style is demonstrated in the DefaultFormBuilderExample .
• PanelBuilderExample: Demonstrates a typical use of the FormLayout. Columns and rows are specified before the panel is filled with components, and the panel is filled with a PanelBuilder. Unlike the PlainExample, this implementation can delegate the component creation for text labels and titled separators to the builder. This panel building style is recommended for panels with a medium number of rows and components. If the panel has more rows, you may consider using a row variable to address the current row.
• DefaultFormWithCustomAreasExample: Compares approaches how to append a custom area at the end of a panel built with the DefaultFormBuilder: using two custom rows to align the leading label, using a single custom row with label on top, using a separator. These differ in the position of the leading 'Feedback" label, and in turn in the alignment of font baselines between label and the text area.
• IndentColumnExample: Demonstrates how to efficiently build a panel with a leading indent column using the DefaultFormBuilder. The default FocusTraversalPolicy will lead to a poor focus traversal, where non-editable fields are included in the focus cycle. Anyway, this tutorial is about layout, not focus, and so I favor a lean example over a fully functional.
• DefaultFormWithCustomRowsExample: Shows three approaches how to add custom rows to a form that is built using a DefaultFormBuilder. single custom row, standard + custom row, multiple standard rows. These differ in the position of the 'Comment' label, the alignment of font baselines and the height of the custom row.
• QuickStartExample: Quickly introduces the most important features of the FormLayout: create and configure a layout, create a builder, add components. Note that this class is not a JPanel subclass; it justs uses a JPanel as layout container that will be returned by #buildPanel() .
• FormDebugExample: Demonstrates how to find bugs in the layout using the FormDebugPanel and the FormDebugUtils . The example also demonstrates efficient panel building with the DefaultFormBuilder. The builder has been configured to use a leading indent column.
• ComponentSizesExample: Demonstrates the three FormLayout component sizes: minimum, default and preferred. Min and Pref measure the components minimum and preferred size, where the Default size behaves like Pref but shrinks if the container space is scarce.
• VerticalGrowthExample: Demonstrates a frequent pitfall when specifying a growing row. In this layout a row grows, but the text area in that row is centered and doesn't 'grow'. In other words, the area doesn't fill the available vertical space.
• UnitsExample: Demonstrates the different sizing units provided by the FormLayout: Pixel, Dialog Units (dlu), Point, Millimeter, Centimeter and Inches. Pt, mm, cm, in honor the screen resolution; dlus honor the font size too.
• ButtonOrderExample: Demonstrates how to build button bars with a fixed button order or with a button order that honors the platform's style.
• CellAlignmentExample: Demonstrates how FormLayout applies the default column and row alignments to cells, and how to override the defaults.
• GrowingTextAreaExample: Demonstrates how a JTextArea's preferred size grows with the container if no columns and rows are set.
• BoundedSizesExample: Demonstrates the basic FormLayout sizes: constant, minimum, preferred.
• BasicSizesExample: Demonstrates the basic FormLayout sizes: constant, minimum, preferred.
• GrowingExample: Demonstrates the FormLayout growing options: none, default, weighted.
• ButtonStacksExample: Demonstrates how to build button stacks using the ButtonStackBuilder.
• FormFactoryExample: Demonstrates the use of Factories as provided by the Forms framework.
• ButtonBarFactoryExample: Demonstrates the use of Factories as provided by the Forms framework.
• SpanExample: Demonstrates how components can span multiple columns and rows.

Home | Contact Us | Privacy Policy | Terms of Service