JGoodies Form参数详解

http://hi.baidu.com/whicss/blog/item/d1e7d819efbc1a76dbb4bd03.html

 

Alignments

JGoodies Forms 允許元件排列：水平 – left、center、right
                    垂直 –  top、center、bottom
並且可以填滿 (fill) 一個或多個cell之中有用的空間。

FormLayout layout = new FormLayout(
  "left:pref, 15px, center:pref, 15px, right:pref, 15px, fill:pref,15px, pref",   

  "pref, 12px, pref, 4px, pref, 4px, pref, 4px, pref, 4px, pref");

上面的程式碼是告知元件在行與列中default的排列方式和大小。如果想改變元件的排列方式的話，可以利用CellConstraints的instance在元件加入時改變。

panel.add(new JLabel("Fill"),     cc.xy(7,  1, 
"center, center"
));  

panel.add(new JLabel("Default"),  cc.xy(9,  1, 
"center, center"
));

Basic Sizes

Form提供了豐富的大小設定：75px 指的是固定75像素的大小，pref是元件最適當的大小。

 

private JComponent buildHorizontalSizesPanel() {
        FormLayout layout = new FormLayout(

            "pref, 12px, " 
+
 "75px, 25px, min, 25px, pref",   

            "pref, 12px, pref"); 

            

        
// Create a panel that uses the layout.

        JPanel panel = new JPanel(layout);


        
// Set a default border.

        panel.setBorder(Borders.DIALOG_BORDER);

        

        
// Create a reusable CellConstraints instance.

        CellConstraints cc = new CellConstraints();


        
// Add components to the panel.

        panel.add(new JLabel("75px"),  cc.xy(3, 1));

        panel.add(new JLabel("Min"),   cc.xy(5, 1));

        panel.add(new JLabel("Pref"),  cc.xy(7, 1));

        

        panel.add(new JLabel("new JTextField(15)"),  cc.xy(1, 3));


        panel.add(new JTextField(15),  cc.xy(3, 3));

        panel.add(new JTextField(15),  cc.xy(5, 3));

        panel.add(new JTextField(15),  cc.xy(7, 3));


        return panel;

        }

    

上面利用"+"來區隔出不同的元件區塊，進而使程式碼不會太雜亂。

Growing

如果容器大於最適當的容器大小，會有額外的空間。這時就可以指明如何去分配這些額外的空間 ~ 讓單一的行或列擴張（growing），或是結合行列。

接著來看看這些程式碼片斷...

private JComponent buildHorizontalAllExtraSpacePanel() {
        FormLayout layout = new FormLayout(

            "pref, 6px, pref:grow",   

            "pref, 12px, pref"); 

            

        JPanel panel = new JPanel(layout);

        panel.setBorder(Borders.DIALOG_BORDER);

        CellConstraints cc = new CellConstraints();


        panel.add(new JLabel("Fixed"),  cc.xy(1, 1));

        panel.add(new JLabel("Gets all extra space"),  cc.xy(3, 1));

        

        panel.add(new JTextField(5),   cc.xy(1, 3));

        panel.add(new JTextField(5),   cc.xy(3, 3));


        return panel;

    }

在formLayout的參數中可以看到pref:grow 。表示說，在這個位置的元件，大小為元件本身的大小 (最合適的大小...pref ) ，並會隨著面版的縮放，進而縮小或放大填滿剩下的有用空間 ( grow )。

private JComponent buildHorizontalHalfAndHalfPanel() {
        FormLayout layout = new FormLayout(

            "pref, 6px, 
0:grow
, 6px, 
0:grow
",   

            "pref, 12px, pref"); 

            

        JPanel panel = new JPanel(layout);

        panel.setBorder(Borders.DIALOG_BORDER);

        CellConstraints cc = new CellConstraints();


        panel.add(new JLabel("Fixed"),  cc.xy(1, 1));

        panel.add(new JLabel("Gets half of extra space"),  cc.xy(3, 1));

        panel.add(new JLabel("gets half of extra space"),  cc.xy(5, 1));

        

        panel.add(new JTextField(5),   cc.xy(1, 3));

        panel.add(new JTextField(5),   cc.xy(3, 3));

        panel.add(new JTextField(5),   cc.xy(5, 3));


        return panel;

    }

0:grow 表示在這個位置的元件，對齊方式是fill (default) ，元件大小為0，並且會擴張填滿目前剩下的有用空間。

下面二張圖可以看出pref:grow 與0:grow 的差別...

上面的圖是pref:grow ，下面的是0:grow 。可以發現到上面的圖第三個元件畫面被截掉了，這是因為第二個元件保有他自己本身的大小所致。

private JComponent buildHorizontalPercentMixedPanel() {
        FormLayout layout = new FormLayout(

            "pref, 6px, 
fill:0:grow(0.25)
, 6px, fill:0:grow(0.75)",   

            "pref, 12px, pref"); 

            

        JPanel panel = new JPanel(layout);

        panel.setBorder(Borders.DIALOG_BORDER);

        CellConstraints cc = new CellConstraints();


        panel.add(new JLabel("Fixed"),       cc.xy(1, 1));

        panel.add(new JLabel("Gets 25% of extra space"),  cc.xy(3, 1));

        panel.add(new JLabel("Gets 75% of extra space"),  cc.xy(5, 1));

        

        panel.add(new JTextField(5),        cc.xy(1, 3));

        panel.add(new JTextField(5),        cc.xy(3, 3));

        panel.add(new JTextField(5),        cc.xy(5, 3));


        return panel;

    }

fill:0:grow(0.25)表示說：在這個位置的元件對齊方式是fill，元件大小為0，可以擴張的比列是：全部空間中的25%。

private JComponent buildHorizontalPercentPanel() {
        FormLayout layout = new FormLayout(

            "
pref:grow(0.33)
, 6px, pref:grow(0.67)",   

            "pref, 12px, pref"); 

            

        JPanel panel = new JPanel(layout);

        panel.setBorder(Borders.DIALOG_BORDER);

        CellConstraints cc = new CellConstraints();


        panel.add(new JLabel("Gets 33% of the space"),    cc.xy(1, 1));

        panel.add(new JLabel("Gets 67% of the space"),    cc.xy(3, 1));

        

        panel.add(new JTextField(5),   cc.xy(1, 3));

        panel.add(new JTextField(5),   cc.xy(3, 3));


        return panel;

    }

pref:grow(0.33)表示說：在這個位置的元件對齊方式是fill (default) ，元件大小為pref，可以縮放的比列是：剩下空間中的 33%。

 

---

 

fill:0:grow(x) 與pref:grow(x) 的不同處...

---

用相同的比例來看看，上面的圖使用的是fill:0:grow(0.25) ，下面的是pref:grow(0.25) 。上圖因為元件大小為0，所以直接取得整個空間中的25%（在先前元件之後的空間）。而下面的圖，因為保有基本的元件大小（pref），所以gorw只會取得...在所有 元件基本大小（pref）之後的額外空間（在這為25%）。也就是說，整個空間先減去所有 元件的基本大小，之後再從剩下空間中（若有的話）分配25%給此位置的元件，75%也是一樣。下面的圖說明一切...