java.awt
클래스 GridLayout

java.lang.Object 
  java.awt.GridLayout

모든 구현된 인터페이스:

LayoutManager, Serializable

public class GridLayout
extends Object 
implements LayoutManager,
 Serializable 

GridLayout 클래스는 구형 구라두에 컨테이너의 컴퍼넌트를 배치하는 레이아웃 매니저입니다. 컨테이너는 사이즈가 동일한 구형에 분할되어 구형 마다 1개의 컴퍼넌트가 배치됩니다. 예를 들어 다음의 예는 6개의 버튼을 3 행 2 열에 배치하는 애플릿을 나타냅니다.

 import java.awt. *;
 import java.applet.Applet;
 public class ButtonGrid extends Applet {
     public void init() {
         setLayout(new GridLayout(3,2));
         add(new Button("1"));
         add(new Button("2"));
         add(new Button("3"));
         add(new Button("4"));
         add(new Button("5"));
         add(new Button("6"));
     }
 }
 

컨테이너의 ComponentOrientation 프로퍼티가 수평 방향으로 왼쪽에서 오른쪽의 경우, 상기의 예는 그림 1에 나타내는 것 같은 출력을 생성합니다. 컨테이너의 ComponentOrientation 프로퍼티가 수평 방향으로 오른쪽에서 왼쪽의 경우, 상기의 예는 그림 2에 나타내는 것 같은 출력을 생성합니다.

그림 1: 수평 방향으로 왼쪽에서 우	도 2: 수평 방향으로 오른쪽에서 왼쪽

행수와 렬수의 어느쪽이나 제로 이외의 값으로 설정되어 있는 경우, 생성자에의해 또는 setRows 메서드 및 setColumns 메서드에의해 지정된 렬수는 무시됩니다. 대신에 지정된 행수 및 레이아웃의 컴퍼넌트의 총수로부터, 렬수가 결정됩니다. 따라서, 예를 들어 3 행과 2 열이 지정되고 있어 9개의 컴퍼넌트를 레이아웃에 추가하는 경우, 컴퍼넌트는 3 열의 3 행에 표시됩니다. 렬수의 지정이 레이아웃에 영향을 주는 것은 행수가 제로로 설정되었을 경우만입니다.

도입된 버전 :

JDK1. 0

관련 항목:

직렬화 된 형식

생성자 개요

GridLayout ()
1 행중에 컴퍼넌트 근처 1개의 열을 가지는 디폴트 지정으로 구라두 레이아웃을 작성합니다.

GridLayout (int rows, int cols)
지정된 수의 행으로 열을 가지는 구라두 레이아웃을 작성합니다.

GridLayout (int rows, int cols, int hgap, int vgap)
지정된 수의 행으로 열을 가지는 구라두 레이아웃을 작성합니다.

메서드 개요

void	addLayoutComponent (String name, Component comp) 지정된 이름으로 지정된 컴퍼넌트를 레이아웃에 추가합니다.
int	getColumns () 이 레이아웃내의 렬수를 리턴합니다.
int	getHgap () 컴퍼넌트간의 수평 방향의 간격을 리턴합니다.
int	getRows () 이 레이아웃내의 행수를 리턴합니다.
int	getVgap () 컴퍼넌트간의 수직 방향의 간격을 리턴합니다.
void	layoutContainer (Container parent) 이 레이아웃을 사용해, 지정된 컨테이너를 배치합니다.
Dimension	minimumLayoutSize (Container parent) 이 구라두 레이아웃을 사용해, 컨테이너 인수의 최소 사이즈를 지정합니다.
Dimension	preferredLayoutSize (Container parent) 이 구라두 레이아웃을 사용해, 컨테이너 인수의 추천 사이즈를 지정합니다.
void	removeLayoutComponent (Component comp) 지정된 컴퍼넌트를 레이아웃으로부터 삭제합니다.
void	setColumns (int cols) 이 레이아웃의 렬수를, 지정된 값으로 설정합니다.
void	setHgap (int hgap) 컴퍼넌트간의 수평 방향의 간격을 지정된 값으로 설정합니다.
void	setRows (int rows) 이 레이아웃내의 행수를, 지정된 값으로 설정합니다.
void	setVgap (int vgap) 컴퍼넌트간의 수직 방향의 간격을 지정된 값으로 설정합니다.
String	toString () 이 구라두 레이아웃의 값의 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

생성자 상세

GridLayout

public GridLayout()

1 행중에 컴퍼넌트 근처 1개의 열을 가지는 디폴트 지정으로 구라두 레이아웃을 작성합니다.

도입된 버전 :

JDK1. 1

GridLayout

public GridLayout(int rows,
                  int cols)

지정된 수의 행으로 열을 가지는 구라두 레이아웃을 작성합니다. 레이아웃내의 컴퍼넌트는 모두, 동일한 사이즈로 지정됩니다.

rows와 cols 어느 쪽인지 1개는 제로에서도 괜찮습니다. 제로의 경우, 객체를 몇개에서도 1 행 또는 1 열에 배치할 수 있는 것을의미합니다.

파라미터:

rows - 행 수. 값제로는 임의의 행수를의미하는

cols - 렬수. 값제로는 임의의 렬수를 미한다

GridLayout

public GridLayout(int rows,
                  int cols,
                  int hgap,
                  int vgap)

지정된 수의 행으로 열을 가지는 구라두 레이아웃을 작성합니다. 레이아웃내의 컴퍼넌트는 모두, 동일한 사이즈로 지정됩니다.

게다가 수평 방향과 수직 방향의 간격이 지정된 값으로 설정됩니다. 수평 방향의 간격은 렬간에 삽입됩니다. 수직 방향의 간격은 행간에 삽입됩니다.

rows와 cols 어느 쪽인지 1개는 제로에서도 괜찮습니다. 제로의 경우, 객체를 몇개에서도 1 행 또는 1 열에 배치할 수 있는 것을의미합니다.

모든 GridLayout 생성자는 이 프레임에 따릅니다.

파라미터:

rows - 행 수. 값제로는 임의의 행수를의미하는

cols - 렬수. 값제로는 임의의 렬수를의미하는

hgap - 수평 방향의 간격

vgap - 수직 방향의 간격

예외:

IllegalArgumentException - rows와 cols값을 어느 쪽과도 제로로 설정했을 경우

메서드의 상세

getRows

public int getRows()

이 레이아웃내의 행수를 리턴합니다.

반환값:

이 레이아웃내의 행수

도입된 버전 :

JDK1. 1

setRows

public void setRows(int rows)

이 레이아웃내의 행수를, 지정된 값으로 설정합니다.

파라미터:

rows - 이 레이아웃내의 행수

예외:

IllegalArgumentException - rows와 cols값을 어느 쪽과도 제로로 설정했을 경우

도입된 버전 :

JDK1. 1

getColumns

public int getColumns()

이 레이아웃내의 렬수를 리턴합니다.

반환값:

이 레이아웃내의 렬수

도입된 버전 :

JDK1. 1

setColumns

public void setColumns(int cols)

이 레이아웃의 렬수를, 지정된 값으로 설정합니다. 생성자 또는 setRows 메서드에 의해 지정된 행의 수가 제로가 아닌 경우는 렬수의 설정은 레이아웃에 영향을 주지 않습니다. 그 경우, 레이아웃에 표시되는 렬수는 컴퍼넌트의 총수 및 지정된 행의 수에 결정됩니다.

파라미터:

cols - 이 레이아웃내의 렬수

예외:

IllegalArgumentException - rows와 cols값을 어느 쪽과도 제로로 설정했을 경우

도입된 버전 :

JDK1. 1

getHgap

public int getHgap()

컴퍼넌트간의 수평 방향의 간격을 리턴합니다.

반환값:

컴퍼넌트간의 수평 방향의 간격

도입된 버전 :

JDK1. 1

setHgap

public void setHgap(int hgap)

컴퍼넌트간의 수평 방향의 간격을 지정된 값으로 설정합니다.

파라미터:

hgap - 컴퍼넌트간의 수평 방향의 간격

도입된 버전 :

JDK1. 1

getVgap

public int getVgap()

컴퍼넌트간의 수직 방향의 간격을 리턴합니다.

반환값:

컴퍼넌트간의 수직 방향의 간격

도입된 버전 :

JDK1. 1

setVgap

public void setVgap(int vgap)

컴퍼넌트간의 수직 방향의 간격을 지정된 값으로 설정합니다.

파라미터:

vgap - 컴퍼넌트간의 수직 방향의 간격

도입된 버전 :

JDK1. 1

addLayoutComponent

public void addLayoutComponent(String  name,
                               Component  comp)

지정된 이름으로 지정된 컴퍼넌트를 레이아웃에 추가합니다.

정의:

인터페이스 LayoutManager 내의 addLayoutComponent

파라미터:

name - 컴퍼넌트의 이름

comp - 추가되는 컴퍼넌트

removeLayoutComponent

public void removeLayoutComponent(Component  comp)

지정된 컴퍼넌트를 레이아웃으로부터 삭제합니다.

정의:

인터페이스 LayoutManager 내의 removeLayoutComponent

파라미터:

comp - 삭제되는 컴퍼넌트

preferredLayoutSize

public Dimension  preferredLayoutSize(Container  parent)

이 구라두 레이아웃을 사용해, 컨테이너 인수의 추천 사이즈를 지정합니다.

구라두 레이아웃의 추천폭은 컨테이너내의 모든 컴퍼넌트의 최대 추천폭에 렬수를 걸쳐 수평 패딩에 렬수마이너스 1 배가 된 것을 더해, 또한 타겟 컨테이너의 오른쪽과 왼쪽의 인 세트를 더한 폭이 됩니다.

구라두 레이아웃의 추천 높이는 컨테이너내의 모든 컴퍼넌트의 최대 추천 높이에 행수를 걸쳐 수직 패딩에 행수마이너스 1 배가 된 것을 더해, 또한 타겟 컨테이너 위와 아래의 인 세트를 더한 높이가 됩니다.

정의:

인터페이스 LayoutManager 내의 preferredLayoutSize

파라미터:

parent - 배치를 하는 컨테이너

반환값:

지정된 컨테이너의 서브 컴퍼넌트를 배치하는 바람직한 크기

관련 항목:

minimumLayoutSize(java.awt.Container), Container.getPreferredSize()

minimumLayoutSize

public Dimension  minimumLayoutSize(Container  parent)

이 구라두 레이아웃을 사용해, 컨테이너 인수의 최소 사이즈를 지정합니다.

구라두 레이아웃의 최소폭은 컨테이너내의 모든 컴퍼넌트의 최대 최소값에 렬수를 걸쳐 수평 패딩에 렬수마이너스 1 배가 된 것을 더해, 또한 타겟 컨테이너의 오른쪽과 왼쪽의 인 세트를 더한 폭이 됩니다.

구라두 레이아웃의 최소 높이는 컨테이너내의 모든 컴퍼넌트의 최대 최소 높이에 행수를 걸쳐 수직 패딩에 행수마이너스 1 배가 된 것을 더해, 또한 타겟 컨테이너 위와 아래의 인 세트를 더한 높이가 됩니다.

정의:

인터페이스 LayoutManager 내의 minimumLayoutSize

파라미터:

parent - 배치를 하는 컨테이너

반환값:

지정된 컨테이너의 서브 컴퍼넌트를 배치하기 위해서 필요한 최소의 크기

관련 항목:

preferredLayoutSize(java.awt.Container), Container.doLayout()

layoutContainer

public void layoutContainer(Container  parent)

이 레이아웃을 사용해, 지정된 컨테이너를 배치합니다.

이 메서드는 GridLayout 객체의 제약을 채우기 위해서 지정된 타겟 컨테이너내의 컴퍼넌트의 형상을 재성형합니다.

구라두 레이아웃 매니저는 개별의 컴퍼넌트의 사이즈를 지정하기 위해서 컨테이너내의 빈영역을 레이아웃의 행수와 렬수에 따라 등분 합니다. 컨테이너의 빈영역은 컨테이너의 사이즈로부터, 임의의 인 세트 및 지정된 임의의 수평 또는 수직의 간격을 당긴 것에 동일해집니다. 구라두 레이아웃내의 컴퍼넌트는 모두, 같은 사이즈로 설정됩니다.

정의:

인터페이스 LayoutManager 내의 layoutContainer

파라미터:

parent - 배치를 하는 컨테이너

관련 항목:

Container, Container.doLayout()

toString

public String  toString()

이 구라두 레이아웃의 값의 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 구라두 레이아웃의 캐릭터 라인 표현