java.awt.GridBagLayout
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public class GridBagLayout
GridBagLayout 클래스는 다른 크기의 컴퍼넌트에서도 종횡에 배치할 수 있는 유연한 레이아웃 매니저입니다. 각각의 GridBagLayout객체는
셀에 의해 구성되는 동적인 구형 구라두를 포함하고 있습니다. 각 컴퍼넌트는 1개
이상의 셀 ( 「표시 영역」이라고 부른다)에 배치됩니다.
GridBagLayout에 의해 관리되는 각 컴퍼넌트는 GridBagConstraints
인스턴스와 관련합니다. 제약 객체는 컴퍼넌트의 표시 영역을 구라두상에 배치하는 장소 및 컴퍼넌트를 그 표시 영역내에 배치하는 방법을 지정합니다. 또, 이 제약 객체에 가세해GridBagLayout는
컴퍼넌트의 사이즈를 결정하기 위해서
각 컴퍼넌트의 최소 사이즈 및 추천 사이즈를 고려합니다.
구라두의 전체의 방향은 컨테이너 ComponentOrientation 프로퍼티에 의해 정해집니다. 수평 방향으로 왼쪽에서 오른쪽의 경우, 구라두의 좌표 (0, 0)는 컨테이너의 좌상구석이 됩니다. 이 경우
X 좌표는 우측향에
Y 좌표는 아래방향에 값이 증가합니다. 수평 방향으로 오른쪽에서 왼쪽의 경우, 구라두의 좌표 (0, 0)는 컨테이너의 우상구석이 됩니다. 이 경우
X 좌표는 좌방향에
Y 좌표는 아래방향에 값이 증가합니다.
구라두 가방 레이아웃을 효과적으로 이용하려면,
컴퍼넌트의 적어도 1개의 GridBagConstraints 객체를 커스터마이즈 할 필요가 있습니다. GridBagConstraints 객체를 커스터마이즈 하려면,
1개
또는 복수의 인스턴스 변수를 설정합니다.
GridBagConstraints.gridx,
GridBagConstraints.gridy gridx = 0, gridy = 0 입니다. 수평 방향으로 왼쪽에서 오른쪽에의 레이아웃의 경우, 컴퍼넌트의 리딩 코너는 좌상구석입니다. 수평 방향으로 금방 다른 곳으로의 레이아웃의 경우, 컴퍼넌트의 리딩 코너는 우상구석입니다. GridBagConstraints.RELATIVE (규정치)를 사용해, 컴퍼넌트를, 이 컴퍼넌트가 추가되기 직전에 컨테이너에 추가된 컴퍼넌트의 직후에 (gridx는 x 축으로 따라, gridy는 y 축으로 따라) 배치하도록 지정합니다.
GridBagConstraints.gridwidth,
GridBagConstraints.gridheight gridwidth) 또는 1 열 (gridheight) 근처의 셀의 수를 지정합니다. 기정치는 1 입니다. 컴퍼넌트의 표시 영역이 gridx로
부터 행의 마지막 셀까지 (gridwidth) 또는 gridy로
부터 열의 마지막 셀까지 (gridheight)인 것을 지정하는 경우는 GridBagConstraints.REMAINDER를 사용합니다.
컴퍼넌트의 표시 영역이 gridx로
부터, 행의 최후로부터 2번째의 셀까지 (gridwidth), 또는 gridy로
부터, 열의 최후로부터 2번째의 셀까지 (gridheight)인 것을 지정하는 경우는 GridBagConstraints.RELATIVE를 사용합니다.
GridBagConstraints.fill GridBagConstraints.NONE (디폴트), GridBagConstraints.HORIZONTAL (컴퍼넌트의 높이는 변경하지 않고,
넓이를 표시 영역 최대로 한다), GridBagConstraints.VERTICAL (컴퍼넌트의 폭은 변경하지 않고,
높이를 표시 영역 최대로 한다), GridBagConstraints.BOTH (컴퍼넌트를 표시 영역 최대로 한다)입니다.
GridBagConstraints.ipadx,
GridBagConstraints.ipady ipadx 픽셀이 됩니다. 같이 컴퍼넌트의 높이는 적어도 최소의 높이 + ipady 픽셀이 됩니다.
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. 0weightx = 1. 0, gridwidth = GridBagConstraints.REMAINDERgridwidth = GridBagConstraints.REMAINDERgridwidth = GridBagConstraints.RELATIVEgridwidth = GridBagConstraints.REMAINDERgridheight = 2, weighty = 1. 0gridwidth = 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("SansSerif", Font.PLAIN, 14));
setLayout(gridbag);. 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 <Component,
GridBagConstraints > |
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)
관리되는자식 의 현재세트에 대한 GridBagLayoutInfo
인스턴스에 값을 입금시킵니다. |
protected java.awt.GridBagLayoutInfo |
GetLayoutInfo (Container parent,
int sizeflag)
이 메서드는 하위 호환성 위해서만 제공됩니다. |
Point |
getLayoutOrigin ()
타겟 컨테이너의 그래픽 좌표 공간내에서 레이아웃 영역의 원점을 지정합니다. |
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)
이 구라두 가방 레이아웃을 사용해, parent 컨테이너의 최소 사이즈를 지정합니다. |
Dimension |
preferredLayoutSize (Container parent)
이 구라두 가방 레이아웃을 사용해, parent 컨테이너의 추천 사이즈를 지정합니다. |
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 <Component, GridBagConstraints > comptable
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가 GridBagLayout에 없는 경우, 일련의 디폴트의 GridBagConstraints가 리턴됩니다
. null
comp값은 무효로null이 리턴됩니다
.
comp - 조회되는 컴퍼넌트
public Point getLayoutOrigin()
ComponentOrientation값과는 관계없이, 레이아웃 영역의 좌상구석의 픽셀 좌표를 나타냅니다. 이것은 셀 좌표 (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)
parent 컨테이너의 추천 사이즈를 지정합니다.
대부분의 어플리케이션은 이 메서드를 직접은 호출하지 않습니다.
LayoutManager 내의 preferredLayoutSize parent - 배치를 하는 컨테이너
parent 컨테이너의 추천 사이즈Container.getPreferredSize() public Dimension minimumLayoutSize(Container parent)
parent 컨테이너의 최소 사이즈를 지정합니다.
대부분의 어플리케이션은 이 메서드를 직접은 호출하지 않습니다.
LayoutManager 내의 minimumLayoutSize parent - 배치를 하는 컨테이너
parent 컨테이너의 최소 사이즈Container.doLayout() public Dimension maximumLayoutSize(Container target)
LayoutManager2 내의 maximumLayoutSize target - 배치할 필요가 있는 컨테이너
Container,
minimumLayoutSize(Container),
preferredLayoutSize(Container) public float getLayoutAlignmentX(Container parent)
LayoutManager2 내의 getLayoutAlignmentX 0.5fpublic float getLayoutAlignmentY(Container parent)
LayoutManager2 내의 getLayoutAlignmentY 0.5fpublic 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)
GridBagLayoutInfo
인스턴스에 값을 입금시킵니다. 이 인스턴스에는 자식
세트를 통해서, 다음의 3개의 단계의 실행이 필요합니다.
이 메서드는 GridBagLayout에 의해 내부에서만 사용됩니다.
parent - 레이아웃 컨테이너sizeflag - PREFERREDSIZE 또는 MINSIZE
어느 쪽인지
GridBagLayoutInfo
protected java.awt.GridBagLayoutInfo GetLayoutInfo(Container parent,
int sizeflag)
getLayoutInfo를
호출합니다. 이 메서드는 getLayoutInfo와
같습니다. 파라미터와 반환값의 자세한 것은 getLayoutInfo를 참조하십시오.
protected void adjustForGravity(GridBagConstraints constraints,
Rectangle r)
GridBagLayout에 의해 내부에서만 사용됩니다.
constraints - 적용되는 제약r - 조정하는 Rectangle
protected void AdjustForGravity(GridBagConstraints constraints,
Rectangle r)
adjustForGravity를
호출합니다. 이 메서드는 adjustForGravity와
같습니다. 파라미터의 자세한 것은 adjustForGravity를 참조하십시오.
protected Dimension getMinSize(Container parent,
java.awt.GridBagLayoutInfo info)
getLayoutInfo로
부터의 정보에 기반해
마스터의 최소 사이즈를 산출합니다. 이 메서드는 GridBagLayout에 의해 내부에서만 사용됩니다.
parent - 레이아웃 컨테이너info - 이 부모의 레이아웃 정보
Dimension 객체
protected Dimension GetMinSize(Container parent,
java.awt.GridBagLayoutInfo info)
getMinSize를
호출합니다. 이 메서드는 getMinSize와
같습니다. 파라미터와 반환값의 자세한 것은 getMinSize를 참조하십시오.
protected void arrangeGrid(Container parent)
GridBagLayout에 의해 내부에서만 사용됩니다.
parent - 레이아웃 컨테이너protected void ArrangeGrid(Container parent)
arrangeGrid를
호출합니다. 이 메서드는 arrangeGrid와
같습니다. 파라미터의 자세한 것은 arrangeGrid를 참조하십시오.
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.