The different sizing units provided by the FormLayout : FormLayout « Swing Components « Java






The different sizing units provided by the FormLayout

The different sizing units provided by the FormLayout
/*
 * Copyright (c) 2002-2004 JGoodies Karsten Lentzsch. All Rights Reserved.
 *
 * Redistribution and use in source and binary forms, with or without 
 * modification, are permitted provided that the following conditions are met:
 * 
 *  o Redistributions of source code must retain the above copyright notice, 
 *    this list of conditions and the following disclaimer. 
 *     
 *  o Redistributions in binary form must reproduce the above copyright notice, 
 *    this list of conditions and the following disclaimer in the documentation 
 *    and/or other materials provided with the distribution. 
 *     
 *  o Neither the name of JGoodies Karsten Lentzsch nor the names of 
 *    its contributors may be used to endorse or promote products derived 
 *    from this software without specific prior written permission. 
 *     
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE 
 * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, 
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
 */



import javax.swing.*;

import com.jgoodies.forms.builder.DefaultFormBuilder;
import com.jgoodies.forms.factories.Borders;
import com.jgoodies.forms.layout.CellConstraints;
import com.jgoodies.forms.layout.FormLayout;

/**
 * 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.
 * 
 * @author  Karsten Lentzsch
 * @version $Revision: 1.9 $
 */
public class UnitsExample {

    
    public static void main(String[] args) {
        try {
            UIManager.setLookAndFeel("com.jgoodies.plaf.plastic.PlasticXPLookAndFeel");
        } catch (Exception e) {
            // Likely PlasticXP is not in the class path; ignore.
        }
        JFrame frame = new JFrame();
        frame.setTitle("Forms Tutorial :: Units");
        frame.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
        JComponent panel = new UnitsExample().buildPanel();
        frame.getContentPane().add(panel);
        frame.pack();
        frame.setVisible(true);
    }


    public JComponent buildPanel() {
        JTabbedPane tabbedPane = new JTabbedPane();
        tabbedPane.putClientProperty("jgoodies.noContentBorder", Boolean.TRUE);

        tabbedPane.add("Horizontal",     buildHorizontalUnitsPanel());
        tabbedPane.add("Horizontal Dlu", buildHorizontalDluPanel());
        tabbedPane.add("Vertical",       buildVerticalUnitsPanel());
        tabbedPane.add("Vertical Dlu",   buildVerticalDluPanel());
        return tabbedPane;
    }
    
    
    private JComponent buildHorizontalUnitsPanel() {
        FormLayout layout = new FormLayout(
            "right:pref, 1dlu, left:pref, 4dlu, left:pref",   
            ""); 
        DefaultFormBuilder builder = new DefaultFormBuilder(layout);
        builder.setDefaultDialogBorder();

        builder.append("72",   new JLabel("pt"), buildHorizontalPanel("72pt"));
        builder.append("25.4", new JLabel("mm"), buildHorizontalPanel("25.4mm"));
        builder.append("2.54", new JLabel("cm"), buildHorizontalPanel("2.54cm"));
        builder.append("1",    new JLabel("in"), buildHorizontalPanel("1in"));
        builder.append("72",   new JLabel("px"), buildHorizontalPanel("72px"));
        builder.append("96",   new JLabel("px"), buildHorizontalPanel("96px"));
        builder.append("120",  new JLabel("px"), buildHorizontalPanel("120px"));
        
        return builder.getPanel();
    }
    
    
    private JComponent buildHorizontalDluPanel() {
        FormLayout layout = new FormLayout(
            "right:pref, 1dlu, left:pref, 4dlu, left:pref",   
            ""); 
        DefaultFormBuilder builder = new DefaultFormBuilder(layout);
        builder.setDefaultDialogBorder();

        builder.append("9",  new JLabel("cols"), buildHorizontalPanel(9));
        builder.append("50", new JLabel("dlu"),  buildHorizontalPanel("50dlu"));
        builder.append("75", new JLabel("px"),   buildHorizontalPanel("75px"));
        builder.append("88", new JLabel("px"),   buildHorizontalPanel("88px"));
        builder.append("100",new JLabel("px"),   buildHorizontalPanel("100px"));
        
        return builder.getPanel();
    }
    
    
    private JComponent buildVerticalUnitsPanel() {
        FormLayout layout = new FormLayout(
            "c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p",   
            "pref, 6dlu, top:pref"); 
            
        JPanel panel = new JPanel(layout);
        panel.setBorder(Borders.DIALOG_BORDER);
        CellConstraints cc = new CellConstraints();

        panel.add(new JLabel("72 pt"),            cc.xy(1, 1));
        panel.add(buildVerticalPanel("72pt"),     cc.xy(1, 3));
        
        panel.add(new JLabel("25.4 mm"),          cc.xy(3, 1));
        panel.add(buildVerticalPanel("25.4mm"),   cc.xy(3, 3));
        
        panel.add(new JLabel("2.54 cm"),          cc.xy(5, 1));
        panel.add(buildVerticalPanel("2.54cm"),   cc.xy(5, 3));
        
        panel.add(new JLabel("1 in"),             cc.xy(7, 1));
        panel.add(buildVerticalPanel("1in"),      cc.xy(7, 3));

        panel.add(new JLabel("72 px"),            cc.xy(9, 1));
        panel.add(buildVerticalPanel("72px"),     cc.xy(9, 3));
        
        panel.add(new JLabel("96 px"),           cc.xy(11, 1));
        panel.add(buildVerticalPanel("96px"),    cc.xy(11, 3));
        
        panel.add(new JLabel("120 px"),           cc.xy(13, 1));
        panel.add(buildVerticalPanel("120px"),    cc.xy(13, 3));
        
        return panel;
    }
    
    private JComponent buildVerticalDluPanel() {
        FormLayout layout = new FormLayout(
            "c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p, 4dlu, c:p",   
            "pref, 6dlu, top:pref, 25dlu, pref, 6dlu, top:pref"); 
            
        JPanel panel = new JPanel(layout);
        panel.setBorder(Borders.DIALOG_BORDER);
        CellConstraints cc = new CellConstraints();

        panel.add(new JLabel("4 rows"),           cc.xy(1, 1));
        panel.add(buildVerticalPanel("pref", 4),  cc.xy(1, 3));
        
        panel.add(new JLabel("42 dlu"),           cc.xy(3, 1));
        panel.add(buildVerticalPanel("42dlu", 4), cc.xy(3, 3));
        
        panel.add(new JLabel("57 px"),            cc.xy(5, 1));
        panel.add(buildVerticalPanel("57px", 4),  cc.xy(5, 3));
        
        panel.add(new JLabel("63 px"),            cc.xy(7, 1));
        panel.add(buildVerticalPanel("63px", 4),  cc.xy(7, 3));
        
        panel.add(new JLabel("68 px"),            cc.xy(9, 1));
        panel.add(buildVerticalPanel("68px", 4),  cc.xy(9, 3));
        

        panel.add(new JLabel("field"),            cc.xy(1, 5));
        panel.add(new JTextField(4),              cc.xy(1, 7));
        
        panel.add(new JLabel("14 dlu"),           cc.xy(3, 5));
        panel.add(buildVerticalPanel("14dlu"),    cc.xy(3, 7));
        
        panel.add(new JLabel("21 px"),            cc.xy(5, 5));
        panel.add(buildVerticalPanel("21px"),     cc.xy(5, 7));
        
        panel.add(new JLabel("23 px"),            cc.xy(7, 5));
        panel.add(buildVerticalPanel("23px"),     cc.xy(7, 7));
        
        panel.add(new JLabel("24 px"),            cc.xy(9, 5));
        panel.add(buildVerticalPanel("24px"),     cc.xy(9, 7));
        
        panel.add(new JLabel("button"),           cc.xy(11, 5));
        panel.add(new JButton("..."),             cc.xy(11, 7));
        
        return panel;
    }
    
    
    
    // Component Creation *****************************************************
    
    private JComponent createTextArea(int rows, int cols) {
        JTextArea area = new JTextArea(rows, cols);
        //area.setText(text);
        return new JScrollPane(area,
                    ScrollPaneConstants.VERTICAL_SCROLLBAR_NEVER,
                    ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER);
    }
    
    // Helper Code ************************************************************
    
    private JComponent buildHorizontalPanel(String width) {
        FormLayout layout = new FormLayout(width, "pref");
        JPanel panel = new JPanel(layout);
        panel.add(new JTextField(), new CellConstraints(1, 1));
        return panel;
    }
    
    private JComponent buildHorizontalPanel(int columns) {
        FormLayout layout = new FormLayout("pref, 4dlu, pref", "pref");
        JPanel panel = new JPanel(layout);
        CellConstraints cc = new CellConstraints();
        panel.add(new JTextField(columns),                
                  cc.xy(1, 1));
        panel.add(new JLabel("Width of new JTextField(" + columns + ")"), 
                  cc.xy(3, 1));
        return panel;
    }
    
    private JComponent buildVerticalPanel(String height) {
        return buildVerticalPanel(height, 10);
    }
    
    private JComponent buildVerticalPanel(String height, int rows) {
        FormLayout layout = new FormLayout("pref", "fill:"+ height);
        JPanel panel = new JPanel(layout);
        CellConstraints cc = new CellConstraints();
        panel.add(createTextArea(rows, 5), cc.xy(1, 1));
        return panel;
    }
    
    
}


           
       








forms.zip( 197 k)

Related examples in the same category

1.FormLayout: Default Alignment Example 2FormLayout: Default Alignment Example 2
2.FormLayout: Explicit Alignment Example 3FormLayout: Explicit Alignment Example 3
3.Demonstrates the different FormLayout alignmentsDemonstrates the different FormLayout alignments
4.FormLayout: Size Specification Example 4FormLayout: Size Specification Example 4
5.Demonstrates sizes: constant, minimum, preferredDemonstrates sizes: constant, minimum, preferred
6.Demonstrates the basic FormLayout sizes: constant, minimum, preferredDemonstrates the basic FormLayout sizes: constant, minimum, preferred
7.Three FormLayout component sizes: minimum, default and preferredThree FormLayout component sizes: minimum, default and 
 preferred
8.FormLayout: Spacing Example 5FormLayout: Spacing Example 5
9.Panel Builder Example 1Panel Builder Example 1
10.Panel Builder Example 2Panel Builder Example 2
11.Columns and rows are specified before the panel is filled with componentsColumns and rows are specified before the panel is filled with components
12.Build a panel with a leading indent column using the DefaultFormBuilderBuild a panel with a leading
 indent column using the DefaultFormBuilder
13.FormLayout: Growable Example 8FormLayout: Growable Example 8
14.FormLayout: No Grouping Example 9FormLayout: No Grouping Example 9
15.FormLayout: Grouping Example 10FormLayout: Grouping Example 10
16.Demonstrates a pure use of the FormLayoutDemonstrates a pure use of the FormLayout
17.Columns and rows are specified before the panel is filled with components 1Columns and rows are specified before the panel is filled with components 1
18.How columns and rows can be grouped in FormLayoutHow columns and rows can be grouped in FormLayout
19.FormLayout growing options: none, default, weightedFormLayout growing options: none, default, weighted
20.FormLayout: Default Form Builder Example 1FormLayout: Default Form Builder Example 1
21.Uses the FormLayout and the DefaultFormBuilderUses the FormLayout and the DefaultFormBuilder
22.The use of Factories as provided by the Forms frameworkThe use of Factories as provided by the Forms framework
23.Demonstrates how to find bugs in the layout usingDemonstrates how to find bugs in the layout using
24.Build panels component orientation: left-to-right vs. right-to-leftBuild panels component orientation: left-to-right vs. right-to-left
25.Demonstrates a frequent pitfall when specifying a growing rowDemonstrates a frequent pitfall when specifying a growing row
26.Demonstrates how a JTextArea's preferred size grows with the container if no columns and rows are setDemonstrates how a JTextArea's preferred size grows with the container
 if no columns and rows are set
27.FormLayout: Button Bar Builder ExampleFormLayout: Button Bar Builder Example
28.FormLayout: Button Bar Builder Example 2FormLayout: Button Bar Builder Example 2
29.FormLayout: Button Bar Builder Example 3FormLayout: Button Bar Builder Example 3
30.FormLayout: Button Stack Builder Example 1FormLayout: Button Stack Builder Example 1
31.Build button stacks using the ButtonStackBuilderBuild button stacks using the ButtonStackBuilder
32.Demonstrates how to build button bars using a ButtonBarBuilderDemonstrates how to build button bars using a ButtonBarBuilder
33.Demonstrates how to build button bars with a fixed button orderDemonstrates how to build button bars with a fixed button order
34.FormLayout: Basic Example 1FormLayout: Basic Example 1
35.FormLayout: Bounds Example 6FormLayout: Bounds Example 6
36.Create and configure a layout, create a builder, add componentsCreate and configure a layout, create a builder, add components
37.Compares approaches how to append a custom area at the end of a panel built with the DefaultFormBuilderCompares approaches how to append a custom area at the end of
 a panel built with the DefaultFormBuilder
38.Shows three approaches how to add custom rows to a form that is built using a DefaultFormBuilderShows three approaches how to add custom rows to a form that is built
 using a DefaultFormBuilder
39.How FormLayout applies the default column andHow FormLayout applies the default column and
40.FormLayout: Spanning Example 7FormLayout: Spanning Example 7
41.How components can span multiple columns and rowsHow components can span multiple columns and rows