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 컴퍼넌트가 그것 자신을 렌더링하기 위한 장소를 제공하는 특수한 컴퍼넌트입니다. 포함 관계의 계층에 대해서는 「The Java Tutorial」의 「Swing Components and the Containment Hierarchy」를 참조하십시오.

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

• Swing 아키텍쳐를 사용하는 표준 컴퍼넌트 및 커스텀 컴퍼넌트 양쪽 모두의 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로 부터 파생하는 어느 객체에도 관련짓는 것이 가능
• 더블 버퍼링과 보더의 지원에 대응하고 있는 페인트를 위한 인프라스트럭쳐. 상세한 것에 대하여는 「The Java Tutorial」의 「Painting」라고 「How to Use Borders」를 참조

상기의 기능의 상세한 것에 대하여는 Swing 패키지의 설명과 「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 릴리즈와 호환되지 않을 예정입니다. 현재의 직렬화의 지원은 단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전 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)

중첩(Nested) 클래스 개요

class

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

클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스

Component.AccessibleAWTComponent, 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 버전 1.1 그 뒤로는 java.awt.Component.setEnabled(boolean)로 옮겨졌습니다.
void	enable () 추천하지 않습니다. JDK 버전 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 프로퍼티를 리턴합니다.
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 버전 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 () Component 「가시 구형」을 리턴합니다.
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	isPaintingTile () 컴퍼넌트가 현재 타일을 페인트 하고 있는 경우에 true를 리턴합니다.
boolean	isRequestFocusEnabled () 이 JComponent이 포커스를 얻는인 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다.
boolean	isValidateRoot () 이 메서드가 true를 돌려주는 경우, 이 컴퍼넌트의 하위 컴퍼넌트에 의해 revalidate가 불려가 면, 이 루트로 시작되는 트리 전체가 검증됩니다.
void	paint (Graphics g) 이 메서드는 Swing에 의해 불려가 컴퍼넌트를 렌더링 합니다.
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) 컴퍼넌트를 인쇄하려면, 이 메서드를 호출합니다.
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 () 추천하지 않습니다. JDK 버전 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 버전 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 () UI 프로퍼티를 현재의 Look & Feel 로부터의 값에 리셋 합니다.

클래스 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()

UI 프로퍼티를 현재의 Look & Feel 로부터의 값에 리셋 합니다. 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) 해, 그러한 Look & Feel를 정의하는 ComponentUI 서브 클래스에 대응하는 UIDefaults 키를 돌려줄 필요가 있습니다.

반환값:

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인 경우, 컴퍼넌트의 상위 객체는 버퍼를 가지지 않고, 컴퍼넌트의자식는 각각 독자적인 버퍼를 가질 때 버퍼를 사용할 수 있습니다. 그렇지 않은 경우, 상위 객체가 버퍼를 현재 사용중이며,자식는 렌더링를 위한 버퍼를 사용할 수 없습니다.

파라미터:

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에 의해 불려가 컴퍼넌트를 렌더링 합니다. 어플리케이션으로부터는 paint를 직접 호출하지 않게 합니다. 대신에 repaint 메서드를 사용해 컴퍼넌트의 재렌더링를 스케줄 할 필요가 있습니다.

이 메서드는 실제로는 페인트 작업을 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)

컴퍼넌트를 인쇄하려면, 이 메서드를 호출합니다. 이 메서드는 printComponent, printBorder 및 printChildren을 호출합니다. 이 메서드를 오버라이드(override) 하는 것은 추천 되지 않기 때문에 대신에 전술의 메서드의 어떤 것인지를 오버라이드(override) 합니다. 이 메서드에서는 컴퍼넌트를 더블 버퍼링을 사용하지 않는 상태, 즉 페인트가 Graphics 수신측에서 직접 행해지는 상태로 설정합니다.

오버라이드(override):

클래스 Container 내의 print

파라미터:

g - 페인트 대상의 Graphics 컨텍스트

관련 항목:

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

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

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 버전 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 버전 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 traversal을 가능하게 하는 경우에 사용됩니다. 이 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 입니다. 현재의 포커스를 가지는 컴퍼넌트에의 입력이, 그 컴퍼넌트의 입력 베리파이아로 건네받지 않은 경우에서도 활성화 할 필요가 있는 「Cancel」버튼 또는 스크롤 바등의 컴퍼넌트는 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) 한다), 임의로 그러한 인 세트의 경계내의 보더 장식을 렌더링 합니다. Swing 컴퍼넌트로 장식 영역 및 비장식 영역 (마진 및 패딩등)의 양쪽 모두를 생성하려면, 인 세트가 아니고 보더를 사용할 필요가 있습니다. 단일의 컴퍼넌트내에서 복수의 보더를 상자로 하려면, 복합 보더를 사용할 수 있습니다.

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

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

파라미터:

border - 이 컴퍼넌트로 렌더링 되는 보더

관련 항목:

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

이 컴퍼넌트의 그래픽 컨텍스트를 리턴합니다. 그래픽 컨텍스트를 사용하면, 컴퍼넌트를 렌더링 할 수 있습니다. 이 메서드를 사용하면, Graphics 객체를 취득해, 그 객체로 처리를 호출해 컴퍼넌트를 렌더링 할 수 있습니다.

오버라이드(override):

클래스 Component 내의 getGraphics

반환값:

이 컴퍼넌트의 그래픽 컨텍스트

관련 항목:

Component.paint(java.awt.Graphics)

setDebugGraphicsOptions

public void setDebugGraphicsOptions(int debugOptions)

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

파라미터:

debugOptions - 컴퍼넌트가 정보를 표시하는 방법을 지정하는 옵션. 다음의 어떤 것인가가 됩니다.

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

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

getDebugGraphicsOptions

public int getDebugGraphicsOptions()

그래픽의 디버그 상태를 리턴합니다.

반환값:

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

• DebugGraphics.LOG_OPTION - 텍스트 메세지를 출력한다
• DebugGraphics.FLASH_OPTION - 렌더링를 몇차례 점멸시킨다
• 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가 발생 됩니다. 같이condition가 상기의 것이 아닌 경우, IllegalArgumentException가 발생 됩니다.

파라미터:

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

도입된 버전 :

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

requestDefaultFocus

@Deprecated 
public boolean requestDefaultFocus()

추천하지 않습니다. JDK 버전 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 컬러를 설정합니다.

오버라이드(override):

클래스 Component 내의 setForeground

파라미터:

fg - 요구하는 foreground Color

관련 항목:

Component.getForeground()

setBackground

public void setBackground(Color  bg)

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

오버라이드(override):

클래스 Component 내의 setBackground

파라미터:

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

관련 항목:

Component.getBackground()

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가 표시되는 위치

도입된 버전 :

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 버전 1.1 그 뒤로는 java.awt.Component.setEnabled(boolean)로 옮겨졌습니다.

오버라이드(override):

클래스 Component 내의 enable

disable

@Deprecated 
public void disable()

추천하지 않습니다. JDK 버전 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)

관련 항목:

Component.firePropertyChange(java.lang.String, java.lang.Object, 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. 거부 가능 변경 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

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. 상위 리스너가 현재 등록되지 않은 경우는 비어있는 배열을 돌려주는

도입된 버전 :

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 메서드로 등록된 것입니다.

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

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

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

오버라이드(override):

클래스 Container 내의 getListeners

파라미터:

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

반환값:

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

예외:

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 로 설정되어 있는 경우, 이 컴퍼넌트로부터의 모든 렌더링는 오프 스크린 렌더링 버퍼로 행해집니다. 그리고 오프 스크린 렌더링 버퍼가 화면에 복사됩니다. Swing 렌더링 시스템은 항상 1개의 더블 버퍼를 최대한 사용합니다. 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 캐릭터 라인 표현을 리턴합니다. 이 메서드는 디버그 전용이며, 리턴된 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 리턴된 캐릭터 라인은 비어있는 경우가 있습니다만, null로는 되지 않습니다.

오버라이드(override):

클래스 Container 내의 paramString

반환값:

이 JComponent 캐릭터 라인 표현