JavaTM Platform
Standard Ed. 6

java.awt
클래스 CardLayout

java.lang.Object 
  상위를 확장 java.awt.CardLayout
모든 구현된 인터페이스:
LayoutManager , LayoutManager2 , Serializable


public class CardLayout
extends Object
implements LayoutManager2 , Serializable

CardLayout 객체는 컨테이너의 레이아웃 매니저입니다. 컨테이너내의 각 컴퍼넌트를 카드로 해서 취급합니다. 한 번에 1 매의 카드만을 표시해, 컨테이너는 카드의 스택으로서 동작합니다. CardLayout 객체에 최초로 추가되는 컴퍼넌트는, 컨테이너가 최초로 표시될 때의 가시 컴퍼넌트가 됩니다.  

카드의 순서는, 컴퍼넌트 객체의 컨테이너 자신의 내부 순서로 정해집니다. CardLayout 는, 어플리케이션이 이러한 카드를 차례로 넘기거나 지정한 카드를 표시하거나 할 수 있도록(듯이) 하는 메소드세트를 정의합니다. addLayoutComponent(java.awt.Component, java.lang.Object) 메소드를 사용하면(자), 고속의 랜덤 억세스를 위해서(때문에), 캐릭터 라인의 식별자를 지정한 카드로 관련지을 수가 있습니다.

도입된 버젼:
JDK1. 0
관련 항목:
Container , 직렬화 된 형식

생성자 의 개요
CardLayout ()
          새로운 카드 레이아웃을 사이즈 제로의 간격으로 작성합니다.
CardLayout (int hgap, int vgap)
          지정된 수평 방향 및 수직 방향의 간격을 사용해 새로운 카드 레이아웃을 작성합니다.
 
메소드의 개요
 void addLayoutComponent (Component  comp, Object  constraints)
          이 카드 레이아웃 내부의 이름 테이블에, 지정된 컴퍼넌트를 추가합니다.
 void addLayoutComponent (String  name, Component  comp)
          추천 되고 있지 않습니다.  addLayoutComponent(Component, Object) 에 옮겨놓을 수 있었습니다.
 void first (Container  parent)
          컨테이너의 최초의 카드로 전환합니다.
 int getHgap ()
          컴퍼넌트간의 수평 방향의 간격을 돌려줍니다.
 float getLayoutAlignmentX (Container  parent)
          x 축방향의 배치를 돌려줍니다.
 float getLayoutAlignmentY (Container  parent)
          y 축방향의 배치를 돌려줍니다.
 int getVgap ()
          컴퍼넌트간의 수직 방향의 간격을 돌려줍니다.
 void invalidateLayout (Container  target)
          레이아웃을 무효로 합니다.
 void last (Container  parent)
          컨테이너의 마지막 카드로 전환합니다.
 void layoutContainer (Container  parent)
          이 카드 레이아웃을 사용해, 지정된 컨테이너를 배치합니다.
 Dimension maximumLayoutSize (Container  target)
          지정된 타겟 컨테이너가 주어진 컴퍼넌트에 대한 레이아웃의 최대 사이즈를 돌려줍니다.
 Dimension minimumLayoutSize (Container  parent)
          지정된 패널의 최소 사이즈를 산출합니다.
 void next (Container  parent)
          지정된 컨테이너의 다음의 카드로 전환합니다.
 Dimension preferredLayoutSize (Container  parent)
          이 카드 레이아웃을 사용해, 인수의 컨테이너의 추천 사이즈를 판정합니다.
 void previous (Container  parent)
          지정된 컨테이너의 전의 카드로 전환합니다.
 void removeLayoutComponent (Component  comp)
          지정된 컴퍼넌트를 레이아웃으로부터 삭제합니다.
 void setHgap (int hgap)
          컴퍼넌트간의 수평 방향의 간격을 설정합니다.
 void setVgap (int vgap)
          컴퍼넌트간의 수직 방향의 간격을 설정합니다.
 void show (Container  parent, String  name)
          addLayoutComponent 를 사용해, 지정된 name 를 가지는, 이 레이아웃에 추가된 컴퍼넌트로 전환합니다.
 String toString ()
          이 카드 레이아웃 상태를 나타내는 캐릭터 라인 표현을 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

CardLayout

public CardLayout()
새로운 카드 레이아웃을 사이즈 제로의 간격으로 작성합니다.


CardLayout

public CardLayout(int hgap,
                  int vgap)
지정된 수평 방향 및 수직 방향의 간격을 사용해 새로운 카드 레이아웃을 작성합니다. 수평 방향의 간격은 좌단 및 우단에 배치됩니다. 수직 방향의 간격은 상단 및 하단에 배치됩니다.

파라미터:
hgap - 수평 방향의 간격
vgap - 수직 방향의 간격
메소드의 상세

getHgap

public int getHgap()
컴퍼넌트간의 수평 방향의 간격을 돌려줍니다.

반환값:
컴퍼넌트간의 수평 방향의 간격
도입된 버젼:
JDK1. 1
관련 항목:
setHgap(int) , getVgap()

setHgap

public void setHgap(int hgap)
컴퍼넌트간의 수평 방향의 간격을 설정합니다.

파라미터:
hgap - 컴퍼넌트간의 수평 방향의 간격
도입된 버젼:
JDK1. 1
관련 항목:
getHgap() , setVgap(int)

getVgap

public int getVgap()
컴퍼넌트간의 수직 방향의 간격을 돌려줍니다.

반환값:
컴퍼넌트간의 수직 방향의 간격
관련 항목:
setVgap(int) , getHgap()

setVgap

public void setVgap(int vgap)
컴퍼넌트간의 수직 방향의 간격을 설정합니다.

파라미터:
vgap - 컴퍼넌트간의 수직 방향의 간격
도입된 버젼:
JDK1. 1
관련 항목:
getVgap() , setHgap(int)

addLayoutComponent

public void addLayoutComponent(Component  comp,
                               Object  constraints)
이 카드 레이아웃 내부의 이름 테이블에, 지정된 컴퍼넌트를 추가합니다. constraints 에 의해 지정되는 객체는 캐릭터 라인이 아니면 안됩니다. 카드 레이아웃은 이 캐릭터 라인을, 특정의 카드에의 랜덤 억세스에 사용하는 키와 값의 페어로서 포함합니다. show 메소드를 호출하는 것으로, 어플리케이션은 지정된 이름의 컴퍼넌트를 표시할 수 있습니다.

정의:
인터페이스 LayoutManager2 내의 addLayoutComponent
파라미터:
comp - 추가되는 요소
constraints - 레이아웃내의 특정의 카드를 식별하는 태그
예외:
IllegalArgumentException - 제약이 캐릭터 라인이 아닌 경우
관련 항목:
show(java.awt.Container, java.lang.String)

addLayoutComponent

@Deprecated 
public void addLayoutComponent(String  name,
                                          Component  comp)
추천 되고 있지 않습니다.  addLayoutComponent(Component, Object) 에 옮겨놓을 수 있었습니다.

인터페이스 LayoutManager 의 기술:
레이아웃 매니저가 컴퍼넌트마다의 캐릭터 라인을 사용하는 경우, 레이아웃에 컴퍼넌트의 comp 를 추가해,name 에 의해 지정된 캐릭터 라인에 관련짓습니다.

정의:
인터페이스 LayoutManager 내의 addLayoutComponent
파라미터:
name - 컴퍼넌트에 관련지을 수 있었던 캐릭터 라인
comp - 추가되는 컴퍼넌트

removeLayoutComponent

public void removeLayoutComponent(Component  comp)
지정된 컴퍼넌트를 레이아웃으로부터 삭제합니다. 카드가 맨 앞면에 표시되고 있었을 경우는, 그 아래에 있는 다음의 카드가 표시됩니다.

정의:
인터페이스 LayoutManager 내의 removeLayoutComponent
파라미터:
comp - 삭제되는 요소
관련 항목:
Container.remove(java.awt.Component) , Container.removeAll()

preferredLayoutSize

public Dimension  preferredLayoutSize(Container  parent)
이 카드 레이아웃을 사용해, 인수의 컨테이너의 추천 사이즈를 판정합니다.

정의:
인터페이스 LayoutManager 내의 preferredLayoutSize
파라미터:
parent - 배치를 하는 친컨테이너
반환값:
지정된 컨테이너의 서브 컴퍼넌트를 배치하기 위한 바람직한 치수
관련 항목:
Container.getPreferredSize() , minimumLayoutSize(java.awt.Container)

minimumLayoutSize

public Dimension  minimumLayoutSize(Container  parent)
지정된 패널의 최소 사이즈를 산출합니다.

정의:
인터페이스 LayoutManager 내의 minimumLayoutSize
파라미터:
parent - 배치를 하는 친컨테이너
반환값:
지정된 컨테이너의 서브 컴퍼넌트를 배치하기 위해서 필요한 최소의 치수
관련 항목:
Container.doLayout() , preferredLayoutSize(java.awt.Container)

maximumLayoutSize

public Dimension  maximumLayoutSize(Container  target)
지정된 타겟 컨테이너가 주어진 컴퍼넌트에 대한 레이아웃의 최대 사이즈를 돌려줍니다.

정의:
인터페이스 LayoutManager2 내의 maximumLayoutSize
파라미터:
target - 레이아웃 할 필요가 있는 컴퍼넌트
관련 항목:
Container , minimumLayoutSize(java.awt.Container) , preferredLayoutSize(java.awt.Container)

getLayoutAlignmentX

public float getLayoutAlignmentX(Container  parent)
x 축방향의 배치를 돌려줍니다. 이것은, 그 컴퍼넌트가 다른 컴퍼넌트에 대해서 어떻게 배치되어야할 것인가를 지정한 것입니다. 이 값은 0 에서 1 의 사이의 수치로, 0 은 기점을 따른 배치를 나타내, 1 은 기점으로부터도 와도 먼 곳에, 0.5 는 중앙에 배치됩니다.

정의:
인터페이스 LayoutManager2 내의 getLayoutAlignmentX

getLayoutAlignmentY

public float getLayoutAlignmentY(Container  parent)
y 축방향의 배치를 돌려줍니다. 이것은, 그 컴퍼넌트가 다른 컴퍼넌트에 대해서 어떻게 배치되어야할 것인가를 지정한 것입니다. 이 값은 0 에서 1 의 사이의 수치로, 0 은 기점을 따른 배치를 나타내, 1 은 기점으로부터도 와도 먼 곳에, 0.5 는 중앙에 배치됩니다.

정의:
인터페이스 LayoutManager2 내의 getLayoutAlignmentY

invalidateLayout

public void invalidateLayout(Container  target)
레이아웃을 무효로 합니다. 이 때, 레이아웃 매니저가 정보를 캐쉬하고 있으면 그것을 파기합니다.

정의:
인터페이스 LayoutManager2 내의 invalidateLayout

layoutContainer

public void layoutContainer(Container  parent)
이 카드 레이아웃을 사용해, 지정된 컨테이너를 배치합니다.  

parent 컨테이너의 각 컴퍼넌트는, 컨테이너로부터 주위의 인 세트, 수평 방향의 간격, 및 수직 방향의 간격의 스페이스를 공제한 사이즈가 되도록(듯이) 형상 변경됩니다.

정의:
인터페이스 LayoutManager 내의 layoutContainer
파라미터:
parent - 배치를 하는 친컨테이너
관련 항목:
Container.doLayout()

first

public void first(Container  parent)
컨테이너의 최초의 카드로 전환합니다.

파라미터:
parent - 배치를 하는 친컨테이너
관련 항목:
last(java.awt.Container)

next

public void next(Container  parent)
지정된 컨테이너의 다음의 카드로 전환합니다. 현재 표시되고 있는 카드가 마지막 카드인 경우, 이 메소드는 레이아웃내의 최초의 카드로 전환합니다.

파라미터:
parent - 배치를 하는 친컨테이너
관련 항목:
previous(java.awt.Container)

previous

public void previous(Container  parent)
지정된 컨테이너의 전의 카드로 전환합니다. 현재 표시되고 있는 카드가 최초의 카드인 경우, 이 메소드는 레이아웃내의 마지막 카드로 전환합니다.

파라미터:
parent - 배치를 하는 친컨테이너
관련 항목:
next(java.awt.Container)

last

public void last(Container  parent)
컨테이너의 마지막 카드로 전환합니다.

파라미터:
parent - 배치를 하는 친컨테이너
관련 항목:
first(java.awt.Container)

show

public void show(Container  parent,
                 String  name)
addLayoutComponent 를 사용해, 지정된 name 를 가지는, 이 레이아웃에 추가된 컴퍼넌트로 전환합니다. 그러한 컴퍼넌트가 없는 경우, 처리는 행해지지 않습니다.

파라미터:
parent - 배치를 하는 친컨테이너
name - 컴퍼넌트의 이름
관련 항목:
addLayoutComponent(java.awt.Component, java.lang.Object)

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 도 참조해 주세요.