javax.swing
클래스 JComponent

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          javax.swing.JComponent

모든 구현된 인터페이스:

ImageObserver , MenuContainer , Serializable

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

AbstractButton , BasicInternalFrameTitlePane , Box , Box.Filler , JColorChooser , JComboBox , JFileChooser , JInternalFrame , JInternalFrame.JDesktopIcon , JLabel , JLayeredPane , JList , JMenuBar , JOptionPane , JPanel , JPopupMenu , JProgressBar , JRootPane , JScrollBar , JScrollPane , JSeparator , JSlider , JSpinner , JSplitPane , JTabbedPane , JTable , JTableHeader , JTextComponent , JToolBar , JToolTip , JTree , JViewport

public abstract class JComponent
extends Container 
implements Serializable 

톱 레벨의 컨테이너를 제외한 모든 Swing 컴퍼넌트의 base class입니다. JComponent 로부터 상속하는 컴퍼넌트를 사용하려면 , 루트가 톱 레벨의 Swing 컨테이너인 포함 관계의 계층에 컴퍼넌트를 자리 매김을 할 필요가 있습니다. JFrame,JDialog,JApplet 등의 톱 레벨의 Swing 컨테이너는, 다른 Swing 컴퍼넌트가 그것 자신을 draw하기 위한 장소를 제공하는 특수한 컴퍼넌트입니다. 포함 관계의 계층에 대해서는, 「The Java Tutorial」의「Swing Components and the Containment Hierarchy」를 참조해 주세요.

JComponent 클래스는 이하의 기능을 제공합니다.

• Swing 아키텍쳐(architecture)를 사용하는, 표준 컴퍼넌트 및 커스텀 컴퍼넌트 양쪽 모두의 base class.
• 프로그래머가 지정, 또는 옵션으로 사용자가 실행시에 선택할 수 있는 「플러그 인 가능한 Look & Feel (L&F)」. 각 컴퍼넌트의 Look & Feel 는 「UI 위양」, 즉 ComponentUI 로부터 파생하는 객체로 제공됩니다. 상세한 것에 대하여는, 「The Java Tutorial」의「How to Set the Look and Feel」를 참조해 주세요.
• 포괄적인 키스트로크(keystroke) 처리. 상세한 것에 대하여는, 「The Swing Connection」의「Keyboard Bindings in Swing」를 참조해 주세요.
• 툴팁의 지원. 툴팁는 커서가 컴퍼넌트상에 있을 때 표시되는 짧은 설명. 자세한 것은, 「The Java Tutorial」의「How to Use Tool Tips」를 참조해 주세요.
• 접근성? 지원. JComponent 는 인터페이스 Accessible 에 모든 메소드를 포함합니다만, 인터페이스를 실제로는 구현하지 않습니다. 구현은 JComponent 를 확장하는 개개의 클래스에 의존합니다.
• 컴퍼넌트 고유의 프로퍼티의 지원. putClientProperty(java.lang.Object, java.lang.Object) 와 getClientProperty(java.lang.Object) 의 메소드의 경우, 이름과 객체의 페어를 JComponent 로부터 파생하는 어느 객체에도 관련지을 수가 있습니다.
• 더블 버퍼링과 경계의 지원에 대응하고 있는, 페인트를 위한 인프라스트럭쳐(infrastructure). 상세한 것에 대하여는, 「The Java Tutorial」의「Painting」라고 「How to Use Borders」를 참조해 주세요.

상기의 기능의 상세한 것에 대하여는,「Swing package description」와「 The Java Tutorial」의「The JComponent Class」를 참조해 주세요.

JComponent 와 그 서브 클래스는, 특정의 프로퍼티의 디폴트 값를 문서화합니다. 예를 들어,JTable 는 디폴트의 행의 높이를 16 으로서 문서화합니다. ComponentUI 를 가지는 JComponent 의 각 서브 클래스는,ComponentUI 를 그 생성자 의 일부로서 생성합니다. 각 ComponentUI 에서는, 특수한 Look & Feel 를 제공하기 위해서, 생성원의 JComponent 로 프로퍼티을 다시 설정하는 일이 있습니다. 예를 들어, 커스텀의 Look & Feel 에서는,JTable 의 행의 높이를 24 로 할 필요가 있습니다. 문서화 된 디폴트는,ComponentUI 를 인스톨 하기 전의 프로퍼티의 값입니다. 특정의 프로퍼티에 특정의 값이 필요한 경우는, 그것을 명시적으로 설정해 주세요.

릴리스 1.4 에서는, 포커스 하부조직이 재구축 되었습니다. 상세한 것에 대하여는, 「The Java Tutorial」의「How to Use the Focus Subsystem」를 참조해 주세요.

경고: Swing 는 thread에 대해서 안전하지는 않습니다. 자세한 것은,「Swing's Threading Policy」를 참조해 주세요.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans^™ 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

관련 항목:

KeyStroke , Action , setBorder(javax.swing.border.Border) , registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int) , JOptionPane , setDebugGraphicsOptions(int) , setToolTipText(java.lang.String) , setAutoscrolls(boolean)

상자의 클래스의 개요

class

JComponent.AccessibleJComponent 접근성?의 디폴트 지원를 제공하기 위해서 사용하는 JComponen 의 내부 클래스입니다.

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

Container.AccessibleAWTContainer

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

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

필드의 개요

protected AccessibleContext	accessibleContext 이 JComponent 에 관련지을 수 있었던 AccessibleContext 입니다.
protected EventListenerList	listenerList 이 컴퍼넌트의 이벤트 청취자 리스트입니다.
static String	TOOL_TIP_TEXT_KEY 커서가 컴퍼넌트상에 있을 때 표시되는 코멘트입니다.
protected ComponentUI	ui 이 컴퍼넌트의 Look & Feel 위양입니다.
static int	UNDEFINED_CONDITION 몇개의 API 로 사용되는 정수입니다.
static int	WHEN_ANCESTOR_OF_FOCUSED_COMPONENT registerKeyboardAction() 로 사용되는 정수입니다.
static int	WHEN_FOCUSED registerKeyboardAction 로 사용되는 정수입니다.
static int	WHEN_IN_FOCUSED_WINDOW registerKeyboardAction() 로 사용되는 정수입니다.

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

BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT

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

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

생성자 의 개요

JComponent ()
디폴트의 JComponent 생성자 입니다.

메소드의 개요

void	addAncestorListener (AncestorListener listener) listener 를 등록해, 컴퍼넌트 또는 게다가 위객체가 이동하든가, 혹은 가시 또는 불가시가 될 때 그 청취자가 AncestorEvent 를 받아들이도록(듯이) 합니다.
void	addNotify () 이 컴퍼넌트에 현재친컴퍼넌트가 있는 것을, 이 컴퍼넌트에 통지합니다.
void	addVetoableChangeListener (VetoableChangeListener listener) VetoableChangeListener 를 청취자 리스트에 추가합니다.
void	computeVisibleRect (Rectangle visibleRect) Component 의 「가시 구형」을 돌려줍니다.
boolean	contains (int x, int y) 마우스 처리를 위해서(때문에), 이 컴퍼넌트의 정확한 형상을 정의할 기회를 UI 위양에 제공합니다.
JToolTip	createToolTip () 툴팁를 표시하기 위해서 사용되는 JToolTip 의 인스턴스를 돌려줍니다.
void	disable () 추천 되고 있지 않습니다. JDK version 1.1 이후는,java.awt.Component.setEnabled(boolean) 로 옮겨졌습니다.
void	enable () 추천 되고 있지 않습니다. JDK version 1.1 이후는,java.awt.Component.setEnabled(boolean) 로 옮겨졌습니다.
void	firePropertyChange (String propertyName, boolean oldValue, boolean newValue) boolean 형 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다.
void	firePropertyChange (String propertyName, char oldValue, char newValue) 바운드 프로퍼티의 변경을 통지합니다.
void	firePropertyChange (String propertyName, int oldValue, int newValue) 정수형 프로퍼티에 대한 바운드 프로퍼티의 변경의 보고를 지원합니다.
protected void	fireVetoableChange (String propertyName, Object oldValue, Object newValue) 제약 프로퍼티의 변경의 보고를 지원합니다.
AccessibleContext	getAccessibleContext () JComponent 에 관련한 AccessibleContext 를 돌려줍니다.
ActionListener	getActionForKeyStroke (KeyStroke aKeyStroke) 지정된 키스트로크(keystroke)에 대해서 등록되어 있는 액션을 실행하는 객체를 돌려줍니다.
ActionMap	getActionMap () 특정의 KeyStroke 바인딩에 대해서 트리거하는 Action 의 지정에 사용되는 ActionMap 를 돌려줍니다.
float	getAlignmentX () Container.getAlignmentX 를 오버라이드(override) 해, 수직의 배치 방법을 돌려줍니다.
float	getAlignmentY () Container.getAlignmentY 를 오버라이드(override) 해, 수평의 배치 방법을 돌려주도록(듯이) 합니다.
AncestorListener []	getAncestorListeners () 이 컴퍼넌트에 등록되어 모든 상위 청취자의 배열을 돌려줍니다.
boolean	getAutoscrolls () autoscrolls 프로퍼티을 돌려줍니다.
int	getBaseline (int width, int height) baseline를 돌려줍니다.
Component.BaselineResizeBehavior	getBaselineResizeBehavior () 컴퍼넌트의 사이즈가 변화하는 것에 따라 baseline가 변화하는 방법의 열거를 돌려줍니다.
Border	getBorder () 이 컴퍼넌트의 경계를 돌려줍니다.
Rectangle	getBounds (Rectangle rv) 이 컴퍼넌트의 경계를 「반환값」rv 에 포함해,rv 를 돌려줍니다.
Object	getClientProperty (Object key) 지정된 키를 가지는 프로퍼티의 값을 돌려줍니다.
protected Graphics	getComponentGraphics (Graphics g) 이 컴퍼넌트를 페인트 하기 위해서 사용되는 그래픽스 객체를 돌려줍니다.
JPopupMenu	getComponentPopupMenu () 이 컴퍼넌트에 할당할 수 있었던 JPopupMenu 를 돌려줍니다.
int	getConditionForKeyStroke (KeyStroke aKeyStroke) 등록되어 있는 액션이, 지정된 키스트로크(keystroke)에 반응해 발생할지 어떨지를 결정하는 조건을 돌려줍니다.
int	getDebugGraphicsOptions () 그라픽스데밧깅 상태를 돌려줍니다.
static Locale	getDefaultLocale () 각 JComponent 의 로케일 프로퍼티을 생성시에 초기화하기 위해서 사용하는 디폴트 로케일을 돌려줍니다.
FontMetrics	getFontMetrics (Font font) 지정된 Font 의 FontMetrics 를 돌려줍니다.
Graphics	getGraphics () 이 컴퍼넌트의 그래픽스 문맥을 돌려줍니다.
int	getHeight () 이 컴퍼넌트의 현재의 높이를 돌려줍니다.
boolean	getInheritsPopupMenu () JPopupMenu 가 부모로부터 상속될 것인 경우는 true 를 돌려줍니다.
InputMap	getInputMap () 컴퍼넌트가 포커스를 취득했을 때에 사용하는 InputMap 를 돌려줍니다.
InputMap	getInputMap (int condition) condition 로 사용되고 있는 InputMap 를 돌려줍니다.
InputVerifier	getInputVerifier () 이 컴퍼넌트의 입력 검증자를 돌려줍니다.
Insets	getInsets () 이 컴퍼넌트로 경계가 설정되어 있는 경우는 경계의 인 세트를 돌려주어, 그렇지 않은 경우는 super.getInsets 를 호출합니다.
Insets	getInsets (Insets insets) 이 컴퍼넌트의 인 세트치를 포함하는 Insets 객체를 돌려줍니다.
<T extends EventListener > T[]	getListeners (Class <T> listenerType) 이 JComponent 에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다.
Point	getLocation (Point rv) 이 컴퍼넌트의 원점의 x, y 좌표를 「반환값」rv 에 포함해,rv 를 돌려줍니다.
Dimension	getMaximumSize () 최대 사이즈가 null 이외의 값으로 설정되어 있는 경우는 그 값을 돌려줍니다.
Dimension	getMinimumSize () 최소 사이즈가 null 이외의 값으로 설정되어 있는 경우는 그 값을 돌려줍니다.
Component	getNextFocusableComponent () 추천 되고 있지 않습니다. JDK Version 1.4 이후는,FocusTraversalPolicy 로 옮겨졌습니다.
Point	getPopupLocation (MouseEvent event) 이 컴퍼넌트의 좌표계에 pop-up menu를 표시하는데 적절한 위치를 돌려줍니다.
Dimension	getPreferredSize () preferredSize 가 null 이외의 값으로 설정되어 있는 경우에 그 값을 돌려줍니다.
KeyStroke []	getRegisteredKeyStrokes () 등록되어 있는 액션을 개시하는 KeyStroke 를 돌려줍니다.
JRootPane	getRootPane () 이 컴퍼넌트의 JRootPane 상위 컴퍼넌트를 돌려줍니다.
Dimension	getSize (Dimension rv) 이 컴퍼넌트의 폭과 높이를 「반환값」rv 에 포함해,rv 를 돌려줍니다.
Point	getToolTipLocation (MouseEvent event) 이 컴퍼넌트의 좌표계에 있어서의 툴팁의 위치를 돌려줍니다.
String	getToolTipText () setToolTipText 로 설정되어 있는 툴팁의 캐릭터 라인을 돌려줍니다.
String	getToolTipText (MouseEvent event) event 의 툴팁로서 사용되는 캐릭터 라인을 돌려줍니다.
Container	getTopLevelAncestor () 이 컴퍼넌트의 톱 레벨의 상위 객체 (포함처의 Window 또는 Applet)를 돌려줍니다.
TransferHandler	getTransferHandler () transferHandler 프로퍼티을 돌려줍니다.
String	getUIClassID () 이 컴퍼넌트의 Look & Feel 를 정의하는 swing.plaf.ComponentUI 클래스의 이름을 검색하기 위해서 사용하는 UIDefaults 키를 돌려줍니다.
boolean	getVerifyInputWhenFocusTarget () 이 컴퍼넌트가 포커스를 요구하기 전에, 현재의 포커스를 가지는 컴퍼넌트에 입력 검증자를 호출할지 어떨지를 나타내는 값을 돌려줍니다.
VetoableChangeListener []	getVetoableChangeListeners () 이 컴퍼넌트에 등록되어 모든 거부 가능 변경 청취자의 배열을 돌려줍니다.
Rectangle	getVisibleRect () 이것은 이 메소드의 반환값입니다.
int	getWidth () 이 컴퍼넌트의 현재의 폭을 돌려줍니다.
int	getX () 컴퍼넌트의 원점의 현재의 x 좌표를 돌려줍니다.
int	getY () 컴퍼넌트의 원점의 현재의 y 좌표를 돌려줍니다.
void	grabFocus () 이 컴퍼넌트가 입력초점을 취득해, 이 컴퍼넌트의 최상정도 클래스의 윈도우에 포커스를 설정하는 것을 요구합니다.
boolean	isDoubleBuffered () 이 컴퍼넌트가 버퍼를 사용해 페인트 할지 어떨지를 돌려줍니다.
static boolean	isLightweightComponent (Component c) 이 컴퍼넌트가 경량의 경우, 즉 네이티브의 윈도우 시스템 피어를 가지지 않는 경우에 true 를 돌려줍니다.
boolean	isManagingFocus () 추천 되고 있지 않습니다. 1.4 이후는 Component.setFocusTraversalKeys(int, Set) 와 Container.setFocusCycleRoot(boolean) 로 옮겨졌습니다.
boolean	isOpaque () 이 컴퍼넌트가 완전하게 불투명한 경우에 true 를 돌려줍니다.
boolean	isOptimizedDrawingEnabled () 이 컴퍼넌트가 그 아이를 타일링 하는 경우, 즉 아이가 오버랩 하지 않는 것이 보증되는 경우에 true 를 돌려줍니다.
boolean	isPaintingForPrint () 이 컴퍼넌트상의 현재의 페인트 조작이 다른 print 조작의 일부인 경우는 true 를 돌려줍니다.
boolean	isPaintingTile () 컴퍼넌트가 현재 타일을 페인트 하고 있는 경우에 true 를 돌려줍니다.
boolean	isRequestFocusEnabled () 이 JComponent 가 포커스를 취득하는 경우는 true 를 돌려주어, 그렇지 않은 경우는 false 를 돌려줍니다.
boolean	isValidateRoot () 이 메소드가 true 를 돌려주는 경우, 이 컴퍼넌트의 하위 컴퍼넌트에 의해 revalidate 가 불려 가면(자), 이 루트로 시작되는 트리 전체가 검증됩니다.
void	paint (Graphics g) 이 메소드는 Swing 에 의해 불려 가 컴퍼넌트를 draw 합니다.
protected void	paintBorder (Graphics g) 컴퍼넌트의 경계를 그립니다.
protected void	paintChildren (Graphics g) 이 컴퍼넌트의 아이를 그립니다.
protected void	paintComponent (Graphics g) UI 위양이 null 가 아닌 경우에, UI 위양의 페인트 메소드를 호출합니다.
void	paintImmediately (int x, int y, int w, int h) 이 컴퍼넌트의 지정된 영역, 및 그 영역과 오버랩 하는 모든 하위 컴퍼넌트를 곧바로 그립니다.
void	paintImmediately (Rectangle r) 지정된 영역을 곧바로 그립니다.
protected String	paramString () 이 JComponent 의 캐릭터 라인 표현을 돌려줍니다.
void	print (Graphics g) 컴퍼넌트를 지정의 Graphics 에 인쇄하려면 , 이 메소드를 호출합니다.
void	printAll (Graphics g) 컴퍼넌트를 인쇄하려면 , 이 메소드를 호출합니다.
protected void	printBorder (Graphics g) 컴퍼넌트의 경계를 그립니다.
protected void	printChildren (Graphics g) 이 컴퍼넌트의 아이를 그립니다.
protected void	printComponent (Graphics g) 이 메소드는 인쇄 조작중에 불려 갑니다.
protected void	processComponentKeyEvent (KeyEvent e) 컴퍼넌트 자체가 인식하는 키 이벤트를 처리합니다.
protected boolean	processKeyBinding (KeyStroke ks, KeyEvent e, int condition, boolean pressed) KeyEvent e 의 결과로서 ks 의 키 바인드를 처리하기 위해서 불려 갑니다.
protected void	processKeyEvent (KeyEvent e) 이벤트를 처리하는 processKeyEvent 를 오버라이드(override) 합니다.
protected void	processMouseEvent (MouseEvent e) 이 컴퍼넌트로 발생하는 마우스 이벤트를, 등록되어 모든 MouseListener 객체에 발송 하는 것으로써, 마우스 이벤트를 처리합니다.
protected void	processMouseMotionEvent (MouseEvent e) MouseEvent.MOUSE_DRAGGED 등의 마우스 모션 이벤트를 처리합니다.
void	putClientProperty (Object key, Object value) 임의의 키와 값을 조합한 클라이언트 프로퍼티을 이 컴퍼넌트에 추가합니다.
void	registerKeyboardAction (ActionListener anAction, KeyStroke aKeyStroke, int aCondition) 이 메소드는 현재 사용되고 있지 않습니다.
void	registerKeyboardAction (ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition) 이 메소드는 현재 사용되고 있지 않습니다.
void	removeAncestorListener (AncestorListener listener) listener 의 등록을 해제해, 그 청취자가 AncestorEvent 를 받지 않게 합니다.
void	removeNotify () 이 컴퍼넌트에 친컴퍼넌트가 없어진 것을, 이 컴퍼넌트에 통지합니다.
void	removeVetoableChangeListener (VetoableChangeListener listener) VetoableChangeListener 를 청취자 리스트로부터 삭제합니다.
void	repaint (long tm, int x, int y, int width, int height) 컴퍼넌트가 표시되고 있는 경우에, 지정된 영역을 더티 리젼 리스트에 추가합니다.
void	repaint (Rectangle r) 컴퍼넌트가 표시되고 있는 경우에, 지정된 영역을 더티 리젼 리스트에 추가합니다.
boolean	requestDefaultFocus () 추천 되고 있지 않습니다. 1.4 이후는 FocusTraversalPolicy.getDefaultComponent(Container). requestFocus() 로 옮겨졌습니다.
void	requestFocus () 이 Component 가 입력초점을 취득하는 것을 요구합니다.
boolean	requestFocus (boolean temporary) 이 Component 가 입력초점을 취득하는 것을 요구합니다.
boolean	requestFocusInWindow () 이 Component 가 입력초점을 취득하는 것을 요구합니다.
protected boolean	requestFocusInWindow (boolean temporary) 이 Component 가 입력초점을 취득하는 것을 요구합니다.
void	resetKeyboardActions () 제 1 층의 InputMap 와 ActionMap 의 바인딩을 모두 등록 해제합니다.
void	reshape (int x, int y, int w, int h) 추천 되고 있지 않습니다. JDK 5 이후는,Component.setBounds(int, int, int, int) 로 옮겨졌습니다. 이 컴퍼넌트를 이동해, 사이즈 변경합니다.
void	revalidate () 지연 자동 레이아웃을 지원합니다.
void	scrollRectToVisible (Rectangle aRect) scrollRectToVisible() 메세지를 JComponent 의 부모에게 전송 합니다.
void	setActionMap (ActionMap am) ActionMap 를 am 로 설정합니다.
void	setAlignmentX (float alignmentX) 수직의 배치 방법을 설정합니다.
void	setAlignmentY (float alignmentY) 수평의 배치 방법을 설정합니다.
void	setAutoscrolls (boolean autoscrolls) autoscrolls 프로퍼티을 설정합니다.
void	setBackground (Color bg) 이 컴퍼넌트의 백그라운드 칼라를 설정합니다.
void	setBorder (Border border) 이 컴퍼넌트의 경계를 설정합니다.
void	setComponentPopupMenu (JPopupMenu popup) 이 JComponent 의 JPopupMenu 를 설정합니다.
void	setDebugGraphicsOptions (int debugOptions) 이 컴퍼넌트, 또는 그 아이의 어떤 것인가로 실행되는 모든 그래픽 조작에 대한 진단 정보를 유효화 또는 무효화합니다.
static void	setDefaultLocale (Locale l) 각 JComponent 의 로케일 프로퍼티을 생성시에 초기화하기 위해서 사용하는 디폴트 로케일을 설정합니다.
void	setDoubleBuffered (boolean aFlag) 이 컴퍼넌트가 버퍼를 사용해 페인트 할지 어떨지를 설정합니다.
void	setEnabled (boolean enabled) 이 컴퍼넌트가 유효한지 어떤지를 설정합니다.
void	setFocusTraversalKeys (int id, Set <? extends AWTKeyStroke > keystrokes) 이 컴퍼넌트의 지정된 traversal 조작에 대한 포커스 traversal 키를 설정합니다.
void	setFont (Font font) 이 컴퍼넌트의 폰트를 설정합니다.
void	setForeground (Color fg) 이 컴퍼넌트의 foreground 칼라를 설정합니다.
void	setInheritsPopupMenu (boolean value) 이 컴퍼넌트에 JPopupMenu 를 할당할 수 있지 않은 경우에 getComponentPopupMenu 가 부모에게 위양 될지 어떨지를 설정합니다.
void	setInputMap (int condition, InputMap map) 조건 condition 로 사용하는 InputMap 를 map 로 설정합니다.
void	setInputVerifier (InputVerifier inputVerifier) 이 컴퍼넌트의 입력 검증자를 설정합니다.
void	setMaximumSize (Dimension maximumSize) 이 컴퍼넌트의 최대 사이즈를 정수치로 설정합니다.
void	setMinimumSize (Dimension minimumSize) 이 컴퍼넌트의 최소 사이즈를 정수치로 설정합니다.
void	setNextFocusableComponent (Component aComponent) 추천 되고 있지 않습니다. JDK Version 1.4 이후는,FocusTraversalPolicy 로 옮겨졌습니다.
void	setOpaque (boolean isOpaque) true 의 경우, 컴퍼넌트는 그 경계내의 모든 픽셀을 그립니다.
void	setPreferredSize (Dimension preferredSize) 이 컴퍼넌트의 적절한 사이즈를 설정합니다.
void	setRequestFocusEnabled (boolean requestFocusEnabled) 이 JComponent 가 포커스를 취득할지 어떨지에 대한 힌트를 제공합니다.
void	setToolTipText (String text) 툴팁에 표시하는 텍스트를 등록합니다.
void	setTransferHandler (TransferHandler newHandler) transferHandler 프로퍼티을 설정합니다.
protected void	setUI (ComponentUI newUI) 이 컴퍼넌트의 Look & Feel 의 위양을 설정합니다.
void	setVerifyInputWhenFocusTarget (boolean verifyInputWhenFocusTarget) 이 컴퍼넌트가 포커스를 요구하기 전에, 현재의 포커스를 가지는 컴퍼넌트에 입력 검증자를 호출할지 어떨지를 나타내는 값을 설정합니다.
void	setVisible (boolean aFlag) 컴퍼넌트를 가시 또는 불가시로 합니다.
void	unregisterKeyboardAction (KeyStroke aKeyStroke) 이 메소드는 현재 사용되고 있지 않습니다.
void	update (Graphics g) paint 를 호출합니다.
void	updateUI () 현재의 Look & Feel 로부터의 값에 UI 프로퍼티을 리셋 합니다.

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

add , add , add , add , add , addContainerListener , addImpl , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getComponentZOrder , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , getMousePosition , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setComponentZOrder , setFocusCycleRoot , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , setLayout , transferFocusBackward , transferFocusDownCycle , validate , validateTree

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

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

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

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

필드의 상세

ui

protected transient ComponentUI  ui

이 컴퍼넌트의 Look & Feel 위양입니다.

listenerList

protected EventListenerList  listenerList

이 컴퍼넌트의 이벤트 청취자 리스트입니다.

WHEN_FOCUSED

public static final int WHEN_FOCUSED

registerKeyboardAction 로 사용되는 정수입니다. 컴퍼넌트에 포커스가 설정되었을 때에 커멘드를 호출하는 것을 나타냅니다.

관련 항목:

정수 필드치

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

public static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

registerKeyboardAction() 로 사용되는 정수입니다. 수신측 컴퍼넌트가 포커스를 가지는 컴퍼넌트의 상위인지, 그 자체가 포커스를 가지는 컴퍼넌트인 경우에, 커멘드를 호출하는 것을 나타냅니다.

관련 항목:

정수 필드치

WHEN_IN_FOCUSED_WINDOW

public static final int WHEN_IN_FOCUSED_WINDOW

registerKeyboardAction() 로 사용되는 정수입니다. 수신측 컴퍼넌트가 포커스를 가지는 윈도우내에 있는지, 그 자체가 포커스를 가지는 컴퍼넌트인 경우에, 커멘드를 호출하는 것을 나타냅니다.

관련 항목:

정수 필드치

UNDEFINED_CONDITION

public static final int UNDEFINED_CONDITION

몇개의 API 로 사용되는 정수입니다. 조건이 정의되어 있지 않은 것을 나타냅니다.

관련 항목:

정수 필드치

TOOL_TIP_TEXT_KEY

public static final String  TOOL_TIP_TEXT_KEY

커서가 컴퍼넌트상에 있을 때 표시되는 코멘트입니다. 「값힌트」, 「부유 헬프」, 또는 「부유 라벨」이라고도 불립니다.

관련 항목:

정수 필드치

accessibleContext

protected AccessibleContext  accessibleContext

이 JComponent 에 관련지을 수 있었던 AccessibleContext 입니다.

생성자 의 상세

JComponent

public JComponent()

디폴트의 JComponent 생성자 입니다. 이 생성자 에서는,Container 생성자 호출전의 초기화는 거의 실행되지 않습니다. 예를 들어 초기 레이아웃 매니저는 null 입니다. 컴퍼넌트의 로케일 프로퍼티은 JComponent.getDefaultLocale 로 반환된 값으로 설정합니다.

관련 항목:

getDefaultLocale()

메소드의 상세

setInheritsPopupMenu

public void setInheritsPopupMenu(boolean value)

이 컴퍼넌트에 JPopupMenu 를 할당할 수 있지 않은 경우에 getComponentPopupMenu 가 부모에게 위양 될지 어떨지를 설정합니다.

이 메소드의 디폴트 값는 false 입니다만, 다수의 JComponent 로서 구현되는 일부의 JComponent 서브 클래스에서는 이 메소드를 true 로 설정합니다.

이것은 바운드 프로퍼티입니다.

파라미터:

value - JPopupMenu 가 상속될지 어떨지

도입된 버젼:

1.5

관련 항목:

setComponentPopupMenu(javax.swing.JPopupMenu)

getInheritsPopupMenu

public boolean getInheritsPopupMenu()

JPopupMenu 가 부모로부터 상속될 것인 경우는 true 를 돌려줍니다.

도입된 버젼:

1.5

관련 항목:

setComponentPopupMenu(javax.swing.JPopupMenu)

setComponentPopupMenu

public void setComponentPopupMenu(JPopupMenu  popup)

이 JComponent 의 JPopupMenu 를 설정합니다. 이 UI 는,JPopupMenu 가 적절한 타이밍에 표시되도록(듯이), 바인딩을 등록하거나 필요한 청취자를 추가하거나 합니다. JPopupMenu 가 언제 표시될까는, Look & Feel 에 따라서 달라, 마우스 이벤트로 표시되는 일도 있으면, 키 바인딩이 유효하게 될 수도 있습니다.

popup 가 null 로,getInheritsPopupMenu 가 true 를 돌려주는 경우는,getComponentPopupMenu 이 부모에게 위양 됩니다. 이것에 의해, 모든 아이 컴퍼넌트에 부모의 pop-up menu를 상속시킬 수가 있습니다.

이것은 바운드 프로퍼티입니다.

파라미터:

popup - 이 컴퍼넌트에 할당할 수 있는 pop-up. null 의 경우도 있는

도입된 버젼:

1.5

관련 항목:

getComponentPopupMenu()

getComponentPopupMenu

public JPopupMenu  getComponentPopupMenu()

이 컴퍼넌트에 할당할 수 있었던 JPopupMenu 를 돌려줍니다. 이 컴퍼넌트에 JPopupMenu 를 할당할 수 있지 않고,getInheritsPopupMenu 가 true 의 경우는,getParent(). getComponentPopupMenu() 이 돌려주어집니다 (부모가 유효하다 것으로 한다).

반환값:

이 컴퍼넌트에 할당할 수 있었던 JPopupMenu, pop-up를 할당할 수 있지 않은 경우는 null

도입된 버젼:

1.5

관련 항목:

setComponentPopupMenu(javax.swing.JPopupMenu)

updateUI

public void updateUI()

현재의 Look & Feel 로부터의 값에 UI 프로퍼티을 리셋 합니다. JComponent 의 서브 클래스는, 다음과 같이 이 메소드를 오버라이드(override) 할 필요가 있습니다.

   public void updateUI() {
      setUI((SliderUI) UIManager.getUI(this);
   }
  

관련 항목:

setUI(javax.swing.plaf.ComponentUI) , UIManager.getLookAndFeel() , UIManager.getUI(javax.swing.JComponent)

setUI

protected void setUI(ComponentUI  newUI)

이 컴퍼넌트의 Look & Feel 의 위양을 설정합니다. 일반적으로,JComponent 의 서브 클래스는 이 메소드를 오버라이드(override) 해 인수의 형태를 네로우 변환할 필요가 있습니다. 다음에 JSlider 의 예를 나타냅니다.

 public void setUI(SliderUI newUI) {
     super.setUI(newUI);
 }
  

또,JComponent 의 서브 클래스는 올바른 형태를 돌려주는 getUI 메소드를 제공할 필요가 있습니다. 다음에 예를 나타냅니다.

 public SliderUI getUI() {
     return (SliderUI) ui;
 }
 

파라미터:

newUI - 신규의 UI 위양

관련 항목:

updateUI() , UIManager.getLookAndFeel() , UIManager.getUI(javax.swing.JComponent)

getUIClassID

public String  getUIClassID()

이 컴퍼넌트의 Look & Feel 를 정의하는 swing.plaf.ComponentUI 클래스의 이름을 검색하기 위해서 사용하는 UIDefaults 키를 돌려줍니다. 대부분의 어플리케이션은, 이 메소드를 호출할 필요는 없습니다. 플러그 인 가능한 Look & Feel 를 지원하는 JComponent 의 서브 클래스는, 이 메소드를 오버라이드(override) 해,UIDefaults 키를 돌려줍니다. 이 키는, Look & Feel 를 정의하는 ComponentUI 서브 클래스에 맵 됩니다.

반환값:

ComponentUI 서브 클래스의 UIDefaults 키

관련 항목:

UIDefaults.getUI(javax.swing.JComponent)

getComponentGraphics

protected Graphics  getComponentGraphics(Graphics  g)

이 컴퍼넌트를 페인트 하기 위해서 사용되는 그래픽스 객체를 돌려줍니다. DebugGraphics 가 온의 경우, 필요한 때에 신규 DebugGraphics 객체를 생성합니다. 그렇지 않은 경우, 단순하게 지정된 그래픽스 객체의 foreground와 폰트를 설정합니다.

파라미터:

g - 오리지날의 Graphics 객체

반환값:

이 컴퍼넌트를 위해서(때문에) 설정된 Graphics 객체

paintComponent

protected void paintComponent(Graphics  g)

UI 위양이 null 가 아닌 경우에, UI 위양의 페인트 메소드를 호출합니다. 위양에는 Graphics 객체의 카피를 건네주어, 나머지의 페인트 코드에 대해서 취소할 수 없는 변경을 하지 않게 보호합니다 (예를 들어 Graphics.translate 등).

이 메소드를 서브 클래스에서 오버라이드(override) 하는 경우는, 건네받은 Graphics 의 객체에는 영속적인 변경은 실시하지 않게 합니다. 예를 들어 Rectangle 클립이나 변환은 변경하지 않습니다. 이러한 변경이 필요한 경우는, 건네받은 Graphics 로부터 새로운 Graphics 를 생성해, 그것을 변경하는 편이 용이합니다. 한층 더 상위 객체의 구현을 실시하지 않는 경우는, 불투명 프로퍼티에 주의할 필요가 있습니다. 즉 이 컴퍼넌트가 불투명한 경우는, 백그라운드에는 불투명하지 않은 색을 사용할 필요가 있습니다. 불투명 프로퍼티을 무시하면 화면이 보기 나뻐집니다.

건네받은 Graphics 객체에는, 인스톨 되고 있는 변환 이외의 변환이 포함되어 있는 일이 있습니다. 이 경우, 다른 변환을 누적적으로 적용하면(자), 예기치 않은 결과가 생길 가능성이 있습니다.

파라미터:

g - 보호 대상의 Graphics 객체

관련 항목:

paint(java.awt.Graphics) , ComponentUI

paintChildren

protected void paintChildren(Graphics  g)

이 컴퍼넌트의 아이를 그립니다. shouldUseBuffer 가 true 의 경우, 컴퍼넌트의 상위 객체는 버퍼를 가지지 않고, 컴퍼넌트의 아이는 각각 독자적인 버퍼를 가질 때 버퍼를 사용할 수 있습니다. 그렇지 않은 경우, 상위 객체가 버퍼를 현재 사용중이며, 아이는 draw를 위한 버퍼를 사용할 수 없습니다.

파라미터:

g - 페인트 대상의 Graphics 문맥

관련 항목:

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

paintBorder

protected void paintBorder(Graphics  g)

컴퍼넌트의 경계를 그립니다.

이 메소드를 서브 클래스에서 오버라이드(override) 하는 경우는, 건네받은 Graphics 의 객체에는 영속적인 변경은 실시하지 않게 합니다. 예를 들어 Rectangle 클립이나 변환은 변경하지 않습니다. 이러한 변경이 필요한 경우는, 건네받은 Graphics 로부터 새로운 Graphics 를 생성해, 그것을 변경하는 편이 용이합니다.

파라미터:

g - 페인트 대상의 Graphics 문맥

관련 항목:

paint(java.awt.Graphics) , setBorder(javax.swing.border.Border)

update

public void update(Graphics  g)

paint 를 호출합니다. 백그라운드의 클리어는 실시하지 않고,paintComponent 에 의해 불려 가는 ComponentUI.update 를 참조합니다.

오버라이드(override):

클래스 Container 내의 update

파라미터:

g - 페인트 대상의 Graphics 문맥

관련 항목:

paint(java.awt.Graphics) , paintComponent(java.awt.Graphics) , ComponentUI

paint

public void paint(Graphics  g)

이 메소드는 Swing 에 의해 불려 가 컴퍼넌트를 draw 합니다. 어플리케이션으로부터는 paint 를 직접 호출하지 않게 합니다. 대신에 repaint 메소드를 사용해 컴퍼넌트의 재draw를 스케줄 할 필요가 있습니다.

이 메소드는, 실제로는 페인트 작업을 3 개의 protected 메소드에 위양 합니다. 그것들은,paintComponent,paintBorder, 및 paintChildren 입니다. 이러한 메소드는, 여기에 늘어놓을 수 있었던 차례로 불려 가 아이가 컴퍼넌트상에 표시되도록(듯이) 합니다. 일반적으로, 컴퍼넌트와 그 아이는, 경계에 할당할 수 있었던 인 세트 영역에는 페인트 하지 않습니다. 서브 클래스는, 일반적으로대로 이 메소드를 오버라이드(override) 할 수 있습니다. UI (Look & Feel) 위양의 paint 메소드를 특수화 하는 서브 클래스는,paintComponent 를 오버라이드(override) 할 필요가 있습니다.

오버라이드(override):

클래스 Container 내의 paint

파라미터:

g - 페인트 대상의 Graphics 문맥

관련 항목:

paintComponent(java.awt.Graphics) , paintBorder(java.awt.Graphics) , paintChildren(java.awt.Graphics) , getComponentGraphics(java.awt.Graphics) , repaint(long, int, int, int, int)

printAll

public void printAll(Graphics  g)

컴퍼넌트를 인쇄하려면 , 이 메소드를 호출합니다. 이 메소드는 컴퍼넌트의 print 를 호출합니다.

오버라이드(override):

클래스 Component 내의 printAll

파라미터:

g - 페인트 대상의 Graphics 문맥

관련 항목:

print(java.awt.Graphics) , printComponent(java.awt.Graphics) , printBorder(java.awt.Graphics) , printChildren(java.awt.Graphics)

print

public void print(Graphics  g)

컴퍼넌트를 지정의 Graphics 에 인쇄하려면 , 이 메소드를 호출합니다. 이 메소드는 printComponent,printBorder 및 printChildren 를 호출합니다. 인쇄의 외관을 커스터마이즈 하는 경우는, 이 메소드는 아니고, 전술의 메소드의 어느쪽이든을 오버라이드(override) 하는 것을 추천합니다. 다만, 슈퍼 클래스의 동작을 호출하기 전에 상태를 준비하는 경우는, 이 메소드를 오버라이드(override) 해도 괜찮습니다. 예를 들어, 인쇄전에 컴퍼넌트의 백그라운드의 색을 변경하는 경우는, 다음과 같이 지정할 수 있습니다.

     public void print(Graphics g) {
         Color orig = getBackground();
         setBackground(Color.WHITE);

         // wrap in try/finally so that we always restore the state
         try {
             super.print(g);
         } finally {
             setBackground(orig);
         }
     }
 

또, 다른 객체에 페인트를 위양 하는 컴퍼넌트의 경우는, 컴퍼넌트가 인쇄 조작중일지 어떨지를 페인트중에 조회할 수 있습니다. 이 기능은,isPaintingForPrint 메소드가 제공합니다. 이 메소드에 의해, 반환값은 draw 직전에 true, draw 직후에 false 로 변경됩니다. 변경이 있을 때마다, 이 컴퍼넌트상에서,paintingForPrint 라는 이름으로 프로퍼티 변경 이벤트가 트리거됩니다.

이 메소드는, 더블 버퍼를 사용하지 않게 컴퍼넌트 상태를 설정합니다. 페인트는, 건네받은 Graphics 상에서 직접 실행됩니다.

오버라이드(override):

클래스 Container 내의 print

파라미터:

g - 페인트 대상의 Graphics 문맥

관련 항목:

printComponent(java.awt.Graphics) , printBorder(java.awt.Graphics) , printChildren(java.awt.Graphics) , isPaintingForPrint()

printComponent

protected void printComponent(Graphics  g)

이 메소드는 인쇄 조작중에 불려 갑니다. 컴퍼넌트의 paintComponent 를 호출하기 위해서(때문에) 구현되고 있습니다. 인쇄시에 특정의 페인트 동작을 추가하는 경우는, 이 메소드를 오버라이드(override) 합니다.

파라미터:

g - 페인트 대상의 Graphics 문맥

도입된 버젼:

1.3

관련 항목:

print(java.awt.Graphics)

printChildren

protected void printChildren(Graphics  g)

이 컴퍼넌트의 아이를 그립니다. 컴퍼넌트의 paintChildren 를 호출하기 위해서(때문에) 구현되고 있습니다. 페인트 하는 아이와는 다른 아이를 인쇄하는 경우는, 이 메소드를 오버라이드(override) 합니다.

파라미터:

g - 페인트 대상의 Graphics 문맥

도입된 버젼:

1.3

관련 항목:

print(java.awt.Graphics)

printBorder

protected void printBorder(Graphics  g)

컴퍼넌트의 경계를 그립니다. 컴퍼넌트의 paintBorder 를 호출하기 위해서(때문에) 구현되고 있습니다. 페인트 하는 경계와는 다른 경계를 출력하고 싶을 때는, 이 메소드를 오버라이드(override) 합니다.

파라미터:

g - 페인트 대상의 Graphics 문맥

도입된 버젼:

1.3

관련 항목:

print(java.awt.Graphics)

isPaintingTile

public boolean isPaintingTile()

컴퍼넌트가 현재 타일을 페인트 하고 있는 경우에 true 를 돌려줍니다. 이 메소드가 true 를 돌려주는 경우, 다른 타일을 위해서(때문에) paint 가 다시 불려 갑니다. 이 메소드는, 타일을 페인트 하고 있지 않는 경우, 또는 마지막 타일이 페인트 되고 있는 경우에 false 를 돌려줍니다. 이 메소드를 사용하면(자), 타일의 사이에 필요할 가능성이 있는 몇개의 상태를 유지할 수 있습니다.

반환값:

컴퍼넌트가 현재 타일을 인쇄하고 있는 경우는 true, 그렇지 않은 경우는 false

isPaintingForPrint

public final boolean isPaintingForPrint()

이 컴퍼넌트상의 현재의 페인트 조작이 다른 print 조작의 일부인 경우는 true 를 돌려줍니다. 이 메소드는, 인쇄 내용과 화면에 표시하는 내용을 커스터마이즈 하는 경우에 사용합니다.

이 프로퍼티의 값의 변화는, 이 컴퍼넌트상에서 paintingForPrint 라는 이름의 프로퍼티 변경 이벤트를 대기하는 것으로 검출할 수 있습니다.

주:이 메소드는, 다른 고레벨 Swing 인쇄 API 에 의해 제공되는 메소드에 대해서 추가 기능을 제공합니다. 다만, 엄밀하게 페인트만을 취급합니다. 보다 고레벨의 인쇄 프로세스에 관한 정보를 제공하는 것은 아닙니다. 예를 들어,JTable.print() 조작을 실행해도, 컴퍼넌트 전체가 연속적으로 draw 되는 결과가 된다고는 할 수 없습니다. 이 메소드의 반환값은, 조작중으로 여러 차례 변경될 가능성이 있습니다. 인쇄 프로세스의 진행중에, 화면에 컴퍼넌트가 페인트 될 가능성도 있습니다. 이러한 경우로, 겉(표)가 인쇄 프로세스의 일부로서 페인트 되고 있을 때 한, 이 메소드의 반환값은 true 가 됩니다.

반환값:

이 컴퍼넌트상의 현재의 페인트 조작이 다른 인쇄 조작의 일부인 경우는 true

도입된 버젼:

1.6

관련 항목:

print(java.awt.Graphics)

isManagingFocus

@Deprecated 
public boolean isManagingFocus()

추천 되고 있지 않습니다. 1.4 이후는 Component.setFocusTraversalKeys(int, Set) 와 Container.setFocusCycleRoot(boolean) 로 옮겨졌습니다.

릴리스 1.4 에서는, 포커스 하부조직이 재구축 되었습니다. 상세한 것에 대하여는, 「The Java Tutorial」의「How to Use the Focus Subsystem」를 참조해 주세요.

이 JComponent 의 포커스 traversal 키를 CTRL+TAB 와 CTRL+SHIFT+TAB 로 변경합니다. 또, 포커스 traversal 사이클 계산시에,SortingFocusTraversalPolicy 를 이 JComponent 의 하위 클래스라고 보지 않게 합니다.

관련 항목:

Component.setFocusTraversalKeys(int, java.util.Set) , SortingFocusTraversalPolicy

setNextFocusableComponent

@Deprecated 
public void setNextFocusableComponent(Component  aComponent)

추천 되고 있지 않습니다. JDK Version 1.4 이후는,FocusTraversalPolicy 로 옮겨졌습니다.

릴리스 1.4 에서는, 포커스 하부조직이 재구축 되었습니다. 상세한 것에 대하여는, 「The Java Tutorial」의「How to Use the Focus Subsystem」를 참조해 주세요.

이 JComponent 의 포커스 traversal 사이클에 대한 디폴트의 FocusTraversalPolicy 를, 지정된 Component 를 사이클의 다음의 Component 로서 무조건 설정해, 오버라이드(override) 합니다. 이 JComponent 는, 사이클내의 지정된 Component 의 전의 Component 로서 설정됩니다.

파라미터:

aComponent - 포커스 traversal 사이클내의 이 JComponent 에 따르는 Component

관련 항목:

getNextFocusableComponent() , FocusTraversalPolicy

getNextFocusableComponent

@Deprecated 
public Component  getNextFocusableComponent()

추천 되고 있지 않습니다. JDK Version 1.4 이후는,FocusTraversalPolicy 로 옮겨졌습니다.

릴리스 1.4 에서는, 포커스 하부조직이 재구축 되었습니다. 상세한 것에 대하여는, 「The Java Tutorial」의「How to Use the Focus Subsystem」를 참조해 주세요.

전의 호출로, 이 JComponent 의 setNextFocusableComponent(Component) 로 설정된 Component 를 돌려줍니다.

반환값:

포커스 traversal 사이클내의 이 JComponent 에 따르는 Component, 명시적으로 지정되고 있는 것이 없는 경우는 null

관련 항목:

setNextFocusableComponent(java.awt.Component)

setRequestFocusEnabled

public void setRequestFocusEnabled(boolean requestFocusEnabled)

이 JComponent 가 포커스를 취득할지 어떨지에 대한 힌트를 제공합니다. 단순한 힌트이며, 이 프로퍼티을 고려해 포커스를 요구할지 어떨지는 컨슈머(consumer)측에서 결정합니다. 이것은 주로 마우스 조작으로 고려되어 키보드 조작에서는 그다지 고려되지 않습니다. 예를 들어 Look & Feel 는, 마우스 조작의 포커스 요구전에, 이 프로퍼티이 true 화도인지를 확인할 수 있습니다. JComponent 상에서의 마우스 클릭으로 포커스를 취득시키지 않고 , 키보드로 JComponent 의 횡단(traverse)을 가능하게 하는 경우에 사용됩니다. 이 JComponent 에 대해서 전혀 포커스를 설정하지 않게 하기 위해서는,setFocusable 메소드를 사용합니다.

상세한 것에 대하여는, 「The Java Tutorial」의 「How to Use the Focus Subsystem」를 참조해 주세요.

파라미터:

requestFocusEnabled - 이 JComponent 에 포커스를 설정 가능하게 할지 어떨지를 나타내는

관련 항목:

Focus Specification , Component.setFocusable(boolean)

isRequestFocusEnabled

public boolean isRequestFocusEnabled()

이 JComponent 가 포커스를 취득하는 경우는 true 를 돌려주어, 그렇지 않은 경우는 false 를 돌려줍니다.

상세한 것에 대하여는, 「The Java Tutorial」의 「How to Use the Focus Subsystem」를 참조해 주세요.

반환값:

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

관련 항목:

setRequestFocusEnabled(boolean) , Focus Specification , Component.isFocusable()

requestFocus

public void requestFocus()

이 Component 가 입력초점을 취득하는 것을 요구합니다. 이 메소드의 상세한 것에 대하여는,Component.requestFocus() 를 참조해 주세요.

이 메소드의 동작은 플랫폼에 의존하고 있기 (위해)때문에, 이 메소드를 사용하는 것은 추천 되지 않습니다. 대신에 requestFocusInWindow() 를 사용하는 것을 추천합니다. 포커스의 상세한 것에 대하여는, 「The Java Tutorial」의 「How to Use the Focus Subsystem」를 참조해 주세요.

오버라이드(override):

클래스 Component 내의 requestFocus

도입된 버젼:

1.4

관련 항목:

Component.requestFocusInWindow() , Component.requestFocusInWindow(boolean)

requestFocus

public boolean requestFocus(boolean temporary)

이 Component 가 입력초점을 취득하는 것을 요구합니다. 이 메소드의 상세한 것에 대하여는,Component.requestFocus(boolean) 를 참조해 주세요.

이 메소드의 동작은 플랫폼에 의존하고 있기 (위해)때문에, 이 메소드를 사용하는 것은 추천 되지 않습니다. 대신에 requestFocusInWindow(boolean) 를 사용하는 것을 추천합니다. 포커스의 상세한 것에 대하여는, 「The Java Tutorial」의 「How to Use the Focus Subsystem」를 참조해 주세요.

오버라이드(override):

클래스 Component 내의 requestFocus

파라미터:

temporary - 포커스의 변경이 일시적인 것인가 어떤가를 나타내는 boolean 치

반환값:

포커스 변경 요구가 확실히 에러가 되는 경우는 false, 성공할 가능성이 있는 경우는 true

도입된 버젼:

1.4

관련 항목:

Component.requestFocusInWindow() , Component.requestFocusInWindow(boolean)

requestFocusInWindow

public boolean requestFocusInWindow()

이 Component 가 입력초점을 취득하는 것을 요구합니다. 이 메소드의 상세한 것에 대하여는,Component.requestFocusInWindow() 를 참조해 주세요.

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

오버라이드(override):

클래스 Component 내의 requestFocusInWindow

반환값:

포커스 변경 요구가 확실히 에러가 되는 경우는 false, 성공할 가능성이 있는 경우는 true

도입된 버젼:

1.4

관련 항목:

Component.requestFocusInWindow() , Component.requestFocusInWindow(boolean)

requestFocusInWindow

protected boolean requestFocusInWindow(boolean temporary)

이 Component 가 입력초점을 취득하는 것을 요구합니다. 이 메소드의 상세한 것에 대하여는,Component.requestFocusInWindow(boolean) 를 참조해 주세요.

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

오버라이드(override):

클래스 Component 내의 requestFocusInWindow

파라미터:

temporary - 포커스의 변경이 일시적인 것인가 어떤가를 나타내는 boolean 치

반환값:

포커스 변경 요구가 확실히 에러가 되는 경우는 false, 성공할 가능성이 있는 경우는 true

도입된 버젼:

1.4

관련 항목:

Component.requestFocusInWindow() , Component.requestFocusInWindow(boolean)

grabFocus

public void grabFocus()

이 컴퍼넌트가 입력초점을 취득해, 이 컴퍼넌트의 최상정도 클래스의 윈도우에 포커스를 설정하는 것을 요구합니다. 이 요구를 허가하기 위해서는, 이 컴퍼넌트가 가시, 표시 가능해 포커스 가능하지 않으면 안됩니다.

이 메소드는 포커스 구현에서의 사용을 상정하고 있습니다. 클라이언트 코드에서는 이 메소드는 아니고,requestFocusInWindow() 를 사용합니다.

관련 항목:

requestFocusInWindow()

setVerifyInputWhenFocusTarget

public void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)

이 컴퍼넌트가 포커스를 요구하기 전에, 현재의 포커스를 가지는 컴퍼넌트에 입력 검증자를 호출할지 어떨지를 나타내는 값을 설정합니다. 디폴트는 true 입니다. 현재의 포커스를 가지는 컴퍼넌트에의 입력이, 그 컴퍼넌트의 입력 검증자로 건네받지 않은 경우에서도 액티브하게 할 필요가 있는 「취소」버튼 또는 스크롤 바등의 컴퍼넌트는, false 로 설정합니다.

파라미터:

verifyInputWhenFocusTarget - verifyInputWhenFocusTarget 프로퍼티의 값

도입된 버젼:

1.3

관련 항목:

InputVerifier , setInputVerifier(javax.swing.InputVerifier) , getInputVerifier() , getVerifyInputWhenFocusTarget()

getVerifyInputWhenFocusTarget

public boolean getVerifyInputWhenFocusTarget()

이 컴퍼넌트가 포커스를 요구하기 전에, 현재의 포커스를 가지는 컴퍼넌트에 입력 검증자를 호출할지 어떨지를 나타내는 값을 돌려줍니다.

반환값:

verifyInputWhenFocusTarget 프로퍼티의 값

도입된 버젼:

1.3

관련 항목:

InputVerifier , setInputVerifier(javax.swing.InputVerifier) , getInputVerifier() , setVerifyInputWhenFocusTarget(boolean)

getFontMetrics

public FontMetrics  getFontMetrics(Font  font)

지정된 Font 의 FontMetrics 를 돌려줍니다. 폰트메트릭스를 취득하는 폰트

오버라이드(override):

클래스 Component 내의 getFontMetrics

파라미터:

font - 폰트메트릭스를 취득하는 폰트

반환값:

font 의 폰트메트릭스

예외:

NullPointerException - font 가 null 의 경우

도입된 버젼:

1.5

관련 항목:

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

setPreferredSize

public void setPreferredSize(Dimension  preferredSize)

이 컴퍼넌트의 적절한 사이즈를 설정합니다. preferredSize 가 null 의 경우, UI 로 적절한 사이즈를 요구합니다.

오버라이드(override):

클래스 Component 내의 setPreferredSize

파라미터:

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

관련 항목:

Component.getPreferredSize() , Component.isPreferredSizeSet()

getPreferredSize

public Dimension  getPreferredSize()

preferredSize 가 null 이외의 값으로 설정되어 있는 경우에 그 값을 돌려줍니다. UI 위양의 getPreferredSize() 메소드가 null 이외의 값을 돌려주는 경우는, 그 값을 돌려줍니다. 그렇지 않은 경우는 컴퍼넌트 레이아웃 매니저에 따릅니다.

오버라이드(override):

클래스 Container 내의 getPreferredSize

반환값:

preferredSize 프로퍼티의 값

관련 항목:

setPreferredSize(java.awt.Dimension) , ComponentUI

setMaximumSize

public void setMaximumSize(Dimension  maximumSize)

이 컴퍼넌트의 최대 사이즈를 정수치로 설정합니다. getMaximumSize 의 이후의 호출로, 항상 이 값을 돌려줍니다. 그 계산을 위해서(때문에) 컴퍼넌트의 UI 가 요구될 것은 없습니다. 최대 사이즈를 null 로 설정하면(자), 디폴트의 동작하러 돌아옵니다.

오버라이드(override):

클래스 Component 내의 setMaximumSize

파라미터:

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

관련 항목:

getMaximumSize()

getMaximumSize

public Dimension  getMaximumSize()

최대 사이즈가 null 이외의 값으로 설정되어 있는 경우는 그 값을 돌려줍니다. UI 위양의 getMaximumSize 메소드가 null 이외의 값을 돌려주는 경우는, 그 값을 돌려줍니다. 그렇지 않은 경우는 컴퍼넌트 레이아웃 매니저에 따릅니다.

오버라이드(override):

클래스 Container 내의 getMaximumSize

반환값:

maximumSize 프로퍼티의 값

관련 항목:

setMaximumSize(java.awt.Dimension) , ComponentUI

setMinimumSize

public void setMinimumSize(Dimension  minimumSize)

이 컴퍼넌트의 최소 사이즈를 정수치로 설정합니다. getMinimumSize 의 이후의 호출로, 항상 이 값을 돌려줍니다. 그 계산을 위해서(때문에) 컴퍼넌트의 UI 가 요구될 것은 없습니다. 최소 사이즈를 null 로 설정하면(자), 디폴트의 동작하러 돌아옵니다.

오버라이드(override):

클래스 Component 내의 setMinimumSize

파라미터:

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

관련 항목:

getMinimumSize()

getMinimumSize

public Dimension  getMinimumSize()

최소 사이즈가 null 이외의 값으로 설정되어 있는 경우는 그 값을 돌려줍니다. UI 위양의 getMinimumSize 메소드가 null 이외의 값을 돌려주는 경우는, 그 값을 돌려줍니다. 그렇지 않은 경우는 컴퍼넌트 레이아웃 매니저에 따릅니다.

오버라이드(override):

클래스 Container 내의 getMinimumSize

반환값:

minimumSize 프로퍼티의 값

관련 항목:

setMinimumSize(java.awt.Dimension) , ComponentUI

contains

public boolean contains(int x,
                        int y)

마우스 처리를 위해서(때문에), 이 컴퍼넌트의 정확한 형상을 정의할 기회를 UI 위양에 제공합니다.

오버라이드(override):

클래스 Component 내의 contains

파라미터:

x - 점의 x 좌표

y - 점의 y 좌표

반환값:

이 컴퍼넌트가 논리적으로 x 와 y 를 포함한 경우는 true

관련 항목:

Component.contains(int, int) , ComponentUI

setBorder

public void setBorder(Border  border)

이 컴퍼넌트의 경계를 설정합니다. Border 객체는, 컴퍼넌트의 인 세트를 정의해 (컴퍼넌트로 직접 설정되어 있는 인 세트를 오버라이드(override) 한다), 임의로 그러한 인 세트의 경계내의 경계 장식을 draw 합니다. Swing 컴퍼넌트로 장식 영역 및 비장식 영역 (마진 및 패딩등)의 양쪽 모두를 생성하려면 , 인 세트는 아니고 경계를 사용할 필요가 있습니다. 단일의 컴퍼넌트내에서 복수의 경계를 상자로 하려면 , 복합 경계를 사용할 수 있습니다.

기술적으로는 JComponent 를 상속하는 어느 객체에도 경계를 설정할 수 있습니다만, 표준의 Swing 컴퍼넌트의 Look & Feel 의 구현의 상당수는, 사용자 설정의 경계에서는 올바르게 동작하지 않습니다. 일반적으로,JPanel 또는 JLabel 이외의 표준의 Swing 컴퍼넌트로 경계를 설정할 때는, 컴퍼넌트를 JPanel 에 넣어,JPanel 로 경계를 설정하는 것을 추천합니다.

이것은 바운드 프로퍼티입니다.

파라미터:

border - 이 컴퍼넌트로 draw 되는 경계

관련 항목:

Border , CompoundBorder

getBorder

public Border  getBorder()

이 컴퍼넌트의 경계를 돌려줍니다. 경계가 현재 설정되어 있지 않은 경우는 null 를 돌려줍니다.

반환값:

이 컴퍼넌트의 경계 객체

관련 항목:

setBorder(javax.swing.border.Border)

getInsets

public Insets  getInsets()

이 컴퍼넌트로 경계가 설정되어 있는 경우는 경계의 인 세트를 돌려주어, 그렇지 않은 경우는 super.getInsets 를 호출합니다.

오버라이드(override):

클래스 Container 내의 getInsets

반환값:

인 세트 프로퍼티의 값

관련 항목:

setBorder(javax.swing.border.Border)

getInsets

public Insets  getInsets(Insets  insets)

이 컴퍼넌트의 인 세트치를 포함하는 Insets 객체를 돌려줍니다. 건네받은 Insets 객체는, 가능한 경우에 재사용됩니다. 그러나, 메소드를 호출할 때마다 같은 객체가 반환된다고는 할 수 없습니다. 이 객체내의 모든 기존의 값은 덧쓰기됩니다. insets 가 null 의 경우, 새로운 값을 할당할 수 있습니다.

파라미터:

insets - 재사용할 수 있는 Insets 객체

반환값:

Insets 객체

관련 항목:

getInsets()

getAlignmentY

public float getAlignmentY()

Container.getAlignmentY 를 오버라이드(override) 해, 수평의 배치 방법을 돌려주도록(듯이) 합니다.

오버라이드(override):

클래스 Container 내의 getAlignmentY

반환값:

alignmentY 프로퍼티의 값

관련 항목:

setAlignmentY(float) , Component.getAlignmentY()

setAlignmentY

public void setAlignmentY(float alignmentY)

수평의 배치 방법을 설정합니다.

파라미터:

alignmentY - 새로운 수평의 배치 방법

관련 항목:

getAlignmentY()

getAlignmentX

public float getAlignmentX()

Container.getAlignmentX 를 오버라이드(override) 해, 수직의 배치 방법을 돌려줍니다.

오버라이드(override):

클래스 Container 내의 getAlignmentX

반환값:

alignmentX 프로퍼티의 값

관련 항목:

setAlignmentX(float) , Component.getAlignmentX()

setAlignmentX

public void setAlignmentX(float alignmentX)

수직의 배치 방법을 설정합니다.

파라미터:

alignmentX - 새로운 수직의 배치 방법

관련 항목:

getAlignmentX()

setInputVerifier

public void setInputVerifier(InputVerifier  inputVerifier)

이 컴퍼넌트의 입력 검증자를 설정합니다.

파라미터:

inputVerifier - 새로운 입력 검증자

도입된 버젼:

1.3

관련 항목:

InputVerifier

getInputVerifier

public InputVerifier  getInputVerifier()

이 컴퍼넌트의 입력 검증자를 돌려줍니다.

반환값:

inputVerifier 프로퍼티

도입된 버젼:

1.3

관련 항목:

InputVerifier

getGraphics

public Graphics  getGraphics()

이 컴퍼넌트의 그래픽스 문맥을 돌려줍니다. 그래픽스 문맥을 사용하면(자), 컴퍼넌트를 draw 할 수 있습니다. 이 메소드를 사용하면(자),Graphics 객체를 취득해, 그 객체로 처리를 호출해 컴퍼넌트를 draw 할 수 있습니다.

오버라이드(override):

클래스 Component 내의 getGraphics

반환값:

이 컴퍼넌트의 그래픽스 문맥

관련 항목:

Component.paint(java.awt.Graphics)

setDebugGraphicsOptions

public void setDebugGraphicsOptions(int debugOptions)

이 컴퍼넌트, 또는 그 아이의 어떤 것인가로 실행되는 모든 그래픽 조작에 대한 진단 정보를 유효화 또는 무효화합니다.

파라미터:

debugOptions - 컴퍼넌트가 정보를 표시하는 방법을 지정하는 옵션. 다음의 언젠가

• DebugGraphics.LOG_OPTION - 텍스트 메세지를 출력한다
• DebugGraphics.FLASH_OPTION - draw를 몇차례 점멸시킨다
• DebugGraphics.BUFFERED_OPTION - View 의 오프 스크린 버퍼로 실행된 처리를 표시하는 ExternalWindow 를 작성한다
• DebugGraphics.NONE_OPTION - 디버그를 무효로 한다
• 값이 제로의 경우는 디버그 옵션을 변경하지 않는다

debugOptions 는, 현재의 값에 대한 비트 단위의 논리합입니다.

getDebugGraphicsOptions

public int getDebugGraphicsOptions()

그라픽스데밧깅 상태를 돌려줍니다.

반환값:

다음에 드는 각 옵션의 비트 단위의 논리합.

• DebugGraphics.LOG_OPTION - 텍스트 메세지를 출력한다
• DebugGraphics.FLASH_OPTION - draw를 몇차례 점멸시킨다
• DebugGraphics.BUFFERED_OPTION - View 의 오프 스크린 버퍼로 실행된 처리를 표시하는 ExternalWindow 를 작성한다
• DebugGraphics.NONE_OPTION - 디버그를 무효로 한다
• 값이 제로의 경우는 디버그 옵션을 변경하지 않는다

관련 항목:

setDebugGraphicsOptions(int)

registerKeyboardAction

public void registerKeyboardAction(ActionListener  anAction,
                                   String  aCommand,
                                   KeyStroke  aKeyStroke,
                                   int aCondition)

이 메소드는 현재 사용되고 있지 않습니다. 유사한 동작에는 getActionMap() 와 getInputMap() 의 메소드를 조합해 사용해 주세요. 예를 들어,KeyStroke 의 aKeyStroke 를 Action 의 anAction 에 바인드 하려면 , 다음의 메소드를 사용합니다.

   component.getInputMap(). put(aKeyStroke, aCommand);
   component.getActionMap(). put(aCommmand, anAction);
 

상기의 예는,WHEN_FOCUSED 에 적절한 바인딩을 실행하면(자) 가정한 것입니다. 다른 포커스 상태의 바인딩을 등록하려면 , 정수값을 받는 getInputMap 메소드를 사용합니다.

새로운 키보드 액션을 등록합니다. anAction 는,aKeyStroke 와 일치하는 키 이벤트가 발생해,aCondition 가 확인되었을 경우에 불려 갑니다. KeyStroke 객체는, 키보드의 키와 1 개 이상의 수식 키 (alt, shift, ctrl, meta)의 특정의 편성을 정의합니다.

aCommand 는, 지정되고 있으면, 보내지는 이벤트로 설정됩니다.

aCondition 는 다음의 머지않아인가입니다.

WHEN_FOCUSED

액션은, 컴퍼넌트가 포커스를 가지는 경우에 키스트로크(keystroke)가 발생했을 때만 불려 간다

WHEN_IN_FOCUSED_WINDOW

액션은, 컴퍼넌트가 포커스를 가지는지, 또는 포커스를 가지는 윈도우내에 있는 경우에 키스트로크(keystroke)가 발생했을 때에만 불려 간다. 컴퍼넌트는 윈도우의 직접적인 하위일 필요는 없고, 윈도우의 포함 관계의 계층의 어디에 있어도 상관없다. 즉, 윈도우내의어느컴퍼넌트가 포커스를 가지고 있어도, 이 컴퍼넌트에 등록되어 있는 액션은 불려 간다

WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

액션은, 컴퍼넌트가 포커스를 가지는지, 또는 포커스를 가지는 컴퍼넌트의 상위 객체인 경우에 키스트로크(keystroke)가 발생했을 때만 불려 간다

키스트로크(keystroke)와 조건의 편성에 의해, (KeyStroke 클래스를 사용해) 지정된 키스트로크(keystroke)와 수식 키의 편성에 대한 하이레벨의 (의미상의) 액션 이벤트를 정의할 수 있어 포커스를 가지는 컴퍼넌트의 부모 또는 아이, 혹은 컴퍼넌트 자체를 향할 수가 있습니다. 즉, 어떠한 컴퍼넌트의 계층 구조에 대해도, 임의의 키의 편성을 계층내의 적절한 컴퍼넌트에 직접 이끌 수가 있어 특정의 메소드를 호출할 수가 있습니다 (일반적으로은 어댑터 객체를 개입시킨다).

액션이 벌써 같은 charCode 및 같은 수식 키로 수신측 컨테이너에 등록되어 있는 경우,anAction 는 그 액션을 옮겨놓습니다.

파라미터:

anAction - 등록하는 Action

aCommand - 보내지는 이벤트로 설정되는 커멘드

aKeyStroke - 액션을 바인드 하는 KeyStroke

aCondition - 채울 필요가 있는 조건. 상기 참조

관련 항목:

KeyStroke

registerKeyboardAction

public void registerKeyboardAction(ActionListener  anAction,
                                   KeyStroke  aKeyStroke,
                                   int aCondition)

이 메소드는 현재 사용되고 있지 않습니다. 유사한 동작에는 getActionMap() 와 getInputMap() 의 메소드를 조합해 사용해 주세요.

unregisterKeyboardAction

public void unregisterKeyboardAction(KeyStroke  aKeyStroke)

이 메소드는 현재 사용되고 있지 않습니다. 기존의 바인딩의 등록을 해제하는데는,ActionMap 또는 InputMap 로부터 바인딩을 삭제하는지, 또는 InputMap 에 더미 바인딩을 설정합니다. InputMap 로부터 바인딩을 삭제하면(자), 부모의 InputMap 의 바인딩을 액티브하게 할 수 있습니다. 그에 대해,InputMap 에 더미 바인딩을 배치하면(자), 지금까지 발생한 바인딩을 효과적으로 무효로 합니다.

키보드 액션을 등록 해제합니다. 이 해제에 의해,InputMap 와 같이 ActionMap (존재하는 경우)의 바인딩도 삭제합니다.

getRegisteredKeyStrokes

public KeyStroke [] getRegisteredKeyStrokes()

등록되어 있는 액션을 개시하는 KeyStroke 를 돌려줍니다.

반환값:

KeyStroke 객체의 배열

관련 항목:

registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

getConditionForKeyStroke

public int getConditionForKeyStroke(KeyStroke  aKeyStroke)

등록되어 있는 액션이, 지정된 키스트로크(keystroke)에 반응해 발생할지 어떨지를 결정하는 조건을 돌려줍니다.

Java 2 플랫폼 v1. 3 의 경우,KeyStroke 를 복수의 조건과 관련지을 수가 있습니다. 예를 들어, 1 개의 키스트로크(keystroke)를 2 개의 조건 WHEN_FOCUSED 와 WHEN_IN_FOCUSED_WINDOW 에 바인드 할 수가 있습니다.

반환값:

액션과 키스트로크(keystroke)의 조건

getActionForKeyStroke

public ActionListener  getActionForKeyStroke(KeyStroke  aKeyStroke)

지정된 키스트로크(keystroke)에 대해서 등록되어 있는 액션을 실행하는 객체를 돌려줍니다.

반환값:

키스트로크(keystroke)가 발생했을 때에 불려 가는 ActionListener 객체

resetKeyboardActions

public void resetKeyboardActions()

제 1 층의 InputMap 와 ActionMap 의 바인딩을 모두 등록 해제합니다. 이 방법은, 어느 로컬 바인딩을 삭제하는 경우에도 효과적이며, 부모의 InputMap 및 ActionMap (UI 는 일반적으로 제 2 층에서 정의)에 정의된 바인딩을 지속시킬 수가 있습니다.

setInputMap

public final void setInputMap(int condition,
                              InputMap  map)

조건 condition 로 사용하는 InputMap 를 map 로 설정합니다. null 치는 UI 로부터의 것이어도 바인딩을 사용하지 않는 것을 나타냅니다. UI InputMap 가 존재하는 경우, 재인스톨은 하지 않습니다. condition 의 값은 다음의 어느 쪽인가에 됩니다.

• WHEN_IN_FOCUSED_WINDOW
• WHEN_FOCUSED
• WHEN_ANCESTOR_OF_FOCUSED_COMPONENT

condition 가 WHEN_IN_FOCUSED_WINDOW 이며,map 가 ComponentInputMap 가 아닌 경우,IllegalArgumentException 가 throw 됩니다. 같이condition 가 상기의 것이 아닌 경우,IllegalArgumentException 가 throw 됩니다. 전술의 값의 언젠가

파라미터:

condition - 상기의 값의 어느쪽이든

map - 지정의 조건에 대해서 사용되는 InputMap

예외:

IllegalArgumentException - condition 가 WHEN_IN_FOCUSED_WINDOW 이며,map 가 ComponentInputMap 의 인스턴스가 아닌 경우, 또는 condition 가 상기로 지정된 값이 아닌 경우

도입된 버젼:

1.3

getInputMap

public final InputMap  getInputMap(int condition)

condition 로 사용되고 있는 InputMap 를 돌려줍니다.

파라미터:

condition - WHEN_IN_FOCUSED_WINDOW, WHEN_FOCUSED, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT 가운데 1 개

반환값:

지정된 condition 에 대한 InputMap

도입된 버젼:

1.3

getInputMap

public final InputMap  getInputMap()

컴퍼넌트가 포커스를 취득했을 때에 사용하는 InputMap 를 돌려줍니다. 이것은 getInputMap(WHEN_FOCUSED) 의 편리한 메소드입니다.

반환값:

컴퍼넌트가 포커스를 취득했을 때에 사용하는 InputMap

도입된 버젼:

1.3

setActionMap

public final void setActionMap(ActionMap  am)

ActionMap 를 am 로 설정합니다. UI 가 존재하는 경우에서도,am 의 부모를 UI 로부터의 ActionMap 로서는 설정하지 않습니다. 이 처리는 호출해 옆에서 실시합니다.

파라미터:

am - 새로운 ActionMap

도입된 버젼:

1.3

getActionMap

public final ActionMap  getActionMap()

특정의 KeyStroke 바인딩에 대해서 트리거하는 Action 의 지정에 사용되는 ActionMap 를 돌려줍니다. 외가 설정되어 있지 않으면, 반환되는 ActionMap 는, 그 부모와 같은 UI 의 ActionMap 를 가집니다.

반환값:

키 또는 액션의 바인딩을 포함한 ActionMap

도입된 버젼:

1.3

getBaseline

public int getBaseline(int width,
                       int height)

baseline를 돌려줍니다. baseline는, 컴퍼넌트의 상단으로부터 측정됩니다. 이 메소드는, 주로 LayoutManager 가 그 baseline에 따라 컴퍼넌트를 배치하기 위해서 사용합니다. 반환값이 0 보다 작은 경우, 이 컴퍼넌트의 baseline는 적절하지는 않습니다. LayoutManager 는, 그 baseline상에 이 컴퍼넌트를 배치하지 않습니다.

이 메소드는, 같은 이름의 ComponentUI 메소드를 호출합니다. 이 컴퍼넌트가 ComponentUI 를 가지고 있지 않은 경우는 -1 이 돌려주어집니다. 반환값이 0 이상의 경우, 컴퍼넌트의 baseline는 최소 사이즈 이상의 임의의 사이즈에 대해서 유효하고,getBaselineResizeBehavior 를 사용해 사이즈에 의한 baseline의 변화를 특정할 수가 있습니다.

오버라이드(override):

클래스 Component 내의 getBaseline

파라미터:

width - baseline를 취득하는 폭

height - baseline를 취득하는 높이

반환값:

baseline 또는 0 보다 작은 값 (적절한 baseline가 존재하지 않는다)

예외:

IllegalArgumentException - 폭 또는 높이가 0 보다 작은 경우

도입된 버젼:

1.6

관련 항목:

getBaselineResizeBehavior() , FontMetrics

getBaselineResizeBehavior

public Component.BaselineResizeBehavior  getBaselineResizeBehavior()

컴퍼넌트의 사이즈가 변화하는 것에 따라 baseline가 변화하는 방법의 열거를 돌려줍니다. 이 메소드는, 주로 레이아웃 매니저와 GUI 빌더로 사용됩니다.

이 메소드는, 같은 이름의 ComponentUI 메소드를 호출합니다. 이 컴퍼넌트가 ComponentUI 를 가지고 있지 않은 경우는 BaselineResizeBehavior.OTHER 가 돌려주어집니다. 서브 클래스는 null 를 돌려주지 않습니다. baseline를 계산할 수 없는 경우는,BaselineResizeBehavior.OTHER 를 돌려줍니다. 호출측은, 우선 getBaseline 를 사용해 baseline를 요구합니다. 그리고, 반환값이 0 이상의 경우는 이 메소드를 사용합니다. getBaseline 가 0 보다 작은 값을 돌려주는 경우에서도, 이 메소드가 BaselineResizeBehavior.OTHER 이외의 값을 돌려주는 것은 허용 됩니다.

오버라이드(override):

클래스 Component 내의 getBaselineResizeBehavior

반환값:

컴퍼넌트의 사이즈가 변화하는 것에 따라 baseline가 변화하는 방법의 열거

도입된 버젼:

1.6

관련 항목:

getBaseline(int, int)

requestDefaultFocus

@Deprecated 
public boolean requestDefaultFocus()

추천 되고 있지 않습니다. 1.4 이후는 FocusTraversalPolicy.getDefaultComponent(Container). requestFocus() 로 옮겨졌습니다.

릴리스 1.4 에서는, 포커스 하부조직이 재구축 되었습니다. 상세한 것에 대하여는, 「The Java Tutorial」의「How to Use the Focus Subsystem」를 참조해 주세요.

이 JComponent 의 FocusTraversalPolicy 의 디폴트 Component 에의 포커스를 요구합니다. 이 JComponent 가 포커스 사이클 루트의 경우, 그 FocusTraversalPolicy 가 사용됩니다. 그렇지 않은 경우는, 이 JComponent 의 포커스 사이클 루트 클래스의 FocusTraversalPolicy 가 사용됩니다.

관련 항목:

FocusTraversalPolicy.getDefaultComponent(java.awt.Container)

setVisible

public void setVisible(boolean aFlag)

컴퍼넌트를 가시 또는 불가시로 합니다. Component.setVisible 를 오버라이드(override) 합니다.

오버라이드(override):

클래스 Component 내의 setVisible

파라미터:

aFlag - 컴퍼넌트를 가시로 하는 경우는 true, 불가시로 하는 경우는 false

관련 항목:

Component.isVisible()

setEnabled

public void setEnabled(boolean enabled)

이 컴퍼넌트가 유효한지 어떤지를 설정합니다. 유효한 컴퍼넌트는 사용자의 입력에 반응할 수 있습니다만, 무효인 컴퍼넌트는 사용자의 입력에 반응할 수 없습니다. 컴퍼넌트에 따라서는, 자신이 무효인 경우로 표시를 변경해, 입력을 납득할 수 없는 것을 나타내는 피드백을 사용자에게 제공할 수 있습니다.

주:컴퍼넌트를 무효화해도 아이는 무효화되지 않습니다.

주:경량화 컴퍼넌트를 무효화해도 MouseEvent 는 수신됩니다.

오버라이드(override):

클래스 Component 내의 setEnabled

파라미터:

enabled - 이 컴퍼넌트를 유효화하는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Component.isEnabled() , Component.isLightweight()

setForeground

public void setForeground(Color  fg)

이 컴퍼넌트의 foreground 칼라를 설정합니다. 이 프로퍼티을 받아들일 수 있을지 어떨지는 Look & Feel 나름이며, 무시되는 일도 있습니다.

오버라이드(override):

클래스 Component 내의 setForeground

파라미터:

fg - 요구하는 foreground Color

관련 항목:

Component.getForeground()

setBackground

public void setBackground(Color  bg)

이 컴퍼넌트의 백그라운드 칼라를 설정합니다. 백그라운드 칼라는, 컴퍼넌트가 불투명한 경우에게만,JComponent 또는 ComponentUI 의 구현의 서브 클래스에 의해서만 사용됩니다. JComponent 의 직접적인 서브 클래스는, 이 프로퍼티을 받아들이기 위해서(때문에) paintComponent 를 오버라이드(override) 할 필요가 있습니다.

이 프로퍼티을 받아들일 수 있을지 어떨지는 Look & Feel 나름이며, 무시되는 일도 있습니다.

오버라이드(override):

클래스 Component 내의 setBackground

파라미터:

bg - 요구하는 백그라운드 Color

관련 항목:

Component.getBackground() , setOpaque(boolean)

setFont

public void setFont(Font  font)

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

오버라이드(override):

클래스 Container 내의 setFont

파라미터:

font - 이 컴퍼넌트로 지정하는 Font

관련 항목:

Component.getFont()

getDefaultLocale

public static Locale  getDefaultLocale()

각 JComponent 의 로케일 프로퍼티을 생성시에 초기화하기 위해서 사용하는 디폴트 로케일을 돌려줍니다. 디폴트 로케일에는 「AppContext」스코프가 있어, 애플릿 (그리고 잠재적으로는 단독의 VM 로 실행되는 복수의 경량 어플리케이션)이 독자적인 설정을 가질 수가 있습니다. 어느 애플릿이 디폴트 로케일을 변경해도, 다른 애플릿 (또는 브라우저)에는 영향을 주지 않기 때문에, 안전하게 변경할 수가 있습니다.

반환값:

디폴트의 Locale

도입된 버젼:

1.4

관련 항목:

setDefaultLocale(java.util.Locale) , Component.getLocale() , Component.setLocale(java.util.Locale)

setDefaultLocale

public static void setDefaultLocale(Locale  l)

각 JComponent 의 로케일 프로퍼티을 생성시에 초기화하기 위해서 사용하는 디폴트 로케일을 설정합니다. 초기치는 VM 의 디폴트 로케일입니다. 디폴트 로케일에는 「AppContext」스코프가 있어, 애플릿 (그리고 잠재적으로는 단독의 VM 로 실행되는 복수의 경량 어플리케이션)이 독자적인 설정을 가질 수가 있습니다. 어느 애플릿이 디폴트 로케일을 변경해도, 다른 애플릿 (또는 브라우저)에는 영향을 주지 않기 때문에, 안전하게 변경할 수가 있습니다.

파라미터:

l - 새로운 컴퍼넌트로 지정하는 디폴트 Locale

도입된 버젼:

1.4

관련 항목:

getDefaultLocale() , Component.getLocale() , Component.setLocale(java.util.Locale)

processComponentKeyEvent

protected void processComponentKeyEvent(KeyEvent  e)

컴퍼넌트 자체가 인식하는 키 이벤트를 처리합니다. 이 메소드는, 포커스 매니저 및 관련하는 모든 청취자에게, 이벤트를 횡령할 기회가 주어진 뒤에 불려 갑니다. 이 메소드는, 이벤트가 아직 사용되어 있지 않은 경우에만 불려 갑니다. 이 메소드는, 키보드 UI 논리에 우선해 불려 갑니다.

이 메소드의 구현은 아무것도 실시하지 않습니다. 일반적으로, 서브 클래스는 그것들 자체가 키 이벤트를 처리하는 경우에 이 메소드를 오버라이드(override) 합니다. 처리된 이벤트는 파기됩니다.

processKeyEvent

protected void processKeyEvent(KeyEvent  e)

이벤트를 처리하는 processKeyEvent 를 오버라이드(override) 합니다.

오버라이드(override):

클래스 Component 내의 processKeyEvent

파라미터:

e - 키 이벤트

관련 항목:

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

processKeyBinding

protected boolean processKeyBinding(KeyStroke  ks,
                                    KeyEvent  e,
                                    int condition,
                                    boolean pressed)

KeyEvent e 의 결과로서 ks 의 키 바인드를 처리하기 위해서 불려 갑니다. 이 메소드는 적절한 InputMap, 그 바인딩,ActionMap 의 액션을 취득해, (액션이 발견되어, 컴퍼넌트가 유효한 경우) 액션을 통지하기 위해서 notifyAction 를 호출합니다.

파라미터:

ks - 조회하는 KeyStroke

e - KeyEvent

condition - 다음의 값의 언젠가.

• JComponent.WHEN_FOCUSED
• JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
• JComponent.WHEN_IN_FOCUSED_WINDOW

pressed - 키가 밀리고 있는 경우는 true

반환값:

액션에 바인딩이 있어, 액션이 유효했던 경우는 true

도입된 버젼:

1.3

setToolTipText

public void setToolTipText(String  text)

툴팁에 표시하는 텍스트를 등록합니다. 이 텍스트는, 커서가 컴퍼넌트상에 있을 때 표시됩니다.

자세한 것은, 「The Java Tutorial」의「How to Use Tool Tips」를 참조해 주세요.

파라미터:

text - 표시하는 캐릭터 라인. 텍스트가 null 의 경우, 이 컴퍼넌트의 툴팁는 오프

관련 항목:

TOOL_TIP_TEXT_KEY

getToolTipText

public String  getToolTipText()

setToolTipText 로 설정되어 있는 툴팁의 캐릭터 라인을 돌려줍니다.

반환값:

툴팁의 텍스트

관련 항목:

TOOL_TIP_TEXT_KEY

getToolTipText

public String  getToolTipText(MouseEvent  event)

event 의 툴팁로서 사용되는 캐릭터 라인을 돌려줍니다. 디폴트에서는,setToolTipText 를 사용해 설정된 임의의 캐릭터 라인을 돌려줍니다. 컴퍼넌트가 보다 포괄적인 API 를 제공해 다른 위치에서 다른 툴팁를 지원하는 경우, 이 메소드는 오버라이드(override) 됩니다.

getToolTipLocation

public Point  getToolTipLocation(MouseEvent  event)

이 컴퍼넌트의 좌표계에 있어서의 툴팁의 위치를 돌려줍니다. null 가 반환되는 경우는, Swing 가 위치를 선택합니다. 디폴트 구현은 null 를 돌려줍니다.

파라미터:

event - ToolTipManager 에 툴팁를 표시시키는 MouseEvent

반환값:

항상 null 를 돌려준다

getPopupLocation

public Point  getPopupLocation(MouseEvent  event)

이 컴퍼넌트의 좌표계에 pop-up menu를 표시하는데 적절한 위치를 돌려줍니다. 이 프로퍼티을 받아들일 수 있을지 어떨지는 Look & Feel 나름이며, 무시되는 일도 있습니다. null 의 경우는, Look & Feel 에 의해 적절한 위치가 선택됩니다.

파라미터:

event - pop-up의 표시를 트리거한 MouseEvent, 마우스 이벤트의 결과로서 pop-up가 표시되지 않는 경우는 null

반환값:

JPopupMenu 가 표시되는 위치, 또는 null

도입된 버젼:

1.5

createToolTip

public JToolTip  createToolTip()

툴팁를 표시하기 위해서 사용되는 JToolTip 의 인스턴스를 돌려줍니다. 일반적으로 컴퍼넌트는 이 메소드를 오버라이드(override) 하지 않습니다만, 이 메소드는 복수의 툴팁를 따로 따로 표시하기 위해서 사용할 수 있습니다.

반환값:

이 툴팁 표시에 사용되는 JToolTip

scrollRectToVisible

public void scrollRectToVisible(Rectangle  aRect)

scrollRectToVisible() 메세지를 JComponent 의 부모에게 전송 합니다. 이 요구를 처리할 수 있는 JViewport 등의 컴퍼넌트는, 이 메소드를 오버라이드(override) 해 스크롤을 실행합니다.

파라미터:

aRect - 가시 Rectangle

관련 항목:

JViewport

setAutoscrolls

public void setAutoscrolls(boolean autoscrolls)

autoscrolls 프로퍼티을 설정합니다. true 의 경우, 마우스가 컴퍼넌트의 경계외에 드래그 되어 마우스의 버튼을 누른 채로 정지되면(자), 마우스 드래그 이벤트가 합성되어 생성됩니다. 합성 이벤트에서는, 컴퍼넌트의 경계를 넘어 드래그가 실행되었을 경우, 그 방향에의 드래그가 재개된 것처럼 가장합니다. 오토 스크롤을 지원하는 컴퍼넌트는, 마우스 이벤트 위치를 포함한 구형을 지정해 scrollRectToVisible 를 호출해,mouseDragged 이벤트를 처리할 필요가 있습니다. 항목 선택을 지원해,JScrollPane 에 표시되는 모든 Swing 컴퍼넌트 (JTable,JList,JTree,JTextArea, 및 JEditorPane)는, 이 방법에서의 마우스 드래그 이벤트 처리를 구현제입니다. 다른 컴퍼넌트로 오토 스크롤을 유효화하기 위해서(때문에)는,scrollRectToVisible 을 호출하는 마우스 모션 청취자를 추가합니다. JPanel,myPanel 에서의 예를 듭니다.

 MouseMotionListener doScrollRectToVisible = new MouseMotionAdapter() {
     public void mouseDragged(MouseEvent e) {
        Rectangle r = new Rectangle(e.getX(), e.getY(), 1, 1);
        ((JPanel) e.getSource()). scrollRectToVisible(r);
    }
 };
 myPanel.addMouseMotionListener(doScrollRectToVisible);
 

autoScrolls 프로퍼티의 디폴트 값는 false 입니다.

파라미터:

autoscrolls - true 의 경우는, mouse button를 누른채로 컴퍼넌트의 경계의 밖까지 마우스를 드래그 하면(자), 합성 마우스 드래그 이벤트가 생성된다. false 의 경우는 생성되지 않는

관련 항목:

getAutoscrolls() , JViewport , JScrollPane

getAutoscrolls

public boolean getAutoscrolls()

autoscrolls 프로퍼티을 돌려줍니다.

반환값:

autoscrolls 프로퍼티의 값

관련 항목:

JViewport , setAutoscrolls(boolean)

setTransferHandler

public void setTransferHandler(TransferHandler  newHandler)

transferHandler 프로퍼티을 설정합니다. 컴퍼넌트가 데이터 전송 처리를 지원하고 있지 않는 경우는 null 가 돌려주어집니다.

newHandler 가 null 는 아니고, 시스템 프로퍼티 suppressSwingDropSupport 가 true 가 아닌 경우는,JComponent 의 DropTarget 를 인스톨 합니다. 이 시스템 프로퍼티의 디폴트는 false 이며,DropTarget 가 추가됩니다.

자세한 것은, 「The Java Tutorial」의「How to Use Drag and Drop and Data Transfer」를 참조해 주세요.

파라미터:

newHandler - 컴퍼넌트와의 사이에 데이터를 전송 한다 방법

도입된 버젼:

1.4

관련 항목:

TransferHandler , getTransferHandler()

getTransferHandler

public TransferHandler  getTransferHandler()

transferHandler 프로퍼티을 돌려줍니다.

반환값:

transferHandler 프로퍼티의 값

도입된 버젼:

1.4

관련 항목:

TransferHandler , setTransferHandler(javax.swing.TransferHandler)

processMouseEvent

protected void processMouseEvent(MouseEvent  e)

이 컴퍼넌트로 발생하는 마우스 이벤트를, 등록되어 모든 MouseListener 객체에 발송 하는 것으로써, 마우스 이벤트를 처리합니다. 이 메소드의 상세한 것에 대하여는,Component.processMouseEvent(MouseEvent) 를 참조해 주세요.

오버라이드(override):

클래스 Component 내의 processMouseEvent

파라미터:

e - 마우스 이벤트

도입된 버젼:

1.5

관련 항목:

Component.processMouseEvent(java.awt.event.MouseEvent)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent  e)

MouseEvent.MOUSE_DRAGGED 등의 마우스 모션 이벤트를 처리합니다.

오버라이드(override):

클래스 Component 내의 processMouseMotionEvent

파라미터:

e - MouseEvent

관련 항목:

MouseEvent

enable

@Deprecated 
public void enable()

추천 되고 있지 않습니다. JDK version 1.1 이후는,java.awt.Component.setEnabled(boolean) 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 enable

disable

@Deprecated 
public void disable()

추천 되고 있지 않습니다. JDK version 1.1 이후는,java.awt.Component.setEnabled(boolean) 로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 disable

getAccessibleContext

public AccessibleContext  getAccessibleContext()

JComponent 에 관련한 AccessibleContext 를 돌려줍니다. 이 base class에 의한 메소드 구현에서는 null 가 돌려주어집니다. JComponent 를 확장하는 클래스는, 이 메소드를 구현해, 서브 클래스에 관련지을 수 있었던 AccessibleContext 를 돌려주도록(듯이) 합니다.

오버라이드(override):

클래스 Component 내의 getAccessibleContext

반환값:

이 JComponent 의 AccessibleContext

getClientProperty

public final Object  getClientProperty(Object  key)

지정된 키를 가지는 프로퍼티의 값을 돌려줍니다. putClientProperty 로 추가된 프로퍼티만이 null 이외의 값을 돌려줍니다.

파라미터:

key - 조회용의 키

반환값:

이 프로퍼티의 값 또는 null

관련 항목:

putClientProperty(java.lang.Object, java.lang.Object)

putClientProperty

public final void putClientProperty(Object  key,
                                    Object  value)

임의의 키와 값을 조합한 클라이언트 프로퍼티을 이 컴퍼넌트에 추가합니다.

get/putClientProperty 메소드는, 인스턴스마다의 작은 해시 테이블에의 액세스를 제공합니다. 호출측은, getClientProperty 와 putClientProperty 를 사용해, 다른 모듈에 의해 생성된 컴퍼넌트에 주석을 붙입니다. 예를 들어, 레이아웃 매니저는 이 방법으로 아이마다의 제약을 포함하는 경우가 있습니다. 다음에 예를 나타냅니다.

 componentA.putClientProperty("to the left of", componentB);
 

값이 null 의 경우, 이 메소드는 그 프로퍼티을 삭제합니다. 클라이언트 프로퍼티에의 변경은,PropertyChange 이벤트로 보고됩니다. (PropertyChange 이벤트용의) 프로퍼티의 이름은,key.toString() 입니다.

clientProperty 의 사전는, JComponent 에의 대규모 확장 기능을 지원하는 것이 아닙니다. 또 새로운 컴퍼넌트를 설계할 때의 서브 클래스화의 대체라고 해도 사용할 수 없습니다.

파라미터:

key - 새로운 클라이언트 프로퍼티 키

value - 새로운 클라이언트 프로퍼티치. null 의 경우, 이 메소드는 프로퍼티을 삭제

관련 항목:

getClientProperty(java.lang.Object) , Container.addPropertyChangeListener(java.beans.PropertyChangeListener)

setFocusTraversalKeys

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

이 컴퍼넌트의 지정된 traversal 조작에 대한 포커스 traversal 키를 설정합니다. 이 메소드의 상세한 것에 대하여는,Component.setFocusTraversalKeys(int, java.util.Set) 를 참조해 주세요.

오버라이드(override):

클래스 Container 내의 setFocusTraversalKeys

파라미터:

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.5

관련 항목:

KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS , KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS , KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS

isLightweightComponent

public static boolean isLightweightComponent(Component  c)

이 컴퍼넌트가 경량의 경우, 즉 네이티브의 윈도우 시스템 피어를 가지지 않는 경우에 true 를 돌려줍니다.

반환값:

이 컴퍼넌트가 경량의 경우는 true

reshape

@Deprecated 
public void reshape(int x,
                               int y,
                               int w,
                               int h)

추천 되고 있지 않습니다. JDK 5 이후는,Component.setBounds(int, int, int, int) 로 옮겨졌습니다.

이 컴퍼넌트를 이동해, 사이즈 변경합니다.

오버라이드(override):

클래스 Component 내의 reshape

파라미터:

x - 새로운 수평 방향의 위치

y - 새로운 수직 방향의 위치

w - 신규폭

h - 신규 높이

관련 항목:

Component.setBounds(int, int, int, int)

getBounds

public Rectangle  getBounds(Rectangle  rv)

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

오버라이드(override):

클래스 Component 내의 getBounds

파라미터:

rv - 컴퍼넌트의 경계가 포함된 반환값

반환값:

rv. rv 가 null 의 경우는 새롭게 작성된 Rectangle 와 컴퍼넌트의 경계를 돌려준다

getSize

public Dimension  getSize(Dimension  rv)

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

오버라이드(override):

클래스 Component 내의 getSize

파라미터:

rv - 컴퍼넌트의 사이즈가 포함된 반환값

반환값:

rv

getLocation

public Point  getLocation(Point  rv)

이 컴퍼넌트의 원점의 x, y 좌표를 「반환값」rv 에 포함해,rv 를 돌려줍니다. rv 가 null 의 경우, 새로운 Point 를 할당할 수 있습니다. 이 버젼의 getLocation 는, 호출측이 heap로 새로운 Point 객체를 할당하고 싶지 않은 경우에 편리합니다.

오버라이드(override):

클래스 Component 내의 getLocation

파라미터:

rv - 컴퍼넌트의 위치가 포함된 반환값

반환값:

rv

getX

public int getX()

컴퍼넌트의 원점의 현재의 x 좌표를 돌려줍니다. 이 메소드는, heap 할당이 발생하지 않기 때문에,component.getBounds(). x 또는 component.getLocation(). x 보다 적절합니다.

오버라이드(override):

클래스 Component 내의 getX

반환값:

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

getY

public int getY()

컴퍼넌트의 원점의 현재의 y 좌표를 돌려줍니다. 이 메소드는, heap 할당이 발생하지 않기 때문에,component.getBounds(). y 또는 component.getLocation(). y 보다 적절합니다.

오버라이드(override):

클래스 Component 내의 getY

반환값:

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

getWidth

public int getWidth()

이 컴퍼넌트의 현재의 폭을 돌려줍니다. 이 메소드는, heap의 할당이 발생하지 않기 때문에,component.getBounds(). width 또는 component.getSize(). width 보다 적절합니다.

오버라이드(override):

클래스 Component 내의 getWidth

반환값:

이 컴퍼넌트의 현재의 폭

getHeight

public int getHeight()

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

오버라이드(override):

클래스 Component 내의 getHeight

반환값:

이 컴퍼넌트의 현재의 높이

isOpaque

public boolean isOpaque()

이 컴퍼넌트가 완전하게 불투명한 경우에 true 를 돌려줍니다.

불투명한 컴퍼넌트는 그 구형 경계내의 모든 픽셀을 그립니다. 불투명하지 않는 컴퍼넌트는 그 픽셀의 부분집합만을 페인트 하는지, 전혀 페인트 하지 않기 때문에, 그 아래의 픽셀을 틈이 날 수 있어 표시됩니다. 그 때문에, 모든 픽셀을 페인트 하지 않는 컴퍼넌트는 어느 정도의 투명도가 있습니다.

항상 그 내용을 완전하게 페인트 하는 서브 클래스는, 이 메소드를 오버라이드(override) 해, true 를 돌려줍니다.

오버라이드(override):

클래스 Component 내의 isOpaque

반환값:

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

관련 항목:

setOpaque(boolean)

setOpaque

public void setOpaque(boolean isOpaque)

true 의 경우, 컴퍼넌트는 그 경계내의 모든 픽셀을 그립니다. false 의 경우, 컴퍼넌트는 픽셀의 일부 또는 전부를 페인트 하지 않기 때문에, 그 아래의 픽셀을 틈이 날 수 있어 표시됩니다.

JComponent 에 대한 이 프로퍼티의 디폴트 값는, false 입니다. 다만, 가장 표준적인 JComponent 의 서브 클래스 (JButton 및 JTree 등)에 대한 이 프로퍼티의 디폴트 값는, Look & Feel 에 의존합니다.

파라미터:

isOpaque - 이 컴퍼넌트가 불투명한 경우는 true

관련 항목:

isOpaque()

computeVisibleRect

public void computeVisibleRect(Rectangle  visibleRect)

Component 의 「가시 구형」을 돌려줍니다. 이것은, 이 컴퍼넌트와 그 모든 상위 객체의 가시 구형의 공통 부분입니다. 반환값은,visibleRect 에 포함됩니다.

파라미터:

visibleRect - 이 컴퍼넌트와 그 모든 상위 객체의 가시 구형의 공통 부분으로서 요구되는 Rectangle. 이것은 이 메소드의 반환값

관련 항목:

getVisibleRect()

getVisibleRect

public Rectangle  getVisibleRect()

이것은 이 메소드의 반환값입니다. Component 의 「가시 구형」을 돌려줍니다. 이것은, 이 컴퍼넌트의 가시 구형,new Rectangle(0, 0, getWidth(), getHeight()), 및 그 모든 상위 객체의 가시 구형의 공통 부분입니다.

반환값:

가시 구형

firePropertyChange

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

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

오버라이드(override):

클래스 Component 내의 firePropertyChange

파라미터:

propertyName - 치가 변경된 프로퍼티

oldValue - 프로퍼티의 이전의 값

newValue - 프로퍼티의 새로운 값

firePropertyChange

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

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

오버라이드(override):

클래스 Component 내의 firePropertyChange

파라미터:

propertyName - 치가 변경된 프로퍼티

oldValue - 프로퍼티의 이전의 값

newValue - 프로퍼티의 새로운 값

firePropertyChange

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

클래스 Component 의 기술:

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

오버라이드(override):

클래스 Component 내의 firePropertyChange

파라미터:

propertyName - 변경된 프로퍼티의 프로그램상의 이름

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

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

관련 항목:

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

fireVetoableChange

protected void fireVetoableChange(String  propertyName,
                                  Object  oldValue,
                                  Object  newValue)
                           throws PropertyVetoException 

제약 프로퍼티의 변경의 보고를 지원합니다. 이 메소드는, 제약 프로퍼티이 변경되었을 때에 불려 가 등록되어 모든 VetoableChangeListeners 에 대응하는 PropertyChangeEvent 를 송신합니다.

파라미터:

propertyName - 대기하고 있던 프로퍼티의 이름

oldValue - 프로퍼티의 변경전의 값

newValue - 프로퍼티의 변경 후의 값

예외:

PropertyVetoException - 프로퍼티을 설정하려고 해 수신 측에야는 거부되었을 경우

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener  listener)

VetoableChangeListener 를 청취자 리스트에 추가합니다. 청취자는, 모든 프로퍼티에 대해서 등록됩니다.

파라미터:

listener - 추가되는 VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener  listener)

VetoableChangeListener 를 청취자 리스트로부터 삭제합니다. 모든 프로퍼티에 등록된 VetoableChangeListener 를 삭제합니다.

파라미터:

listener - 삭제되는 VetoableChangeListener

getVetoableChangeListeners

public VetoableChangeListener [] getVetoableChangeListeners()

이 컴퍼넌트에 등록되어 모든 거부 가능 변경 청취자의 배열을 돌려줍니다.

반환값:

컴퍼넌트의 모든 VetoableChangeListener, 또는 거부 가능 변경 청취자가 현재 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.4

관련 항목:

addVetoableChangeListener(java.beans.VetoableChangeListener) , removeVetoableChangeListener(java.beans.VetoableChangeListener)

getTopLevelAncestor

public Container  getTopLevelAncestor()

이 컴퍼넌트의 톱 레벨의 상위 객체 (포함처의 Window 또는 Applet)를 돌려줍니다. 이 컴퍼넌트가 어느 컨테이너에도 추가되어 있지 않은 경우는 null 를 돌려줍니다.

반환값:

이 컴퍼넌트가 포함되는 톱 레벨의 Container. 어느 컨테이너에도 포함되지 않는 경우는 null

addAncestorListener

public void addAncestorListener(AncestorListener  listener)

listener 를 등록해, 컴퍼넌트 또는 게다가 위객체가 이동하든가, 혹은 가시 또는 불가시가 될 때 그 청취자가 AncestorEvent 를 받아들이도록(듯이) 합니다. 이벤트는, 컴퍼넌트 또는 게다가 위객체가 포함 관계의 계층에 추가되는지, 또는 삭제될 때도 송신됩니다.

파라미터:

listener - 등록하는 AncestorListener

관련 항목:

AncestorEvent

removeAncestorListener

public void removeAncestorListener(AncestorListener  listener)

listener 의 등록을 해제해, 그 청취자가 AncestorEvent 를 받지 않게 합니다.

파라미터:

listener - 삭제하는 AncestorListener

관련 항목:

addAncestorListener(javax.swing.event.AncestorListener)

getAncestorListeners

public AncestorListener [] getAncestorListeners()

이 컴퍼넌트에 등록되어 모든 상위 청취자의 배열을 돌려줍니다.

반환값:

컴퍼넌트의 모든 AncestorListener, 상위 청취자가 현재 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

1.4

관련 항목:

addAncestorListener(javax.swing.event.AncestorListener) , removeAncestorListener(javax.swing.event.AncestorListener)

getListeners

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

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

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

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

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

오버라이드(override):

클래스 Container 내의 getListeners

파라미터:

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

반환값:

컴퍼넌트에 FooListener 로서 등록되어 모든 객체의 배열. 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열을 돌려준다

예외:

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

도입된 버젼:

1.3

관련 항목:

getVetoableChangeListeners() , getAncestorListeners()

addNotify

public void addNotify()

이 컴퍼넌트에 현재친컴퍼넌트가 있는 것을, 이 컴퍼넌트에 통지합니다. 이 메소드가 불려 가면(자), 친컴퍼넌트의 체인이 KeyboardAction 이벤트 청취자로 설정됩니다.

오버라이드(override):

클래스 Container 내의 addNotify

관련 항목:

registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

removeNotify

public void removeNotify()

이 컴퍼넌트에 친컴퍼넌트가 없어진 것을, 이 컴퍼넌트에 통지합니다. 이 메소드가 불려 가면(자), 친컴퍼넌트의 체인으로 설정된 KeyboardAction 가 삭제됩니다.

오버라이드(override):

클래스 Container 내의 removeNotify

관련 항목:

registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

repaint

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

컴퍼넌트가 표시되고 있는 경우에, 지정된 영역을 더티 리젼 리스트에 추가합니다. 컴퍼넌트는, 현재 보류 떠날 수 있어 모든 이벤트가 발송 된 뒤에 재페인트 됩니다.

오버라이드(override):

클래스 Component 내의 repaint

파라미터:

tm - 이 파라미터는 사용되지 않습니다

x - 더티 리젼의 x 좌표

y - 더티 리젼의 y 좌표

width - 더티 리젼의 폭

height - 더티 리젼의 높이

관련 항목:

Component.isShowing() , RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

repaint

public void repaint(Rectangle  r)

컴퍼넌트가 표시되고 있는 경우에, 지정된 영역을 더티 리젼 리스트에 추가합니다. 컴퍼넌트는, 현재 보류 떠날 수 있어 모든 이벤트가 발송 된 뒤에 재페인트 됩니다.

파라미터:

r - 더티 리젼을 포함한 Rectangle

관련 항목:

Component.isShowing() , RepaintManager.addDirtyRegion(javax.swing.JComponent, int, int, int, int)

revalidate

public void revalidate()

지연 자동 레이아웃을 지원합니다.

invalidate 를 호출해, 다음에 이 컴퍼넌트의 validateRoot 를, 검증될 필요가 있는 컴퍼넌트의 리스트에 추가합니다. 검증은, 현재 보류 떠날 수 있어 모든 이벤트가 발송 된 뒤에 행해집니다. 즉, 이 메소드가 불려 간 뒤, 이 컴퍼넌트의 포함 관계의 계층의 상위에서 최초로 발견된 validateRoot 가 검증됩니다. 디폴트에서는,JRootPane,JScrollPane, 및 JTextField 이 isValidateRoot 로부터 true 를 돌려줍니다.

이 메소드는, 이 컴퍼넌트의 사이즈, 위치, 또는 내부 레이아웃에 영향을 주는 프로퍼티치의 변경이 있었을 때에, 컴퍼넌트에 대해서 자동적으로 불려 갑니다. 이 자동적인 갱신은, 프로그램이, 일반적으로, GUI 의 내용을 갱신하기 위해서 validate 를 호출할 필요가 없다고 하는 점으로써 AWT 와는 다릅니다.

관련 항목:

Component.invalidate() , Container.validate() , isValidateRoot() , RepaintManager.addInvalidComponent(javax.swing.JComponent)

isValidateRoot

public boolean isValidateRoot()

이 메소드가 true 를 돌려주는 경우, 이 컴퍼넌트의 하위 컴퍼넌트에 의해 revalidate 가 불려 가면(자), 이 루트로 시작되는 트리 전체가 검증됩니다. 디폴트에서는 false 를 돌려줍니다. JScrollPane 는 이 메소드를 오버라이드(override) 해, true 를 돌려줍니다.

반환값:

항상 false 를 돌려주는

관련 항목:

revalidate() , Component.invalidate() , Container.validate()

isOptimizedDrawingEnabled

public boolean isOptimizedDrawingEnabled()

이 컴퍼넌트가 그 아이를 타일링 하는 경우, 즉 아이가 오버랩 하지 않는 것이 보증되는 경우에 true 를 돌려줍니다. 일반적으로는, 재페인트 시스템 쪽이 꽤 효율적입니다. JLayeredPane 등, 이 보증을 할 수 없는 JComponent 의 서브 클래스는, 이 메소드를 오버라이드(override) 해 false 를 돌려줄 필요가 있습니다.

반환값:

항상 true 를 돌려준다

paintImmediately

public void paintImmediately(int x,
                             int y,
                             int w,
                             int h)

이 컴퍼넌트의 지정된 영역, 및 그 영역과 오버랩 하는 모든 하위 컴퍼넌트를 곧바로 그립니다.

이 메소드를 호출할 필요는 거의 없습니다. 대부분의 경우, 실제의 페인트를 늦추어 장황한 요구를 단일의 paint 호출해에 집약할 수가 있는 repaint 를 호출하는 편이 보다 효율적입니다. 이 메소드는, 현재의 이벤트가 발송 되고 있을 때 표시를 갱신할 필요가 있는 경우에는 편리합니다.

파라미터:

x - 페인트 영역의 x 좌표

y - 페인트 영역의 y 좌표

w - 페인트 영역의 폭

h - 페인트 영역의 높이

관련 항목:

repaint(long, int, int, int, int)

paintImmediately

public void paintImmediately(Rectangle  r)

지정된 영역을 곧바로 그립니다.

파라미터:

r - 페인트 하는 영역을 포함한 Rectangle

setDoubleBuffered

public void setDoubleBuffered(boolean aFlag)

이 컴퍼넌트가 버퍼를 사용해 페인트 할지 어떨지를 설정합니다. true 로 설정되어 있는 경우, 이 컴퍼넌트로부터의 모든 draw는 오프 스크린 draw 버퍼로 행해집니다. 그리고 오프 스크린 draw 버퍼가 화면에 카피됩니다. Component 가 버퍼링 되고 있어 게다가 위객체도 버퍼링 되고 있는 경우, 상위 객체의 버퍼가 사용됩니다.

파라미터:

aFlag - true 의 경우, 이 컴퍼넌트로 더블 버퍼를 사용하도록(듯이) 설정

isDoubleBuffered

public boolean isDoubleBuffered()

이 컴퍼넌트가 버퍼를 사용해 페인트 할지 어떨지를 돌려줍니다.

오버라이드(override):

클래스 Component 내의 isDoubleBuffered

반환값:

이 컴퍼넌트가 더블 버퍼를 사용하는 경우는 true, 그렇지 않은 경우는 false

getRootPane

public JRootPane  getRootPane()

이 컴퍼넌트의 JRootPane 상위 컴퍼넌트를 돌려줍니다.

반환값:

이 컴퍼넌트를 포함하는 JRootPane. JRootPane 가 발견되지 않는 경우는 null

paramString

protected String  paramString()

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

오버라이드(override):

클래스 Container 내의 paramString

반환값:

이 JComponent 의 캐릭터 라인 표현