JavaTM Platform
Standard Ed. 6

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 에 나타내는 것 같은 출력을 생성합니다.  

6 개의 버튼이 행에 2 개씩 있다.
행 1 에는 버튼 1 과 2, 행 2 에는 버튼 3 과 4, 행 3 에는 버튼 5 과 6 가 각각 있다. 6 개의 버튼이 행에 2 개씩 있다.
행 1 에는 버튼 2 과 1, 행 2 에는 버튼 4 과 3, 행 3 에는 버튼 6 과 5 가 각각 있다.
그림 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)
지정된 수의 행으로 열을 가지는 구라두 레이아웃을 작성합니다. 레이아웃내의 컴퍼넌트는 모두, 동일한 사이즈로 지정됩니다.  

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

파라미터:
rows - 행 수. 값제로는 임의의 수의 행을 의미하는
cols - 렬수. 값제로는 임의의 수의 열을 의미한다

GridLayout

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

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

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

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

파라미터:
rows - 행 수. 값제로는 임의의 수의 행을 의미하는
cols - 렬수. 값제로는 임의의 수의 열을 의미하는
hgap - 수평 방향의 간격
vgap - 수직 방향의 간격
예외:
IllegalArgumentException - rowscols 의 값을 어느쪽이나 제로로 설정했을 경우
메소드의 상세

getRows

public int getRows()
이 레이아웃내의 행수를 돌려줍니다.

반환값:
이 레이아웃내의 행수
도입된 버젼:
JDK1. 1

setRows

public void setRows(int rows)
이 레이아웃내의 행수를, 지정된 값으로 설정합니다.

파라미터:
rows - 이 레이아웃내의 행수
예외:
IllegalArgumentException - rowscols 의 값을 어느쪽이나 제로로 설정했을 경우
도입된 버젼:
JDK1. 1

getColumns

public int getColumns()
이 레이아웃내의 렬수를 돌려줍니다.

반환값:
이 레이아웃내의 렬수
도입된 버젼:
JDK1. 1

setColumns

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

파라미터:
cols - 이 레이아웃내의 렬수
예외:
IllegalArgumentException - rowscols 의 값을 어느쪽이나 제로로 설정했을 경우
도입된 버젼:
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
반환값:
이 구라두 레이아웃의 캐릭터 라인 표현

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.