GridBagConstraint

java.awt.GridBagLayout:一個靈活的布局管理器,它不要求組件的大小相同便可以將組件垂直、水平或沿它們的基線對齊。每個 GridBagLayout 對象維持一個動態的矩形單元格線,每個組件占用一個或多個這樣的單元,該單元被稱為顯示區域。每個由 GridBagLayout 管理的組件都與 GridBagConstraints 的實例相關聯。

基本介紹

  • 中文名:GridBagConstraint
  • 簡介:一個靈活的布局管理器
  • 特點:不要求組件的大小相同
  • 構造方法:創建格線包布局管理器
簡介,構造方法,常用方法,構造方法,

簡介

Constraints 對象指定組件的顯示區域在格線中的具體放置位置,以及組件在其顯示區域中的放置方式。除了 Constraints 對象之外,GridBagLayout 還考慮每個組件的最小大小和首選大小,以確定組件的大小。格線的總體方向取決於容器的 ComponentOrientation 屬性。對於水平的從左到右的方向,格線坐標 (0,0) 位於容器的左上角,其中 X 向右遞增,Y 向下遞增。對於水平的從右到左的方向,格線坐標 (0,0) 位於容器的右上角,其中 X 向左遞增,Y 向下遞增。
要使用GridBagLayout,必須使用GridBagConstraints對象來指定GridBagLayout中組件的位置。
GridBagLayout類的setConstraints方法用Component和GridBagConstraints作為參數來設定Component的約束。

構造方法

GridBagLayout():創建格線包布局管理器。

常用方法

void setConstraints(Component comp, GridBagConstraints constraints):設定此布局中指定組件的約束條件。
java.awt.GridBagConstraints:用於指定使用 GridBagLayout 類布置的組件的約束。

構造方法

GridBagConstraints(): 創建一個 GridBagConstraint 對象,將其所有欄位都設定為默認值。
GridBagConstraints(int gridx, int gridy, int gridwidth, int gridheight, double
weightx, double weighty, int anchor, int fill, Insets insets, int ipadx, int ipady):創建一個 GridBagConstraints 對象,將其所有欄位都設定為傳入參數。
gridx:指定包含組件的顯示區域開始邊的單元格.[默認值為 RELATIVE。gridx 應為非負值。]
其中行的第一個單元格為 gridx=0。組件顯示區域的開始邊指的是水平的、從左到右的容器的左邊緣,以及水平的、從右到左的容器的右邊緣。值 RELATIVE 指定將組件放置在添加此組件之前剛剛添加到容器中的組件的後面。
gridy:指定位於組件顯示區域的頂部的單元格.[默認值為 RELATIVE。gridy 應為非負值。]
其中最上邊的單元格為 gridy=0。值 RELATIVE 指定將組件放置在添加此組件之前剛剛添加到容器中的組件的下面。
gridwidth:指定組件顯示區域的某一行中的單元格數。 [gridwidth 應為非負,默認值為 1。 ]
使用 REMAINDER 指定組件的顯示區域,該區域的範圍是從 gridx 到該行的最後一個單元格。使用 RELATIVE 指定組件的顯示區域,該區域的範圍是從 gridx 到它所在行的倒數第二個單元格。
gridheight:指定在組件顯示區域的一列中的單元格數。 [gridheight 應為非負,默認值為 1。 ]
使用 REMAINDER 指定組件的顯示區域,該區域的範圍是從 gridy 到該列的最後一個單元格。使用 RELATIVE 指定組件的顯示區域,該區域的範圍是從 gridy 到它所在列的倒數第二個單元格。
weightx:指定如何分布額外的水平空間。 [此欄位的默認值為 0。weightx 應為非負值。 ]
格線包布局管理器計算出列的權重將是列的所有組件中最大的 weightx。如果得到的布局在水平方向上比需要填充的區域小,那么系統會將額外的空間按照其權重比例分布到每一列。權重為零的列不會得到額外的空間。
如果所有的權重都為零,則所有的額外空間都將出現在單元格的格線之間和左右邊緣之間。
weighty:指定如何分布額外的垂直空間。 [此欄位的默認值為 0。weighty 應為非負值。]
格線包布局管理器計算出行的權重將是行的所有組件中最大的 weighty。如果得到的布局在垂直方向上比需要填充的區域小,則系統會將額外的空間按照其權重比例分布到每一行。權重為零的行不會得到額外的空間。
如果所有的權重都為零,則所有的額外空間都將出現在單元格的格線之間和上下邊緣之間。
anchor:當組件小於其顯示區域時使用此欄位。它可以確定在顯示區域中放置組件的位置。[默認值為 CENTER。]
可能的值有三種:相對於方向的值、相對於基線的值和絕對值。相對於方向的值是相對於容器的組件方向屬性進行解釋的,相對於基線值是相對於基線進行解釋的,絕對值則不然。絕對值有:CENTER、NORTH、NORTHEAST、EAST、SOUTHEAST、SOUTH、SOUTHWEST、WEST 和 NORTHWEST。方向相對值有:PAGE_START、PAGE_END、LINE_START、LINE_END、FIRST_LINE_START、FIRST_LINE_END、LAST_LINE_START 和 LAST_LINE_END。相對於基線的值有:BASELINE、BASELINE_LEADING、BASELINE_TRAILING、ABOVE_BASELINE、ABOVE_BASELINE_LEADING、ABOVE_BASELINE_TRAILING、BELOW_BASELINE、BELOW_BASELINE_LEADING 和 BELOW_BASELINE_TRAILING。
fill:當組件的顯示區域大於它所請求的顯示區域的大小時使用此欄位。它可以確定是否調整組件大小,以及在需要的時候如何進行調整。[默認值為 NONE。]
以下值適用於 fill:
NONE:不調整組件大小。
HORIZONTAL:加寬組件,使它在水平方向上填滿其顯示區域,但是不改變高度。
VERTICAL:加高組件,使它在垂直方向上填滿其顯示區域,但是不改變寬度。
BOTH:使組件完全填滿其顯示區域。
insets:此欄位指定組件的外部填充,即組件與其顯示區域邊緣之間間距的最小量。 [默認值為 new Insets(0, 0, 0, 0)。]
insets四個參數按順序分別代表上,左,下,右四個方向空出的間距。
ipadx:此欄位指定組件的內部填充,即給組件的最小寬度添加多大的空間。組件的寬度至少為其最小寬度加上 ipadx 像素。 [默認值為 0。 ]
ipady:此欄位指定內部填充,即給組件的最小高度添加多大的空間。組件的高度至少為其最小高度加上 ipady 像素。 [默認值為 0。 ]
示例代碼:
package GUITest;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JPanel;
public class GridBagLayoutTest2 {
JPanel panelTop = new JPanel();
private void addButton(String arg0,GridBagLayout gridBag,GridBagConstraints constraints){
JButton btn = new JButton(arg0);
gridBag.setConstraints(btn, constraints);
panelTop.add(btn);
}
public GridBagLayoutTest2(){
JFrame frm = new JFrame("GridBagLayout Test v1.0");
GridBagLayout gridBag = new GridBagLayout();
panelTop.setLayout(gridBag);
GridBagConstraints constraints = new GridBagConstraints();
constraints.weightx = 1;
constraints.fill = GridBagConstraints.BOTH;
this.addButton("Button0",gridBag,constraints);
this.addButton("Button1",gridBag,constraints);
this.addButton("Button2",gridBag,constraints);
constraints.gridwidth = GridBagConstraints.REMAINDER;
this.addButton("Button3",gridBag,constraints);
this.addButton("Button4",gridBag,constraints);
constraints.gridwidth = GridBagConstraints.RELATIVE;//倒數第二,後邊一定要使用REMAINDER
this.addButton("Button5",gridBag,constraints);
constraints.gridwidth = GridBagConstraints.REMAINDER;//倒數第一,下一個換行。
this.addButton("Button6",gridBag,constraints);
constraints.gridwidth = 1;
constraints.gridheight = 2;
constraints.weighty = 1.0;
this.addButton("Button7",gridBag,constraints);
constraints.weighty = 0.0;
constraints.gridwidth = GridBagConstraints.REMAINDER;
constraints.gridheight = 1;
this.addButton("Button8",gridBag,constraints);
constraints.gridwidth = GridBagConstraints.RELATIVE;
this.addButton("Button9",gridBag,constraints);
this.addButton("Button10",gridBag,constraints);
frm.add(panelTop);
frm.setVisible(true);
frm.setSize(500, 300);
frm.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
}
public static void main(String[] args){
new GridBagLayoutTest2();
}
}

相關詞條

熱門詞條

聯絡我們