 |
 |
| 그림 1: 수평 방향으로 왼쪽에서 오른쪽 | 그림 2: 수평 방향으로 오른쪽에서 왼쪽 |
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object | +--java.awt.GridBagLayout
GridBagLayout 클래스는 다른 크기의 컴퍼넌트에서도 종횡에 배치할 수 있는 유연한 레이아웃 매니저입니다. 각각의 GridBagLayout 오브젝트는 셀에 의해 구성되는 동적인 구형 구라두를 저장하고 있습니다. 각 컴퍼넌트는 1 kr 이상의 셀 ( 「표시 area」라고 부른다)에 배치됩니다.
GridBagLayout 에 의해 관리되는 각 컴퍼넌트는 GridBagConstraints 의 인스턴스와 관련합니다. 제약 오브젝트는 컴퍼넌트의 표시 area를 구라두상에 배치하는 장소, 및 컴퍼넌트를 그 표시 영역내에 배치하는 방법을 지정합니다. 또, 이 제약 오브젝트에 가세해GridBagLayout 는 컴퍼넌트의 사이즈를 결정하기 위해서(때문에), 각 컴퍼넌트의 최소 사이즈 및 추천 사이즈를 고려합니다.
구라두의 전체의 방향은 컨테이너의 ComponentOrientation 프로퍼티에 의해 정해집니다. 수평 방향으로 왼쪽에서 오른쪽의 경우, 구라두의 좌표 (0,0)는 컨테이너의 좌상구석이 됩니다. 이 경우, X 좌표는 우측향에, Y 좌표는 아래방향에 값이 증가합니다. 수평 방향으로 오른쪽에서 왼쪽의 경우, 구라두의 좌표 (0,0)는 컨테이너의 우상구석이 됩니다. 이 경우, X 좌표는 좌방향에, Y 좌표는 아래방향에 값이 증가합니다.
구라두 가방 레이아웃을 효과적으로 이용하려면 , 컴퍼넌트의 적어도 1 개의 GridBagConstraints 오브젝트를 커스터마이즈 할 필요가 있습니다. GridBagConstraints 오브젝트를 커스터마이즈 하려면 , 1 kr 또는 복수의 인스턴스 변수를 설정합니다.
GridBagConstraints.gridx ,GridBagConstraints.gridy
gridx = 0,gridy = 0 입니다. 수평 방향으로 왼쪽에서 오른쪽에의 레이아웃의 경우, 컴퍼넌트의 리딩 코너는 좌상구석입니다. 수평 방향으로 금방 다른 곳으로의 레이아웃의 경우, 컴퍼넌트의 리딩 코너는 우상구석입니다. GridBagConstraints.RELATIVE (규정치)를 사용해, 컴퍼넌트를 이 컴퍼넌트가 추가되기 직전에 컨테이너에 추가된 컴퍼넌트의 직후에 (gridx 는 x 축으로 따라,gridy 는 y 축으로 따라) 배치하도록(듯이) 지정합니다.
GridBagConstraints.gridwidth , GridBagConstraints.gridheight
gridwidth) 또는 1 열 (gridheight) 근처의 셀의 수를 지정합니다. 기정치는 1 입니다. 컴퍼넌트가 행 (gridwidth) 또는 열 (gridheight)의 최후인 것을 지정하는 경우는 GridBagConstraints.REMAINDER 를 설정합니다. 다음의 컴퍼넌트로, 행 (gridwidth) 또는 열 (gridheight) 이 종료되는 것을 지정하는 경우는 GridBagConstraints.RELATIVE 를 설정합니다.
GridBagConstraints.fill
GridBagConstraints.NONE (디폴트),GridBagConstraints.HORIZONTAL (컴퍼넌트의 높이는 변경하지 않고 , 폭을 표시 area 가득 한다),GridBagConstraints.VERTICAL (컴퍼넌트의 폭은 변경하지 않고 , 높이를 표시 area 가득 한다),GridBagConstraints.BOTH (컴퍼넌트를 표시 area 가득 한다)입니다.
GridBagConstraints.ipadx ,GridBagConstraints.ipady
(ipadx * 2) 픽셀이 됩니다 (컴퍼넌트의 양측으로 패딩 되기 (위해)때문에). 같이 컴퍼넌트의 높이는 적어도 최소의 높이 + (ipady * 2) 픽셀이 됩니다.
GridBagConstraints.insets
GridBagConstraints.anchor
ComponentOrientation 프로퍼티를 기준(� 해석됩니다. 유효한 값은 다음과 같습니다. | 절대치 | 상대치 |
GridBagConstraints.NORTHGridBagConstraints.SOUTHGridBagConstraints.WESTGridBagConstraints.EASTGridBagConstraints.NORTHWESTGridBagConstraints.NORTHEASTGridBagConstraints.SOUTHWESTGridBagConstraints.SOUTHEASTGridBagConstraints.CENTER (디폴트) |
GridBagConstraints.PAGE_STARTGridBagConstraints.PAGE_ENDGridBagConstraints.LINE_STARTGridBagConstraints.LINE_ENDGridBagConstraints.FIRST_LINE_STARTGridBagConstraints.FIRST_LINE_ENDGridBagConstraints.LAST_LINE_STARTGridBagConstraints.LAST_LINE_END |
GridBagConstraints.weightx , GridBagConstraints.weighty
weightx) 또는 1 열 (weighty)에 대해, 적어도 1 개의 컴퍼넌트에 웨이트를 설정하지 않는 한, 모든 컴퍼넌트가 컨테이너 속앙에 모입니다. 이것은 웨이트가 0 의 경우 (디폴트)에는 GridBagLayout 오브젝트가 여분의 스페이스를 모두 셀의 구라두와 컨테이너의 구석의 사이에 배치해 버리기 때문입니다.
다음에 나타내는 그림은 구라두 가방 레이아웃에 의해 관리되는 10 개의 컴퍼넌트 (모든 버튼)를 나타냅니다. 그림 1 은 수평 방향으로 왼쪽에서 오른쪽에의 컨테이너를 나타내, 그림 2 는 수평 방향으로 금방 다른 곳으로의 컨테이너를 나타냅니다.
|
|
| 그림 1: 수평 방향으로 왼쪽에서 오른쪽 | 그림 2: 수평 방향으로 오른쪽에서 왼쪽 |
10 개의 컴퍼넌트의 각각은 그 관련하고 있는 GridBagConstraints 오브젝트의 fill 필드가 GridBagConstraints.BOTH 로 설정되어 있습니다. 한층 더 컴퍼넌트는 디폴트와는 다른 이하의 제약을 가지고 있습니다.
weightx = 1. 0
weightx = 1. 0,gridwidth = GridBagConstraints.REMAINDER
gridwidth = GridBagConstraints.REMAINDER
gridwidth = GridBagConstraints.RELATIVE
gridwidth = GridBagConstraints.REMAINDER
gridheight = 2,weighty = 1. 0
gridwidth = GridBagConstraints.REMAINDER
상기의 예를 구현한 샘플 코드를 나타냅니다.
import java.awt. *;
import java.util. *;
import java.applet.Applet;
public class GridBagEx1 extends Applet {
protected void makebutton(String name,
GridBagLayout gridbag,
GridBagConstraints c) {
Button button = new Button(name);
gridbag.setConstraints(button, c);
add(button);
}
public void init() {
GridBagLayout gridbag = new GridBagLayout();
GridBagConstraints c = new GridBagConstraints();
setFont(new Font("Helvetica", Font.PLAIN, 14));
setLayout(gridbag);
c.fill = GridBagConstraints.BOTH;
c.weightx = 1.0;
makebutton("Button1", gridbag, c);
makebutton("Button2", gridbag, c);
makebutton("Button3", gridbag, c);
c.gridwidth = GridBagConstraints.REMAINDER; //end row
makebutton("Button4", gridbag, c);
c.weightx = 0.0; //reset to the default
makebutton("Button5", gridbag, c); //another row
c.gridwidth = GridBagConstraints.RELATIVE; //next-to-last in row
makebutton("Button6", gridbag, c);
c.gridwidth = GridBagConstraints.REMAINDER; //end row
makebutton("Button7", gridbag, c);
c.gridwidth = 1; //reset to the default
c.gridheight = 2;
c.weighty = 1.0;
makebutton("Button8", gridbag, c);
c.weighty = 0.0; //reset to the default
c.gridwidth = GridBagConstraints.REMAINDER; //end row
c.gridheight = 1; //reset to the default
makebutton("Button9", gridbag, c);
makebutton("Button10", gridbag, c);
setSize(300, 100);
}
public static void main(String args[]) {
Frame f = new Frame("GridBag Layout Example");
GridBagEx1 ex1 = new GridBagEx1();
ex1.init();
f.add("Center", ex1);
f.pack();
f.setSize(f.getPreferredSize());
f.show();
}
}
GridBagConstraints ,
ComponentOrientation ,
직렬화 된 형식 | 필드의 개요 | |
double[] |
columnWeights
이 필드는 열의 웨이트에 대한 오버라이드(override)를 보관 유지합니다. |
int[] |
columnWidths
이 필드는 열의 최소폭에 대한 오버라이드(override)를 보관 유지합니다. |
protected Hashtable |
comptable
이 해시 테이블은 컴퍼넌트와 컴퍼넌트의 구라두 가방 제약과의 관련성을 유지합니다. |
protected GridBagConstraints |
defaultConstraints
이 필드는 기정치를 저장하는 구라두 가방 제약의 인스턴스를 보관 유지합니다. |
protected java.awt.GridBagLayoutInfo |
layoutInfo
이 필드는 구라두 가방의 레이아웃 정보를 보관 유지합니다. |
protected static int |
MAXGRIDSIZE
구라두 가방 레이아웃에 의해 배치할 수 있는 구라두 위치 (종횡 어느 쪽이라고도)의 최대수입니다. |
protected static int |
MINSIZE
구라두 가방 레이아웃에 의해 배치할 수 있는 최소의 구라두입니다. |
protected static int |
PREFERREDSIZE
구라두 가방 레이아웃에 의해 배치할 수 있는 구라두의 추천 사이즈입니다. |
int[] |
rowHeights
이 필드는 행의 최소의 높이에 대한 오버라이드(override)를 보관 유지합니다. |
double[] |
rowWeights
이 필드는 행의 웨이트에 대한 오버라이드(override)를 보관 유지합니다. |
| 생성자의 개요 | |
GridBagLayout ()
구라두 가방 레이아웃 매니저를 작성합니다. |
|
| 메소드의 개요 | |
void |
addLayoutComponent (Component comp,
Object constraints)
지정된 constraints 오브젝트를 사용해, 지정된 컴퍼넌트를 레이아웃에 추가합니다. |
void |
addLayoutComponent (String name,
Component comp)
지정된 이름으로, 지정된 컴퍼넌트를 레이아웃에 추가합니다. |
protected void |
adjustForGravity (GridBagConstraints constraints,
Rectangle r)
x, y, 폭, 높이 필드를, 제약 지오메트리 및 패드에 응해 올바른 값에 조정합니다. |
protected void |
AdjustForGravity (GridBagConstraints constraints,
Rectangle r)
이 메소드는 하위 호환성 (을) 위해서만 제공됩니다. |
protected void |
arrangeGrid (Container parent)
구라두를 배치합니다. |
protected void |
ArrangeGrid (Container parent)
이 메소드는 하위 호환성 (을) 위해서만 제공됩니다. |
GridBagConstraints |
getConstraints (Component comp)
지정된 컴퍼넌트의 제약을 돌려줍니다. |
float |
getLayoutAlignmentX (Container parent)
x 축방향의 배치 방법을 돌려줍니다. |
float |
getLayoutAlignmentY (Container parent)
y 축방향의 배치 방법을 돌려줍니다. |
int[][] |
getLayoutDimensions ()
레이아웃 구라두의 열의 폭과 행의 높이를 지정합니다. |
protected java.awt.GridBagLayoutInfo |
getLayoutInfo (Container parent,
int sizeflag)
관리되는 아이의 현재세트에 대한 상기 구조의 인스턴스에 값을 입금시킵니다. |
protected java.awt.GridBagLayoutInfo |
GetLayoutInfo (Container parent,
int sizeflag)
이 메소드는 하위 호환성 (을) 위해서만 제공됩니다. |
Point |
getLayoutOrigin ()
타겟 컨테이너의 그래픽스 좌표 공간내에서, 레이아웃 area의 원점을 지정합니다. |
double[][] |
getLayoutWeights ()
레이아웃 구라두의 열과 행의 웨이트를 지정합니다. |
protected Dimension |
getMinSize (Container parent,
java.awt.GridBagLayoutInfo info)
getLayoutInfo()의 정보에 근거해 마스터의 최소 사이즈를 계산합니다. |
protected Dimension |
GetMinSize (Container parent,
java.awt.GridBagLayoutInfo info)
이 메소드는 하위 호환성 (을) 위해서만 제공됩니다. |
void |
invalidateLayout (Container target)
레이아웃을 무효로 합니다. |
void |
layoutContainer (Container parent)
이 구라두 가방 레이아웃을 사용해 지정된 컨테이너를 배치합니다. |
Point |
location (int x,
int y)
레이아웃 구라두의 어느 셀이 (x, y) 로 지정되는 좌표를 저장하는지를 판정합니다. |
protected GridBagConstraints |
lookupConstraints (Component comp)
지정된 컴퍼넌트의 제약을 돌려줍니다. |
Dimension |
maximumLayoutSize (Container target)
지정된 타겟 컨테이너가 주어진 컴퍼넌트에 대한 레이아웃의 최대 치수를 돌려줍니다. |
Dimension |
minimumLayoutSize (Container parent)
이 구라두 가방 레이아웃을 사용해, target 컨테이너의 최소 사이즈를 지정합니다.
|
Dimension |
preferredLayoutSize (Container parent)
이 구라두 가방 레이아웃을 사용해, target 컨테이너의 추천 사이즈를 지정합니다.
|
void |
removeLayoutComponent (Component comp)
지정된 컴퍼넌트를 이 레이아웃으로부터 삭제합니다. |
void |
setConstraints (Component comp,
GridBagConstraints constraints)
이 레이아웃의 지정된 컴퍼넌트에 대해서 제약을 설정합니다. |
String |
toString ()
구라두 가방 레이아웃의 값의 캐릭터 라인 표현을 돌려줍니다. |
| 클래스 java.lang. Object 에서 상속받은 메소드 |
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
| 필드의 상세 |
protected static final int MAXGRIDSIZE
protected static final int MINSIZE
protected static final int PREFERREDSIZE
protected Hashtable comptable
GridBagConstraints 의 인스턴스입니다.
GridBagConstraints protected GridBagConstraints defaultConstraints
defaultConstraints 의 카피를 할당할 수 있습니다.
getConstraints(Component) ,
setConstraints(Component, GridBagConstraints) ,
lookupConstraints(Component) protected java.awt.GridBagLayoutInfo layoutInfo
layoutInfo 가 null 의 경우는 구라두 가방에 컴퍼넌트가 없는지 또는 컴퍼넌트가 있어도 그것이 아직 검사를 받고 있지 않은 것을 의미합니다.
getLayoutInfo(Container, int) public int[] columnWidths
null 가 아닌 경우, 모든 최소렬폭이 계산된 후에, 그 값이 구라두 가방에 적용됩니다. columnWidths 에 렬수보다 많은 요소가 있는 경우, columnWidth 의 요소수에 맞추기 위해서(때문에) 구라두 가방에 열이 추가됩니다.
getLayoutDimensions() public int[] rowHeights
rowHeights 에 행수보다 많은 요소가 있는 경우,rowHeights 의 요소수에 맞추기 위해서(때문에), 구라두 가방에 행이 추가됩니다.
getLayoutDimensions() public double[] columnWeights
null 가 아닌 경우, 모든 열의 웨이트가 계산된 다음에, 그 값이 구라두 가방에 적용됩니다. columnWeights[i] > 가 열 i 의 웨이트보다 큰 경우, 열 i 에 columnWeights[i] 의 웨이트를 할당할 수 있습니다. columnWeights 에 렬수보다 많은 요소가 있는 경우, 초과한 요소는 무시되어 열의 작성은 행해지지 않습니다.
public double[] rowWeights
rowWeights[i] > 가 행 i 의 웨이트보다 큰 경우, 행 i 에 rowWeights[i] 의 웨이트를 할당할 수 있습니다. rowWeights 에 행수보다 많은 요소가 있는 경우, 초과한 요소는 무시되어 행의 작성은 행해지지 않습니다.
| 생성자의 상세 |
public GridBagLayout()
| 메소드의 상세 |
public void setConstraints(Component comp,
GridBagConstraints constraints)
comp - 변경되는 컴퍼넌트constraints - 적용되는 제약public GridBagConstraints getConstraints(Component comp)
GridBagConstraints 오브젝트의 카피가 돌려주어집니다.
comp - 조회되는 컴퍼넌트
protected GridBagConstraints lookupConstraints(Component comp)
GridBagConstraints 오브젝트입니다.
comp - 조회되는 컴퍼넌트
public Point getLayoutOrigin()
ComponentOrientation 의 값과는 관계없이, 레이아웃 area의 좌상구석의 픽셀 좌표를 나타냅니다. 이것은 셀 좌표 (0,0)에 의해 지정되는 구라두의 원점과는 다릅니다. 대부분의 어플리케이션은 이 메소드를 직접은 호출하지 않습니다.
ComponentOrientation public int[][] getLayoutDimensions()
대부분의 어플리케이션은 이 메소드를 직접은 호출하지 않습니다.
public double[][] getLayoutWeights()
대부분의 어플리케이션은 이 메소드를 직접은 호출하지 않습니다.
public Point location(int x,
int y)
(x, y) 로 지정되는 좌표를 저장하는지를 판정합니다. 각 셀은 열인덱스 (0 ~렬수 - 1)와 행 인덱스 (0 ~행수 - 1)로 식별됩니다.
점 (x, y) 이 구라두의 외측에 있는 경우, 다음의 규칙이 적용됩니다. x 가 왼쪽에서 우측향의 컨테이너의 레이아웃의 왼쪽에 있는 경우, 또는 오른쪽으로부터 좌방향의 컨테이너의 레이아웃의 오른쪽에 있는 경우, 열인덱스는 제로가 돌려주어집니다. x 가 왼쪽에서 우측향의 컨테이너의 레이아웃의 오른쪽에 있는 경우, 또는 오른쪽으로부터 좌방향의 컨테이너의 레이아웃의 왼쪽에 있는 경우, 열인덱스는 렬수가 돌려주어집니다. y 가 레이아웃의 상부에 있는 경우는 행 인덱스는 제로가 돌려주어져y 가 레이아웃의 하부에 있는 경우는 행수가 돌려주어집니다. 컨테이너의 방향은 그 ComponentOrientation 프로퍼티에 의해 지정됩니다.
x - 점의 x 좌표y - 점의 y 좌표
ComponentOrientation
public void addLayoutComponent(String name,
Component comp)
LayoutManager 내의 addLayoutComponent name - 컴퍼넌트의 이름comp - 추가되는 컴퍼넌트
public void addLayoutComponent(Component comp,
Object constraints)
constraints 오브젝트를 사용해, 지정된 컴퍼넌트를 레이아웃에 추가합니다. 제약은 가변이며, 그 때문에 캐쉬시에 복제되는 것에 주의합니다.
LayoutManager2 내의 addLayoutComponent comp - 추가되는 컴퍼넌트constraints - 컴퍼넌트를 레이아웃에 추가하는 방법을 지정하는 오브젝트
IllegalArgumentException - constraints 가 GridBagConstraint 가 아닌 경우public void removeLayoutComponent(Component comp)
대부분의 어플리케이션은 이 메소드를 직접은 호출하지 않습니다.
LayoutManager 내의 removeLayoutComponent comp - 삭제되는 컴퍼넌트Container.remove(java.awt.Component) ,
Container.removeAll() public Dimension preferredLayoutSize(Container parent)
target 컨테이너의 추천 사이즈를 지정합니다.
대부분의 어플리케이션은 이 메소드를 직접은 호출하지 않습니다.
LayoutManager 내의 preferredLayoutSize parent - 배치되는 컨테이너Container.getPreferredSize() public Dimension minimumLayoutSize(Container parent)
target 컨테이너의 최소 사이즈를 지정합니다.
대부분의 어플리케이션은 이 메소드를 직접은 호출하지 않습니다.
LayoutManager 내의 minimumLayoutSize parent - 배치되는 컴퍼넌트Container.doLayout() public Dimension maximumLayoutSize(Container target)
LayoutManager2 내의 maximumLayoutSize target - 레이아웃 할 필요가 있는 컴퍼넌트Container ,
minimumLayoutSize(Container) ,
preferredLayoutSize(Container) public float getLayoutAlignmentX(Container parent)
LayoutManager2 내의 getLayoutAlignmentX public float getLayoutAlignmentY(Container parent)
LayoutManager2 내의 getLayoutAlignmentY public void invalidateLayout(Container target)
LayoutManager2 내의 invalidateLayout public void layoutContainer(Container parent)
GridBagLayout 오브젝트의 제약을 채우기 위해서(때문에), 지정된 컨테이너로 컴퍼넌트를 재성형합니다.
대부분의 어플리케이션은 이 메소드를 직접은 호출하지 않습니다.
LayoutManager 내의 layoutContainer parent - 배치를 하는 컨테이너Container ,
Container.doLayout() public String toString()
Object 내의 toString
protected java.awt.GridBagLayoutInfo getLayoutInfo(Container parent,
int sizeflag)
protected java.awt.GridBagLayoutInfo GetLayoutInfo(Container parent,
int sizeflag)
getLayoutInfo
protected void adjustForGravity(GridBagConstraints constraints,
Rectangle r)
protected void AdjustForGravity(GridBagConstraints constraints,
Rectangle r)
adjustForGravity
protected Dimension getMinSize(Container parent,
java.awt.GridBagLayoutInfo info)
protected Dimension GetMinSize(Container parent,
java.awt.GridBagLayoutInfo info)
getMinSizeprotected void arrangeGrid(Container parent)
protected void ArrangeGrid(Container parent)
arrangeGrid
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.