java.awt
클래스 Container

java.lang.Object 
  java.awt.Component 
      java.awt.Container

모든 구현된 인터페이스:

ImageObserver , MenuContainer , Serializable

직계의 기존의 서브 클래스:

BasicSplitPaneDivider , CellRendererPane , DefaultTreeCellEditor.EditorContainer , JComponent , Panel , ScrollPane , Window

public class Container
extends Component 

총칭 Abstract Window Toolkit (AWT) 컨테이너 객체는, 다른 AWT 컴퍼넌트를 포함할 수가 있는 컴퍼넌트입니다.

컨테이너에 추가되는 컴퍼넌트는 리스트중에 넣어집니다. 리스트의 차례는, 컨테이너중의 전면에서 후면에 컴퍼넌트가 스택 되는 차례를 나타냅니다. 컨테이너에 컴퍼넌트를 추가할 경우에 인덱스가 지정되지 않으면 리스트의 최후미에 추가되어 최후미에 스택 됩니다.

주:포커스 하부조직의 상세한 것에 대하여는,「How to Use the Focus Subsystem」, 「The Java Tutorial」의 섹션,「Focus Specification」를 참조해 주세요.

도입된 버젼:

JDK1. 0

관련 항목:

add(java.awt.Component, int) , getComponent(int) , LayoutManager , 직렬화 된 형식

상자의 클래스의 개요

protected class

Container.AccessibleAWTContainer 사용자 보조 기능의 디폴트 지원의 제공에 사용하는 Container 의 내부 클래스입니다.

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스

Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

클래스 java.awt. Component 로부터 상속된 필드

BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT

인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드

ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH

생성자 의 개요

Container ()
새로운 컨테이너를 구축합니다.

메소드의 개요

Component	add (Component comp) 지정된 컴퍼넌트를 이 컨테이너의 마지막에 추가합니다.
Component	add (Component comp, int index) 지정된 컴퍼넌트를, 이 컨테이너의 지정된 위치에 추가합니다.
void	add (Component comp, Object constraints) 지정된 컴퍼넌트를 이 컨테이너의 마지막에 추가합니다.
void	add (Component comp, Object constraints, int index) 지정된 컴퍼넌트를, 지정된 인덱스와 지정된 제약으로, 컨테이너에 추가합니다.
Component	add (String name, Component comp) 지정된 컴퍼넌트를 이 컨테이너에 추가합니다.
void	addContainerListener (ContainerListener l) 이 컨테이너로부터의 컨테이너 이벤트를 받아들이도록(듯이), 지정된 컨테이너 청취자를 추가합니다.
protected void	addImpl (Component comp, Object constraints, int index) 지정된 컴퍼넌트를, 지정된 인덱스로, 컨테이너에 추가합니다.
void	addNotify () 네이티브 스크린 자원에 접속하는 것으로써, 이 Container 를 표시 가능하게 합니다.
void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChangeListener 를 청취자 리스트에 추가합니다.
void	addPropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 청취자 리스트에 PropertyChangeListener 를 추가합니다.
void	applyComponentOrientation (ComponentOrientation o) 이 컨테이너와 포함되는 모든 컴퍼넌트의 ComponentOrientation 프로퍼티을 설정합니다.
boolean	areFocusTraversalKeysSet (int id) 지정된 포커스 traversal 조작에 대한 포커스 traversal 키세트가, 이 컨테이너에 명시적으로 정의되고 있는지 어떤지를 돌려줍니다.
int	countComponents () 추천 되고 있지 않습니다. JDK Version 1.1 이후는, getComponentCount()로 옮겨졌습니다.
void	deliverEvent (Event e) 추천 되고 있지 않습니다. JDK Version 1.1 이후는, dispatchEvent(AWTEvent e) 로 옮겨졌습니다.
void	doLayout () 이 컨테이너가 컴퍼넌트를 배치할 수 있도록(듯이) 합니다.
Component	findComponentAt (int x, int y) 지정된 점을 포함하는 가시의 아이 컴퍼넌트를 검색합니다.
Component	findComponentAt (Point p) 지정된 점을 포함하는 가시의 아이 컴퍼넌트를 검색합니다.
float	getAlignmentX () x 축방향의 배치를 돌려줍니다.
float	getAlignmentY () y 축방향의 배치를 돌려줍니다.
Component	getComponent (int n) 컨테이너내의 n 번째의 컴퍼넌트를 돌려줍니다.
Component	getComponentAt (int x, int y) x, y 좌표를 포함한 컴퍼넌트를 찾습니다.
Component	getComponentAt (Point p) 지정된 점을 포함한 컴퍼넌트를 돌려줍니다.
int	getComponentCount () 이 패널내의 컴퍼넌트의 수를 돌려줍니다.
Component []	getComponents () 컨테이너내의 모든 컴퍼넌트를 돌려줍니다.
int	getComponentZOrder (Component comp) 컨테이너내의 컴퍼넌트의 Z 축 순서 인덱스를 돌려줍니다.
ContainerListener []	getContainerListeners () 이 컨테이너에 등록되어 모든 항목 청취자의 배열을 돌려줍니다.
Set <AWTKeyStroke >	getFocusTraversalKeys (int id) 이 컨테이너의 지정된 traversal 조작의 포커스 traversal 키세트를 돌려줍니다.
FocusTraversalPolicy	getFocusTraversalPolicy () 이 컨테이너의 아이의 키보드 traversal를 관리하는 포커스 traversal 정책를 돌려줍니다.
Insets	getInsets () 컨테이너의 경계의 사이즈를 나타내는, 이 컨테이너의 인 세트를 판정합니다.
LayoutManager	getLayout () 이 컨테이너의 레이아웃 매니저를 돌려줍니다.
<T extends EventListener > T[]	getListeners (Class <T> listenerType) 이 Container 에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다.
Dimension	getMaximumSize () 이 컨테이너의 최대 사이즈를 돌려줍니다.
Dimension	getMinimumSize () 이 컨테이너의 최소 사이즈를 돌려줍니다.
Point	getMousePosition (boolean allowChildren) Container 가 마우스 포인터아래에 있는 경우, 이 Container 의 좌표 공간의 마우스 포인터의 위치를 돌려주어, 그렇지 않은 경우는,null 를 돌려줍니다.
Dimension	getPreferredSize () 이 컨테이너의 추천 사이즈를 돌려줍니다.
Insets	insets () 추천 되고 있지 않습니다. JDK Version 1.1 이후는, getInsets() 로 옮겨졌습니다.
void	invalidate () 컨테이너를 무효로 합니다.
boolean	isAncestorOf (Component c) 컴퍼넌트가 이 컨테이너의 컴퍼넌트 계층에 포함되고 있는지 어떤지를 판정합니다.
boolean	isFocusCycleRoot () 이 컨테이너가 포커스 traversal 사이클의 루트일지 어떨지를 돌려줍니다.
boolean	isFocusCycleRoot (Container container) 지정된 컨테이너가, 이 컨테이너의 포커스 traversal 사이클의 포커스 사이클 루트일지 어떨지를 돌려줍니다.
boolean	isFocusTraversalPolicyProvider () 이 컨테이너가 포커스 traversal 정책를 제공할지 어떨지를 돌려줍니다.
boolean	isFocusTraversalPolicySet () 포커스 traversal 정책가 이 컨테이너에 대해서 명시적으로 설정되어 있는지 어떤지를 설정합니다.
void	layout () 추천 되고 있지 않습니다. JDK Version 1.1 이후는, doLayout() 로 옮겨졌습니다.
void	list (PrintStream out, int indent) 지정된 출력 스트림에 이 컨테이너의 리스트를 출력합니다.
void	list (PrintWriter out, int indent) 지정된 인덴트 위치로부터 개시해, 지정된 프린트 라이터에 리스트를 출력합니다.
Component	locate (int x, int y) 추천 되고 있지 않습니다. JDK Version 1.1 이후는, getComponentAt(int, int) 로 옮겨졌습니다.
Dimension	minimumSize () 추천 되고 있지 않습니다. JDK Version 1.1 이후는, getMinimumSize() 로 옮겨졌습니다.
void	paint (Graphics g) 컨테이너를 그립니다.
void	paintComponents (Graphics g) 이 컨테이너내의 각 컴퍼넌트를 그립니다.
protected String	paramString () 이 Container 상태를 나타내는 캐릭터 라인을 돌려줍니다.
Dimension	preferredSize () 추천 되고 있지 않습니다. JDK Version 1.1 이후는, getPreferredSize() 로 옮겨졌습니다.
void	print (Graphics g) 컨테이너를 출력합니다.
void	printComponents (Graphics g) 이 컨테이너내의 각 컴퍼넌트를 출력합니다.
protected void	processContainerEvent (ContainerEvent e) 이 컨테이너로 발생하는 컨테이너 이벤트를, 등록되어 있는 ContainerListener 객체에 발송 하는 것으로 처리합니다.
protected void	processEvent (AWTEvent e) 이 컨테이너의 이벤트를 처리합니다.
void	remove (Component comp) 컨테이너로부터, 지정된 컴퍼넌트를 삭제합니다.
void	remove (int index) 컨테이너로부터,index 로 지정된 컴퍼넌트를 삭제합니다.
void	removeAll () 컨테이너로부터 모든 컴퍼넌트를 삭제합니다.
void	removeContainerListener (ContainerListener l) 이 컨테이너로부터의 컨테이너 이벤트를 받지 않게, 지정된 컨테이너 청취자를 삭제합니다.
void	removeNotify () 네이티브 스크린 자원에의 접속을 삭제하는 것으로써, 이 Container 를 표시 불가로 합니다.
void	setComponentZOrder (Component comp, int index) 지정된 컴퍼넌트를, 컨테이너의 지정된 Z 축 순서의 인덱스로 이동합니다.
void	setFocusCycleRoot (boolean focusCycleRoot) 이 컨테이너가 포커스 traversal 사이클의 루트일지 어떨지를 설정합니다.
void	setFocusTraversalKeys (int id, Set <? extends AWTKeyStroke > keystrokes) 이 컨테이너의 지정된 traversal 조작에 대한 포커스 traversal 키를 설정합니다.
void	setFocusTraversalPolicy (FocusTraversalPolicy policy) 이 컨테이너가 포커스 사이클 루트의 경우, 이 컨테이너의 아이의 키 보트 traversal를 관리하는 포커스 traversal 정책를 설정합니다.
void	setFocusTraversalPolicyProvider (boolean provider) 이 컨테이너를 사용해, 포커스 traversal 정책를 제공할지 어떨지를 설정합니다.
void	setFont (Font f) 이 컨테이너의 폰트를 설정합니다.
void	setLayout (LayoutManager mgr) 이 컨테이너의 레이아웃 매니저를 설정합니다.
void	transferFocusBackward () 이 컴퍼넌트가 포커스 소유자인것 같이, 포커스를 전의 컴퍼넌트에 전송 합니다.
void	transferFocusDownCycle () 포커스를 1 포커스 traversal 사이클만 하위로 이동합니다.
void	update (Graphics g) 컨테이너를 갱신합니다.
void	validate () 이 컨테이너 및 모든 서브 컴퍼넌트를 검증합니다.
protected void	validateTree () 컨테이너 트리를 재귀적으로 하위까지 더듬어, 필요하다라고 마크 된 모든 서브 트리, 그리고 무효와 마크 된 모든 서브 트리의 배치를 재계산합니다.

클래스 java.awt. Component 로부터 상속된 메소드

action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , bounds , checkImage , checkImage , coalesceEvents , contains , contains , createImage , createImage , createVolatileImage , createVolatileImage , disable , disableEvents , dispatchEvent , enable , enable , enableEvents , enableInputMethods , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , getAccessibleContext , getBackground , getBaseline , getBaselineResizeBehavior , getBounds , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphics , getGraphicsConfiguration , getHeight , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getSize , getToolkit , getTreeLock , getWidth , getX , getY , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isDoubleBuffered , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , prepareImage , prepareImage , printAll , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processKeyEvent , processMouseEvent , processMouseMotionEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removePropertyChangeListener , removePropertyChangeListener , repaint , repaint , repaint , repaint , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , reshape , resize , resize , setBackground , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setEnabled , setFocusable , setFocusTraversalKeysEnabled , setForeground , setIgnoreRepaint , setLocale , setLocation , setLocation , setMaximumSize , setMinimumSize , setName , setPreferredSize , setSize , setSize , setVisible , show , show , size , toString , transferFocus , transferFocusUpCycle

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

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

생성자 의 상세

Container

public Container()

새로운 컨테이너를 구축합니다. 컨테이너는 직접 확장할 수 있습니다만, 이 경우 경량이며 컴퍼넌트 트리 상부의 네이티브인 컴퍼넌트 트리 (예를 들어 Frame)에 포함되지 않으면 안됩니다.

메소드의 상세

getComponentCount

public int getComponentCount()

이 패널내의 컴퍼넌트의 수를 돌려줍니다.

반환값:

이 패널의 컴퍼넌트수

도입된 버젼:

JDK1. 1

관련 항목:

getComponent(int)

countComponents

@Deprecated 
public int countComponents()

추천 되고 있지 않습니다. JDK Version 1.1 이후는, getComponentCount()로 옮겨졌습니다.

getComponent

public Component  getComponent(int n)

컨테이너내의 n 번째의 컴퍼넌트를 돌려줍니다.

파라미터:

n - 취득하는 컴퍼넌트의 인덱스

반환값:

이 컨테이너내의 n 번째의 컴퍼넌트

예외:

ArrayIndexOutOfBoundsException - n 번째의 값이 없는 경우

getComponents

public Component [] getComponents()

컨테이너내의 모든 컴퍼넌트를 돌려줍니다.

반환값:

이 컨테이너내의 모든 컴퍼넌트의 배열

getInsets

public Insets  getInsets()

컨테이너의 경계의 사이즈를 나타내는, 이 컨테이너의 인 세트를 판정합니다.

예를 들어,Frame 객체는, 프레임의 타이틀 바의 높이에 대응하는 위의 인 세트를 가집니다.

반환값:

이 컨테이너의 인 세트

도입된 버젼:

JDK1. 1

관련 항목:

Insets , LayoutManager

insets

@Deprecated 
public Insets  insets()

추천 되고 있지 않습니다. JDK Version 1.1 이후는, getInsets() 로 옮겨졌습니다.

add

public Component  add(Component  comp)

지정된 컴퍼넌트를 이 컨테이너의 마지막에 추가합니다. 이것은 addImpl(java.awt.Component, java.lang.Object, int) 의 편리한 메소드입니다.

주:컴퍼넌트를, 표시되고 있는 컨테이너에 추가했을 경우, 그 컨테이너에 대해서 validate 를 호출해, 새로운 컴퍼넌트를 표시할 필요가 있습니다. 복수의 컴퍼넌트를 추가하는 경우는, 모든 컴퍼넌트를 추가한 후에,validate 를 1 회만 호출하는 것에 의해, 효율을 향상할 수 있습니다.

파라미터:

comp - 추가되는 컴퍼넌트

반환값:

컴퍼넌트 인수

예외:

NullPointerException - comp 가 null 의 경우

관련 항목:

addImpl(java.awt.Component, java.lang.Object, int) , validate() , JComponent.revalidate()

add

public Component  add(String  name,
                     Component  comp)

지정된 컴퍼넌트를 이 컨테이너에 추가합니다. 이것은 addImpl(java.awt.Component, java.lang.Object, int) 의 편리한 메소드입니다.

이 메소드는 1.1 으로부터 무효가 되어 있습니다. 대신에 add(Component, Object) 메소드를 사용해 주세요.

예외:

NullPointerException - comp 가 null 의 경우

관련 항목:

add(Component, Object)

add

public Component  add(Component  comp,
                     int index)

지정된 컴퍼넌트를, 이 컨테이너의 지정된 위치에 추가합니다. 이것은 addImpl(java.awt.Component, java.lang.Object, int) 의 편리한 메소드입니다.

주:컴퍼넌트를, 표시되고 있는 컨테이너에 추가했을 경우, 그 컨테이너에 대해서 validate 를 호출해, 새로운 컴퍼넌트를 표시할 필요가 있습니다. 복수의 컴퍼넌트를 추가하는 경우는, 모든 컴퍼넌트를 추가한 후에,validate 를 1 회만 호출하는 것에 의해, 효율을 향상할 수 있습니다.

파라미터:

comp - 추가되는 컴퍼넌트

index - 컴퍼넌트를 삽입하는 위치. 컴퍼넌트를 마지막으로 삽입하는 경우는 -1

반환값:

컴퍼넌트 comp

예외:

NullPointerException - comp 가 null 의 경우

IllegalArgumentException - index 가 무효인 경우 (자세한 것은 addImpl(java.awt.Component, java.lang.Object, int) 를 참조)

관련 항목:

addImpl(java.awt.Component, java.lang.Object, int) , remove(int) , validate() , JComponent.revalidate()

setComponentZOrder

public void setComponentZOrder(Component  comp,
                               int index)

지정된 컴퍼넌트를, 컨테이너의 지정된 Z 축 순서의 인덱스로 이동합니다. Z 축 순서에 의해, 컴퍼넌트가 페인트 되는 차례가 정해집니다. Z 축 순서가 최고의 컴퍼넌트가 최초로 페인트 되어 Z 축 순서가 최저의 컴퍼넌트가 마지막에 페인트 됩니다. 컴퍼넌트가 오버랩 되는 경우, Z 축 순서의 낮은 컴퍼넌트가 Z 축 순서의 높은 컴퍼넌트 위에 페인트 됩니다.

컴퍼넌트가 다른 컨테이너의 아이인 경우, 이 컨테이너에 추가되기 전에 그 컨테이너로부터 삭제됩니다. 이 메소드와 java.awt.Container.add(Component, int) 의 차이는, 전의 컨테이너로부터 삭제될 때에, 필요하지 않은 한, 또 기본이 되는 네티브윈드우시스템에 의해 허가되고 있는 한, 이 메소드가 컴퍼넌트에 대해서 removeNotify 를 호출하지 않는 것입니다. 이와 같이, 컴퍼넌트에 키보드 포커스가 있는 경우, 그 컴퍼넌트가 새로운 위치에 이동되어도 포커스를 유지합니다.

이 프로퍼티은 경량의 Container 이외의 컴퍼넌트에만 적용됩니다.

주:removeNotify 를 호출하지 않고 , 다른 컨테이너에의 중량 컴퍼넌트의 Z 축 순서의 변경을 지원하고 있지 않는 플랫폼도 있습니다. 플랫폼에서 이것이 지원되고 있는지 어떤지를 판단하는 방법은 없기 때문에, 개발자는 추측하지 않게 해 주세요.

파라미터:

comp - 이동되는 컴퍼넌트

index - 컴퍼넌트를 삽입하는 컨테이너의 리스트내에서의 위치. getComponentCount() 는 마지막에 삽입하는 것을 의미한다

예외:

NullPointerException - comp 가 null 의 경우

IllegalArgumentException - comp 가 컨테이너의 부모의 어느 쪽인지인 경우

IllegalArgumentException - 컨테이너간의 이동으로,index 가 [0, getComponentCount()] 의 범위에 없는 경우, 또는 컨테이너내의 이동으로 [0, getComponentCount()-1] 의 범위에 없다 경우

IllegalArgumentException - 컨테이너를 그 컨테이너 자체에 추가하려고 하고 있는 경우

IllegalArgumentException - Window 를 컨테이너에 추가하려고 하고 있는 경우

도입된 버젼:

1.5

관련 항목:

getComponentZOrder(java.awt.Component)

getComponentZOrder

public int getComponentZOrder(Component  comp)

컨테이너내의 컴퍼넌트의 Z 축 순서 인덱스를 돌려줍니다. Z 축 순서 계층이 비싼 컴퍼넌트(정도)만큼, 그 인덱스는 낮아집니다. Z 축 순서 인덱스가 최저의 컴퍼넌트가 다른 아이 컴퍼넌트의 마지막에 페인트 됩니다.

파라미터:

comp - 조회용의 컴퍼넌트

반환값:

컴퍼넌트의 Z 축 순서 인덱스. 컴퍼넌트가 null 또는 컨테이너에 속하지 않는 경우는 -1 을 돌려주는

도입된 버젼:

1.5

관련 항목:

setComponentZOrder(java.awt.Component, int)

add

public void add(Component  comp,
                Object  constraints)

지정된 컴퍼넌트를 이 컨테이너의 마지막에 추가합니다. 또, 지정된 제약 객체를 사용해, 이 컨테이너의 배치에 컴퍼넌트를 추가하는 것을 레이아웃 매니저에게 통지합니다. 이것은 addImpl(java.awt.Component, java.lang.Object, int) 의 편리한 메소드입니다.

주:컴퍼넌트를, 표시되고 있는 컨테이너에 추가했을 경우, 그 컨테이너에 대해서 validate 를 호출해, 새로운 컴퍼넌트를 표시할 필요가 있습니다. 복수의 컴퍼넌트를 추가하는 경우는, 모든 컴퍼넌트를 추가한 후에,validate 를 1 회만 호출하는 것에 의해, 효율을 향상할 수 있습니다.

파라미터:

comp - 추가되는 컴퍼넌트

constraints - 이 컴퍼넌트의 배치 조건을 표현하는 객체

예외:

NullPointerException - comp 가 null 의 경우

도입된 버젼:

JDK1. 1

관련 항목:

addImpl(java.awt.Component, java.lang.Object, int) , validate() , JComponent.revalidate() , LayoutManager

add

public void add(Component  comp,
                Object  constraints,
                int index)

지정된 컴퍼넌트를, 지정된 인덱스와 지정된 제약으로, 컨테이너에 추가합니다. 또, 지정된 제약 객체를 사용해, 이 컨테이너의 배치에 컴퍼넌트를 추가하는 것을 레이아웃 매니저에게 통지합니다. 이것은 addImpl(java.awt.Component, java.lang.Object, int) 의 편리한 메소드입니다.

주:컴퍼넌트를, 표시되고 있는 컨테이너에 추가했을 경우, 그 컨테이너에 대해서 validate 를 호출해, 새로운 컴퍼넌트를 표시할 필요가 있습니다. 복수의 컴퍼넌트를 추가하는 경우는, 모든 컴퍼넌트를 추가한 후에,validate 를 1 회만 호출하는 것에 의해, 효율을 향상할 수 있습니다.

파라미터:

comp - 추가되는 컴퍼넌트

constraints - 이 컴퍼넌트의 배치 조건을 표현하는 객체

index - 컴퍼넌트를 삽입하는 컨테이너의 리스트내의 위치. -1 (은)는 마지막에 삽입하는 것을 의미한다

예외:

NullPointerException - comp 가 null 의 경우

IllegalArgumentException - index 가 무효인 경우 (자세한 것은 addImpl(java.awt.Component, java.lang.Object, int) 를 참조)

관련 항목:

addImpl(java.awt.Component, java.lang.Object, int) , validate() , JComponent.revalidate() , remove(int) , LayoutManager

addImpl

protected void addImpl(Component  comp,
                       Object  constraints,
                       int index)

지정된 컴퍼넌트를, 지정된 인덱스로, 컨테이너에 추가합니다. 또, 이 메소드는,addLayoutComponent 메소드를 사용해, 지정된 제약 객체를 사용해 이 컨테이너의 레이아웃에 컴퍼넌트를 추가하는 것을 레이아웃 매니저에게 통지합니다.

제약은 사용되고 있는 레이아웃 매니저를 사용해 정의됩니다. 예를 들어 BorderLayout 클래스는,BorderLayout.NORTH,BorderLayout.SOUTH,BorderLayout.EAST,BorderLayout.WEST, 및 BorderLayout.CENTER 의 5 개의 제약을 정의합니다.

GridBagLayout 클래스에는 GridBagConstraints 객체가 필요합니다. 올바른 형태의 제약 객체를 건네주지 않으면IllegalArgumentException 가 발생합니다.

현재의 레이아웃 매니저가 LayoutManager2 를 구현하는 경우는, 이 객체에 대해서 LayoutManager2.addLayoutComponent(Component, Object) 가 불려 갑니다. 현재의 레이아웃 매니저가 LayoutManager2 를 구현하지 않고, 제약이 String 인 경우는, 이 객체에 대해서 LayoutManager.addLayoutComponent(String, Component) 가 불려 갑니다.

컴퍼넌트가 이 컨테이너의 상위에는 없고, null 가 아닌 부모가 있는 경우는, 이 컨테이너에 추가되기 전에 현재의 부모로부터 삭제됩니다.

이것은, 프로그램이 컨테이너에의 모든 추가 요구를 추적할 필요가 있는 경우에 오버라이드(override) 하는 메소드입니다. 다른 모든 추가 메소드에서는 추적을 실시하지 않습니다. 오버라이드(override) 하는 메소드는, 일반적으로, 메소드의 슈퍼 클래스의 버젼의 호출을 포함할 필요가 있습니다.

super.addImpl(comp, constraints, index)

파라미터:

comp - 추가되는 컴퍼넌트

constraints - 이 컴퍼넌트의 배치 조건을 표현하는 객체

index - 컴퍼넌트를 삽입하는 컨테이너의 리스트내에서의 위치. -1 하 마지막에 추가하는 것을 의미한다

예외:

IllegalArgumentException - index 가 무효인 경우. comp 가 이 컨테이너의 아이이며, 유효한 범위가 [-1, getComponentCount()-1] 인 경우. 컴퍼넌트가 이 컨테이너의 아이는 아니고, 한편 유효한 범위가 [-1, getComponentCount()] 인 경우

IllegalArgumentException - comp 가 이 컨테이너의 상위에 있는 경우

IllegalArgumentException - 윈도우를 컨테이너에 추가하려고 하고 있는 경우

NullPointerException - comp 가 null 의 경우

도입된 버젼:

JDK1. 1

관련 항목:

add(Component) , add(Component, int) , add(Component, java.lang.Object) , LayoutManager , LayoutManager2

remove

public void remove(int index)

컨테이너로부터,index 로 지정된 컴퍼넌트를 삭제합니다. 한층 더 이 메소드는,removeLayoutComponent 메소드를 사용해, 이 컨테이너의 레이아웃으로부터 컴퍼넌트를 삭제하는 것을 레이아웃 매니저에게 통지합니다.

주:표시되고 있던 컴퍼넌트가 컨테이너로부터 삭제되었을 경우는, 그 컨테이너에 대해서 validate() 를 호출해, 변경을 반영시킬 필요가 있습니다. 복수의 컴퍼넌트를 삭제하는 경우는, 모든 컴퍼넌트를 삭제한 후에,validate() 를 1 회만 호출하는 것에 의해, 효율을 향상할 수 있습니다.

파라미터:

index - 삭제되는 컴퍼넌트의 인덱스

예외:

ArrayIndexOutOfBoundsException - index 가 [0, getComponentCount()-1] 의 범위내에 없는 경우

도입된 버젼:

JDK1. 1

관련 항목:

add(java.awt.Component) , validate() , getComponentCount()

remove

public void remove(Component  comp)

컨테이너로부터, 지정된 컴퍼넌트를 삭제합니다. 한층 더 이 메소드는,removeLayoutComponent 메소드를 사용해, 이 컨테이너의 레이아웃으로부터 컴퍼넌트를 삭제하는 것을 레이아웃 매니저에게 통지합니다.

주:표시되고 있던 컴퍼넌트가 컨테이너로부터 삭제되었을 경우는, 그 컨테이너에 대해서 validate() 를 호출해, 변경을 반영시킬 필요가 있습니다. 복수의 컴퍼넌트를 삭제하는 경우는, 모든 컴퍼넌트를 삭제한 후에,validate() 를 1 회만 호출하는 것에 의해, 효율을 향상할 수 있습니다.

파라미터:

comp - 삭제되는 컴퍼넌트

관련 항목:

add(java.awt.Component) , validate() , remove(int)

removeAll

public void removeAll()

컨테이너로부터 모든 컴퍼넌트를 삭제합니다. 한층 더 이 메소드는,removeLayoutComponent 메소드를 사용해, 이 컨테이너의 레이아웃으로부터 컴퍼넌트를 삭제하는 것을 레이아웃 매니저에게 통지합니다.

관련 항목:

add(java.awt.Component) , remove(int)

getLayout

public LayoutManager  getLayout()

이 컨테이너의 레이아웃 매니저를 돌려줍니다.

관련 항목:

doLayout() , setLayout(java.awt.LayoutManager)

setLayout

public void setLayout(LayoutManager  mgr)

이 컨테이너의 레이아웃 매니저를 설정합니다.

파라미터:

mgr - 지정된 레이아웃 매니저

관련 항목:

doLayout() , getLayout()

doLayout

public void doLayout()

이 컨테이너가 컴퍼넌트를 배치할 수 있도록(듯이) 합니다. 대부분의 프로그램에서는, 이 메소드를 직접 호출하는 대신에,validate 메소드를 호출할 필요가 있습니다.

오버라이드(override):

클래스 Component 내의 doLayout

도입된 버젼:

JDK1. 1

관련 항목:

LayoutManager.layoutContainer(java.awt.Container) , setLayout(java.awt.LayoutManager) , validate()

layout

@Deprecated 
public void layout()

추천 되고 있지 않습니다. JDK Version 1.1 이후는, doLayout() 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 layout

invalidate

public void invalidate()

컨테이너를 무효로 합니다. 상기의 컨테이너와 모든 부모는, 배치될 필요가 있는 것으로서 마크 됩니다. 이 메소드는 빈번하게 불려 가므로, 신속히 동작할 필요가 있습니다.

이 컨테이너에 인스톨 되고 있는 LayoutManager 가 LayoutManager2 의 인스턴스인 경우는, 이 Container 를 인수로서 LayoutManager2.invalidateLayout(Container) 가 불려 갑니다.

오버라이드(override):

클래스 Component 내의 invalidate

관련 항목:

validate() , layout() , LayoutManager , LayoutManager2.invalidateLayout(Container)

validate

public void validate()

이 컨테이너 및 모든 서브 컴퍼넌트를 검증합니다.

validate 메소드를 사용해, 컨테이너에 다시 그 서브 컴퍼넌트를 배치시킵니다. 이 컨테이너가 표시되고 나서, 컨테이너의 서브 컴퍼넌트가 변경되었을 (컨테이너에의 추가 또는 삭제, 레이아웃 관련의 정보의 변경) 경우에 호출할 필요가 있습니다.

이 Container 가 유효하지 않은 경우, 이 메소드는 Container 메소드를 호출해, 이 Container 를 유효로서 마크 합니다. 그 이외의 경우는, 어떤 처리도 실시하지 않습니다.

오버라이드(override):

클래스 Component 내의 validate

관련 항목:

add(java.awt.Component) , Component.invalidate() , JComponent.revalidate() , validateTree()

validateTree

protected void validateTree()

컨테이너 트리를 재귀적으로 하위까지 더듬어, 필요하다라고 마크 된 모든 서브 트리, 그리고 무효와 마크 된 모든 서브 트리의 배치를 재계산합니다. 동기화는, 이 validate 를 호출하는 메소드에 의해 제공될 필요가 있습니다.

관련 항목:

doLayout() , validate()

setFont

public void setFont(Font  f)

이 컨테이너의 폰트를 설정합니다.

오버라이드(override):

클래스 Component 내의 setFont

파라미터:

f - 이 컨테이너의 폰트로서 설정하는 폰트

도입된 버젼:

JDK1. 0

관련 항목:

Component.getFont()

getPreferredSize

public Dimension  getPreferredSize()

이 컨테이너의 추천 사이즈를 돌려줍니다. 추천 사이즈가 Component.setPreferredSize(Dimension) 에 의해 명시적으로 설정되어 있지 않은 경우로, 이 Container 에 non-null LayoutManager 가 있을 때는,LayoutManager.preferredLayoutSize(Container) 를 사용해 추천 사이즈가 계산됩니다.

주:구현에 따라서는,LayoutManager 의 반환값을 캐쉬하는 경우가 있습니다. 그러한 구현에서는, 이 메소드가 불려 갈 때마다 LayoutManager 의 preferredLayoutSize 를 호출할 필요는 없고,Container 가 무효가 되었을 때 만여라 LayoutManager 를 조회합니다.

오버라이드(override):

클래스 Component 내의 getPreferredSize

반환값:

이 컨테이너의 추천 사이즈를 나타낸다 Dimension 의 인스턴스

관련 항목:

getMinimumSize() , getMaximumSize() , getLayout() , LayoutManager.preferredLayoutSize(Container) , Component.getPreferredSize()

preferredSize

@Deprecated 
public Dimension  preferredSize()

추천 되고 있지 않습니다. JDK Version 1.1 이후는, getPreferredSize() 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 preferredSize

getMinimumSize

public Dimension  getMinimumSize()

이 컨테이너의 최소 사이즈를 돌려줍니다. 최소 사이즈가 Component.setMinimumSize(Dimension) 에 의해 명시적으로 설정되어 있지 않은 경우로, 이 Container 에 non-null LayoutManager 가 있을 때는,LayoutManager.minimumLayoutSize(Container) 를 사용해 최소 사이즈가 계산됩니다.

주:구현에 따라서는,LayoutManager 의 반환값을 캐쉬하는 경우가 있습니다. 그러한 구현에서는, 이 메소드가 불려 갈 때마다 LayoutManager 의 minimumLayoutSize 를 호출할 필요는 없고,Container 가 무효가 되었을 때 만여라 LayoutManager 를 조회합니다.

오버라이드(override):

클래스 Component 내의 getMinimumSize

반환값:

이 컨테이너의 최소 사이즈를 나타낸다 Dimension 의 인스턴스

도입된 버젼:

JDK1. 1

관련 항목:

getPreferredSize() , getMaximumSize() , getLayout() , LayoutManager.minimumLayoutSize(Container) , Component.getMinimumSize()

minimumSize

@Deprecated 
public Dimension  minimumSize()

추천 되고 있지 않습니다. JDK Version 1.1 이후는, getMinimumSize() 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 minimumSize

getMaximumSize

public Dimension  getMaximumSize()

이 컨테이너의 최대 사이즈를 돌려줍니다. 최대 사이즈가 Component.setMaximumSize(Dimension) 에 의해 명시적으로 설정되어 있지 않은 경우로, 이 Container 에 인스톨 되고 있는 LayoutManager 가 LayoutManager2 의 인스턴스일 때는,LayoutManager2.maximumLayoutSize(Container) 를 사용해 최대 사이즈가 계산됩니다.

주:구현에 따라서는,LayoutManager2 의 반환값을 캐쉬하는 경우가 있습니다. 그러한 구현에서는, 이 메소드가 불려 갈 때마다 LayoutManager2 의 maximumLayoutSize 를 호출할 필요는 없고,Container 가 무효가 되었을 때 만여라 LayoutManager2 를 조회합니다.

오버라이드(override):

클래스 Component 내의 getMaximumSize

반환값:

이 컨테이너의 최대 사이즈를 나타낸다 Dimension 의 인스턴스

관련 항목:

getPreferredSize() , getMinimumSize() , getLayout() , LayoutManager2.maximumLayoutSize(Container) , Component.getMaximumSize()

getAlignmentX

public float getAlignmentX()

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

오버라이드(override):

클래스 Component 내의 getAlignmentX

getAlignmentY

public float getAlignmentY()

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

오버라이드(override):

클래스 Component 내의 getAlignmentY

paint

public void paint(Graphics  g)

컨테이너를 그립니다. 이 컨테이너의 아이 컴퍼넌트인 모든 경량 컴퍼넌트에 페인트 요구를 전송 합니다. 이 메소드가 재구현되는 경우, 경량 컴퍼넌트가 올바르고 draw 되도록(듯이) super.paint(g)를 호출하지 않으면 안됩니다. 아이 컴퍼넌트 전체가, g 로 설정되는 현재의 클리핑에 의해 클립 되는 경우, paint()는 그 아이 컴퍼넌트에는 전송 되지 않습니다.

오버라이드(override):

클래스 Component 내의 paint

파라미터:

g - 지정된 Graphics 윈도우

관련 항목:

Component.update(Graphics)

update

public void update(Graphics  g)

컨테이너를 갱신합니다. 이 메소드는, 이 컨테이너의 아이인 경량 컴퍼넌트에 갱신 요구를 전송 합니다. 이 메소드가 재구현되었을 경우, super.update(g)를 호출해 경량 컴퍼넌트를 적절히 draw 할 필요가 있습니다. 아이 컴퍼넌트가 g 내에서 현재의 클리핑의 설정치에 의해 전체적으로 클리핑 되었을 경우, update()는 그 아이에게는 전송 되지 않습니다.

오버라이드(override):

클래스 Component 내의 update

파라미터:

g - 지정된 Graphics 윈도우

관련 항목:

Component.update(Graphics)

print

public void print(Graphics  g)

컨테이너를 출력합니다. 이 메소드는, 이 컨테이너의 아이인 경량 컴퍼넌트에 출력 요구를 전송 합니다. 이 메소드가 재구현되었을 경우, super.print(g)를 호출해 경량 컴퍼넌트를 적절히 draw 할 필요가 있습니다. 아이 컴퍼넌트가 g 내에서 현재의 클리핑의 설정치에 의해 전체적으로 클리핑 되었을 경우, print()는 그 아이에게는 전송 되지 않습니다.

오버라이드(override):

클래스 Component 내의 print

파라미터:

g - 지정된 Graphics 윈도우

관련 항목:

Component.update(Graphics)

paintComponents

public void paintComponents(Graphics  g)

이 컨테이너내의 각 컴퍼넌트를 그립니다.

파라미터:

g - 그래픽스 문맥

관련 항목:

Component.paint(java.awt.Graphics) , Component.paintAll(java.awt.Graphics)

printComponents

public void printComponents(Graphics  g)

이 컨테이너내의 각 컴퍼넌트를 출력합니다.

파라미터:

g - 그래픽스 문맥

관련 항목:

Component.print(java.awt.Graphics) , Component.printAll(java.awt.Graphics)

addContainerListener

public void addContainerListener(ContainerListener  l)

이 컨테이너로부터의 컨테이너 이벤트를 받아들이도록(듯이), 지정된 컨테이너 청취자를 추가합니다. l 가 null 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다.

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

l - 컨테이너 청취자

관련 항목:

removeContainerListener(java.awt.event.ContainerListener) , getContainerListeners()

removeContainerListener

public void removeContainerListener(ContainerListener  l)

이 컨테이너로부터의 컨테이너 이벤트를 받지 않게, 지정된 컨테이너 청취자를 삭제합니다. l 가 null 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다.

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

l - 컨테이너 청취자

관련 항목:

addContainerListener(java.awt.event.ContainerListener) , getContainerListeners()

getContainerListeners

public ContainerListener [] getContainerListeners()

이 컨테이너에 등록되어 모든 항목 청취자의 배열을 돌려줍니다.

반환값:

이 컨테이너의 모든 ContainerListener. 컨테이너 청취자가 현재 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.4

관련 항목:

addContainerListener(java.awt.event.ContainerListener) , removeContainerListener(java.awt.event.ContainerListener)

getListeners

public <T extends EventListener > T[] getListeners(Class <T> listenerType)

이 Container 에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. FooListener 는,addFooListener 메소드를 사용해 등록합니다.

FooListener.class 라고 하는 클래스 리터럴을 사용해,listenerType 인수를 지정할 수 있습니다. 예를 들어, 이 컨테이너 청취자에 대한 Container c 의 조회는 다음의 코드로 실시합니다.

ContainerListener[] cls = (ContainerListener[])(c.getListeners(ContainerListener.class));

이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.

오버라이드(override):

클래스 Component 내의 getListeners

파라미터:

listenerType - 요구되는 청취자의 형태. 이 파라미터는, java.util.EventListener 의 하위 인터페이스를 지정한다

반환값:

이 컴퍼넌트에 FooListener 로서 등록되어 있다 모든 객체의 배열, 그러한 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열

예외:

ClassCastException - listenerType 가 java.util.EventListener 를 구현하는 클래스 또는 지정하지 않는 경우

도입된 버젼:

1.3

관련 항목:

getContainerListeners()

processEvent

protected void processEvent(AWTEvent  e)

이 컨테이너의 이벤트를 처리합니다. 이벤트가 ContainerEvent 인 경우,processContainerEvent 메소드를 호출합니다. 그렇지 않은 경우는, 슈퍼 클래스의 processEvent 를 호출합니다.

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.

오버라이드(override):

클래스 Component 내의 processEvent

파라미터:

e - 이벤트

관련 항목:

Component.processComponentEvent(java.awt.event.ComponentEvent) , Component.processFocusEvent(java.awt.event.FocusEvent) , Component.processKeyEvent(java.awt.event.KeyEvent) , Component.processMouseEvent(java.awt.event.MouseEvent) , Component.processMouseMotionEvent(java.awt.event.MouseEvent) , Component.processInputMethodEvent(java.awt.event.InputMethodEvent) , Component.processHierarchyEvent(java.awt.event.HierarchyEvent) , Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)

processContainerEvent

protected void processContainerEvent(ContainerEvent  e)

이 컨테이너로 발생하는 컨테이너 이벤트를, 등록되어 있는 ContainerListener 객체에 발송 하는 것으로 처리합니다. 주:이 메소드는, 이 컴퍼넌트의 컨테이너 이벤트가 유효하게 된 시점에서 불려 갑니다. 컨테이너 이벤트는 다음이 발생했을 때에 유효하게 됩니다.

• ContainerListener 객체가 addContainerListener 에 의해 등록되어 있다
• enableEvents 에 의해 컨테이너 이벤트가 사용 가능하게 되어 있다

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.

파라미터:

e - 컨테이너 이벤트

관련 항목:

Component.enableEvents(long)

deliverEvent

@Deprecated 
public void deliverEvent(Event  e)

추천 되고 있지 않습니다. JDK Version 1.1 이후는, dispatchEvent(AWTEvent e) 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 deliverEvent

getComponentAt

public Component  getComponentAt(int x,
                                int y)

x, y 좌표를 포함한 컴퍼넌트를 찾습니다. 컴퍼넌트가 오버랩 하고 있는 경우, 최상부의 아이 컴퍼넌트가 돌려주어집니다. 이것은, Component.contains()에 의해 지정된 점을 포함하는 것 같은, 인덱스 0 에 가장 가까운 컴퍼넌트를 찾아내는 것으로 결정됩니다. 컴퍼넌트를 찾아내는 경우는, 네이티브 피어를 가지는 컴퍼넌트가 네이티브 피어를 가지지 않는 컴퍼넌트 (경량 컴퍼넌트)보다 우선됩니다.

오버라이드(override):

클래스 Component 내의 getComponentAt

파라미터:

x - x 좌표

y - y 좌표

반환값:

컴퍼넌트가 그 위치를 포함하지 않는 경우는 null. 요구된 점에 아이 컴퍼넌트가 없고, 그 점이 컨테이너의 경계내에 있는 경우는, 컨테이너 자신이 그렇지 않은 경우는, 최상부의 아이 컴퍼넌트가 반환되는

도입된 버젼:

JDK1. 1

관련 항목:

Component.contains(int, int)

locate

@Deprecated 
public Component  locate(int x,
                                   int y)

추천 되고 있지 않습니다. JDK Version 1.1 이후는, getComponentAt(int, int) 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 locate

getComponentAt

public Component  getComponentAt(Point  p)

지정된 점을 포함한 컴퍼넌트를 돌려줍니다.

오버라이드(override):

클래스 Component 내의 getComponentAt

파라미터:

p - 점

반환값:

지정된 점을 포함한 컴퍼넌트. 컴퍼넌트가 그 점을 포함하지 않는 경우는 null

도입된 버젼:

JDK1. 1

관련 항목:

Component.contains(int, int)

getMousePosition

public Point  getMousePosition(boolean allowChildren)
                       throws HeadlessException 

Container 가 마우스 포인터아래에 있는 경우, 이 Container 의 좌표 공간의 마우스 포인터의 위치를 돌려주어, 그렇지 않은 경우는,null 를 돌려줍니다. 이 메소드는,Container 의 아이가 고려되는 것을 제외하면,Component.getMousePosition() 와 닮아 있습니다. allowChildren 가 false 의 경우는, 마우스 포인터가 Container 의 직접적인 위에 있어, 아이에 의해 숨겨지지 않은 부분 위에 있는 경우에게만, null 이외의 값을 돌려줍니다. allowChildren 가 true 의 경우는, 마우스 포인터가 Container 또는 그 몇개의 아이 위에 있는 경우에게만, null 이외의 값을 돌려줍니다.

파라미터:

allowChildren - 자를 고려할 필요가 있는 경우는 true

반환값:

이 Component 를 기준으로 하는 마우스 좌표, 또는 null

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

도입된 버젼:

1.5

관련 항목:

Component.getMousePosition()

findComponentAt

public Component  findComponentAt(int x,
                                 int y)

지정된 점을 포함하는 가시의 아이 컴퍼넌트를 검색합니다. 컴퍼넌트가 오버랩 하고 있는 경우, 최상부의 아이 컴퍼넌트가 돌려주어집니다. 포함하고 있는 아이 컴퍼넌트가 Container 의 경우, 이 메소드는, 가장 깊게 상자가 되어 있는 아이 컴퍼넌트를 검색합니다. 가시가 아닌 컴퍼넌트는 검색시에 무시됩니다.

findComponentAt 메소드는, Container 의 직접적인 아이만을 검색하는 getComponentAt 와는 다릅니다. 포함되고 있는 컴퍼넌트가 Container 의 경우, findComponentAt 는 그 아이를 검색해 상자가 되어 있는 컴퍼넌트를 찾아냅니다.

파라미터:

x - x 좌표

y - y 좌표

반환값:

컴퍼넌트가 그 위치를 포함하지 않는 경우는 null. 요구된 점에 아이 컴퍼넌트가 없고, 그 점이 컨테이너의 경계내에 있는 경우는, 컨테이너 자신이 하지만 반환되는

도입된 버젼:

1.2

관련 항목:

Component.contains(int, int) , getComponentAt(int, int)

findComponentAt

public Component  findComponentAt(Point  p)

지정된 점을 포함하는 가시의 아이 컴퍼넌트를 검색합니다. 컴퍼넌트가 오버랩 하고 있는 경우, 최상부의 아이 컴퍼넌트가 돌려주어집니다. 포함하고 있는 아이 컴퍼넌트가 Container 의 경우, 이 메소드는, 가장 깊게 상자가 되어 있는 아이 컴퍼넌트를 검색합니다. 가시가 아닌 컴퍼넌트는 검색시에 무시됩니다.

findComponentAt 메소드는, Container 의 직접적인 아이만을 검색하는 getComponentAt 와는 다릅니다. 포함되고 있는 컴퍼넌트가 Container 의 경우, findComponentAt 는 그 아이를 검색해 상자가 되어 있는 컴퍼넌트를 찾아냅니다.

파라미터:

p - 점

반환값:

컴퍼넌트가 그 위치를 포함하지 않는 경우는 null. 요구된 점에 아이 컴퍼넌트가 없고, 그 점이 컨테이너의 경계내에 있는 경우는, 컨테이너 자신이 하지만 반환되는

도입된 버젼:

1.2

관련 항목:

Component.contains(int, int) , getComponentAt(int, int)

addNotify

public void addNotify()

네이티브 스크린 자원에 접속하는 것으로써, 이 Container 를 표시 가능하게 합니다. 컨테이너를 표시 가능하게 하면(자), 그 컨테이너의 모든 아이도 표시 가능하게 됩니다. 이 메소드는, 툴 킷에 의해 내부에서 불려 갑니다. 프로그램이 직접 호출할 수 없습니다.

오버라이드(override):

클래스 Component 내의 addNotify

관련 항목:

Component.isDisplayable() , removeNotify()

removeNotify

public void removeNotify()

네이티브 스크린 자원에의 접속을 삭제하는 것으로써, 이 Container 를 표시 불가로 합니다. 컨테이너를 표시 불가로 하면(자), 그 컨테이너의 모든 아이도 표시 불가가 됩니다. 이 메소드는, 툴 킷에 의해 내부에서 불려 가 프로그램으로부터 직접 불려 갈 것은 없습니다.

오버라이드(override):

클래스 Component 내의 removeNotify

관련 항목:

Component.isDisplayable() , addNotify()

isAncestorOf

public boolean isAncestorOf(Component  c)

컴퍼넌트가 이 컨테이너의 컴퍼넌트 계층에 포함되고 있는지 어떤지를 판정합니다.

파라미터:

c - 컴퍼넌트

반환값:

상위 객체인 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

JDK1. 1

paramString

protected String  paramString()

이 Container 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 Component 내의 paramString

반환값:

이 컨테이너의 파라미터 캐릭터 라인

list

public void list(PrintStream  out,
                 int indent)

지정된 출력 스트림에 이 컨테이너의 리스트를 출력합니다. 리스트는, 지정된 인덴트 위치로부터 개시됩니다.

컨테이너의 직접적인 아이는 indent+1 의 인덴트 위치에서 출력됩니다. 이러한 아이의 아이는 indent+2, 이하와 같이 출력됩니다.

오버라이드(override):

클래스 Component 내의 list

파라미터:

out - 출력 스트림

indent - 인덴트 되는 스페이스의 수

도입된 버젼:

JDK1. 0

관련 항목:

Component.list(java.io.PrintStream, int)

list

public void list(PrintWriter  out,
                 int indent)

지정된 인덴트 위치로부터 개시해, 지정된 프린트 라이터에 리스트를 출력합니다.

컨테이너의 직접적인 아이는 indent+1 의 인덴트 위치에서 출력됩니다. 이러한 아이의 아이는 indent+2, 이하와 같이 출력됩니다.

오버라이드(override):

클래스 Component 내의 list

파라미터:

out - 프린트 라이터

indent - 인덴트 되는 스페이스의 수

도입된 버젼:

JDK1. 1

관련 항목:

Component.list(java.io.PrintWriter, int)

setFocusTraversalKeys

public void setFocusTraversalKeys(int id,
                                  Set <?  extends AWTKeyStroke > keystrokes)

이 컨테이너의 지정된 traversal 조작에 대한 포커스 traversal 키를 설정합니다.

컨테이너의 포커스 traversal 키의 디폴트 값는 구현에 따라서 다릅니다. Sun 는 특정의 네이티브인 플랫폼에 대한 모든 구현으로 같은 디폴트 값를 사용하는 것을 추천합니다. Windows 및 Unix 에 대한 추천은 다음에 리스트 되고 있습니다. 이러한 추천은 Sun AWT 의 구현으로 사용됩니다.

식별자	의미	디폴트
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	일반적으로의 순서 방향 키보드 traversal	TAB 의 KEY_PRESSED, CTRL-TAB 의 KEY_PRESSED
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	일반적으로의 리버스 키보드 traversal	SHIFT-TAB 의 KEY_PRESSED, CTRL-SHIFT-TAB 의 KEY_PRESSED
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	1 개(살)상의 포커스 traversal 사이클에 이동	없음
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS		1 개(살)하의 포커스 traversal 사이클에 이동	없음

traversal 키를 무효화하기 위해서는, 빈 상태(empty)세트를 사용합니다. Collections.EMPTY_SET 의 사용을 추천합니다.

AWTKeyStroke API 를 사용하면(자), 클라이언트 코드로 KEY_PRESSED 와 KEY_RELEASED 의 2 개의 KeyEvent 를 지정할 수 있게 되어, 포커스 traversal를 조작할 수 있게 됩니다. 다만, 지정되는 KeyEvent 에 관계없이, 관련지을 수 있는 KEY_TYPED 이벤트를 포함한, 포커스 traversal 키에 관련하는 모든 KeyEvent 는 소비되어 다른 컨테이너에의 발송는 행해지지 않습니다. KEY_TYPED 이벤트의 포커스 traversal 조작에의 매핑, 1 개의 이벤트의 복수의 디폴트 포커스 traversal 조작에의 매핑은 실행시 에러가 됩니다.

세트에 값 null 가 지정되고 있는 경우, 이 컨테이너는 세트를 부모로부터 상속합니다. 이 컨테이너보다 상위의 모든 컨테이너세트에 값 null 가 지정되고 있는 경우, 현재의 KeyboardFocusManager 의 디폴트 세트가 사용됩니다.

오버라이드(override):

클래스 Component 내의 setFocusTraversalKeys

파라미터:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS 의 어느쪽이든

keystrokes - 지정된 조작에 대한 AWTKeyStroke 세트

예외:

IllegalArgumentException - id 가 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS 의 어떤 것도 아닌 경우, 또는 키스트로크(keystroke)에 null 가 포함되는 경우, 키스트로크(keystroke)내의 임의의 Object 가 AWTKeyStroke 가 아닌 경우, 임의의 키스트로크(keystroke)가 KEY_TYPED 이벤트를 나타내는 경우, 또는 키스트로크(keystroke)중 한쪽이 이 컨테이너의 다른 포커스 traversal 조작에 맵 되고 있는 경우

도입된 버젼:

1.4

관련 항목:

getFocusTraversalKeys(int) , KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS , KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS , KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS , KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

getFocusTraversalKeys

public Set <AWTKeyStroke > getFocusTraversalKeys(int id)

이 컨테이너의 지정된 traversal 조작의 포커스 traversal 키세트를 돌려줍니다. 모든 키의 설명은 setFocusTraversalKeys 를 참조해 주세요.

traversal 키세트가 이 컨테이너에 대해서 명시적으로 정의되어 있지 않은 경우, 이 컨테이너의 부모의 키 세트가 돌려주어집니다. 이 컨테이너보다 상위의 모든 컨테이너세트가 정의되어 있지 않은 경우, 현재의 KeyboardFocusManager 의 디폴트 세트가 돌려주어집니다.

오버라이드(override):

클래스 Component 내의 getFocusTraversalKeys

파라미터:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS 의 언젠가

반환값:

지정된 조작에 대한 AWTKeyStrokes 세트. 이 세트는 변경할 수 없다. 또 공백의 가능성도 있다. null 가 돌려주어질 것은 없다

예외:

IllegalArgumentException - id 가 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS 의 어떤 것도 아닌 경우

도입된 버젼:

1.4

관련 항목:

setFocusTraversalKeys(int, java.util.Set) , KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS , KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS , KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS , KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

지정된 포커스 traversal 조작에 대한 포커스 traversal 키세트가, 이 컨테이너에 명시적으로 정의되고 있는지 어떤지를 돌려줍니다. false 가 반환되는 경우, 이 컨테이너는 세트를 상위의 컨테이너로부터, 또는 현재의 KeyboardFocusManager 로부터 상속합니다.

오버라이드(override):

클래스 Component 내의 areFocusTraversalKeysSet

파라미터:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS 의 언젠가

반환값:

지정된 포커스 traversal 조작의 포커스 traversal 키세트가, 이 컴퍼넌트에 명시적으로 정의되고 있는 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalArgumentException - id 가 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS 의 어떤 것도 아닌 경우

도입된 버젼:

1.4

isFocusCycleRoot

public boolean isFocusCycleRoot(Container  container)

지정된 컨테이너가, 이 컨테이너의 포커스 traversal 사이클의 포커스 사이클 루트일지 어떨지를 돌려줍니다. 포커스 traversal 사이클은, 각각 포커스 사이클 루트를 1 개 가져, 포커스 사이클 루트 이외의 각 컨테이너는, 1 개의 포커스 traversal 사이클인 만큼 소속합니다. 포커스 사이클 루트가 되어 있는 컨테이너는, 그 자체가 루트가 되어 있는 포커스 사이클과 그 1 개(살) 상위의 포커스 사이클 루트가 구성하는 포커스 사이클의 양쪽 모두에 속합니다. 이 메소드는 어느 쪽의 컨테이너에 대해서도, 이 경우 true 를 돌려줍니다.

오버라이드(override):

클래스 Component 내의 isFocusCycleRoot

파라미터:

container - 판정 대상의 Container

반환값:

지정된 컨테이너가 이 컨테이너의 포커스 사이클 루트의 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.4

관련 항목:

isFocusCycleRoot()

transferFocusBackward

public void transferFocusBackward()

클래스 Component 의 기술:

이 컴퍼넌트가 포커스 소유자인것 같이, 포커스를 전의 컴퍼넌트에 전송 합니다.

오버라이드(override):

클래스 Component 내의 transferFocusBackward

관련 항목:

Component.requestFocus()

setFocusTraversalPolicy

public void setFocusTraversalPolicy(FocusTraversalPolicy  policy)

이 컨테이너가 포커스 사이클 루트의 경우, 이 컨테이너의 아이의 키 보트 traversal를 관리하는 포커스 traversal 정책를 설정합니다. 인수가 null 의 경우는, 이 컨테이너는 상위의 포커스 사이클 루트로부터 정책를 상속합니다. null 가 아닌 경우는, 이 정책는 독자적인 키보드 traversal 정책를 가지지 않는, 포커스 사이클 루트의 모든 아이에 의해 상속됩니다. 이 상속은, 이러한 아이의 하위까지 재귀적으로 행해집니다.

이 컨테이너가 포커스 사이클 루트가 아닌 경우, 정책는 기록됩니다만, 이 컨테이너가 포커스 사이클 루트가 될 때까지는, 이 컨테이너가 사용하는 일도, 다른 컨테이너에 의해 상속되는 일도 없습니다.

파라미터:

policy - 이 컨테이너의 새로운 포커스 traversal 정책

도입된 버젼:

1.4

관련 항목:

getFocusTraversalPolicy() , setFocusCycleRoot(boolean) , isFocusCycleRoot(java.awt.Container)

getFocusTraversalPolicy

public FocusTraversalPolicy  getFocusTraversalPolicy()

이 컨테이너의 아이의 키보드 traversal를 관리하는 포커스 traversal 정책를 돌려줍니다. 이 컨테이너가 포커스 사이클 루트가 아닌 경우는 null 를 돌려줍니다. 이 컨테이너에 traversal 정책가 명시적으로 설정되어 있지 않은 경우는, 이 컨테이너의 상위의 포커스 사이클 루트의 정책가 돌려주어집니다.

반환값:

이 컨테이너의 포커스 traversal 정책. 이 컨테이너가 포커스 사이클 루트가 아닌 경우는 null

도입된 버젼:

1.4

관련 항목:

setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) , setFocusCycleRoot(boolean) , isFocusCycleRoot(java.awt.Container)

isFocusTraversalPolicySet

public boolean isFocusTraversalPolicySet()

포커스 traversal 정책가 이 컨테이너에 대해서 명시적으로 설정되어 있는지 어떤지를 설정합니다. false 를 돌려주는 경우, 이 컨테이너는 상위의 컨테이너로부터 traversal 정책를 상속합니다.

반환값:

이 컨테이너에 대해서 포커스 traversal 정책가 명시적으로 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.4

setFocusCycleRoot

public void setFocusCycleRoot(boolean focusCycleRoot)

이 컨테이너가 포커스 traversal 사이클의 루트일지 어떨지를 설정합니다. 포커스가 한 번 traversal 사이클로 설정되면(자), 사이클을 상위 또는 하위로 전환하는 키를 누르지 않으면, 일반적으로은 포커스 traversal를 떨어질 수 없습니다. 일반적으로의 traversal는 이 컨테이너와 그 하위 클래스에 제한되고 있어 하층의 포커스 사이클 루트의 하위 클래스에의 traversal는 할 수 없습니다. 다만 FocusTraversalPolicy 는 이 제한을 없앨 수가 있습니다. 예를 들어 ContainerOrderFocusTraversalPolicy 는 암묵의 다운 사이클 traversal를 지원합니다.

컨테이너의 아이의 traversal순서를 지정하는 다른 방법은, 이 컨테이너를「포커스 traversal 정책 프로바이더」로 하는 것입니다.

파라미터:

focusCycleRoot - 이 컨테이너가 포커스 traversal 사이클의 루트인 것을 나타내는

도입된 버젼:

1.4

관련 항목:

isFocusCycleRoot() , setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) , getFocusTraversalPolicy() , ContainerOrderFocusTraversalPolicy , setFocusTraversalPolicyProvider(boolean)

isFocusCycleRoot

public boolean isFocusCycleRoot()

이 컨테이너가 포커스 traversal 사이클의 루트일지 어떨지를 돌려줍니다. 포커스가 한 번 traversal 사이클로 설정되면(자), 사이클을 상위 또는 하위로 전환하는 키를 누르지 않으면, 일반적으로은 포커스 traversal를 떨어질 수 없습니다. 일반적으로의 traversal는 이 컨테이너와 그 하위 클래스에 제한되고 있어 하층의 포커스 사이클 루트의 하위 클래스에의 traversal는 할 수 없습니다. 다만 FocusTraversalPolicy 는 이 제한을 없앨 수가 있습니다. 예를 들어 ContainerOrderFocusTraversalPolicy 는 암묵의 다운 사이클 traversal를 지원합니다.

반환값:

이 컨테이너가 포커스 traversal 사이클의 루트일지 어떨지

도입된 버젼:

1.4

관련 항목:

setFocusCycleRoot(boolean) , setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) , getFocusTraversalPolicy() , ContainerOrderFocusTraversalPolicy

setFocusTraversalPolicyProvider

public final void setFocusTraversalPolicyProvider(boolean provider)

이 컨테이너를 사용해, 포커스 traversal 정책를 제공할지 어떨지를 설정합니다. 이 프로퍼티을 true 로 설정한 컨테이너를 사용해, 가장 가까운 상위 포커스 사이클 루트 대신에, 포커스 traversal 정책를 가져옵니다.

파라미터:

provider - 이 컨테이너를 사용해 포커스 traversal 정책를 제공할지 어떨지를 지정하는

도입된 버젼:

1.5

관련 항목:

setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) , getFocusTraversalPolicy() , isFocusTraversalPolicyProvider()

isFocusTraversalPolicyProvider

public final boolean isFocusTraversalPolicyProvider()

이 컨테이너가 포커스 traversal 정책를 제공할지 어떨지를 돌려줍니다. 이 프로퍼티이 true 로 설정되어 있는 경우, 키보드 포커스 매니저가 컨테이너 계층으로부터 포커스 traversal 정책를 검색할 때에, 이 프로퍼티이 true 외의 모든 컨테이너 또는 포커스 사이클 루트의 전에 이 컨테이너를 검출해, 포커스 사이클 루트의 정책 대신에 그 포커스 traversal 정책를 사용합니다.

반환값:

이 컨테이너가 포커스 traversal 정책를 제공하는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.5

관련 항목:

setFocusTraversalPolicy(java.awt.FocusTraversalPolicy) , getFocusTraversalPolicy() , setFocusCycleRoot(boolean) , setFocusTraversalPolicyProvider(boolean)

transferFocusDownCycle

public void transferFocusDownCycle()

포커스를 1 포커스 traversal 사이클만 하위로 이동합니다. 이 컨테이너가 포커스 사이클 루트의 경우, 포커스 소유자는 컨테이너의 디폴트 포커스 컴퍼넌트가 되어, 현재의 포커스 사이클 루트가 이 컨테이너로 설정됩니다. 컨테이너가 포커스 사이클 루트가 아닌 경우, 포커스 traversal 조작은 행해지지 않습니다.

도입된 버젼:

1.4

관련 항목:

Component.requestFocus() , isFocusCycleRoot(java.awt.Container) , setFocusCycleRoot(boolean)

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation  o)

이 컨테이너와 포함되는 모든 컴퍼넌트의 ComponentOrientation 프로퍼티을 설정합니다.

오버라이드(override):

클래스 Component 내의 applyComponentOrientation

파라미터:

o - 이 컨테이너와 거기에 포함되는 컴퍼넌트의, 새로운 컴퍼넌트 방향

예외:

NullPointerException - orientation 가 null 의 경우

도입된 버젼:

1.4

관련 항목:

Component.setComponentOrientation(java.awt.ComponentOrientation) , Component.getComponentOrientation()

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener  listener)

PropertyChangeListener 를 청취자 리스트에 추가합니다. 이 청취자는, 다음과 같은 클래스를 포함한 이 클래스의 모든 바운드 프로퍼티에 등록됩니다.

• 이 컨테이너의 폰트 ("font")
• 이 컨테이너의 백그라운드 칼라 ("background")
• 이 컨테이너의 foreground 칼라 ("foreground")
• 이 컨테이너의 포커스 특성 ("focusable")
• 이 컨테이너의 포커스 traversal 키 (유효한가 어떤가 ) 상태 ("focusTraversalKeysEnabled")
• 이 컨테이너의 FORWARD_TRAVERSAL_KEYS 세트 ("forwardFocusTraversalKeys")
• 이 컨테이너의 BACKWARD_TRAVERSAL_KEYS 세트 ("backwardFocusTraversalKeys")
• 이 컨테이너의 UP_CYCLE_TRAVERSAL_KEYS 세트 ("upCycleFocusTraversalKeys")
• 이 컨테이너의 DOWN_CYCLE_TRAVERSAL_KEYS 세트 ("downCycleFocusTraversalKeys")
• 이 컨테이너의 포커스 traversal 정책 ("focusTraversalPolicy")
• 이 컨테이너의 포커스 사이클 루트 상태 ("focusCycleRoot")

이 컨테이너가 바운드 프로퍼티을 상속하는 경우, 상속되는 프로퍼티의 변경에 반응해 이벤트가 트리거될 것은 없습니다.

listener 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

오버라이드(override):

클래스 Component 내의 addPropertyChangeListener

파라미터:

listener - 추가하는 PropertyChangeListener

관련 항목:

Component.removePropertyChangeListener(java.beans.PropertyChangeListener) , addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

addPropertyChangeListener

public void addPropertyChangeListener(String  propertyName,
                                      PropertyChangeListener  listener)

특정의 프로퍼티의 청취자 리스트에 PropertyChangeListener 를 추가합니다. 사용자 정의의 프로퍼티, 또는 다음의 디폴트를 지정할 수 있습니다.

• 이 컨테이너의 폰트 ("font")
• 이 컨테이너의 백그라운드 칼라 ("background")
• 이 컨테이너의 foreground 칼라 ("foreground")
• 이 컨테이너의 포커스 특성 ("focusable")
• 이 컨테이너의 포커스 traversal 키 (유효한가 어떤가 ) 상태 ("focusTraversalKeysEnabled")
• 이 컨테이너의 FORWARD_TRAVERSAL_KEYS 세트 ("forwardFocusTraversalKeys")
• 이 컨테이너의 BACKWARD_TRAVERSAL_KEYS 세트 ("backwardFocusTraversalKeys")
• 이 컨테이너의 UP_CYCLE_TRAVERSAL_KEYS 세트 ("upCycleFocusTraversalKeys")
• 이 컨테이너의 DOWN_CYCLE_TRAVERSAL_KEYS 세트 ("downCycleFocusTraversalKeys")
• 이 컨테이너의 포커스 traversal 정책 ("focusTraversalPolicy")
• 이 컨테이너의 포커스 사이클 루트 상태 ("focusCycleRoot")
• 이 컨테이너의 포커스 traversal 정책 프로바이더 상태 ("focusTraversalPolicyProvider")

이 컨테이너가 바운드 프로퍼티을 상속하는 경우, 상속되는 프로퍼티의 변경에 반응해 이벤트가 트리거될 것은 없습니다.

listener 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

오버라이드(override):

클래스 Component 내의 addPropertyChangeListener

파라미터:

propertyName - 상기의 프로퍼티명의 어느쪽이든

listener - 추가하는 PropertyChangeListener

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener) , Component.removePropertyChangeListener(java.beans.PropertyChangeListener)