java.awt
클래스 Component

java.lang.Object 
  java.awt.Component

모든 구현된 인터페이스:

ImageObserver, MenuContainer, Serializable

알려진 직계 서브 클래스:

Button, Canvas, Checkbox, Choice, Container, Label, List, Scrollbar, TextComponent

public abstract class Component
extends Object 
implements ImageObserver,
 MenuContainer,
 Serializable 

「컴퍼넌트」는 화면에 표시할 수 있어 사용자 라고 대화할 수 있는 그래피컬한 표현을 가지는 객체입니다. 컴퍼넌트로서는 전형적인 그래피컬 사용자 인터페이스의 버튼, 체크 박스, 스크롤 바등이 있습니다.

Component 클래스는 메뉴에 관련하고 있지 않는 Abstract Window Toolkit 컴퍼넌트의 추상 슈퍼 클래스입니다. 또, Component 클래스를 직접 확장해 경량 컴퍼넌트를 생성할 수도 있습니다. 경량 컴퍼넌트는 네이티브인 불투명 윈도우에 관련하고 있지 않는 컴퍼넌트입니다.

직렬화

객체 보존시에는 Serializable 프로토콜에 적합하는 AWT 리스너만이 보존되는 것에 주의해 주세요. AWT 객체가 직렬화 가능한 리스너를 가지지 않는 경우, writeObject 시에 처리 대상외가 됩니다. 개발자측에서는 보통과 같이, 객체 직렬화의 영향을 고려할 필요가 있습니다. 예를 들어 다음과 같은 경우에는 이 영향을 고려합니다.

    import java.awt. *;
    import java.awt.event. *;
    import java.io.Serializable;
    
    class MyApp implements ActionListener, Serializable
    {
        BigObjectThatShouldNotBeSerializedWithAButton bigOne;
        Button aButton = new Button();
      
        MyApp()
        {
            // Oops, now aButton has a listener with a reference
            // to bigOne!
            aButton.addActionListener(this);
        }
    
        public void actionPerformed(ActionEvent e)
        {
            System.out.println("Hello There");
        }
    }
 

이 예에서는 aButton을 그 자체로 직렬화하면 MyApp가 발생해, 그것을 참조하고 있는 객체도 모두와 같이 직렬화 됩니다. 문제가 발생하는 것은 리스너의 설계 에 해서가 아니라, 우연히, 직렬화 가능하게 되어 있는 경우입니다. MyApp와 ActionListener 각각이 직렬화 가능한가 어떤가의 판단을 독립해 실시하기 위해서 상자 구조의 클래스를 사용할 수 있습니다. 다음에 그 예를 듭니다.

    import java.awt. *;
    import java.awt.event. *;
    import java.io.Serializable;

    class MyApp java.io.Serializable
    {
         BigObjectThatShouldNotBeSerializedWithAButton bigOne;
         Button aButton = new Button();

         class MyActionListener implements ActionListener
         {
             public void actionPerformed(ActionEvent e)
             {
                 System.out.println("Hello There");
             }
         }
 
         MyApp()
         {
             aButton.addActionListener(new MyActionListener());
         }
    }
 

주: 가장 효율적인 페인트 코드를 쓰는 방법 등, AWT 및 Swing에 의해 사용되는 페인트 도구 의 상세한 것에 대하여는 「Painting in AWT and Swing」를 참조하십시오.

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

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

protected class	Component.AccessibleAWTComponent 사용자 보조 기능의 디폴트 지원의 제공에 사용하는 Component 내부 클래스입니다.
protected class	Component.BltBufferStrategy 오프 스크린 표면의 컴퍼넌트에의 Blit 용 내부 클래스입니다.
protected class	Component.FlipBufferStrategy 컴퍼넌트의 버퍼 반전용 내부 클래스.

필드 개요

static float	BOTTOM_ALIGNMENT getAlignmentY용의 편리한 정수입니다.
static float	CENTER_ALIGNMENT getAlignmentY 및 getAlignmentX용의 편리한 정수입니다.
static float	LEFT_ALIGNMENT getAlignmentX용의 편리한 정수입니다.
static float	RIGHT_ALIGNMENT getAlignmentX용의 편리한 정수입니다.
static float	TOP_ALIGNMENT getAlignmentY()용의 편리한 정수입니다.

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

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

생성자 개요

protected

Component () 컴퍼넌트를 새롭게 구축합니다.

메서드 개요

boolean	action (Event evt, Object what) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 이 컴퍼넌트를 액션 이벤트를 트리거 하는 컴퍼넌트의 ActionListener 로서 등록할 필요가 있습니다.
void	add (PopupMenu popup) 지정된 pop-up menu를 컴퍼넌트에 추가합니다.
void	addComponentListener (ComponentListener l) 이 컴퍼넌트로부터 컴퍼넌트 이벤트를 받기 위해서 지정된 컴퍼넌트 리스너를 추가합니다.
void	addFocusListener (FocusListener l) 이 컴퍼넌트가 입력초점을 취득했을 때에 이 컴퍼넌트로부터 포커스 이벤트를 받기 위해서 지정된 포커스 리스너를 추가합니다.
void	addHierarchyBoundsListener (HierarchyBoundsListener l) 이 컨테이너가 소속하는 계층이 변경되었을 때에 이 컴퍼넌트로부터 계층 변경 이벤트를 받기 위해서 지정된 계층 리스너를 추가합니다.
void	addHierarchyListener (HierarchyListener l) 이 컨테이너가 소속하는 계층이 변경되었을 때에 이 컴퍼넌트로부터 계층 변경 이벤트를 받기 위해서 지정된 계층 리스너를 추가합니다.
void	addInputMethodListener (InputMethodListener l) 이 컴퍼넌트로부터 인풋 메서드 이벤트를 받기 위해서 지정된 인풋 메서드 리스너를 추가합니다.
void	addKeyListener (KeyListener l) 이 컴퍼넌트로부터 키 이벤트를 받기 위해서 지정된 키 리스너를 추가합니다.
void	addMouseListener (MouseListener l) 이 컴퍼넌트로부터 마우스 이벤트를 받기 위해서 지정된 마우스 리스너를 추가합니다.
void	addMouseMotionListener (MouseMotionListener l) 이 컴퍼넌트로부터 마우스 모션 이벤트를 받기 위해서 지정된 마우스 모션 리스너를 추가합니다.
void	addMouseWheelListener (MouseWheelListener l) 이 컴퍼넌트로부터 마우스 휠 이벤트를 받기 위해서 지정된 마우스 휠 리스너를 추가합니다.
void	addNotify () 네이티브 스크린 자원에 접속해, 이 Component를 표시 가능하게 합니다.
void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChangeListener를 리스너 리스트에 추가합니다.
void	addPropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 리스너 리스트에 PropertyChangeListener를 추가합니다.
void	applyComponentOrientation (ComponentOrientation orientation) 이 컴퍼넌트와 포함되는 모든 컴퍼넌트의 ComponentOrientation 프로퍼티를 설정합니다.
boolean	areFocusTraversalKeysSet (int id) 지정된 포커스 traversal 조작에 대한 포커스 traversal 키세트가 이 컴퍼넌트에 명시적으로 정의되고 있는지를 리턴합니다.
Rectangle	bounds () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getBounds()를 사용합니다.
int	checkImage (Image image, ImageObserver observer) 지정된 이미지의 화면 표시의 구축 상태를 리턴합니다.
int	checkImage (Image image, int width, int height, ImageObserver observer) 지정된 이미지의 화면 표시의 구축 상태를 리턴합니다.
protected AWTEvent	coalesceEvents (AWTEvent existingEvent, AWTEvent newEvent) 필요에 따라서, 송신되는 이벤트와 기존의 이벤트를 합체 시킵니다.
boolean	contains (int x, int y) 이 컴퍼넌트가 지정된 점을 포함하고 있는지를 판정합니다.
boolean	contains (Point p) 이 컴퍼넌트가 지정된 점을 포함하고 있는지를 판정합니다.
Image	createImage (ImageProducer producer) 지정된 이메이지프로듀서로부터 이미지를 생성합니다.
Image	createImage (int width, int height) 더블 버퍼링을 위해서 사용되는 오프 스크린 렌더링 이미지를 생성합니다.
VolatileImage	createVolatileImage (int width, int height) 더블 버퍼링을 위해서 사용되는 휘발성의 오프 스크린 렌더링 이미지를 생성합니다.
VolatileImage	createVolatileImage (int width, int height, ImageCapabilities caps) 지정된 기능을 사용해 휘발성 오프 스크린 렌더링 이미지를 생성합니다.
void	deliverEvent (Event e) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 dispatchEvent(AWTEvent e)를 사용합니다.
void	disable () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.
protected void	disableEvents (long eventsToDisable) 지정된 이벤트 마스크 파라미터에 의해 정의된 이벤트에 대해, 이 컴퍼넌트에의 송신을 불가능하게 합니다.
void	dispatchEvent (AWTEvent e) 이 컴퍼넌트 또는 그 서브 컴퍼넌트의 1개에 이벤트를 디스패치 합니다.
void	doLayout () 레이아웃 매니저에 이 컴퍼넌트의 배치를 재촉합니다.
void	enable () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.
void	enable (boolean b) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.
protected void	enableEvents (long eventsToEnable) 지정된 이벤트 마스크 파라미터에 의해 정의된 이벤트에 대해, 이 컴퍼넌트에의 송신을 사용 가능하게 합니다.
void	enableInputMethods (boolean enable) 이 컴퍼넌트의 인풋 메서드 지원를 사용 가능 또는 사용 불가능하게 합니다.
protected void	firePropertyChange (String propertyName, boolean oldValue, boolean newValue) boolean 형 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다.
void	firePropertyChange (String propertyName, byte oldValue, byte newValue) 바운드 프로퍼티의 변경을 통지합니다.
void	firePropertyChange (String propertyName, char oldValue, char newValue) 바운드 프로퍼티의 변경을 통지합니다.
void	firePropertyChange (String propertyName, double oldValue, double newValue) 바운드 프로퍼티의 변경을 통지합니다.
void	firePropertyChange (String propertyName, float oldValue, float newValue) 바운드 프로퍼티의 변경을 통지합니다.
protected void	firePropertyChange (String propertyName, int oldValue, int newValue) 정수형 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다.
void	firePropertyChange (String propertyName, long oldValue, long newValue) 바운드 프로퍼티의 변경을 통지합니다.
protected void	firePropertyChange (String propertyName, Object oldValue, Object newValue) 객체 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다.
void	firePropertyChange (String propertyName, short oldValue, short newValue) 바운드 프로퍼티의 변경을 통지합니다.
AccessibleContext	getAccessibleContext () 이 Component에 관련된 AccessibleContext를 리턴합니다.
float	getAlignmentX () x 축방향의 배치를 리턴합니다.
float	getAlignmentY () y 축방향의 배치를 리턴합니다.
Color	getBackground () 이 컴퍼넌트의 백그라운드 컬러를 리턴합니다.
Rectangle	getBounds () 이 컴퍼넌트의 경계를 Rectangle 객체로서 리턴합니다.
Rectangle	getBounds (Rectangle rv) 이 컴퍼넌트의 경계를 「반환값」rv에 포함해, rv를 리턴합니다.
ColorModel	getColorModel () 컴퍼넌트를 출력 디바이스에 표시하는데 사용되는 ColorModel 인스턴스를 리턴합니다.
Component	getComponentAt (int x, int y) 이 컴퍼넌트 또는 그 직접적인 서브 컴퍼넌트가 위치 (x, y)를 포함하고 있는지를 판정합니다.
Component	getComponentAt (Point p) 지정된 점을 포함한 컴퍼넌트 또는 서브 컴퍼넌트를 리턴합니다.
ComponentListener []	getComponentListeners () 이 컴퍼넌트에 등록되어 모든 컴퍼넌트 리스너의 배열을 리턴합니다.
ComponentOrientation	getComponentOrientation () 이 컴퍼넌트내의 요소 또는 텍스트를 정렬하기 위해서 사용한다, 언어에 존할 방향을 취득합니다.
Cursor	getCursor () 컴퍼넌트의 커서 세트를 리턴합니다.
DropTarget	getDropTarget () 이 Component에 관련된 DropTarget을 리턴합니다.
Container	getFocusCycleRootAncestor () 이 컴퍼넌트의 포커스 traversal 사이클의 포커스 사이클 루트인 컨테이너를 리턴합니다.
FocusListener []	getFocusListeners () 이 컴퍼넌트에 등록되어 모든 포커스 리스너의 배열을 리턴합니다.
Set <AWTKeyStroke >	getFocusTraversalKeys (int id) 이 컴퍼넌트의 지정된 traversal 조작의 포커스 traversal 키세트를 리턴합니다.
boolean	getFocusTraversalKeysEnabled () 이 컴퍼넌트에 대해서 포커스 traversal 키를 사용할 수 있을지 어떨지를 리턴합니다.
Font	getFont () 이 컴퍼넌트의 폰트를 리턴합니다.
FontMetrics	getFontMetrics (Font font) 지정된 폰트의 폰트 시학을 리턴합니다.
Color	getForeground () 이 컴퍼넌트의 foreground 컬러를 리턴합니다.
Graphics	getGraphics () 이 컴퍼넌트의 그래픽 컨텍스트를 작성합니다.
GraphicsConfiguration	getGraphicsConfiguration () 이 Component에 관련된 GraphicsConfiguration을 리턴합니다.
int	getHeight () 이 컴퍼넌트의 현재의 높이를 리턴합니다.
HierarchyBoundsListener []	getHierarchyBoundsListeners () 이 컴퍼넌트에 등록되어 모든 계층 변경 리스너의 배열을 리턴합니다.
HierarchyListener []	getHierarchyListeners () 이 컴퍼넌트에 등록되어 모든 계층 리스너의 배열을 리턴합니다.
boolean	getIgnoreRepaint ()
InputContext	getInputContext () 텍스트가 이 컴퍼넌트에 입력되었을 때에 인풋 메서드와의 통신을 처리하기 위해서 이 컴퍼넌트에 의해 사용되는 입력 컨텍스트를 리턴합니다.
InputMethodListener []	getInputMethodListeners () 이 컴퍼넌트에 등록되어 모든 인풋 메서드 리스너의 배열을 리턴합니다.
InputMethodRequests	getInputMethodRequests () 이 컴퍼넌트의 인풋 메서드로부터의 요구를 지원하는 인풋 메서드 요구 핸들러를 리턴합니다.
KeyListener []	getKeyListeners () 이 컴퍼넌트에 등록되어 모든 키 리스너의 배열을 리턴합니다.
<T extends EventListener > T[]	getListeners (Class <T> listenerType) 이 Component에 FooListener로 서 현재 등록되어 모든 객체의 배열을 리턴합니다.
Locale	getLocale () 이 컴퍼넌트의 로케일을 리턴합니다.
Point	getLocation () 이 컴퍼넌트의 위치를, 컴퍼넌트의 좌상구석의 점을 지정해 리턴합니다.
Point	getLocation (Point rv) 이 컴퍼넌트의 경계를 「반환값」rv에 포함해, rv를 리턴합니다.
Point	getLocationOnScreen () 이 컴퍼넌트의 위치를, 화면의 좌표 공간에서의 컴퍼넌트의 좌상구석의 점을 지정해 리턴합니다.
Dimension	getMaximumSize () 이 컴퍼넌트의 최대 사이즈를 리턴합니다.
Dimension	getMinimumSize () 이 컴퍼넌트의 최소 사이즈를 리턴합니다.
MouseListener []	getMouseListeners () 이 컴퍼넌트에 등록되어 모든 마우스 리스너의 배열을 리턴합니다.
MouseMotionListener []	getMouseMotionListeners () 이 컴퍼넌트에 등록되어 모든 마우스 모션 리스너의 배열을 리턴합니다.
Point	getMousePosition () Component이 마우스 포인터의 직하에 있는 경우, 이 Component 좌표 공간의 마우스 포인터의 위치를 리턴합니다.
MouseWheelListener []	getMouseWheelListeners () 이 컴퍼넌트에 등록되어 모든 마우스 휠 리스너의 배열을 리턴합니다.
String	getName () 컴퍼넌트의 이름을 리턴합니다.
Container	getParent () 이 컴퍼넌트의 부모를 리턴합니다.
java.awt.peer.ComponentPeer	getPeer () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 프로그램은 직접 피어를 조작할 수 없습니다. boolean isDisplayable()를 사용합니다.
Dimension	getPreferredSize () 이 컴퍼넌트의 추천 사이즈를 리턴합니다.
PropertyChangeListener []	getPropertyChangeListeners () 이 컴퍼넌트에 등록되어 모든 프로퍼티 변경 리스너의 배열을 리턴합니다.
PropertyChangeListener []	getPropertyChangeListeners (String propertyName) 지정된 프로퍼티에 관련된 모든 리스너의 배열을 리턴합니다.
Dimension	getSize () 이 컴퍼넌트의 사이즈를, Dimension 객체로서 리턴합니다.
Dimension	getSize (Dimension rv) 이 컴퍼넌트의 경계를 「반환값」rv에 포함해, rv를 리턴합니다.
Toolkit	getToolkit () 이 컴퍼넌트의 툴 킷을 리턴합니다.
Object	getTreeLock () AWT 컴퍼넌트 트리 및 배치 조작에 대한, 이 컴퍼넌트의 락 객체 (thread 동기화 모니터를 소유하는 객체)를 취득합니다.
int	getWidth () 이 컴퍼넌트의 현재의 넓이를 리턴합니다.
int	getX () 컴퍼넌트의 원점의 현재의 x 좌표를 리턴합니다.
int	getY () 컴퍼넌트의 원점의 현재의 y 좌표를 리턴합니다.
boolean	gotFocus (Event evt, Object what) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processFocusEvent(FocusEvent)를 사용합니다.
boolean	handleEvent (Event evt) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processEvent(AWTEvent)를 사용합니다.
boolean	hasFocus () 이 Component이 포커스 소유자의 경우에 true를 리턴합니다.
void	hide () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setVisible(boolean)를 사용합니다.
boolean	imageUpdate (Image img, int infoflags, int x, int y, int w, int h) 이미지가 변경되었을 때에 컴퍼넌트를 다시 페인트 합니다.
boolean	inside (int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 contains(int, int)를 사용합니다.
void	invalidate () 컴퍼넌트를 무효로 합니다.
boolean	isBackgroundSet () 백그라운드 컬러가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다.
boolean	isCursorSet () 커서가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다.
boolean	isDisplayable () 이 컴퍼넌트가 표시 가능한가 어떤가를 판정합니다.
boolean	isDoubleBuffered () 이 컴퍼넌트가 나중에 화면에 카피되는 오프 스크린 이미지 (버퍼)에 페인트 되는 경우에 true를 리턴합니다.
boolean	isEnabled () 이 컴퍼넌트가 사용 가능한지 어떤지를 판정합니다.
boolean	isFocusable () 이 컴퍼넌트에 포커스가 설정 가능한가 어떤가를 리턴합니다.
boolean	isFocusCycleRoot (Container container) 지정된 컨테이너가 이 컴퍼넌트의 포커스 traversal 사이클의 포커스 사이클 루트일지 어떨지를 리턴합니다.
boolean	isFocusOwner () 이 Component이 포커스 소유자의 경우는 true를 리턴합니다.
boolean	isFocusTraversable () 추천하지 않습니다. JDK 버전 1.4 그 뒤로는 isFocusable()를 사용합니다.
boolean	isFontSet () 폰트가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다.
boolean	isForegroundSet () foreground 컬러가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다.
boolean	isLightweight () 경량 컴퍼넌트는 네이티브인 툴 킷의 피어를 가지지 않습니다.
boolean	isMaximumSizeSet () 최대 사이즈가 null 이외의 값으로 설정되어 있는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.
boolean	isMinimumSizeSet () null 이외의 값으로 setMinimumSize를 호출하고 있는지를 리턴합니다.
boolean	isOpaque () 이 컴퍼넌트가 완전하게 불투명한 경우에 true를 리턴합니다.
boolean	isPreferredSizeSet () 적절한 사이즈가 null 이외의 값으로 설정되어 있는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.
boolean	isShowing () 이 컴퍼넌트가 화면에 표시되고 있는지를 판정합니다.
boolean	isValid () 이 컴퍼넌트가 유효한지 어떤지를 판정합니다.
boolean	isVisible () 부모가 가시가 되었을 때에 이 컴퍼넌트가 가시가 될지 어떨지를 판정합니다.
boolean	keyDown (Event evt, int key) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processKeyEvent(KeyEvent)를 사용합니다.
boolean	keyUp (Event evt, int key) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processKeyEvent(KeyEvent)를 사용합니다.
void	layout () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 doLayout()를 사용합니다.
void	list () 표준의 시스템 출력 스트림 System.out에 이 컴퍼넌트의 일람을 출력합니다.
void	list (PrintStream out) 지정된 출력 스트림에 이 컴퍼넌트의 일람을 출력합니다.
void	list (PrintStream out, int indent) 지정된 인덴트 위치로부터, 지정된 출력 스트림에 일람을 출력합니다.
void	list (PrintWriter out) 지정된 프린트 Writer에 일람을 출력합니다.
void	list (PrintWriter out, int indent) 지정된 인덴트 위치로부터 개시해, 지정된 프린트 Writer에 리스트를 출력합니다.
Component	locate (int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getComponentAt(int, int)를 사용합니다.
Point	location () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getLocation()를 사용합니다.
boolean	lostFocus (Event evt, Object what) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processFocusEvent(FocusEvent)를 사용합니다.
Dimension	minimumSize () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getMinimumSize()를 사용합니다.
boolean	mouseDown (Event evt, int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.
boolean	mouseDrag (Event evt, int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseMotionEvent(MouseEvent)를 사용합니다.
boolean	mouseEnter (Event evt, int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.
boolean	mouseExit (Event evt, int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.
boolean	mouseMove (Event evt, int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseMotionEvent(MouseEvent)를 사용합니다.
boolean	mouseUp (Event evt, int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.
void	move (int x, int y) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setLocation(int, int)를 사용합니다.
void	nextFocus () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 transferFocus()를 사용합니다.
void	paint (Graphics g) 이 컴퍼넌트를 페인트 합니다.
void	paintAll (Graphics g) 이 컴퍼넌트 및 그 모든 서브 컴퍼넌트를 페인트 합니다.
protected String	paramString () 이 컴퍼넌트 상태를 나타내는 캐릭터 라인을 리턴합니다.
boolean	postEvent (Event e) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 dispatchEvent(AWTEvent e)를 사용합니다.
Dimension	preferredSize () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getPreferredSize()를 사용합니다.
boolean	prepareImage (Image image, ImageObserver observer) 이 컴퍼넌트상에 렌더링하기 위한 이미지를 준비합니다.
boolean	prepareImage (Image image, int width, int height, ImageObserver observer) 이 컴퍼넌트상에 표시하기 위한, 지정된 폭과 높이의 이미지를 준비합니다.
void	print (Graphics g) 이 컴퍼넌트를 출력합니다.
void	printAll (Graphics g) 이 컴퍼넌트 및 그 모든 서브 컴퍼넌트를 출력합니다.
protected void	processComponentEvent (ComponentEvent e) 이 컴퍼넌트로 발생하는 컴퍼넌트 이벤트를, 등록되어 있는 ComponentListener 객체에 디스패치 하는 것으로써, 컴퍼넌트 이벤트를 처리합니다.
protected void	processEvent (AWTEvent e) 이 컴퍼넌트로 발생하는 이벤트를 처리합니다.
protected void	processFocusEvent (FocusEvent e) 이 컴퍼넌트로 발생하는 포커스 이벤트를, 등록되어 모든 FocusListener 객체에 디스패치 하는 것으로써 처리합니다.
protected void	processHierarchyBoundsEvent (HierarchyEvent e) 이 컴퍼넌트로 발생하는 계층 변경 이벤트를, 등록된 HierarchyBoundsListener 객체에 디스패치 하는 것에 의해 처리합니다.
protected void	processHierarchyEvent (HierarchyEvent e) 이 컴퍼넌트로 발생하는 계층 이벤트를, 등록된 HierarchyListener 객체에 디스패치 하는 것으로써, 계층 이벤트를 처리합니다.
protected void	processInputMethodEvent (InputMethodEvent e) 이 컴퍼넌트로 발생하는 인풋 메서드 이벤트를, 등록되어 모든 InputMethodListener 객체에 디스패치 하는 것에 의해 처리합니다.
protected void	processKeyEvent (KeyEvent e) 이 컴퍼넌트로 발생하는 키 이벤트를, 등록되어 모든 KeyListener 객체에 디스패치 하는 것으로써, 키 이벤트를 처리합니다.
protected void	processMouseEvent (MouseEvent e) 이 컴퍼넌트로 발생하는 마우스 이벤트를, 등록되어 모든 MouseListener 객체에 디스패치 하는 것으로써, 마우스 이벤트를 처리합니다.
protected void	processMouseMotionEvent (MouseEvent e) 이 컴퍼넌트로 발생하는 마우스 모션 이벤트를, 등록되어 모든 MouseMotionListener 객체에 디스패치 하는 것에 의해 처리합니다.
protected void	processMouseWheelEvent (MouseWheelEvent e) 이 컴퍼넌트로 발생하는 마우스 휠 이벤트를, 등록되어 모든 MouseWheelListener 객체에 디스패치 하는 것에 의해 처리합니다.
void	remove (MenuComponent popup) 지정된 pop-up menu를 컴퍼넌트로부터 삭제합니다.
void	removeComponentListener (ComponentListener l) 이 컴퍼넌트로부터 컴퍼넌트 이벤트를 받지 않게, 지정된 컴퍼넌트 리스너를 삭제합니다.
void	removeFocusListener (FocusListener l) 이 컴퍼넌트로부터 포커스 이벤트를 받지 않게, 지정된 포커스 리스너를 삭제합니다.
void	removeHierarchyBoundsListener (HierarchyBoundsListener l) 이 컴퍼넌트로부터 계층 변경 이벤트를 받지 않게, 지정된 계층 변경 리스너를 삭제합니다.
void	removeHierarchyListener (HierarchyListener l) 이 컴퍼넌트로부터 계층 변경 이벤트를 받지 않게, 지정된 계층 리스너를 삭제합니다.
void	removeInputMethodListener (InputMethodListener l) 이 컴퍼넌트로부터 인풋 메서드 이벤트를 받지 않게, 지정된 인풋 메서드 리스너를 삭제합니다.
void	removeKeyListener (KeyListener l) 이 컴퍼넌트로부터 키 이벤트를 받지 않게, 지정된 키 리스너를 삭제합니다.
void	removeMouseListener (MouseListener l) 이 컴퍼넌트로부터 마우스 이벤트를 받지 않게, 지정된 마우스 리스너를 삭제합니다.
void	removeMouseMotionListener (MouseMotionListener l) 이 컴퍼넌트로부터 마우스 모션 이벤트를 받지 않게, 지정된 마우스 모션 리스너를 삭제합니다.
void	removeMouseWheelListener (MouseWheelListener l) 이 컴퍼넌트로부터 마우스 휠 이벤트를 받지 않게, 지정된 마우스 휠 리스너를 삭제합니다.
void	removeNotify () 네이티브 스크린 자원을 파기해, 이 Component를 비표시로 합니다.
void	removePropertyChangeListener (PropertyChangeListener listener) 리스너 리스트로부터 PropertyChangeListener를 삭제합니다.
void	removePropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 리스너 리스트로부터 PropertyChangeListener를 삭제합니다.
void	repaint () 이 컴퍼넌트를 다시 페인트 합니다.
void	repaint (int x, int y, int width, int height) 이 컴퍼넌트의 지정된 구형 영역을 다시 페인트 합니다.
void	repaint (long tm) 이 컴퍼넌트를 다시 페인트 합니다.
void	repaint (long tm, int x, int y, int width, int height) 이 컴퍼넌트의 지정된 구형 영역을 tm 밀리 세컨드 이내에 다시 페인트 합니다.
void	requestFocus () 이 컴퍼넌트에 입력초점 취득을 요구해, 또 이 컴퍼넌트가 속하는 계층의 최상정도의 컴퍼넌트를 포커스 설정 윈도우로 합니다.
protected boolean	requestFocus (boolean temporary) 이 Component에 입력초점 취득을 요구해, 또 이 Component이 속하는 계층의 최상정도의 컴퍼넌트를 포커스 설정 Window로 합니다.
boolean	requestFocusInWindow () 이 컴퍼넌트가 속하는 계층의 최상정도 컴퍼넌트에 포커스가 설정되어 있는 경우, 컴퍼넌트가 입력초점을 얻는 것을 요구합니다.
protected boolean	requestFocusInWindow (boolean temporary) 이 Component이 속하는 계층의 최상정도 컴퍼넌트에 포커스가 설정되어 있는 경우, Component이 입력초점을 얻는 것을 요구합니다.
void	reshape (int x, int y, int width, int height) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setBounds(int, int, int, int)를 사용합니다.
void	resize (Dimension d) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setSize(Dimension)를 사용합니다.
void	resize (int width, int height) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setSize(int, int)를 사용합니다.
void	setBackground (Color c) 이 컴퍼넌트의 백그라운드 컬러를 설정합니다.
void	setBounds (int x, int y, int width, int height) 이 컴퍼넌트를 이동해, 사이즈 변경합니다.
void	setBounds (Rectangle r) 새로운 경계의 구형 r에 적합하도록 이 컴퍼넌트를 이동해, 사이즈 변경합니다.
void	setComponentOrientation (ComponentOrientation o) 이 컴퍼넌트내의 요소 또는 텍스트를 정렬하기 위해서 사용한다, 언어에 존할 방향을 설정합니다.
void	setCursor (Cursor cursor) 커서 이미지를, 지정된 커서로 설정합니다.
void	setDropTarget (DropTarget dt) DropTarget을 이 컴퍼넌트와 관련짓습니다.
void	setEnabled (boolean b) 파라미터 b값에 응해, 이 컴퍼넌트를 사용 가능 또는 사용 불가능하게 합니다.
void	setFocusable (boolean focusable) 이 컴퍼넌트의 포커스 상태가 지정된 값으로 설정합니다.
void	setFocusTraversalKeys (int id, Set <? extends AWTKeyStroke > keystrokes) 이 컴퍼넌트의 지정된 traversal 조작에 대한 포커스 traversal 키를 설정합니다.
void	setFocusTraversalKeysEnabled (boolean focusTraversalKeysEnabled) 이 컴퍼넌트에 대해서 포커스 traversal 키를 사용할 수 있을지 어떨지를 나타냅니다.
void	setFont (Font f) 이 컴퍼넌트의 폰트를 설정합니다.
void	setForeground (Color c) 이 컴퍼넌트의 foreground 컬러를 설정합니다.
void	setIgnoreRepaint (boolean ignoreRepaint) OS 로부터의, 페인트에 대한 메세지를 무시할지 어떨지를 설정합니다.
void	setLocale (Locale l) 이 컴퍼넌트의 로케일을 설정합니다.
void	setLocation (int x, int y) 이 컴퍼넌트를 새로운 위치로 이동합니다.
void	setLocation (Point p) 이 컴퍼넌트를 새로운 위치로 이동합니다.
void	setMaximumSize (Dimension maximumSize) 이 컴퍼넌트의 최대 사이즈에 정수값을 설정합니다.
void	setMinimumSize (Dimension minimumSize) 이 컴퍼넌트의 최소 사이즈에 정수값을 설정합니다.
void	setName (String name) 컴퍼넌트의 이름을 지정된 캐릭터 라인으로 설정합니다.
void	setPreferredSize (Dimension preferredSize) 이 컴퍼넌트의 추천 사이즈에 정수값을 설정합니다.
void	setSize (Dimension d) 이 컴퍼넌트의 사이즈를,넓이 d.width, 높이 d.height로 변경합니다.
void	setSize (int width, int height) 이 컴퍼넌트의 사이즈를 width 및 height로 변경합니다.
void	setVisible (boolean b) 파라미터 b값에 응해, 이 컴퍼넌트를 표시하는지, 또는 비표시로 합니다.
void	show () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setVisible(boolean)를 사용합니다.
void	show (boolean b) 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setVisible(boolean)를 사용합니다.
Dimension	size () 추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getSize()를 사용합니다.
String	toString () 이 컴퍼넌트 및 그 값의 캐릭터 라인 표현을 리턴합니다.
void	transferFocus () 이 컴퍼넌트가 포커스 소유자인것 같이, 포커스를 다음의 컴퍼넌트에 전송 합니다.
void	transferFocusBackward () 이 컴퍼넌트가 포커스 소유자인것 같이, 포커스를 전의 컴퍼넌트에 전송 합니다.
void	transferFocusUpCycle () 포커스를 1 포커스 traversal 사이클만 상위로 이동합니다.
void	update (Graphics g) 이 컴퍼넌트를 갱신합니다.
void	validate () 컴퍼넌트가 유효한 배치인 것을 확인합니다.

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

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

필드의 상세

TOP_ALIGNMENT

public static final float TOP_ALIGNMENT

getAlignmentY()용의 편리한 정수입니다. 컴퍼넌트 위에의 배치를 지정합니다.

관련 항목:

getAlignmentY(), 정수 필드값

CENTER_ALIGNMENT

public static final float CENTER_ALIGNMENT

getAlignmentY 및 getAlignmentX용의 편리한 정수입니다. 컴퍼넌트의 중앙에의 배치를 지정합니다.

관련 항목:

getAlignmentX(), getAlignmentY(), 정수 필드값

BOTTOM_ALIGNMENT

public static final float BOTTOM_ALIGNMENT

getAlignmentY용의 편리한 정수입니다. 컴퍼넌트아래에의 배치를 지정합니다.

관련 항목:

getAlignmentY(), 정수 필드값

LEFT_ALIGNMENT

public static final float LEFT_ALIGNMENT

getAlignmentX용의 편리한 정수입니다. 컴퍼넌트의 좌측에의 배치를 지정합니다.

관련 항목:

getAlignmentX(), 정수 필드값

RIGHT_ALIGNMENT

public static final float RIGHT_ALIGNMENT

getAlignmentX용의 편리한 정수입니다. 컴퍼넌트의 우측에의 배치를 지정합니다.

관련 항목:

getAlignmentX(), 정수 필드값

생성자 상세

Component

protected Component()

컴퍼넌트를 새롭게 구축합니다. Component 클래스는 불투명한 네이티브의 윈도우를 사용하지 않는 경량 컴퍼넌트를 작성하기 위해서 직접 확장할 수 있습니다 . 경량 컴퍼넌트는 컴퍼넌트 트리의 상위의 어디선가 네이티브인 컨테이너 (Frame 객체등)에 의해 수용될 필요가 있습니다.

메서드의 상세

getName

public String  getName()

컴퍼넌트의 이름을 리턴합니다.

반환값:

이 컴퍼넌트의 이름

도입된 버전 :

JDK1. 1

관련 항목:

setName(java.lang.String)

setName

public void setName(String  name)

컴퍼넌트의 이름을 지정된 캐릭터 라인으로 설정합니다.

파라미터:

name - 이 컴퍼넌트의 이름으로 하는 캐릭터 라인

도입된 버전 :

JDK1. 1

관련 항목:

getName()

getParent

public Container  getParent()

이 컴퍼넌트의 부모를 리턴합니다.

반환값:

이 컴퍼넌트의 친컨테이너

도입된 버전 :

JDK1. 0

getPeer

@Deprecated 
public java.awt.peer.ComponentPeer getPeer()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 프로그램은 직접 피어를 조작할 수 없습니다. boolean isDisplayable()를 사용합니다.

setDropTarget

public void setDropTarget(DropTarget  dt)

DropTarget을 이 컴퍼넌트와 관련짓습니다. Component는 사용 가능한 경우에 한해 드롭을 받습니다.

파라미터:

dt - DropTarget

관련 항목:

isEnabled()

getDropTarget

public DropTarget  getDropTarget()

이 Component에 관련된 DropTarget을 리턴합니다.

getGraphicsConfiguration

public GraphicsConfiguration  getGraphicsConfiguration()

이 Component에 관련된 GraphicsConfiguration을 리턴합니다. Component이 특정의 GraphicsConfiguration에 할당할 수 있지 않은 경우, Component 객체의 최상정도 컨테이너인 GraphicsConfiguration가 리턴됩니다 . Container에 아직 추가되어 있지 않지만, Component이 생성되고 있는 경우, 이 메서드는 null을 리턴합니다.

반환값:

Component이 사용하는 GraphicsConfiguration, 또는 null

도입된 버전 :

1.3

getTreeLock

public final Object  getTreeLock()

AWT 컴퍼넌트 트리 및 배치 조작에 대한, 이 컴퍼넌트의 락 객체 (thread 동기화 모니터를 소유하는 객체)를 취득합니다.

반환값:

이 컴퍼넌트의 락 객체

getToolkit

public Toolkit  getToolkit()

이 컴퍼넌트의 툴 킷을 리턴합니다. 컴퍼넌트를 포함하는 프레임은 어느 툴 킷이 그 컴퍼넌트에 의해 사용되는지를 제어합니다. 그 때문에 컴퍼넌트가 1개의 프레임으로부터 다른 프레임으로 이동했을 경우, 사용하는 툴 킷이 변경되는 일도 있습니다.

반환값:

이 컴퍼넌트의 툴 킷

도입된 버전 :

JDK1. 0

isValid

public boolean isValid()

이 컴퍼넌트가 유효한지 어떤지를 판정합니다. 컴퍼넌트는 적절한 사이즈로 부모중에 배치되고 있어 모든 자식이 유효한 경우에 유효라고 보여집니다. 피어의 사이즈 요건을 고려하기 위해, 컴퍼넌트는 화면에 최초로 표시될 때까지 무효로 됩니다. 친컨테이너가 완전하게 실현된 시점에서 그 모든 컴퍼넌트는 유효하게 됩니다.

반환값:

컴퍼넌트가 유효한 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

관련 항목:

validate(), invalidate()

isDisplayable

public boolean isDisplayable()

이 컴퍼넌트가 표시 가능한가 어떤가를 판정합니다. 컴퍼넌트는 네이티브 스크린 자원에 접속되고 있는 경우에 표시 가능하게 됩니다.

컴퍼넌트가 표시 가능하게 되는 것은 포함 관계의 계층에 추가되었을 때, 혹은 포함 관계의 계층이 표시 가능하게 되었을 때입니다. 포함 관계의 계층은 게다가 위의 윈도우가 팩 되는지, 가시가 된다고 표시 가능하게 됩니다.

컴퍼넌트가 표시 불가가 되는 것은 표시 가능한 포함 관계의 계층으로부터 삭제되었을 때, 혹은 포함 관계의 계층이 표시 불가가 되었을 때입니다. 포함 관계의 계층은 상위의 윈도우가 파기된다고 표시 불가가 됩니다.

반환값:

컴퍼넌트가 표시 가능한 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.2

관련 항목:

Container.add(Component), Window.pack(), Window.show(), Container.remove(Component), Window.dispose()

isVisible

public boolean isVisible()

부모가 가시가 되었을 때에 이 컴퍼넌트가 가시가 될지 어떨지를 판정합니다. 초기 상태에서는 컴퍼넌트는 가시입니다만, Frame 객체등의 톱 레벨 컴퍼넌트의 경우는 예외입니다.

반환값:

컴퍼넌트가 가시의 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

관련 항목:

setVisible(boolean)

getMousePosition

public Point  getMousePosition()
                       throws HeadlessException 

Component이 마우스 포인터의 직하에 있는 경우, 이 Component 좌표 공간의 마우스 포인터의 위치를 리턴합니다. 그렇지 않은 경우는 null을 리턴합니다. Component이 화면에 표시되어 있지 않은 경우는 Component이 표시되고 있는 영역 위에 마우스 포인터가 있는 경우에서도, 이 메서드는 null을 리턴합니다. 다른 Component 나 네이티브 윈도우에 의해 Component이 부분적 또는 완전하게 숨겨지고 있는 경우, 이 메서드는 마우스 포인터가 Component이 숨겨지지 않은 부분 위에 있는 경우에게만, null 이외의 값을 리턴합니다.

Container인 경우, 이 메서드는 마우스 포인터가 Container 자체 위 또는 그 하위 객체 위에 있는 경우, null 이외의 값을 리턴합니다. 자식을 제외할 필요가 있는 경우는 Container.getMousePosition(boolean)를 사용합니다.

정확한 마우스 좌표는 중요하지 않고, 특정의 Component이 마우스 포인터아래에 있을지 어떨지만이 중요한 경우도 있습니다. 이 메서드의 반환값이 null인 경우, 마우스 포인터는 Component 바로 위에 없습니다.

반환값:

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

예외:

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

도입된 버전 :

1.5

관련 항목:

isShowing(), Container.getMousePosition(boolean)

isShowing

public boolean isShowing()

이 컴퍼넌트가 화면에 표시되고 있는지를 판정합니다. 컴퍼넌트가 가시이며, 가시로 표시되는 컨테이너내에 있을 필요가 있습니다.

반환값:

컴퍼넌트가 표시되고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

관련 항목:

setVisible(boolean)

isEnabled

public boolean isEnabled()

이 컴퍼넌트가 사용 가능한지 어떤지를 판정합니다. 사용 가능한 컴퍼넌트는 사용자 입력에 응답하거나 이벤트를 생성하거나 할 수 있습니다 . 디폴트에서는 컴퍼넌트는 초기 상태로 사용 가능하게 됩니다. setEnabled 메서드를 호출하는 것에의해 컴퍼넌트는 사용 가능 또는 사용 불가능하게 할 수 있습니다 .

반환값:

컴퍼넌트가 사용 가능한 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

관련 항목:

setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)

파라미터 b값에 응해, 이 컴퍼넌트를 사용 가능 또는 사용 불가능하게 합니다. 사용 가능한 컴퍼넌트는 사용자 입력에 응답하거나 이벤트를 생성하거나 할 수 있습니다 . 디폴트에서는 컴퍼넌트는 초기 상태로 사용 가능하게 됩니다.

경량화 컴퍼넌트를 사용 불가능하게 해도 MouseEvent는 수신되는 것에 주의해 주세요.

파라미터:

b - true인 경우는 이 컴퍼넌트를 사용 가능, 그렇지 않은 경우는 이 컴퍼넌트는 사용 불가능

도입된 버전 :

JDK1. 1

관련 항목:

isEnabled(), isLightweight()

enable

@Deprecated 
public void enable()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.

enable

@Deprecated 
public void enable(boolean b)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.

disable

@Deprecated 
public void disable()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setEnabled(boolean)를 사용합니다.

isDoubleBuffered

public boolean isDoubleBuffered()

이 컴퍼넌트가 나중에 화면에 카피되는 오프 스크린 이미지 (버퍼)에 페인트 되는 경우에 true를 리턴합니다. 더블 버퍼링이 사용 가능한 경우, 더블 버퍼링을 지원하는 컴퍼넌트 서브 클래스는 true를 돌려주도록 이 메서드를 오버라이드(override) 할 필요가 있습니다.

반환값:

디폴트에서는 false

enableInputMethods

public void enableInputMethods(boolean enable)

이 컴퍼넌트의 인풋 메서드 지원를 사용 가능 또는 사용 불가능하게 합니다. 인풋 메서드 지원가 사용 가능해, 컴퍼넌트가 키 이벤트도 처리하는 경우, 입력 이벤트는 현재의 인풋 메서드에 제공되어 그 컴퍼넌트 에 해서만 처리되는지, 인풋 메서드가 사용하지 않으면, 그 리스너에게 보내집니다. 디폴트에서는 인풋 메서드 지원은 사용 가능합니다.

파라미터:

enable - 사용 가능하게 하려면 true, 사용 불가능하게 하려면 false

도입된 버전 :

1.2

관련 항목:

processKeyEvent(java.awt.event.KeyEvent)

setVisible

public void setVisible(boolean b)

파라미터 b값에 응해, 이 컴퍼넌트를 표시하는지, 또는 비표시로 합니다.

파라미터:

b - true인 경우 이 컴퍼넌트를 표시해, 그렇지 않은 경우는 이 컴퍼넌트를 숨기는

도입된 버전 :

JDK1. 1

관련 항목:

isVisible()

show

@Deprecated 
public void show()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setVisible(boolean)를 사용합니다.

show

@Deprecated 
public void show(boolean b)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setVisible(boolean)를 사용합니다.

hide

@Deprecated 
public void hide()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setVisible(boolean)를 사용합니다.

getForeground

public Color  getForeground()

이 컴퍼넌트의 foreground 컬러를 리턴합니다.

반환값:

이 컴퍼넌트의 foreground 컬러. 이 컴퍼넌트에 foreground 컬러가 없는 경우는 부모의 foreground 컬러가 리턴된

도입된 버전 :

JDK1. 0

관련 항목:

setForeground(java.awt.Color)

setForeground

public void setForeground(Color  c)

이 컴퍼넌트의 foreground 컬러를 설정합니다.

파라미터:

c - 이 컴퍼넌트의 foreground 컬러가 되는 색. 이 파라미터가 null인 경우, 이 컴퍼넌트는 부모의 foreground 컬러를 상속하는

도입된 버전 :

JDK1. 0

관련 항목:

getForeground()

isForegroundSet

public boolean isForegroundSet()

foreground 컬러가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다. false를 돌려주는 경우, 이 컴퍼넌트는 상위의 컴퍼넌트로부터 foreground 컬러를 상속합니다.

반환값:

이 컴퍼넌트에 foreground 컬러가 명시적으로 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

getBackground

public Color  getBackground()

이 컴퍼넌트의 백그라운드 컬러를 리턴합니다.

반환값:

이 컴퍼넌트의 백그라운드 컬러. 이 컴퍼넌트에 백그라운드 컬러가 없는 경우는 부모의 foreground 컬러가 리턴된

도입된 버전 :

JDK1. 0

관련 항목:

setBackground(java.awt.Color)

setBackground

public void setBackground(Color  c)

이 컴퍼넌트의 백그라운드 컬러를 설정합니다.

백그라운드 컬러가 각 컴퍼넌트에 각각 다른 영향을 줍니다. 또 컴퍼넌트의 어느 부분에 영향을 줄까는 OS에 따라서 다릅니다.

파라미터:

c - 이 컴퍼넌트의 백그라운드 컬러가 되는 색. 이 파라미터가 null인 경우, 이 컴퍼넌트는 부모의 백그라운드 컬러를 상속하는

도입된 버전 :

JDK1. 0

관련 항목:

getBackground()

isBackgroundSet

public boolean isBackgroundSet()

백그라운드 컬러가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다. false를 돌려주는 경우, 이 컴퍼넌트는 상위의 컴퍼넌트로부터 백그라운드 컬러를 상속합니다.

반환값:

이 컴퍼넌트에 백그라운드 컬러가 명시적으로 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

getFont

public Font  getFont()

이 컴퍼넌트의 폰트를 리턴합니다.

정의:

인터페이스 MenuContainer 내의 getFont

반환값:

이 컴퍼넌트의 폰트. 이 컴퍼넌트에 폰트가 설정되어 있지 않은 경우는 부모의 폰트가 리턴된

도입된 버전 :

JDK1. 0

관련 항목:

setFont(java.awt.Font)

setFont

public void setFont(Font  f)

이 컴퍼넌트의 폰트를 설정합니다.

파라미터:

f - 이 컴퍼넌트로 설정하는 폰트. 이 파라미터가 null인 경우, 이 컴퍼넌트는 부모의 폰트를 상속하는

도입된 버전 :

JDK1. 0

관련 항목:

getFont()

isFontSet

public boolean isFontSet()

폰트가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다. false를 돌려주는 경우, 이 컴퍼넌트는 상위의 컴퍼넌트로부터 폰트를 상속합니다.

반환값:

폰트가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

getLocale

public Locale  getLocale()

이 컴퍼넌트의 로케일을 리턴합니다.

반환값:

이 컴퍼넌트의 로케일. 이 컴퍼넌트가 로케일을 가지지 않는 경우, 그 부모의 로케일이 리턴된다

예외:

IllegalComponentStateException - Component이 독자적인 로케일을 가지지 않고, 포함하고 있는 부모로부터 로케일을 판정할 수 있는 포함 관계의 계층에 아직 추가되어 있지 않은 경우

도입된 버전 :

JDK1. 1

관련 항목:

setLocale(java.util.Locale)

setLocale

public void setLocale(Locale  l)

이 컴퍼넌트의 로케일을 설정합니다. 이것은 바운드 프로퍼티입니다.

파라미터:

l - 이 컴퍼넌트로 설정하는 로케일

도입된 버전 :

JDK1. 1

관련 항목:

getLocale()

getColorModel

public ColorModel  getColorModel()

컴퍼넌트를 출력 디바이스에 표시하는데 사용되는 ColorModel 인스턴스를 리턴합니다.

반환값:

이 컴퍼넌트가 사용하는 컬러 모델

도입된 버전 :

JDK1. 0

관련 항목:

ColorModel, ComponentPeer.getColorModel(), Toolkit.getColorModel()

getLocation

public Point  getLocation()

이 컴퍼넌트의 위치를, 컴퍼넌트의 좌상구석의 점을 지정해 리턴합니다. 위치는 부모의 좌표 공간에 대한 상대 위치입니다.

네이티브 이벤트 처리는 본질적으로 비동기이므로 이 메서드는 갱신되어 있지 않은 값을 돌려주는 일이 있습니다 (예를 들어 연달아 setLocation() 호출이 있던 뒤 등). 이 때문에 컴퍼넌트의 위치를 취득하려면, java.awt.event.ComponentListener.componentMoved()에 있는 OS가 컴퍼넌트의 이동을 완료한 뒤에 호출되는 메서드의 사용을 추천합니다.

반환값:

컴퍼넌트의 부모의 좌표 공간에서의 컴퍼넌트의 경계의 좌상구석을 나타내는 Point 인스턴스

도입된 버전 :

JDK1. 1

관련 항목:

setLocation(int, int), getLocationOnScreen()

getLocationOnScreen

public Point  getLocationOnScreen()

이 컴퍼넌트의 위치를, 화면의 좌표 공간에서의 컴퍼넌트의 좌상구석의 점을 지정해 리턴합니다.

반환값:

화면의 좌표 공간에서의 컴퍼넌트의 경계의 좌상구석을 나타내는 Point 인스턴스

예외:

IllegalComponentStateException - 컴퍼넌트가 화면에 표시되어 있지 않은 경우

관련 항목:

setLocation(int, int), getLocation()

location

@Deprecated 
public Point  location()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getLocation()를 사용합니다.

setLocation

public void setLocation(int x,
                        int y)

이 컴퍼넌트를 새로운 위치로 이동합니다. 새로운 위치의 좌상구석은 이 컴퍼넌트의 부모의 좌표 공간의 x 파라미터 및 y 파라미터에 의해 지정됩니다.

파라미터:

x - 부모의 좌표 공간에서의 새로운 위치의 좌상구석의 x 좌표

y - 부모의 좌표 공간에서의 새로운 위치의 좌상구석의 y 좌표

도입된 버전 :

JDK1. 1

관련 항목:

getLocation(), setBounds(int, int, int, int)

move

@Deprecated 
public void move(int x,
                            int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setLocation(int, int)를 사용합니다.

setLocation

public void setLocation(Point  p)

이 컴퍼넌트를 새로운 위치로 이동합니다. 새로운 위치의 좌상구석은 점 p에 의해 지정됩니다. 점 p는 부모의 좌표 공간에서 지정됩니다.

파라미터:

p - 이 컴퍼넌트의 부모의 좌표 공간에서 지정되는 새로운 위치의 좌상구석을 정의하는 점

도입된 버전 :

JDK1. 1

관련 항목:

getLocation(), setBounds(int, int, int, int)

getSize

public Dimension  getSize()

이 컴퍼넌트의 사이즈를, Dimension 객체로서 리턴합니다. Dimension 객체의 height 필드는 이 컴퍼넌트의 높이를 포함해, Dimension 객체의 width 필드는 이 컴퍼넌트의 넓이를 포함합니다.

반환값:

이 컴퍼넌트의 사이즈를 나타내는 Dimension 객체

도입된 버전 :

JDK1. 1

관련 항목:

setSize(int, int)

size

@Deprecated 
public Dimension  size()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getSize()를 사용합니다.

setSize

public void setSize(int width,
                    int height)

이 컴퍼넌트의 사이즈를 width 및 height로 변경합니다.

파라미터:

width - 이 컴퍼넌트의 새로운넓이 (픽셀 단위)

height - 이 컴퍼넌트의 새로운 높이 (픽셀 단위)

도입된 버전 :

JDK1. 1

관련 항목:

getSize(), setBounds(int, int, int, int)

resize

@Deprecated 
public void resize(int width,
                              int height)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setSize(int, int)를 사용합니다.

setSize

public void setSize(Dimension  d)

이 컴퍼넌트의 사이즈를,넓이 d.width, 높이 d.height로 변경합니다.

파라미터:

d - 이 컴퍼넌트의 새로운 사이즈를 지정하는 크기

도입된 버전 :

JDK1. 1

관련 항목:

setSize(int, int), setBounds(int, int, int, int)

resize

@Deprecated 
public void resize(Dimension  d)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setSize(Dimension)를 사용합니다.

getBounds

public Rectangle  getBounds()

이 컴퍼넌트의 경계를 Rectangle 객체로서 리턴합니다. 경계는 이 컴퍼넌트의 폭, 높이 및 부모를 기준으로의해 위치를 지정합니다.

반환값:

이 컴퍼넌트의 경계를 나타내는 구형

관련 항목:

setBounds(int, int, int, int), getLocation(), getSize()

bounds

@Deprecated 
public Rectangle  bounds()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getBounds()를 사용합니다.

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

이 컴퍼넌트를 이동해, 사이즈 변경합니다. 좌상구석의 새로운 위치는 x 및 y에 의해 지정되어 새로운 사이즈는 width 및 height에 의해 지정됩니다.

파라미터:

x - 이 컴퍼넌트의 새로운 x 좌표

y - 이 컴퍼넌트의 새로운 y 좌표

width - 이 컴퍼넌트의 새로운 width

height - 이 컴퍼넌트의 새로운 height

도입된 버전 :

JDK1. 1

관련 항목:

getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension)

reshape

@Deprecated 
public void reshape(int x,
                               int y,
                               int width,
                               int height)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setBounds(int, int, int, int)를 사용합니다.

setBounds

public void setBounds(Rectangle  r)

새로운 경계의 구형 r에 적합하도록 이 컴퍼넌트를 이동해, 사이즈 변경합니다. 이 컴퍼넌트의 새로운 위치는 r.x 및 r.y에 의해 지정되어 새로운 사이즈는 r.width 및 r.height에 의해 지정됩니다.

파라미터:

r - 이 컴퍼넌트의 새로운 경계의 구형

도입된 버전 :

JDK1. 1

관련 항목:

getBounds(), setLocation(int, int), setLocation(Point), setSize(int, int), setSize(Dimension)

getX

public int getX()

컴퍼넌트의 원점의 현재의 x 좌표를 리턴합니다. 이 메서드는 heap의 할당을 일으키게 한 없기 때문에 component.getBounds(). x 또는 component.getLocation(). x 보다 적절합니다.

반환값:

컴퍼넌트의 원점의 현재의 x 좌표

도입된 버전 :

1.2

getY

public int getY()

컴퍼넌트의 원점의 현재의 y 좌표를 리턴합니다. 이 메서드는 heap의 할당을 일으키게 한 없기 때문에 component.getBounds(). y 또는 component.getLocation(). y 보다 적절합니다.

반환값:

컴퍼넌트의 원점의 현재의 y 좌표

도입된 버전 :

1.2

getWidth

public int getWidth()

이 컴퍼넌트의 현재의 넓이를 리턴합니다. 이 메서드는 heap의 할당이 발생하지 않기 때문에 component.getBounds(). width 또는 component.getSize(). width 보다 적절합니다.

반환값:

이 컴퍼넌트의 현재의 폭

도입된 버전 :

1.2

getHeight

public int getHeight()

이 컴퍼넌트의 현재의 높이를 리턴합니다. 이 메서드는 heap의 할당이 발생하지 않기 때문에 component.getBounds(). height 또는 component.getSize(). height 보다 적절합니다.

반환값:

이 컴퍼넌트의 현재의 높이

도입된 버전 :

1.2

getBounds

public Rectangle  getBounds(Rectangle  rv)

이 컴퍼넌트의 경계를 「반환값」rv에 포함해, rv를 리턴합니다. rv가 null인 경우, 새로운 Rectangle를 할당할 수 있습니다. 이 버전의 getBounds는 호출측이 heap로 새로운 Rectangle 객체를 할당하고 싶지 않은 경우에 편리합니다.

파라미터:

rv - 컴퍼넌트의 경계로 변경된 반환값

반환값:

rv

getSize

public Dimension  getSize(Dimension  rv)

이 컴퍼넌트의 경계를 「반환값」rv에 포함해, rv를 리턴합니다. rv가 null인 경우, 새로운 Dimension 객체를 할당할 수 있습니다. 이 버전의 getSize는 호출측이 heap로 새로운 Dimension 객체를 할당하고 싶지 않은 경우에 편리합니다.

파라미터:

rv - 컴퍼넌트 사이즈로 변경된 반환값

반환값:

rv

getLocation

public Point  getLocation(Point  rv)

이 컴퍼넌트의 경계를 「반환값」rv에 포함해, rv를 리턴합니다. rv가 null인 경우, 새로운 Point를 할당할 수 있습니다. 이 버전의 getLocation는 호출측이 heap로 새로운 Point 객체를 할당하고 싶지 않은 경우에 편리합니다.

파라미터:

rv - 컴퍼넌트 위치로 변경된 반환값

반환값:

rv

isOpaque

public boolean isOpaque()

이 컴퍼넌트가 완전하게 불투명한 경우에 true를 리턴합니다. 디폴트에서는 false를 리턴합니다.

불투명 컴퍼넌트는 구형 영역내의 모든 픽셀을 페인트 합니다. 불투명하지 않은 컴퍼넌트는 일부의 픽셀만을 페인트 해, 그 아래의 픽셀이 비쳐 보이도록 합니다. 픽셀을 완전하게 페인트 하지 않는 컴퍼넌트는 어느 정도의 투명도가 있습니다. 투명하게 할 수 있는 것은 경량 컴퍼넌트 뿐입니다.

항상 내용을 완전하게 페인트 하는 것을 보증하는 서브 클래스는 이 메서드를 오버라이드(override)의해 true를 돌려주도록 합니다. 「중량」AWT 컴퍼넌트는 모두 불투명합니다.

반환값:

이 컴퍼넌트가 완전하게 불투명한 경우는 true

도입된 버전 :

1.2

관련 항목:

isLightweight()

isLightweight

public boolean isLightweight()

경량 컴퍼넌트는 네이티브인 툴 킷의 피어를 가지지 않습니다. Button 나 Scrollbar와 같이 이 패키지로 정의되고 있는 것 이외의 Component 및 Container 서브 클래스는 경량 컴퍼넌트가 됩니다. Swing 컴퍼넌트는 모두 경량입니다.

표시 불가능한 컴퍼넌트의 중량감을 판정할 수 없기 위해, 이 컴퍼넌트가 표시 가능하지 않은 경우는 이 메서드는 반드시 false를 리턴합니다.

반환값:

이 컴퍼넌트에 경량 피어가 있는 경우는 true. 네이티브 피어가 있든가 혹은 피어가 없는 경우는 false

도입된 버전 :

1.2

관련 항목:

isDisplayable()

setPreferredSize

public void setPreferredSize(Dimension  preferredSize)

이 컴퍼넌트의 추천 사이즈에 정수값을 설정합니다. 이후 getPreferredSize를 호출하면 항상 이 값이 리턴됩니다 . 추천 사이즈를 null로 설정하면, 디폴트의 동작하러 돌아옵니다.

파라미터:

preferredSize - 새로운 추천 사이즈, 또는 null

도입된 버전 :

1.5

관련 항목:

getPreferredSize(), isPreferredSizeSet()

isPreferredSizeSet

public boolean isPreferredSizeSet()

적절한 사이즈가 null 이외의 값으로 설정되어 있는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.

반환값:

null 이외의 값으로 setPreferredSize를 호출하고 있는 경우는 true

도입된 버전 :

1.5

getPreferredSize

public Dimension  getPreferredSize()

이 컴퍼넌트의 추천 사이즈를 리턴합니다.

반환값:

이 컴퍼넌트의 추천 사이즈를 나타내는 크기 객체

관련 항목:

getMinimumSize(), LayoutManager

preferredSize

@Deprecated 
public Dimension  preferredSize()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getPreferredSize()를 사용합니다.

setMinimumSize

public void setMinimumSize(Dimension  minimumSize)

이 컴퍼넌트의 최소 사이즈에 정수값을 설정합니다. 이후 getMinimumSize를 호출하면 항상 이 값이 리턴됩니다 . 최소 사이즈를 null로 설정하면, 디폴트의 동작하러 돌아옵니다.

파라미터:

minimumSize - 이 컴퍼넌트의 새로운 최소 사이즈

도입된 버전 :

1.5

관련 항목:

getMinimumSize(), isMinimumSizeSet()

isMinimumSizeSet

public boolean isMinimumSizeSet()

null 이외의 값으로 setMinimumSize를 호출하고 있는지를 리턴합니다.

반환값:

null 이외의 값으로 setMinimumSize를 호출하고 있는 경우는 true

도입된 버전 :

1.5

getMinimumSize

public Dimension  getMinimumSize()

이 컴퍼넌트의 최소 사이즈를 리턴합니다.

반환값:

이 컴퍼넌트의 최소 사이즈를 나타내는 크기 객체

관련 항목:

getPreferredSize(), LayoutManager

minimumSize

@Deprecated 
public Dimension  minimumSize()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getMinimumSize()를 사용합니다.

setMaximumSize

public void setMaximumSize(Dimension  maximumSize)

이 컴퍼넌트의 최대 사이즈에 정수값을 설정합니다. 이후 getMaximumSize를 호출하면 항상 이 값이 리턴됩니다 . 최대 사이즈를 null로 설정하면, 디폴트의 동작하러 돌아옵니다.

파라미터:

maximumSize - 요구되는 최대 허가 사이즈를 보관 유지하는 Dimension

도입된 버전 :

1.5

관련 항목:

getMaximumSize(), isMaximumSizeSet()

isMaximumSizeSet

public boolean isMaximumSizeSet()

최대 사이즈가 null 이외의 값으로 설정되어 있는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.

반환값:

maximumSize가 null 이외의 값의 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.5

getMaximumSize

public Dimension  getMaximumSize()

이 컴퍼넌트의 최대 사이즈를 리턴합니다.

반환값:

이 컴퍼넌트의 최대 사이즈를 나타내는 크기 객체

관련 항목:

getMinimumSize(), getPreferredSize(), LayoutManager

getAlignmentX

public float getAlignmentX()

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

getAlignmentY

public float getAlignmentY()

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

doLayout

public void doLayout()

레이아웃 매니저에 이 컴퍼넌트의 배치를 재촉합니다. 컴퍼넌트 (구체적으로는 컨테이너)가 확인되었을 때에 호출합니다.

관련 항목:

validate(), LayoutManager

layout

@Deprecated 
public void layout()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 doLayout()를 사용합니다.

validate

public void validate()

컴퍼넌트가 유효한 배치인 것을 확인합니다. 이 메서드는 주로 Container 인스턴스의 조작용입니다.

도입된 버전 :

JDK1. 0

관련 항목:

invalidate(), doLayout(), LayoutManager, Container.validate()

invalidate

public void invalidate()

컴퍼넌트를 무효로 합니다. 이 컴퍼넌트와 게다가의 부모는 모두 배치할 필요가 있는 것으로서 마킹 됩니다. 이 메서드는 빈번하게 불려가 므로 신속히 동작할 필요가 있습니다.

도입된 버전 :

JDK1. 0

관련 항목:

validate(), doLayout(), LayoutManager

getGraphics

public Graphics  getGraphics()

이 컴퍼넌트의 그래픽 컨텍스트를 작성합니다. 이 메서드는 컴퍼넌트가 현재 표시 가능하지 않은 경우, null을 리턴합니다.

반환값:

이 컴퍼넌트의 그래픽 컨텍스트. 없는 경우는 null

도입된 버전 :

JDK1. 0

관련 항목:

paint(java.awt.Graphics)

getFontMetrics

public FontMetrics  getFontMetrics(Font  font)

지정된 폰트의 폰트 시학을 리턴합니다.

파라미터:

font - 폰트메트릭스를 얻는 폰트

반환값:

font 폰트메트릭스

도입된 버전 :

JDK1. 0

관련 항목:

getFont(), getPeer(), ComponentPeer.getFontMetrics(Font), Toolkit.getFontMetrics(Font)

setCursor

public void setCursor(Cursor  cursor)

커서 이미지를, 지정된 커서로 설정합니다. 이 커서 이미지는 이 컴퍼넌트의 contains 메서드가 현재의 커서 위치에 대해서 true를 돌려주고, 이 컴퍼넌트가 가시, 표시 가능, 한편 사용 가능한 경우에 표시됩니다. Container 커서를 설정하면, 컨테이너의 모든 서브 컴퍼넌트로 그 커서가 표시됩니다. 다만, null 이외의 커서를 사용하고 있는 서브 컴퍼넌트에서는 표시되지 않습니다.

파라미터:

cursor - Cursor 클래스에서 정의되고 있는 정수의 1개. 이 파라미터가 null인 경우, 이 컴퍼넌트는 부모의 커서를 상속하는

도입된 버전 :

JDK1. 1

관련 항목:

isEnabled(), isShowing(), getCursor(), contains(int, int), Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String), Cursor

getCursor

public Cursor  getCursor()

컴퍼넌트의 커서 세트를 리턴합니다. 컴퍼넌트에 커서 세트가 없는 경우, 부모의 커서가 리턴됩니다 . 계층 전체에 커서가 설정되어 있지 않은 경우는 Cursor.DEFAULT_CURSOR가 리턴됩니다 .

도입된 버전 :

JDK1. 1

관련 항목:

setCursor(java.awt.Cursor)

isCursorSet

public boolean isCursorSet()

커서가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는지를 리턴합니다. false를 돌려주는 경우, 이 컴퍼넌트는 상위의 컴퍼넌트로부터 커서를 상속합니다.

반환값:

커서가 이 컴퍼넌트에 대해서 명시적으로 설정되어 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

paint

public void paint(Graphics  g)

이 컴퍼넌트를 페인트 합니다.

컴퍼넌트가 최초로 표시되는 경우, 또는 손상해 수복이 필요한 경우 등, 컴퍼넌트의 내용을 페인트 할 필요가 있을 때 이 메서드를 호출합니다. Graphics 파라미터의 클립 구형을 페인트가 필요한 영역으로 설정합니다. 이 메서드를 오버라이드(override) 하는 Component 서브 클래스는 super.paint(g)를 호출할 필요는 없습니다.

퍼포먼스상의 이유로부터,넓이 또는 높이가 제로의 Component는 최초로 표시될 때는 페인트 대상으로 간주해지고 두, 또 수복도 불필요하다라고 보입니다.

주: 가장 효율적인 페인트 코드를 쓰는 방법 등, AWT 및 Swing에 의해 사용되는 페인트 도구 의 상세한 것에 대하여는 「Painting in AWT and Swing」를 참조하십시오.

파라미터:

g - 페인트에 사용하는 그래픽 컨텍스트

도입된 버전 :

JDK1. 0

관련 항목:

update(java.awt.Graphics)

update

public void update(Graphics  g)

이 컴퍼넌트를 갱신합니다.

이 컴퍼넌트가 경량 컴퍼넌트가 아닌 경우, AWT는 repaint 호출해에 응답해, update 메서드를 호출합니다. 백그라운드가 클리어 되지 않는다고 생각할 수 있습니다 .

Component update 메서드가 이 컴퍼넌트의 paint 메서드를 호출해, 이 컴퍼넌트를 재렌더링 합니다. 이 메서드는 일반적으로repaint 호출해에 응답해 추가 처리가 필요한 서브 클래스에 의해 오버라이드(override) 됩니다. 이 메서드를 오버라이드(override) 하는 컴퍼넌트의 서브 클래스는 super.update(g) 또는 update 메서드로부터 paint(g)를 직접 호출할 필요가 있습니다.

그래픽 컨텍스트 의 원점의 (0, 0) 좌표의 점은 이 컴퍼넌트의 좌상구석이 됩니다. 그래픽 컨텍스트 의 클리핑 영역은 이 컴퍼넌트의 경계의 구형이 됩니다.

주: 가장 효율적인 페인트 코드를 쓰는 방법 등, AWT 및 Swing에 의해 사용되는 페인트 도구 의 상세한 것에 대하여는 「Painting in AWT and Swing」를 참조하십시오.

파라미터:

g - 갱신에 사용하는 지정된 컨텍스트

도입된 버전 :

JDK1. 0

관련 항목:

paint(java.awt.Graphics), repaint()

paintAll

public void paintAll(Graphics  g)

이 컴퍼넌트 및 그 모든 서브 컴퍼넌트를 페인트 합니다.

그래픽 컨텍스트 의 원점의 (0, 0) 좌표의 점은 이 컴퍼넌트의 좌상구석이 됩니다. 그래픽 컨텍스트 의 클리핑 영역은 이 컴퍼넌트의 경계의 구형이 됩니다.

파라미터:

g - 페인트에 사용하는 그래픽 컨텍스트

도입된 버전 :

JDK1. 0

관련 항목:

paint(java.awt.Graphics)

repaint

public void repaint()

이 컴퍼넌트를 다시 페인트 합니다.

이 컴퍼넌트가 경량 컴퍼넌트인 경우, 이 메서드는 이 컴퍼넌트의 paint 메서드를 가능한 한 신속하게 호출합니다. 그렇지 않은 경우는 update 메서드를 가능한 한 신속하게 호출합니다.

주: 가장 효율적인 페인트 코드를 쓰는 방법 등, AWT 및 Swing에 의해 사용되는 페인트 도구 의 상세한 것에 대하여는 「Painting in AWT and Swing」를 참조하십시오.

도입된 버전 :

JDK1. 0

관련 항목:

update(Graphics)

repaint

public void repaint(long tm)

이 컴퍼넌트를 다시 페인트 합니다. 이 컴퍼넌트가 경량 컴퍼넌트의 경우, tm 밀리 세컨드내에 paint를 호출합니다.

주: 가장 효율적인 페인트 코드를 쓰는 방법 등, AWT 및 Swing에 의해 사용되는 페인트 도구 의 상세한 것에 대하여는 「Painting in AWT and Swing」를 참조하십시오.

파라미터:

tm - 갱신까지의 최대 시간 (밀리 세컨드)

도입된 버전 :

JDK1. 0

관련 항목:

paint(java.awt.Graphics), update(Graphics)

repaint

public void repaint(int x,
                    int y,
                    int width,
                    int height)

이 컴퍼넌트의 지정된 구형 영역을 다시 페인트 합니다.

이 컴퍼넌트가 경량 컴퍼넌트인 경우, 이 메서드는 이 컴퍼넌트의 paint 메서드를 가능한 한 신속하게 호출합니다. 그렇지 않은 경우는 update 메서드를 가능한 한 신속하게 호출합니다.

주: 가장 효율적인 페인트 코드를 쓰는 방법 등, AWT 및 Swing에 의해 사용되는 페인트 도구 의 상세한 것에 대하여는 「Painting in AWT and Swing」를 참조하십시오.

파라미터:

x - x 좌표

y - y 좌표

width - 폭

height - 높이

도입된 버전 :

JDK1. 0

관련 항목:

update(Graphics)

repaint

public void repaint(long tm,
                    int x,
                    int y,
                    int width,
                    int height)

이 컴퍼넌트의 지정된 구형 영역을 tm 밀리 세컨드 이내에 다시 페인트 합니다.

이 컴퍼넌트가 경량 컴퍼넌트인 경우, 이 메서드는 이 컴퍼넌트의 paint 메서드를 호출합니다. 그렇지 않은 경우는 update 메서드를 호출합니다.

주: 가장 효율적인 페인트 코드를 쓰는 방법 등, AWT 및 Swing에 의해 사용되는 페인트 도구 의 상세한 것에 대하여는 「Painting in AWT and Swing」를 참조하십시오.

파라미터:

tm - 갱신까지의 최대 시간 (밀리 세컨드)

x - x 좌표

y - y 좌표

width - 폭

height - 높이

도입된 버전 :

JDK1. 0

관련 항목:

update(Graphics)

print

public void print(Graphics  g)

이 컴퍼넌트를 출력합니다. 출력하기 전에 특수한 처리가 필요한 컴퍼넌트의 경우, 또는 보통과 다른 방법으로 출력할 필요가 있는 컴퍼넌트의 경우, 어플리케이션은 이 메서드를 오버라이드(override) 할 필요가 있습니다.

이 메서드의 디폴트의 구현은 paint 메서드를 호출합니다.

그래픽 컨텍스트 의 원점의 (0, 0) 좌표의 점은 이 컴퍼넌트의 좌상구석이 됩니다. 그래픽 컨텍스트 의 클리핑 영역은 이 컴퍼넌트의 경계의 구형이 됩니다.

파라미터:

g - 출력에 사용하는 그래픽 컨텍스트

도입된 버전 :

JDK1. 0

관련 항목:

paint(Graphics)

printAll

public void printAll(Graphics  g)

이 컴퍼넌트 및 그 모든 서브 컴퍼넌트를 출력합니다.

그래픽 컨텍스트 의 원점의 (0, 0) 좌표의 점은 이 컴퍼넌트의 좌상구석이 됩니다. 그래픽 컨텍스트 의 클리핑 영역은 이 컴퍼넌트의 경계의 구형이 됩니다.

파라미터:

g - 출력에 사용하는 그래픽 컨텍스트

도입된 버전 :

JDK1. 0

관련 항목:

print(Graphics)

imageUpdate

public boolean imageUpdate(Image  img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)

이미지가 변경되었을 때에 컴퍼넌트를 다시 페인트 합니다. ImageObserver 이 imageUpdate 메서드가 호출되는 것은, Graphics drawImage 메서드등의 비동기 루틴을 사용해, 이전에 요구되고 있던 이미지에 대한 상세 정보가 이용 가능하게 되었을 때입니다. 이 메서드와 그 인수에 대한자세한 내용은 imageUpdate 정의를 참조하십시오.

Component imageUpdate 메서드는 이용할 수 있는 이미지의 비트가 많아지는 것에 따라, 인크리멘탈에 컴퍼넌트 이미지를 렌더링 합니다.

시스템 프로퍼티 awt.image.incrementaldraw가 없는지, true값을 가지는 경우, 이미지는 서서히 렌더링 됩니다. 시스템 프로퍼티의 값이 다른 값인 경우는 이미지는 전체가 로드 되고 나서 렌더링 됩니다.

또, 인크리멘탈인 렌더링가 유효한 경우, 시스템 프로퍼티 awt.image.redrawrate값은 밀리 세컨드 단위로 최대의 재렌더링 레이트를 지정하는 정수값으로 해석됩니다. 시스템 프로퍼티가 없는지, 또는 정수값으로 해석할 수 없는 경우, 재렌더링 레이트는 100 밀리 세컨드 마다 1회가 됩니다.

x, y, width 및 height인수의 해석은, infoflags인수의 값에 따라서 다릅니다.

정의:

인터페이스 ImageObserver 내의 imageUpdate

파라미터:

img - 표시되는 이미지

infoflags - 자세한 것은 imageUpdate를 참조

x - x 좌표

y - y 좌표

w - 폭

h - 높이

반환값:

이미지 전체가 로드 되는 것을 infoflags가 가리키는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

관련 항목:

ImageObserver, Graphics.drawImage(Image, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, Color, java.awt.image.ImageObserver), Graphics.drawImage(Image, int, int, int, int, java.awt.image.ImageObserver), ImageObserver.imageUpdate(java.awt.Image, int, int, int, int, int)

createImage

public Image  createImage(ImageProducer  producer)

지정된 이메이지프로듀서로부터 이미지를 생성합니다.

파라미터:

producer - 이메이지프로듀서

반환값:

생성된 이미지

도입된 버전 :

JDK1. 0

createImage

public Image  createImage(int width,
                         int height)

더블 버퍼링을 위해서 사용되는 오프 스크린 렌더링 이미지를 생성합니다.

파라미터:

width - 지정된 폭

height - 지정된 높이

반환값:

더블 버퍼링에 사용할 수 있는 오프 스크린 렌더링 이미지. 컴퍼넌트가 표시 불가능한 경우는 null을 돌려준다. GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우는 항상 null을 돌려주는

도입된 버전 :

JDK1. 0

관련 항목:

isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage  createVolatileImage(int width,
                                         int height)

더블 버퍼링을 위해서 사용되는 휘발성의 오프 스크린 렌더링 이미지를 생성합니다.

파라미터:

width - 지정된 폭

height - 지정된 높이

반환값:

더블 버퍼링에 사용할 수 있는 오프 스크린 렌더링 이미지. 컴퍼넌트가 표시 불가능한 경우는 null을 돌려준다. GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우는 항상 null을 돌려주는

도입된 버전 :

1.4

관련 항목:

VolatileImage, isDisplayable(), GraphicsEnvironment.isHeadless()

createVolatileImage

public VolatileImage  createVolatileImage(int width,
                                         int height,
                                         ImageCapabilities  caps)
                                  throws AWTException 

지정된 기능을 사용해 휘발성 오프 스크린 렌더링 이미지를 생성합니다. 이 이미지의 내용은 OS 측의 문제로 항상 없어질 가능성이 있으므로VolatileImage인터페이스로 관리할 필요가 있습니다.

파라미터:

width - 지정된 폭

height - 지정된 높이

caps - 이미지 기능

반환값:

표면 내용의 손실과 기능의 관리에 사용할 수 있는 VolatileImage 객체

예외:

AWTException - 지정된 기능을 사용해 이미지를 생성할 수 없는 경우

도입된 버전 :

1.4

관련 항목:

VolatileImage

prepareImage

public boolean prepareImage(Image  image,
                            ImageObserver  observer)

이 컴퍼넌트상에 렌더링하기 위한 이미지를 준비합니다. 이미지 데이터는 다른 thread로 비동기에게 다운로드되어 이미지의 적절한 화면 표시가 생성됩니다.

파라미터:

image - 화면 표시를 준비하는 Image

observer - 이미지가 준비될 때 통지를 받는 ImageObserver 객체

반환값:

이미지의 준비가 완료하고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

prepareImage

public boolean prepareImage(Image  image,
                            int width,
                            int height,
                            ImageObserver  observer)

이 컴퍼넌트상에 표시하기 위한, 지정된 폭과 높이의 이미지를 준비합니다.

이미지 데이터는 다른 thread로 비동기적으로 다운로드되어 적절히 슬캘링 된 이미지의 화면 표현이 생성됩니다.

파라미터:

image - 화면 표시가 준비되는 Image 인스턴스

width - 요구하는 화면 표시의 폭

height - 요구하는 화면 표시의 높이

observer - 이미지가 준비될 때 통지를 받는 ImageObserver 객체

반환값:

이미지의 준비가 완료하고 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 0

관련 항목:

ImageObserver

checkImage

public int checkImage(Image  image,
                      ImageObserver  observer)

지정된 이미지의 화면 표시의 구축 상태를 리턴합니다.

이 메서드는 이미지를 로드하지 않습니다. 이미지를 강제적으로 로드하려면, prepareImage 메서드를 사용합니다.

이 메서드에 의해 리턴된 플래그에 대해서는 ImageObserver인터페이스의 설명을 참조하십시오.

파라미터:

image - 상태 검사의 대상이 되는 Image 객체

observer - 이미지가 준비될 때 통지를 받는 ImageObserver 객체

반환값:

이미지에 대해 현재 이용 가능한 정보를 나타내는 ImageObserver 플래그의 비트 단위의 논리 OR

도입된 버전 :

JDK1. 0

관련 항목:

prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

checkImage

public int checkImage(Image  image,
                      int width,
                      int height,
                      ImageObserver  observer)

지정된 이미지의 화면 표시의 구축 상태를 리턴합니다.

이 메서드는 이미지를 로드하지 않습니다. 이미지를 강제적으로 로드하려면, prepareImage 메서드를 사용합니다.

Component checkImage 메서드는 플래그를 계산하기 위해서 피어의 checkImage 메서드를 호출합니다. 이 컴퍼넌트에 아직 피어가 없는 경우, 컴퍼넌트의 툴 킷의 checkImage 메서드가 대신에 호출합니다.

이 메서드에 의해 리턴된 플래그에 대해서는 ImageObserver인터페이스의 설명을 참조하십시오.

파라미터:

image - 상태 검사의 대상이 되는 Image 객체

width - 상태 검사의 대상이 되는 슬캘링 된 버전의 폭

height - 상태 검사의 대상이 되는 슬캘링 된 버전의 높이

observer - 이미지가 준비될 때 통지를 받는 ImageObserver 객체

반환값:

이미지에 대해 현재 이용 가능한 정보를 나타내는 ImageObserver 플래그의 비트 단위의 논리 OR

도입된 버전 :

JDK1. 0

관련 항목:

prepareImage(Image, int, int, java.awt.image.ImageObserver), Toolkit.checkImage(Image, int, int, java.awt.image.ImageObserver), ImageObserver

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

OS 로부터의, 페인트에 대한 메세지를 무시할지 어떨지를 설정합니다. OS 레벨의 페인트 메세지에의 즉시의 반응이 아닌 한, AWT에 의해 소프트웨어내에서 생성되는 페인트 이미지에는 영향을 주지 않습니다.

이것은 예를 들어 전화면 모드에서의 퍼포먼스 향상이 요구되고 있는 경우, 버퍼 제어 방침으로서 페이지 반전이 사용되고 있는 경우에 유효합니다.

도입된 버전 :

1.4

관련 항목:

getIgnoreRepaint(), Canvas.createBufferStrategy(int), Window.createBufferStrategy(int), BufferStrategy, GraphicsDevice.setFullScreenWindow(java.awt.Window)

getIgnoreRepaint

public boolean getIgnoreRepaint()

반환값:

OS 의 페인트 메세지를 무시할지 어떨지

도입된 버전 :

1.4

관련 항목:

setIgnoreRepaint(boolean)

contains

public boolean contains(int x,
                        int y)

이 컴퍼넌트가 지정된 점을 포함하고 있는지를 판정합니다. x와 y는 이 컴퍼넌트의 좌표계에의 상대치로 정의됩니다.

파라미터:

x - 점의 x 좌표

y - 점의 y 좌표

도입된 버전 :

JDK1. 1

관련 항목:

getComponentAt(int, int)

inside

@Deprecated 
public boolean inside(int x,
                                 int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 contains(int, int)를 사용합니다.

contains

public boolean contains(Point  p)

이 컴퍼넌트가 지정된 점을 포함하고 있는지를 판정합니다. x 및 y 좌표는 이 컴퍼넌트의 좌표계에의 상대치로 정의됩니다.

파라미터:

p - 점

도입된 버전 :

JDK1. 1

관련 항목:

getComponentAt(Point)

getComponentAt

public Component  getComponentAt(int x,
                                int y)

이 컴퍼넌트 또는 그 직접적인 서브 컴퍼넌트가 위치 (x, y)를 포함하고 있는지를 판정합니다. 포함하고 있는 경우는 그 컴퍼넌트를 리턴합니다. 이 메서드는 1개 하의 레벨까지 밖에 조사하지 않습니다. 점 (x, y)이 서브 컴퍼넌트를 가지는 서브 컴퍼넌트내에 있는 경우, 서브 컴퍼넌트 트리의 하부는 조사할 수 있지 않습니다.

(x, y) 좌표의 위값이 바운딩박스 내에 있는 경우, Component locate 메서드는 단지 컴퍼넌트 자신을 돌려주고, 그렇지 않은 경우는 null을 리턴합니다.

파라미터:

x - x 좌표

y - y 좌표

반환값:

(x, y)의 위치를 포함한 컴퍼넌트 또는 서브 컴퍼넌트. 그 위값이 이 컴퍼넌트의 밖인 경우는 null

도입된 버전 :

JDK1. 0

관련 항목:

contains(int, int)

locate

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

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getComponentAt(int, int)를 사용합니다.

getComponentAt

public Component  getComponentAt(Point  p)

지정된 점을 포함한 컴퍼넌트 또는 서브 컴퍼넌트를 리턴합니다.

파라미터:

p - 점

도입된 버전 :

JDK1. 1

관련 항목:

contains(int, int)

deliverEvent

@Deprecated 
public void deliverEvent(Event  e)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 dispatchEvent(AWTEvent e)를 사용합니다.

dispatchEvent

public final void dispatchEvent(AWTEvent  e)

이 컴퍼넌트 또는 그 서브 컴퍼넌트의 1개에 이벤트를 디스패치 합니다. processEvent를 호출하고 나서, 이 Component로 사용 가능하게 되어 있는 1.1 형식의 이벤트에 값을 리턴합니다.

파라미터:

e - 이벤트

postEvent

@Deprecated 
public boolean postEvent(Event  e)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 dispatchEvent(AWTEvent e)를 사용합니다.

정의:

인터페이스 MenuContainer 내의 postEvent

addComponentListener

public void addComponentListener(ComponentListener  l)

이 컴퍼넌트로부터 컴퍼넌트 이벤트를 받기 위해서 지정된 컴퍼넌트 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 컴퍼넌트 리스너

도입된 버전 :

JDK1. 1

관련 항목:

ComponentEvent, ComponentListener, removeComponentListener(java.awt.event.ComponentListener), getComponentListeners()

removeComponentListener

public void removeComponentListener(ComponentListener  l)

이 컴퍼넌트로부터 컴퍼넌트 이벤트를 받지 않게, 지정된 컴퍼넌트 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 컴퍼넌트 리스너

도입된 버전 :

JDK1. 1

관련 항목:

ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), getComponentListeners()

getComponentListeners

public ComponentListener [] getComponentListeners()

이 컴퍼넌트에 등록되어 모든 컴퍼넌트 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 ComponentListener. 컴퍼넌트 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addComponentListener(java.awt.event.ComponentListener), removeComponentListener(java.awt.event.ComponentListener)

addFocusListener

public void addFocusListener(FocusListener  l)

이 컴퍼넌트가 입력초점을 취득했을 때에 이 컴퍼넌트로부터 포커스 이벤트를 받기 위해서 지정된 포커스 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 포커스 리스너

도입된 버전 :

JDK1. 1

관련 항목:

FocusEvent, FocusListener, removeFocusListener(java.awt.event.FocusListener), getFocusListeners()

removeFocusListener

public void removeFocusListener(FocusListener  l)

이 컴퍼넌트로부터 포커스 이벤트를 받지 않게, 지정된 포커스 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 포커스 리스너

도입된 버전 :

JDK1. 1

관련 항목:

FocusEvent, FocusListener, addFocusListener(java.awt.event.FocusListener), getFocusListeners()

getFocusListeners

public FocusListener [] getFocusListeners()

이 컴퍼넌트에 등록되어 모든 포커스 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 FocusListener. 컴퍼넌트 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addFocusListener(java.awt.event.FocusListener), removeFocusListener(java.awt.event.FocusListener)

addHierarchyListener

public void addHierarchyListener(HierarchyListener  l)

이 컨테이너가 소속하는 계층이 변경되었을 때에 이 컴퍼넌트로부터 계층 변경 이벤트를 받기 위해서 지정된 계층 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 계층 리스너

도입된 버전 :

1.3

관련 항목:

HierarchyEvent, HierarchyListener, removeHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

removeHierarchyListener

public void removeHierarchyListener(HierarchyListener  l)

이 컴퍼넌트로부터 계층 변경 이벤트를 받지 않게, 지정된 계층 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 계층 리스너

도입된 버전 :

1.3

관련 항목:

HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), getHierarchyListeners()

getHierarchyListeners

public HierarchyListener [] getHierarchyListeners()

이 컴퍼넌트에 등록되어 모든 계층 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 HierarchyListener. 계층 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addHierarchyListener(java.awt.event.HierarchyListener), removeHierarchyListener(java.awt.event.HierarchyListener)

addHierarchyBoundsListener

public void addHierarchyBoundsListener(HierarchyBoundsListener  l)

이 컨테이너가 소속하는 계층이 변경되었을 때에 이 컴퍼넌트로부터 계층 변경 이벤트를 받기 위해서 지정된 계층 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 계층 변경 리스너

도입된 버전 :

1.3

관련 항목:

HierarchyEvent, HierarchyBoundsListener, removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

removeHierarchyBoundsListener

public void removeHierarchyBoundsListener(HierarchyBoundsListener  l)

이 컴퍼넌트로부터 계층 변경 이벤트를 받지 않게, 지정된 계층 변경 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 계층 변경 리스너

도입된 버전 :

1.3

관련 항목:

HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), getHierarchyBoundsListeners()

getHierarchyBoundsListeners

public HierarchyBoundsListener [] getHierarchyBoundsListeners()

이 컴퍼넌트에 등록되어 모든 계층 변경 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 HierarchyBoundsListener. 계층 변경 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), removeHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener)

addKeyListener

public void addKeyListener(KeyListener  l)

이 컴퍼넌트로부터 키 이벤트를 받기 위해서 지정된 키 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 키 리스너

도입된 버전 :

JDK1. 1

관련 항목:

KeyEvent, KeyListener, removeKeyListener(java.awt.event.KeyListener), getKeyListeners()

removeKeyListener

public void removeKeyListener(KeyListener  l)

이 컴퍼넌트로부터 키 이벤트를 받지 않게, 지정된 키 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 키 리스너

도입된 버전 :

JDK1. 1

관련 항목:

KeyEvent, KeyListener, addKeyListener(java.awt.event.KeyListener), getKeyListeners()

getKeyListeners

public KeyListener [] getKeyListeners()

이 컴퍼넌트에 등록되어 모든 키 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 KeyListener. 키 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addKeyListener(java.awt.event.KeyListener), removeKeyListener(java.awt.event.KeyListener)

addMouseListener

public void addMouseListener(MouseListener  l)

이 컴퍼넌트로부터 마우스 이벤트를 받기 위해서 지정된 마우스 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 마우스 리스너

도입된 버전 :

JDK1. 1

관련 항목:

MouseEvent, MouseListener, removeMouseListener(java.awt.event.MouseListener), getMouseListeners()

removeMouseListener

public void removeMouseListener(MouseListener  l)

이 컴퍼넌트로부터 마우스 이벤트를 받지 않게, 지정된 마우스 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 마우스 리스너

도입된 버전 :

JDK1. 1

관련 항목:

MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), getMouseListeners()

getMouseListeners

public MouseListener [] getMouseListeners()

이 컴퍼넌트에 등록되어 모든 마우스 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 MouseListener. 마우스 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addMouseListener(java.awt.event.MouseListener), removeMouseListener(java.awt.event.MouseListener)

addMouseMotionListener

public void addMouseMotionListener(MouseMotionListener  l)

이 컴퍼넌트로부터 마우스 모션 이벤트를 받기 위해서 지정된 마우스 모션 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 마우스 모션 리스너

도입된 버전 :

JDK1. 1

관련 항목:

MouseEvent, MouseMotionListener, removeMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

removeMouseMotionListener

public void removeMouseMotionListener(MouseMotionListener  l)

이 컴퍼넌트로부터 마우스 모션 이벤트를 받지 않게, 지정된 마우스 모션 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 마우스 모션 리스너

도입된 버전 :

JDK1. 1

관련 항목:

MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), getMouseMotionListeners()

getMouseMotionListeners

public MouseMotionListener [] getMouseMotionListeners()

이 컴퍼넌트에 등록되어 모든 마우스 모션 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 MouseMotionListener. 마우스 모션 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addMouseMotionListener(java.awt.event.MouseMotionListener), removeMouseMotionListener(java.awt.event.MouseMotionListener)

addMouseWheelListener

public void addMouseWheelListener(MouseWheelListener  l)

이 컴퍼넌트로부터 마우스 휠 이벤트를 받기 위해서 지정된 마우스 휠 리스너를 추가합니다. 컨테이너도 서브 컴퍼넌트로부터 마우스 휠 이벤트를 받습니다.

마우스 휠 이벤트의 디스패치의 구조에 대해서는 MouseWheelEvent 클래스의 설명을 참조하십시오.

l가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

l - 마우스 휠 리스너

도입된 버전 :

1.4

관련 항목:

MouseWheelEvent, MouseWheelListener, removeMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

removeMouseWheelListener

public void removeMouseWheelListener(MouseWheelListener  l)

이 컴퍼넌트로부터 마우스 휠 이벤트를 받지 않게, 지정된 마우스 휠 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 마우스 휠 리스너

도입된 버전 :

1.4

관련 항목:

MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), getMouseWheelListeners()

getMouseWheelListeners

public MouseWheelListener [] getMouseWheelListeners()

이 컴퍼넌트에 등록되어 모든 마우스 휠 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 MouseWheelListener. 마우스 휠 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addMouseWheelListener(java.awt.event.MouseWheelListener), removeMouseWheelListener(java.awt.event.MouseWheelListener)

addInputMethodListener

public void addInputMethodListener(InputMethodListener  l)

이 컴퍼넌트로부터 인풋 메서드 이벤트를 받기 위해서 지정된 인풋 메서드 리스너를 추가합니다. InputMethodRequests 인스턴스를 돌려주도록 getInputMethodRequests도 오버라이드(override) 하는 경우, 컴퍼넌트는 인풋 메서드로부터 인풋 메서드 이벤트를 받을 뿐입니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

파라미터:

l - 인풋 메서드 리스너

도입된 버전 :

1.2

관련 항목:

InputMethodEvent, InputMethodListener, removeInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners(), getInputMethodRequests()

removeInputMethodListener

public void removeInputMethodListener(InputMethodListener  l)

이 컴퍼넌트로부터 인풋 메서드 이벤트를 받지 않게, 지정된 인풋 메서드 리스너를 삭제합니다. 인수로서 지정된 리스너가 이 컴퍼넌트에 추가되어 있지 않은 경우, 이 메서드는 아무것도 실행하지 않고, 예외도 Throw 하지 않습니다. l가 null인 경우도 같습니다.

파라미터:

l - 인풋 메서드 리스너

도입된 버전 :

1.2

관련 항목:

InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), getInputMethodListeners()

getInputMethodListeners

public InputMethodListener [] getInputMethodListeners()

이 컴퍼넌트에 등록되어 모든 인풋 메서드 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 InputMethodListener. 인풋 메서드 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addInputMethodListener(java.awt.event.InputMethodListener), removeInputMethodListener(java.awt.event.InputMethodListener)

getListeners

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

이 Component에 FooListener로 서 현재 등록되어 모든 객체의 배열을 리턴합니다. 이 FooListener는 addFooListener 메서드로 등록된 것입니다.

listenerType인수는 FooListener.class와 같은 클래스 리터럴로 지정할 수 있습니다. 예를 들어이 마우스 리스너에 대한 Component c 조회는 다음의 코드로 실시합니다.

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

이러한 리스너가 없는 경우는 비어있는 배열을 리턴합니다.

파라미터:

listenerType - 요구되는 리스너의 형태. java.util.EventListener 하위 인터페이스를 지정

반환값:

이 컴퍼넌트에 FooListener로 서 등록되어 모든 객체의 배열. 리스너가 등록되지 않은 경우는 비어있는 배열을 돌려준다

예외:

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

도입된 버전 :

1.3

관련 항목:

getComponentListeners(), getFocusListeners(), getHierarchyListeners(), getHierarchyBoundsListeners(), getKeyListeners(), getMouseListeners(), getMouseMotionListeners(), getMouseWheelListeners(), getInputMethodListeners(), getPropertyChangeListeners()

getInputMethodRequests

public InputMethodRequests  getInputMethodRequests()

이 컴퍼넌트의 인풋 메서드로부터의 요구를 지원하는 인풋 메서드 요구 핸들러를 리턴합니다. 온더 스포트 텍스트 입력을 지원하는 컴퍼넌트는 InputMethodRequests 인스턴스를 돌려주기 위해서는 이 메서드를 오버라이드(override) 할 필요가 있습니다. 동시에 인풋 메서드 이벤트를 처리할 필요도 있습니다.

반환값:

이 컴퍼넌트의 인풋 메서드 요구 핸들러. 디폴트에서는 null

도입된 버전 :

1.2

관련 항목:

addInputMethodListener(java.awt.event.InputMethodListener)

getInputContext

public InputContext  getInputContext()

텍스트가 이 컴퍼넌트에 입력되었을 때에 인풋 메서드와의 통신을 처리하기 위해서 이 컴퍼넌트에 의해 사용되는 입력 컨텍스트를 리턴합니다. 디폴트에서는 친컴퍼넌트로 사용되는 입력 컨텍스트를 리턴합니다. 컴퍼넌트는 사적인 입력 컨텍스트를 돌려주기 위해서 이 메서드를 오버라이드(override) 할 수 있습니다.

반환값:

이 컴퍼넌트가 사용하는 입력 컨텍스트. 컨텍스트를 판별할 수 없는 경우는 null

도입된 버전 :

1.2

enableEvents

protected final void enableEvents(long eventsToEnable)

지정된 이벤트 마스크 파라미터에 의해 정의된 이벤트에 대해, 이 컴퍼넌트에의 송신을 사용 가능하게 합니다.

이벤트 타입은 그 타입의 리스너가 컴퍼넌트에 추가되면 자동적으로 사용 가능하게 됩니다.

이 메서드는 리스너가 등록되어 있는지 어떤지에 관계없이, 지정된 이벤트 타입을 processEvent에 송신하려고 하는 Component 서브 클래스로부터만 호출할 필요가 있습니다.

파라미터:

eventsToEnable - 이벤트 타입을 정의하는 이벤트 마스크

도입된 버전 :

JDK1. 1

관련 항목:

processEvent(java.awt.AWTEvent), disableEvents(long), AWTEvent

disableEvents

protected final void disableEvents(long eventsToDisable)

지정된 이벤트 마스크 파라미터에 의해 정의된 이벤트에 대해, 이 컴퍼넌트에의 송신을 불가능하게 합니다.

파라미터:

eventsToDisable - 이벤트 타입을 정의하는 이벤트 마스크

도입된 버전 :

JDK1. 1

관련 항목:

enableEvents(long)

coalesceEvents

protected AWTEvent  coalesceEvents(AWTEvent  existingEvent,
                                  AWTEvent  newEvent)

필요에 따라서, 송신되는 이벤트와 기존의 이벤트를 합체 시킵니다. 이 메서드는 송신되는 이벤트와 같은 ID를 가지는 이벤트 (어느 쪽의 이벤트도 소스로서 이 컴퍼넌트를 가진다)가 큐상에서 검색되었을 경우에 EventQueue.postEvent에 의해 호출합니다. 이 메서드는 기존의 이벤트와 옮겨지는 합체 된 이벤트를 돌려주든가 (이 경우 새로운 이벤트는 파기된다), 혹은 합체를 하지 않는 것을 나타내기 위해서 null을 리턴합니다 (이 경우 2번째의 이벤트는 큐의 마지막에 추가된다). 한편의 이벤트 파라미터가 변경되어 돌려주고져 한편의 파라미터는 null이 리턴된인 경우를 제외해 파기됩니다.

이 coalesceEvents 구현은 마우스 이동 ( 및 드래그) 이벤트와 페인트 ( 및 갱신) 이벤트의, 2개의 이벤트 타입을 합체 시킵니다. 마우스 이동 이벤트의 경우, 항상 마지막 이벤트가 돌려주고져 중간의 이동은 파기됩니다. 페인트 이벤트의 경우는 피어의 복합적인 RepaintArea에 새로운 이벤트가 합체 됩니다. 새로운 AWTEvent이 반드시 리턴됩니다 .

파라미터:

existingEvent - EventQueue에 들어가 있던 이벤트

newEvent - EventQueue에 송신되는 이벤트

반환값:

합체 된 이벤트. 또는 합체를 하지 않았던 것을 나타내는 null

processEvent

protected void processEvent(AWTEvent  e)

이 컴퍼넌트로 발생하는 이벤트를 처리합니다. 디폴트에서는 이 메서드는 지정된 이벤트의 클래스를 위한 적절한 process<event type>Event 메서드를 호출합니다.

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

파라미터:

e - 이벤트

도입된 버전 :

JDK1. 1

관련 항목:

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

processComponentEvent

protected void processComponentEvent(ComponentEvent  e)

이 컴퍼넌트로 발생하는 컴퍼넌트 이벤트를, 등록되어 있는 ComponentListener 객체에 디스패치 하는 것으로써, 컴퍼넌트 이벤트를 처리합니다.

이 컴퍼넌트에 대해서 컴퍼넌트 이벤트가 사용 가능하지 않은 경우, 이 메서드는 불려가 지 않습니다. 컴퍼넌트 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• ComponentListener 객체가 addComponentListener에 의해 등록되어 있다
• enableEvents에 의해 컴퍼넌트 이벤트가 사용 가능하게 되어 있다

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

파라미터:

e - 컴퍼넌트 이벤트

도입된 버전 :

JDK1. 1

관련 항목:

ComponentEvent, ComponentListener, addComponentListener(java.awt.event.ComponentListener), enableEvents(long)

processFocusEvent

protected void processFocusEvent(FocusEvent  e)

이 컴퍼넌트로 발생하는 포커스 이벤트를, 등록되어 모든 FocusListener 객체에 디스패치 하는 것으로써 처리합니다.

이 컴퍼넌트에 대해서 포커스 이벤트가 사용 가능하지 않은 경우, 이 메서드는 불려가 지 않습니다. 포커스 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• FocusListener 객체가 addFocusListener에 의해 등록되어 있다
• enableEvents에 의해 포커스 이벤트가 사용 가능하게 되어 있다

포커스 이벤트가 Component에 대해서 사용 가능하게 되어 있는 경우, 현재의 KeyboardFocusManager에 의해 포커스 이벤트를 등록된 FocusListener 객체에 디스패치 할 필요가 있을지 어떨지가 판단됩니다. 이벤트를 디스패치 하는 경우, KeyboardFocusManager는 Component dispatchEvent 메서드를 호출하기 때문에 Component processFocusEvent 메서드가 호출됩니다.

포커스 이벤트가 Component에 대해서 사용 가능하게 되어 있는 경우, FocusEvent를 인수로서 Component dispatchEvent 메서드를 호출하면, 현재의 KeyboardFocusManager에 관계없이, Component processFocusEvent 메서드가 호출됩니다.

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

파라미터:

e - 포커스 이벤트

도입된 버전 :

JDK1. 1

관련 항목:

FocusEvent, FocusListener, KeyboardFocusManager, addFocusListener(java.awt.event.FocusListener), enableEvents(long), dispatchEvent(java.awt.AWTEvent)

processKeyEvent

protected void processKeyEvent(KeyEvent  e)

이 컴퍼넌트로 발생하는 키 이벤트를, 등록되어 모든 KeyListener 객체에 디스패치 하는 것으로써, 키 이벤트를 처리합니다.

이 컴퍼넌트에 대해서 키 이벤트가 사용 가능하지 않은 경우, 이 메서드는 불려가 지 않습니다. 키 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• KeyListener 객체가 addKeyListener에 의해 등록되어 있다
• enableEvents에 의해 키 이벤트가 사용 가능하게 되어 있다

키 이벤트가 Component에 대해서 사용 가능하게 되어 있는 경우, 현재의 KeyboardFocusManager에 의해 등록된 KeyListener 객체에 키 이벤트를 디스패치 할 필요가 있을지 어떨지가 판단됩니다. DefaultKeyboardFocusManager는 포커스의 소유자가 아닌지, 또는 표시되어 있지 않은 Component에 키 이벤트를 디스패치 하지 않습니다.

J2SE 1.4 에서는 KeyEvent이 포커스 소유자에게 리다이렉트 됩니다. 상세한 것에 대하여는「Focus Specification」를 참조하십시오.

KeyEvent를 인수로서 Component dispatchEvent 메서드를 호출하면, 컴퍼넌트가 표시되어 포커스 되어 사용 가능하게 되어 있어 키 이벤트가 그 컴퍼넌트로 사용 가능하게 되어 있는 한, 현재의 KeyboardFocusManager에 관계없이, Component processKeyEvent 메서드가 호출됩니다.

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

파라미터:

e - 키 이벤트

도입된 버전 :

JDK1. 1

관련 항목:

KeyEvent, KeyListener, KeyboardFocusManager, DefaultKeyboardFocusManager, processEvent(java.awt.AWTEvent), dispatchEvent(java.awt.AWTEvent), addKeyListener(java.awt.event.KeyListener), enableEvents(long), isShowing()

processMouseEvent

protected void processMouseEvent(MouseEvent  e)

이 컴퍼넌트로 발생하는 마우스 이벤트를, 등록되어 모든 MouseListener 객체에 디스패치 하는 것으로써, 마우스 이벤트를 처리합니다.

이 컴퍼넌트에 대해서 마우스 이벤트가 사용 가능하지 않은 한, 이 메서드는 불려가 지 않습니다. 마우스 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• MouseListener 객체가 addMouseListener에 의해 등록되어 있다
• enableEvents에 의해 마우스 이벤트가 사용 가능하게 되어 있다

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

파라미터:

e - 마우스 이벤트

도입된 버전 :

JDK1. 1

관련 항목:

MouseEvent, MouseListener, addMouseListener(java.awt.event.MouseListener), enableEvents(long)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent  e)

이 컴퍼넌트로 발생하는 마우스 모션 이벤트를, 등록되어 모든 MouseMotionListener 객체에 디스패치 하는 것에 의해 처리합니다.

이 컴퍼넌트에 대해서 마우스 모션 이벤트가 사용 가능하지 않은 경우, 이 메서드는 불려가 지 않습니다. 마우스 모션 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• MouseMotionListener 객체가 addMouseMotionListener에 의해 등록되어 있다
• enableEvents에 의해 마우스 모션 이벤트가 사용 가능하게 되어 있다

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

파라미터:

e - 마우스 모션 이벤트

도입된 버전 :

JDK1. 1

관련 항목:

MouseEvent, MouseMotionListener, addMouseMotionListener(java.awt.event.MouseMotionListener), enableEvents(long)

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent  e)

이 컴퍼넌트로 발생하는 마우스 휠 이벤트를, 등록되어 모든 MouseWheelListener 객체에 디스패치 하는 것에 의해 처리합니다.

이 컴퍼넌트에 대해서 마우스 휠 이벤트가 사용 가능하지 않은 한, 이 메서드는 불려가 지 않습니다. 마우스 휠 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• MouseWheelListener 객체가 addMouseWheelListener에 의해 등록되어 있다
• enableEvents에 의해 마우스 휠 이벤트가 사용 가능하게 되어 있다

마우스 휠 이벤트의 디스패치의 구조에 대해서는 MouseWheelEvent 클래스의 설명을 참조하십시오.

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

파라미터:

e - 마우스 휠 이벤트

도입된 버전 :

1.4

관련 항목:

MouseWheelEvent, MouseWheelListener, addMouseWheelListener(java.awt.event.MouseWheelListener), enableEvents(long)

processInputMethodEvent

protected void processInputMethodEvent(InputMethodEvent  e)

이 컴퍼넌트로 발생하는 인풋 메서드 이벤트를, 등록되어 모든 InputMethodListener 객체에 디스패치 하는 것에 의해 처리합니다.

이 컴퍼넌트에 대해서 인풋 메서드 이벤트가 사용 가능하지 않은 경우, 이 메서드는 불려가 지 않습니다. 인풋 메서드 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• InputMethodListener 객체가 addInputMethodListener에 의해 등록되어 있다
• enableEvents에 의해 인풋 메서드 이벤트가 사용 가능하게 되어 있다

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

파라미터:

e - 인풋 메서드 이벤트

도입된 버전 :

1.2

관련 항목:

InputMethodEvent, InputMethodListener, addInputMethodListener(java.awt.event.InputMethodListener), enableEvents(long)

processHierarchyEvent

protected void processHierarchyEvent(HierarchyEvent  e)

이 컴퍼넌트로 발생하는 계층 이벤트를, 등록된 HierarchyListener 객체에 디스패치 하는 것으로써, 계층 이벤트를 처리합니다.

이 컴퍼넌트에 대해서 계층 이벤트가 사용 가능하지 않은 한, 이 메서드는 불려가 지 않습니다. 계층 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• HierarchyListener 객체가 addHierarchyListener를 사용해 등록된다
• enableEvents에 의해 계층 이벤트가 사용 가능하게 되어 있다

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

파라미터:

e - 계층 이벤트

도입된 버전 :

1.3

관련 항목:

HierarchyEvent, HierarchyListener, addHierarchyListener(java.awt.event.HierarchyListener), enableEvents(long)

processHierarchyBoundsEvent

protected void processHierarchyBoundsEvent(HierarchyEvent  e)

이 컴퍼넌트로 발생하는 계층 변경 이벤트를, 등록된 HierarchyBoundsListener 객체에 디스패치 하는 것에 의해 처리합니다.

이 컴퍼넌트에 대해서 계층 경계 이벤트가 사용 가능하지 않은 한, 이 메서드는 불려가 지 않습니다. 계층 경계 이벤트는 다음의 몇개의 경우에 사용 가능하게 됩니다.

• HierarchyBoundsListener 객체가 addHierarchyBoundsListener를 사용해 등록되어 있다
• enableEvents에 의해 계층 변경 이벤트가 사용 가능하게 되어 있다

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

파라미터:

e - 계층 이벤트

도입된 버전 :

1.3

관련 항목:

HierarchyEvent, HierarchyBoundsListener, addHierarchyBoundsListener(java.awt.event.HierarchyBoundsListener), enableEvents(long)

handleEvent

@Deprecated 
public boolean handleEvent(Event  evt)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processEvent(AWTEvent)를 사용합니다.

mouseDown

@Deprecated 
public boolean mouseDown(Event  evt,
                                    int x,
                                    int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.

mouseDrag

@Deprecated 
public boolean mouseDrag(Event  evt,
                                    int x,
                                    int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseMotionEvent(MouseEvent)를 사용합니다.

mouseUp

@Deprecated 
public boolean mouseUp(Event  evt,
                                  int x,
                                  int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.

mouseMove

@Deprecated 
public boolean mouseMove(Event  evt,
                                    int x,
                                    int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseMotionEvent(MouseEvent)를 사용합니다.

mouseEnter

@Deprecated 
public boolean mouseEnter(Event  evt,
                                     int x,
                                     int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.

mouseExit

@Deprecated 
public boolean mouseExit(Event  evt,
                                    int x,
                                    int y)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processMouseEvent(MouseEvent)를 사용합니다.

keyDown

@Deprecated 
public boolean keyDown(Event  evt,
                                  int key)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processKeyEvent(KeyEvent)를 사용합니다.

keyUp

@Deprecated 
public boolean keyUp(Event  evt,
                                int key)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processKeyEvent(KeyEvent)를 사용합니다.

action

@Deprecated 
public boolean action(Event  evt,
                                 Object  what)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 이 컴퍼넌트를 액션 이벤트를 트리거 하는 컴퍼넌트의 ActionListener 로서 등록할 필요가 있습니다.

addNotify

public void addNotify()

네이티브 스크린 자원에 접속해, 이 Component를 표시 가능하게 합니다. 이 메서드는 툴 킷에 의해 내부에서 불려가 프로그램으로부터 직접 호출할 수 없습니다.

도입된 버전 :

JDK1. 0

관련 항목:

isDisplayable(), removeNotify()

removeNotify

public void removeNotify()

네이티브 스크린 자원을 파기해, 이 Component를 비표시로 합니다.

이 메서드는 툴 킷에 의해 내부에서 호출합니다. 프로그램으로부터 직접 호출할 수 없습니다. 이 메서드를 오버라이드(override) 하는 코드는 오버라이드(override) 하는 메서드의 1 행 째로서 super.removeNotify를 호출할 필요가 있습니다.

도입된 버전 :

JDK1. 0

관련 항목:

isDisplayable(), addNotify()

gotFocus

@Deprecated 
public boolean gotFocus(Event  evt,
                                   Object  what)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processFocusEvent(FocusEvent)를 사용합니다.

lostFocus

@Deprecated 
public boolean lostFocus(Event  evt,
                                    Object  what)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 processFocusEvent(FocusEvent)를 사용합니다.

isFocusTraversable

@Deprecated 
public boolean isFocusTraversable()

추천하지 않습니다. JDK 버전 1.4 그 뒤로는 isFocusable()를 사용합니다.

이 Component이 포커스를 취득할 수 있을지 어떨지를 리턴합니다.

반환값:

이 Component이 포커스를 취득할 수 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

JDK1. 1

관련 항목:

setFocusable(boolean)

isFocusable

public boolean isFocusable()

이 컴퍼넌트에 포커스가 설정 가능한가 어떤가를 리턴합니다.

반환값:

이 컴퍼넌트가 포커스를 취득할 수 있는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

관련 항목:

setFocusable(boolean)

setFocusable

public void setFocusable(boolean focusable)

이 컴퍼넌트의 포커스 상태가 지정된 값으로 설정합니다. 이 값은 컴퍼넌트의 디폴트의 포커스 상태를 오버라이드(override) 합니다.

파라미터:

focusable - 이 컴퍼넌트가 포커스를 취득할 수 있을지 어떨지를 나타내는

도입된 버전 :

1.4

관련 항목:

isFocusable()

setFocusTraversalKeys

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

이 컴퍼넌트의 지정된 traversal 조작에 대한 포커스 traversal 키를 설정합니다.

컴퍼넌트의 포커스 traversal 키의 기본값는 구현에 따라서 다릅니다. 썬마이크로시스템사에서는 1개의 네이티브 플랫폼에서는 같은 기본값 의 사용을 추천하고 있습니다. Windows 및 Unix 환경에서의 추천치를 다음에 기재합니다. 이것들은 Sun AWT 구현에 사용됩니다.

식별자	의미	디폴트
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	보통 의 순서 방향 키보드 traversal	KEY_PRESSED 상의 TAB, KEY_PRESSED 상의 CTRL-TAB
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	보통 의 리버스 키보드 traversal	KEY_PRESSED SHIFT-TAB, KEY_PRESSED CTRL-SHIFT-TAB
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	1개 상의 포커스 traversal 사이클에 이동	없음

traversal 키를 무효화하기 위해서는 빈세트를 사용합니다. Collections.EMPTY_SET 사용을 추천합니다.

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

세트에 값 null이 가리키는 경우, 이 컴퍼넌트는 세트를 부모로부터 상속합니다. 이 컴퍼넌트보다 상위의 모든 컨테이너세트에 값 null이 가리키는 경우, 현재의 KeyboardFocusManager 디폴트 세트가 사용됩니다.

파라미터:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 어느쪽이든

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

예외:

IllegalArgumentException - id가 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 어떤 것도 아닌 경우, 키스트로크(keystroke)가 null인 경우, 키스트로크(keystroke)의 객체중 한쪽이 AWTKeyStroke가 아닌 경우, 키스트로크(keystroke)중 한쪽이 KEY_TYPED 이벤트를 나타내지 않은 경우, 또는 키스트로크(keystroke)중 한쪽이 이 컴퍼넌트의 다른 포커스 traversal 조작에 맵 되고 있는 경우

도입된 버전 :

1.4

관련 항목:

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

getFocusTraversalKeys

public Set <AWTKeyStroke > getFocusTraversalKeys(int id)

이 컴퍼넌트의 지정된 traversal 조작의 포커스 traversal 키세트를 리턴합니다. (모든 키의 설명은 setFocusTraversalKeys를 참조하십시오. )

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

파라미터:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 언젠가

반환값:

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

예외:

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

도입된 버전 :

1.4

관련 항목:

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

areFocusTraversalKeysSet

public boolean areFocusTraversalKeysSet(int id)

지정된 포커스 traversal 조작에 대한 포커스 traversal 키세트가 이 컴퍼넌트에 명시적으로 정의되고 있는지를 리턴합니다. false가 리턴된인 경우, 이 컴퍼넌트는 세트를 상위의 컨테이너로부터, 또는 현재의 KeyboardFocusManager 로부터 상속합니다.

파라미터:

id - KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS 언젠가

반환값:

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

예외:

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

도입된 버전 :

1.4

setFocusTraversalKeysEnabled

public void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)

이 컴퍼넌트에 대해서 포커스 traversal 키를 사용할 수 있을지 어떨지를 나타냅니다. 포커스 traversal 키를 사용할 수 없는 컴퍼넌트는 포커스 traversal 키에 대응하는 키 이벤트를 받습니다. 포커스 traversal 키를 사용할 수 있는 컴퍼넌트는 키 이벤트를 그대로 받지 않고, traversal 조작으로 변환하고 받습니다.

파라미터:

focusTraversalKeysEnabled - 이 컴퍼넌트에 대해서 포커스 traversal 키가 사용 가능한가 어떤가

도입된 버전 :

1.4

관련 항목:

getFocusTraversalKeysEnabled(), setFocusTraversalKeys(int, java.util.Set), getFocusTraversalKeys(int)

getFocusTraversalKeysEnabled

public boolean getFocusTraversalKeysEnabled()

이 컴퍼넌트에 대해서 포커스 traversal 키를 사용할 수 있을지 어떨지를 리턴합니다. 포커스 traversal 키를 사용할 수 없는 컴퍼넌트는 포커스 traversal 키에 대응하는 키 이벤트를 받습니다. 포커스 traversal 키를 사용할 수 있는 컴퍼넌트는 키 이벤트를 그대로 받지 않고, traversal 조작으로 변환하고 받습니다.

반환값:

이 컴퍼넌트에 대해서 포커스 traversal 키가 사용 가능한가 어떤가

도입된 버전 :

1.4

관련 항목:

setFocusTraversalKeysEnabled(boolean), setFocusTraversalKeys(int, java.util.Set), getFocusTraversalKeys(int)

requestFocus

public void requestFocus()

이 컴퍼넌트에 입력초점 취득을 요구해, 또 이 컴퍼넌트가 속하는 계층의 최상정도의 컴퍼넌트를 포커스 설정 윈도우로 합니다. 허가 대상의 요구에 대해서 이 컴퍼넌트가 표시 가능하고, 가시이며, 포커스 설정 가능하지 않으면 안됩니다. 이 요구를 실행하기 위해서 필요한 모든 처리를 합니다만, 경우에 따라서는 불가능한 일도 있습니다. 개발자측에서는 이 컴퍼넌트가 FOCUS_GAINED 이벤트를 받을 때까지 포커스 소유자는 아닌 것에 주의할 필요가 있습니다. 이 컴퍼넌트의 톱 레벨 윈도우에 포커스를 설정할 수 없기 위해 요구가 처리되지 않았던 경우, 이 요구는 기록되어 나중에 사용자가 윈도우에 포커스를 설정할 경우에 허가됩니다.

이 메서드는 포커스 소유자에게 컴퍼넌트를 설정하기 위해서는 사용할 수 없습니다. 이 목적에서는 KeyboardFocusManager.clearGlobalFocusOwner()를 사용합니다.

이 메서드의 포커스 동작은 플랫폼에 따라서 다르기 때문에 개발자측에서는 가능한 한 requestFocusInWindow를 사용하는 것을 강하게 추천합니다.

도입된 버전 :

JDK1. 0

관련 항목:

requestFocusInWindow(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocus

protected boolean requestFocus(boolean temporary)

이 Component에 입력초점 취득을 요구해, 또 이 Component이 속하는 계층의 최상정도의 컴퍼넌트를 포커스 설정 Window로 합니다. 허가 대상의 요구에 대해서 이 컴퍼넌트가 표시 가능하고, 가시이며, 포커스 설정 가능하지 않으면 안됩니다. 이 요구를 실행하기 위해서 필요한 모든 처리를 합니다만, 경우에 따라서는 불가능한 일도 있습니다. 개발자측에서는 이 컴퍼넌트가 FOCUS_GAINED 이벤트를 받을 때까지 포커스 소유자는 아닌 것에 주의할 필요가 있습니다. 이 컴퍼넌트의 톱 레벨 윈도우에 포커스를 설정할 수 없기 위해 요구가 처리되지 않았던 경우, 이 요구는 기록되어 나중에 사용자가 윈도우에 포커스를 설정할 경우에 허가됩니다.

이 메서드는 boolean 형의 값을 리턴합니다. false가 돌려주고졌을 경우, 요구는 확실히 에러가 됩니다. true가 돌려주고졌을 경우, 일반적으로 정상적으로 처리됩니다. 다만, 허가되지 않는 또는 컴퍼넌트의 피어가 파기되는 등의 이상한 이벤트가 네이티브의 윈도우 시스템으로 요구를 허가하기 전에 발생했을 경우는 정상적으로 처리되지 않습니다. true가 돌려주고졌을 경우, 요구는 정상적으로 처리되고 있습니다만, 컴퍼넌트가 FOCUS_GAINED 이벤트를 받을 때까지는 포커스를 취득하고 있지 않는 것에 개발자는 주의하지 않으면 안됩니다.

이 메서드는 포커스 소유자에게 컴퍼넌트를 설정하기 위해서는 사용할 수 없습니다. 이 목적에서는 KeyboardFocusManager.clearGlobalFocusOwner()를 사용합니다.

이 메서드의 포커스 동작은 플랫폼에 따라서 다르기 때문에 개발자측에서는 가능한 한 requestFocusInWindow를 사용하는 것을 강하게 추천합니다.

이 요구의 결과 생성되는 FocusEvent이 지정된 일시치를 확실히 가지도록하기 위한 모든 처리가 실행됩니다. 다만 일부의 네이티브 윈도우 시스템에서는 임의의 일시적인 상태의 지정을 구현할 수 없기 때문에 이 메서드는 경량 Component에 대해서만 정상적으로 동작합니다. 이 메서드는 일반적인 용도 방향이 아닙니다만, Swing와 같은 경량 컴퍼넌트 라이브러리용의 훅으로서 준비되어 있습니다.

파라미터:

temporary - 윈도우가 포커스를 잃었을 경우 등, 포커스 변경이 일시적인 경우는 true. 일시적인 포커스 변경의자세한 내용은 「Focus Specification」를 참조

반환값:

포커스 변경 요구가 확실히 에러가 되는 경우는 false, 정상적으로 실행되는 것 같으면 true

도입된 버전 :

1.4

관련 항목:

FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

public boolean requestFocusInWindow()

이 컴퍼넌트가 속하는 계층의 최상정도 컴퍼넌트에 포커스가 설정되어 있는 경우, 컴퍼넌트가 입력초점을 얻는 것을 요구합니다. 허가 대상의 요구에 대해서 이 컴퍼넌트가 표시 가능하고, 가시이며, 포커스 설정 가능하지 않으면 안됩니다. 이 요구를 실행하기 위해서 필요한 모든 처리를 합니다만, 경우에 따라서는 불가능한 일도 있습니다. 개발자측에서는 이 컴퍼넌트가 FOCUS_GAINED 이벤트를 받을 때까지 포커스 소유자는 아닌 것에 주의할 필요가 있습니다.

이 메서드는 boolean 형의 값을 리턴합니다. false가 돌려주고졌을 경우, 요구는 확실히 에러가 됩니다. true가 돌려주고졌을 경우, 일반적으로 정상적으로 처리됩니다. 다만, 허가되지 않는 또는 컴퍼넌트의 피어가 파기되는 등의 이상한 이벤트가 네이티브의 윈도우 시스템으로 요구를 허가하기 전에 발생했을 경우는 정상적으로 처리되지 않습니다. true가 돌려주고졌을 경우, 요구는 정상적으로 처리되고 있습니다만, 컴퍼넌트가 FOCUS_GAINED 이벤트를 받을 때까지는 포커스를 취득하고 있지 않는 것에 개발자는 주의하지 않으면 안됩니다.

이 메서드는 포커스 소유자에게 컴퍼넌트를 설정하기 위해서는 사용할 수 없습니다. 이 목적에서는 KeyboardFocusManager.clearGlobalFocusOwner()를 사용합니다.

이 메서드의 포커스 동작은 어느 플랫폼으로도 공통이기 때문에 requestFocus 대신에 가능한 한 이 메서드를 사용하는 것을 강하게 추천합니다. requestFocus를 사용하는 경우, 플랫폼에 의해 포커스 동작이 다른 경우가 있습니다.

반환값:

포커스 변경 요구가 확실히 에러가 되는 경우는 false, 정상적으로 실행되는 것 같으면 true

도입된 버전 :

1.4

관련 항목:

requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

이 Component이 속하는 계층의 최상정도 컴퍼넌트에 포커스가 설정되어 있는 경우, Component이 입력초점을 얻는 것을 요구합니다. 허가 대상의 요구에 대해서 이 컴퍼넌트가 표시 가능하고, 가시이며, 포커스 설정 가능하지 않으면 안됩니다. 이 요구를 실행하기 위해서 필요한 모든 처리를 합니다만, 경우에 따라서는 불가능한 일도 있습니다. 개발자측에서는 이 컴퍼넌트가 FOCUS_GAINED 이벤트를 받을 때까지 포커스 소유자는 아닌 것에 주의할 필요가 있습니다.

이 메서드는 boolean 형의 값을 리턴합니다. false가 돌려주고졌을 경우, 요구는 확실히 에러가 됩니다. true가 돌려주고졌을 경우, 일반적으로 정상적으로 처리됩니다. 다만, 허가되지 않는 또는 컴퍼넌트의 피어가 파기되는 등의 이상한 이벤트가 네이티브의 윈도우 시스템으로 요구를 허가하기 전에 발생했을 경우는 정상적으로 처리되지 않습니다. true가 돌려주고졌을 경우, 요구는 정상적으로 처리되고 있습니다만, 컴퍼넌트가 FOCUS_GAINED 이벤트를 받을 때까지는 포커스를 취득하고 있지 않는 것에 개발자는 주의하지 않으면 안됩니다.

이 메서드는 포커스 소유자에게 컴퍼넌트를 설정하기 위해서는 사용할 수 없습니다. 이 목적에서는 KeyboardFocusManager.clearGlobalFocusOwner()를 사용합니다.

이 메서드의 포커스 동작은 어느 플랫폼으로도 공통이기 때문에 requestFocus 대신에 가능한 한 이 메서드를 사용하는 것을 강하게 추천합니다. requestFocus를 사용하는 경우, 플랫폼에 의해 포커스 동작이 다른 경우가 있습니다.

이 요구의 결과 생성되는 FocusEvent이 지정된 일시치를 확실히 가지도록하기 위한 모든 처리가 실행됩니다. 다만 일부의 네이티브 윈도우 시스템에서는 임의의 일시적인 상태의 지정을 구현할 수 없기 때문에 이 메서드는 경량 컴퍼넌트에 대해서만 정상적으로 동작합니다. 이 메서드는 일반적인 용도 방향이 아닙니다만, Swing와 같은 경량 컴퍼넌트 라이브러리용의 훅으로서 준비되어 있습니다.

파라미터:

temporary - 윈도우가 포커스를 잃었을 경우 등, 포커스 변경이 일시적인 경우는 true. 일시적인 포커스 변경의자세한 내용은 「Focus Specification」를 참조

반환값:

포커스 변경 요구가 확실히 에러가 되는 경우는 false, 정상적으로 실행되는 것 같으면 true

도입된 버전 :

1.4

관련 항목:

requestFocus(), FocusEvent, addFocusListener(java.awt.event.FocusListener), isFocusable(), isDisplayable(), KeyboardFocusManager.clearGlobalFocusOwner()

transferFocus

public void transferFocus()

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

도입된 버전 :

JDK1. 1

관련 항목:

requestFocus()

getFocusCycleRootAncestor

public Container  getFocusCycleRootAncestor()

이 컴퍼넌트의 포커스 traversal 사이클의 포커스 사이클 루트인 컨테이너를 리턴합니다. 포커스 traversal 사이클은 각각 포커스 사이클 루트를 1개 가져, 컨테이너 이외의 각 컴퍼넌트는 1개의 포커스 traversal 사이클인 만큼 소속합니다. 포커스 사이클 루트가 되어 있는 컨테이너는 그 자체가 루트가 되어 있는 포커스 사이클과 그 1개 상위의 포커스 사이클 루트가 구성하는 포커스 사이클의 양쪽 모두에 속합니다. 이 메서드는 이러한 컨테이너에 대해서 1개 상위의 포커스 사이클 루트를 리턴합니다.

반환값:

이 컴퍼넌트의 1개 상위의 포커스 사이클 루트

도입된 버전 :

1.4

관련 항목:

Container.isFocusCycleRoot()

isFocusCycleRoot

public boolean isFocusCycleRoot(Container  container)

지정된 컨테이너가 이 컴퍼넌트의 포커스 traversal 사이클의 포커스 사이클 루트일지 어떨지를 리턴합니다. 포커스 traversal 사이클은 각각 1개의 포커스 사이클 루트를 가져, 컨테이너 이외의 각 컴퍼넌트는 1개의 포커스 traversal 사이클에만 속합니다.

파라미터:

container - 판정 대상의 Container

반환값:

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

도입된 버전 :

1.4

관련 항목:

Container.isFocusCycleRoot()

nextFocus

@Deprecated 
public void nextFocus()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 transferFocus()를 사용합니다.

transferFocusBackward

public void transferFocusBackward()

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

도입된 버전 :

1.4

관련 항목:

requestFocus()

transferFocusUpCycle

public void transferFocusUpCycle()

포커스를 1 포커스 traversal 사이클만 상위로 이동합니다. 보통, 포커스 소유자가 이 컴퍼넌트의 포커스 사이클 루트로 설정되어 현재의 포커스 사이클 루트가 새로운 포커스 소유자의 포커스 사이클 루트로 설정됩니다. 컴퍼넌트의 포커스 사이클 루트가 윈도우의 경우, 포커스 소유자는 포커스 사이클 루트의 디폴트 포커스 컴퍼넌트로 설정되어 현재의 포커스 사이클 루트는 변경되지 않습니다.

도입된 버전 :

1.4

관련 항목:

requestFocus(), Container.isFocusCycleRoot(), Container.setFocusCycleRoot(boolean)

hasFocus

public boolean hasFocus()

이 Component이 포커스 소유자의 경우에 true를 리턴합니다. 이 메서드는 현재 isFocusOwner()로 대체되었습니다.

반환값:

이 Component이 포커스 소유자의 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.2

isFocusOwner

public boolean isFocusOwner()

이 Component이 포커스 소유자의 경우는 true를 리턴합니다.

반환값:

이 Component이 포커스 소유자의 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

add

public void add(PopupMenu  popup)

지정된 pop-up menu를 컴퍼넌트에 추가합니다.

파라미터:

popup - 컴퍼넌트에 추가되는 pop-up menu

도입된 버전 :

JDK1. 1

관련 항목:

remove(MenuComponent)

remove

public void remove(MenuComponent  popup)

지정된 pop-up menu를 컴퍼넌트로부터 삭제합니다.

정의:

인터페이스 MenuContainer 내의 remove

파라미터:

popup - 삭제되는 pop-up menu

도입된 버전 :

JDK1. 1

관련 항목:

add(PopupMenu)

paramString

protected String  paramString()

이 컴퍼넌트 상태를 나타내는 캐릭터 라인을 리턴합니다. 이 메서드는 디버그 전용이며, 리턴된 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 리턴된 캐릭터 라인은 비어있는 경우가 있습니다만, null로는 되지 않습니다.

반환값:

이 컴퍼넌트 상태의 캐릭터 라인 표현

도입된 버전 :

JDK1. 0

toString

public String  toString()

이 컴퍼넌트 및 그 값의 캐릭터 라인 표현을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 컴퍼넌트의 캐릭터 라인 표현

도입된 버전 :

JDK1. 0

list

public void list()

표준의 시스템 출력 스트림 System.out에 이 컴퍼넌트의 일람을 출력합니다.

도입된 버전 :

JDK1. 0

관련 항목:

System.out

list

public void list(PrintStream  out)

지정된 출력 스트림에 이 컴퍼넌트의 일람을 출력합니다.

파라미터:

out - 출력 스트림

도입된 버전 :

JDK1. 0

list

public void list(PrintStream  out,
                 int indent)

지정된 인덴트 위치로부터, 지정된 출력 스트림에 일람을 출력합니다.

파라미터:

out - 출력 스트림

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

도입된 버전 :

JDK1. 0

관련 항목:

PrintStream.println(java.lang.Object)

list

public void list(PrintWriter  out)

지정된 프린트 Writer에 일람을 출력합니다.

파라미터:

out - 출력처의 프린트 라이터

도입된 버전 :

JDK1. 1

list

public void list(PrintWriter  out,
                 int indent)

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

파라미터:

out - 출력처의 프린트 라이터

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

도입된 버전 :

JDK1. 1

관련 항목:

PrintStream.println(java.lang.Object)

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")
• 이 컴퍼넌트의 추천 사이즈 ("preferredSize")
• 이 컴퍼넌트의 최소 사이즈 ("minimumSize")
• 이 컴퍼넌트의 최대 사이즈 ("maximumSize")
• 이 컴퍼넌트의 이름 ("name")

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

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

listener - 추가되는 프로퍼티 변경 리스너

관련 항목:

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

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  listener)

리스너 리스트로부터 PropertyChangeListener를 삭제합니다. 이 메서드는 이 클래스의 모든 바운드 프로퍼티에 등록되어 있는 PropertyChangeListener 삭제에 사용합니다.

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

listener - 삭제하는 PropertyChangeListener

관련 항목:

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

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners()

이 컴퍼넌트에 등록되어 모든 프로퍼티 변경 리스너의 배열을 리턴합니다.

반환값:

이 컴퍼넌트의 모든 PropertyChangeListener. 프로퍼티 변경 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

1.4

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), PropertyChangeSupport.getPropertyChangeListeners()

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")

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

propertyName 또는 listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

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

listener - 추가되는 프로퍼티 변경 리스너

관련 항목:

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

removePropertyChangeListener

public void removePropertyChangeListener(String  propertyName,
                                         PropertyChangeListener  listener)

특정의 프로퍼티의 리스너 리스트로부터 PropertyChangeListener를 삭제합니다. 이 메서드는 특정의 바운드 프로퍼티에 등록된 PropertyChangeListener를 삭제하기 위해서 사용할 필요가 있습니다.

propertyName 또는 listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 행해지지 않습니다.

파라미터:

propertyName - 유효한 프로퍼티명

listener - 삭제하는 PropertyChangeListener

관련 항목:

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

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners(String  propertyName)

지정된 프로퍼티에 관련된 모든 리스너의 배열을 리턴합니다.

반환값:

이름 첨부 프로퍼티에 관련된 모든 PropertyChangeListener. 이러한 리스너가 추가되어 있지 않은 경우, 또는 propertyName가 null인 경우는 비어있는 배열이 리턴된

도입된 버전 :

1.4

관련 항목:

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

firePropertyChange

protected void firePropertyChange(String  propertyName,
                                  Object  oldValue,
                                  Object  newValue)

객체 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다. 이 메서드는 바운드 프로퍼티가 변경되었을 때에 불려가 등록되어 모든 PropertyChangeListener 에 대응하는 PropertyChangeEvent를 보냅니다.

파라미터:

propertyName - 값이 변경된 프로퍼티

oldValue - 프로퍼티의 이전의 값

newValue - 프로퍼티의 새로운 값

firePropertyChange

protected void firePropertyChange(String  propertyName,
                                  boolean oldValue,
                                  boolean newValue)

boolean 형 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다. 이 메서드는 바운드 프로퍼티가 변경되었을 때에 불려가 등록되어 모든 PropertyChangeListener 에 대응하는 PropertyChangeEvent를 보냅니다.

파라미터:

propertyName - 값이 변경된 프로퍼티

oldValue - 프로퍼티의 이전의 값

newValue - 프로퍼티의 새로운 값

firePropertyChange

protected void firePropertyChange(String  propertyName,
                                  int oldValue,
                                  int newValue)

정수형 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다. 이 메서드는 바운드 프로퍼티가 변경되었을 때에 불려가 등록되어 모든 PropertyChangeListener 에 대응하는 PropertyChangeEvent를 보냅니다.

파라미터:

propertyName - 값이 변경된 프로퍼티

oldValue - 프로퍼티의 이전의 값

newValue - 프로퍼티의 새로운 값

firePropertyChange

public void firePropertyChange(String  propertyName,
                               byte oldValue,
                               byte newValue)

바운드 프로퍼티의 변경을 통지합니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 프로퍼티의 변경전의 값 (byte)

newValue - 프로퍼티의 변경 후의 값 (byte)

도입된 버전 :

1.5

관련 항목:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String  propertyName,
                               char oldValue,
                               char newValue)

바운드 프로퍼티의 변경을 통지합니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 프로퍼티의 변경전의 값 (char)

newValue - 프로퍼티의 변경 후의 값 (char)

도입된 버전 :

1.5

관련 항목:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String  propertyName,
                               short oldValue,
                               short newValue)

바운드 프로퍼티의 변경을 통지합니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 프로퍼티의 변경 후의 값 (short)

newValue - 프로퍼티의 변경 후의 값 (short)

도입된 버전 :

1.5

관련 항목:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String  propertyName,
                               long oldValue,
                               long newValue)

바운드 프로퍼티의 변경을 통지합니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 프로퍼티의 변경전의 값 (long)

newValue - 프로퍼티의 변경 후의 값 (long)

도입된 버전 :

1.5

관련 항목:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String  propertyName,
                               float oldValue,
                               float newValue)

바운드 프로퍼티의 변경을 통지합니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 프로퍼티의 변경전의 값 (float)

newValue - 프로퍼티의 변경 후의 값 (float)

도입된 버전 :

1.5

관련 항목:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(String  propertyName,
                               double oldValue,
                               double newValue)

바운드 프로퍼티의 변경을 통지합니다.

파라미터:

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 프로퍼티의 변경전의 값 (double)

newValue - 프로퍼티의 변경 후의 값 (double)

도입된 버전 :

1.5

관련 항목:

firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

setComponentOrientation

public void setComponentOrientation(ComponentOrientation  o)

이 컴퍼넌트내의 요소 또는 텍스트를 정렬하기 위해서 사용한다, 언어에 존할 방향을 설정합니다. 언어에 의존된 LayoutManager 서브 클래스 및 Component 서브 클래스는 이 프로퍼티를 사용해 컴퍼넌트의 배치 방법 및 렌더링 방법을 결정합니다.

구축시에는 컴퍼넌트의 방향은 명시적으로 지정되어 있지 않은 것을 나타내는 ComponentOrientation.UNKNOWN 으로 설정됩니다. UNKNOWN 방향의 동작은 ComponentOrientation.LEFT_TO_RIGHT와 같습니다.

컴퍼넌트의 방향 결정을 단독으로 실시하는 경우는 이 메서드를 사용합니다. 컴퍼넌트 계층 전체의 방향을 결정하는 경우는 applyComponentOrientation를 사용합니다.

관련 항목:

ComponentOrientation

getComponentOrientation

public ComponentOrientation  getComponentOrientation()

이 컴퍼넌트내의 요소 또는 텍스트를 정렬하기 위해서 사용한다, 언어에 존할 방향을 취득합니다. LayoutManager 서브 클래스 및 Component 서브 클래스에서는 방향이 중요하고, 이러한 서브 클래스에서는 배치 또는 렌더링를 실행하기 전에 이 메서드를 호출해 컴퍼넌트의 방향을 취득할 필요가 있습니다.

관련 항목:

ComponentOrientation

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation  orientation)

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

파라미터:

orientation - 이 컴퍼넌트와 포함되는 모든 컴퍼넌트의 새로운 컴퍼넌트 방향

예외:

NullPointerException - orientation가 null인 경우

도입된 버전 :

1.4

관련 항목:

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

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 Component에 관련된 AccessibleContext를 리턴합니다. 이 기본 클래스에 한 메서드 구현에서는 null이 리턴됩니다 . Component를 확장하는 클래스는 이 메서드를 구현해, 서브 클래스에 관련된 AccessibleContext를 돌려주도록 합니다.

반환값:

이 Component AccessibleContext