JavaTM Platform
Standard Ed. 6

javax.swing
클래스 JLabel

java.lang.Object 
  상위를 확장 java.awt.Component 
      상위를 확장 java.awt.Container 
          상위를 확장 javax.swing.JComponent 
              상위를 확장 javax.swing.JLabel
모든 구현된 인터페이스:
ImageObserver , MenuContainer , Serializable , Accessible , SwingConstants
직계의 기존의 서브 클래스:
BasicComboBoxRenderer , DefaultListCellRenderer , DefaultTableCellRenderer , DefaultTreeCellRenderer


public class JLabel
extends JComponent
implements SwingConstants , Accessible

짧은 텍스트 캐릭터 라인이나 이미지의 표시 영역입니다. 양쪽 모두를 함께 표시할 수도 있습니다. 라벨은 입력 이벤트에는 반응하지 않습니다. 그 때문에, 라벨은 키보드 포커스를 취득하지 않습니다. 그러나, 근처에 있는 컴퍼넌트에 키보드 쇼트 컷을 할당할 수 있고 있어, 그 컴퍼넌트가 스스로 쇼트 컷을 표시할 수 없는 경우에는, 라벨을 이용해 표시할 수가 있습니다.  

JLabel 객체에는, 캐릭터 라인이나 이미지를 표시할 수가 있습니다. 양쪽 모두를 함께 표시할 수도 있습니다. 수직 방향과 수평 방향의 배치 방법을 설정하는 것에 의해, 라벨의 표시 영역내에서의 라벨 내용의 표시 장소를 지정할 수가 있습니다. 디폴트에서는, 라벨은 표시 영역내에서 수직 방향으로 centering 되어 표시됩니다. 또, 디폴트에서는, 텍스트만의 라벨은 리딩 엣지에 가지런히 할 수 있어 이미지만의 라벨은 수평 방향으로 centering로 됩니다.  

또, 이미지에 대한 텍스트의 위치를 상대적으로 지정할 수도 있습니다. 디폴트에서는, 텍스트는 이미지의 트레이 링 엣지에 표시되어 텍스트와 이미지는 수직 방향으로 가지런히 할 수 있습니다.  

라벨의 리딩 엣지 및 트레이 링 엣지는,ComponentOrientation 프로퍼티의 값으로부터 판정됩니다. 현재는, 디폴트의 ComponentOrientation 설정은, 리딩 엣지가 왼쪽, 트레이 링 엣지가 오른쪽으로 매핑 되고 있습니다.

게다가setIconTextGap 메소드를 사용해, 텍스트와 이미지의 사이의 거리를 픽셀수로 지정할 수가 있습니다. 디폴트는 4 픽셀입니다.  

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

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

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


상자의 클래스의 개요
protected  class JLabel.AccessibleJLabel
          이 객체의 접근성?를 취득하기 위해서 사용되는 클래스입니다.
 
클래스 javax.swing. JComponent 로부터 상속된 상자의 클래스/인터페이스
JComponent.AccessibleJComponent
 
클래스 java.awt. Container 로부터 상속된 상자의 클래스/인터페이스
Container.AccessibleAWTContainer
 
클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스
Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy
 
필드의 개요
protected  Component labelFor
           
 
클래스 javax.swing. JComponent 로부터 상속된 필드
accessibleContext , listenerList , TOOL_TIP_TEXT_KEY , ui , UNDEFINED_CONDITION , WHEN_ANCESTOR_OF_FOCUSED_COMPONENT , WHEN_FOCUSED , WHEN_IN_FOCUSED_WINDOW
 
클래스 java.awt. Component 로부터 상속된 필드
BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT
 
인터페이스 javax.swing. SwingConstants 로부터 상속된 필드
BOTTOM , CENTER , EAST , HORIZONTAL , LEADING , LEFT , NEXT , NORTH , NORTH_EAST , NORTH_WEST , PREVIOUS , RIGHT , SOUTH , SOUTH_EAST , SOUTH_WEST , TOP , TRAILING , VERTICAL , WEST
 
인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드
ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH
 
생성자 의 개요
JLabel ()
          JLabel 의 인스턴스를, 이미지 없음의 빈 상태(empty)의 타이틀 캐릭터 라인으로 작성합니다.
JLabel (Icon  image)
          JLabel 의 인스턴스를, 지정된 이미지로 작성합니다.
JLabel (Icon  image, int horizontalAlignment)
          JLabel 의 인스턴스를, 지정된 이미지와 수평 방향의 배치 방법으로 작성합니다.
JLabel (String  text)
          JLabel 의 인스턴스를, 지정된 텍스트로 작성합니다.
JLabel (String  text, Icon  icon, int horizontalAlignment)
          지정된 텍스트, 이미지, 및 수평 방향의 배치 방법으로,JLabel 의 인스턴스를 작성합니다.
JLabel (String  text, int horizontalAlignment)
          JLabel 의 인스턴스를, 지정된 텍스트와 수평 방향의 배치 방법으로 작성합니다.
 
메소드의 개요
protected  int checkHorizontalKey (int key, String  message)
          horizontalAlignment 프로퍼티에 대해서 키가 정당한 값일지 어떨지를 판정합니다.
protected  int checkVerticalKey (int key, String  message)
          verticalAlignment 또는 verticalTextPosition 프로퍼티에 대해서 키가 정당한 값일지 어떨지를 판정합니다.
 AccessibleContext getAccessibleContext ()
          이 객체의 AccessibleContext 를 돌려줍니다.
 Icon getDisabledIcon ()
          무효인 상태의 라벨의 아이콘을 돌려줍니다.
 int getDisplayedMnemonic ()
          니마닉(mnemonic) 키를 나타내는 키코드를 돌려줍니다.
 int getDisplayedMnemonicIndex ()
          Look & Feel 가 니마닉(mnemonic) 문자를 나타내기 위한 수식을 제공하는 문자를 인덱스로서 돌려줍니다.
 int getHorizontalAlignment ()
          라벨의 내용의 X 축으로 따른 배치 방법을 돌려줍니다.
 int getHorizontalTextPosition ()
          라벨 텍스트의 이미지에 대한 수평 위치를 돌려줍니다.
 Icon getIcon ()
          라벨에 표시하는 그래픽 이미지 (Glyph나 아이콘)를 돌려줍니다.
 int getIconTextGap ()
          이 라벨에 표시되고 있는 텍스트와 아이콘과의 거리를 돌려줍니다.
 Component getLabelFor ()
          이 라벨을 할당할 수 있고 있는 컴퍼넌트를 돌려줍니다.
 String getText ()
          라벨이 표시하는 텍스트 캐릭터 라인을 돌려줍니다.
 LabelUI getUI ()
          이 컴퍼넌트를 draw 하는 L&F 객체를 돌려줍니다.
 String getUIClassID ()
          이 컴퍼넌트를 draw 하는 L&F 클래스의 이름을 지정하는 캐릭터 라인을 돌려줍니다.
 int getVerticalAlignment ()
          라벨의 내용의 Y 축으로 따른 배치 방법을 돌려줍니다.
 int getVerticalTextPosition ()
          라벨 텍스트의 이미지에 대한 수직 위치를 돌려줍니다.
 boolean imageUpdate (Image  img, int infoflags, int x, int y, int w, int h)
          현재의 Icon 의 Image 가, 건네받은 Image 의 img 와 다른 경우는, false 를 돌려주어 오버라이드(override) 합니다.
protected  String paramString ()
          이 JLabel 의 캐릭터 라인 표현을 돌려줍니다.
 void setDisabledIcon (Icon  disabledIcon)
          이 JLabel 가 무효로 되고 있는 (JLabel.setEnabled(false)가 실행되고 있다) 경우에 표시되는 아이콘을 설정합니다.
 void setDisplayedMnemonic (char aChar)
          displayedMnemonic 를 char 값로 설정합니다.
 void setDisplayedMnemonic (int key)
          니마닉(mnemonic) 키를 나타내는 키코드를 설정합니다.
 void setDisplayedMnemonicIndex (int index)
          니마닉(mnemonic)를 나타내기 위해서(때문에) 텍스트의 어느 문자를 장식할까에 대한 힌트를, Look & Feel 에 제공합니다.
 void setHorizontalAlignment (int alignment)
          라벨의 내용의 X 축으로 따른 배치 방법을 설정합니다.
 void setHorizontalTextPosition (int textPosition)
          라벨 텍스트의 이미지에 대한 수평 위치를 설정합니다.
 void setIcon (Icon  icon)
          이 컴퍼넌트가 표시하는 아이콘을 정의합니다.
 void setIconTextGap (int iconTextGap)
          아이콘 프로퍼티과 텍스트 프로퍼티이 양쪽 모두 설정되어 있는 경우에, 이 프로퍼티은 그러한 사이의 거리를 정의합니다.
 void setLabelFor (Component  c)
          이 라벨을 할당할 수 있고 있는 컴퍼넌트를 설정합니다.
 void setText (String  text)
          이 컴퍼넌트가 표시하는 단일행의 텍스트를 정의하는 이 컴퍼넌트가 표시하는 1 행의 텍스트를 정의합니다.
 void setUI (LabelUI  ui)
          이 컴퍼넌트를 draw 하는 L&F 객체를 설정합니다.
 void setVerticalAlignment (int alignment)
          라벨의 내용의 Y 축으로 따른 배치 방법을 설정합니다.
 void setVerticalTextPosition (int textPosition)
          라벨의 이미지에 대한 텍스트의 수직 위치를 설정합니다.
 void updateUI ()
          현재의 Look & Feel 로부터의 값에 UI 프로퍼티을 리셋 합니다.
 
클래스 javax.swing. JComponent 로부터 상속된 메소드
addAncestorListener , addNotify , addVetoableChangeListener , computeVisibleRect , contains , createToolTip , disable , enable , firePropertyChange , firePropertyChange , firePropertyChange , fireVetoableChange , getActionForKeyStroke , getActionMap , getAlignmentX , getAlignmentY , getAncestorListeners , getAutoscrolls , getBaseline , getBaselineResizeBehavior , getBorder , getBounds , getClientProperty , getComponentGraphics , getComponentPopupMenu , getConditionForKeyStroke , getDebugGraphicsOptions , getDefaultLocale , getFontMetrics , getGraphics , getHeight , getInheritsPopupMenu , getInputMap , getInputMap , getInputVerifier , getInsets , getInsets , getListeners , getLocation , getMaximumSize , getMinimumSize , getNextFocusableComponent , getPopupLocation , getPreferredSize , getRegisteredKeyStrokes , getRootPane , getSize , getToolTipLocation , getToolTipText , getToolTipText , getTopLevelAncestor , getTransferHandler , getVerifyInputWhenFocusTarget , getVetoableChangeListeners , getVisibleRect , getWidth , getX , getY , grabFocus , isDoubleBuffered , isLightweightComponent , isManagingFocus , isOpaque , isOptimizedDrawingEnabled , isPaintingForPrint , isPaintingTile , isRequestFocusEnabled , isValidateRoot , paint , paintBorder , paintChildren , paintComponent , paintImmediately , paintImmediately , print , printAll , printBorder , printChildren , printComponent , processComponentKeyEvent , processKeyBinding , processKeyEvent , processMouseEvent , processMouseMotionEvent , putClientProperty , registerKeyboardAction , registerKeyboardAction , removeAncestorListener , removeNotify , removeVetoableChangeListener , repaint , repaint , requestDefaultFocus , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , resetKeyboardActions , reshape , revalidate , scrollRectToVisible , setActionMap , setAlignmentX , setAlignmentY , setAutoscrolls , setBackground , setBorder , setComponentPopupMenu , setDebugGraphicsOptions , setDefaultLocale , setDoubleBuffered , setEnabled , setFocusTraversalKeys , setFont , setForeground , setInheritsPopupMenu , setInputMap , setInputVerifier , setMaximumSize , setMinimumSize , setNextFocusableComponent , setOpaque , setPreferredSize , setRequestFocusEnabled , setToolTipText , setTransferHandler , setUI , setVerifyInputWhenFocusTarget , setVisible , unregisterKeyboardAction , update
 
클래스 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 , 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
 

필드의 상세

labelFor

protected Component  labelFor
생성자 의 상세

JLabel

public JLabel(String  text,
              Icon  icon,
              int horizontalAlignment)
지정된 텍스트, 이미지, 및 수평 방향의 배치 방법으로,JLabel 의 인스턴스를 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다. 텍스트는 이미지의 트레이 링 엣지에 표시됩니다.

파라미터:
text - 라벨에 표시되는 텍스트
icon - 라벨에 표시되는 이미지
horizontalAlignment - SwingConstants 로 정의되고 있는 정수 LEFT,CENTER,RIGHT,LEADING, 또는 TRAILING 가운데 1 개

JLabel

public JLabel(String  text,
              int horizontalAlignment)
JLabel 의 인스턴스를, 지정된 텍스트와 수평 방향의 배치 방법으로 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다.

파라미터:
text - 라벨에 표시되는 텍스트
horizontalAlignment - SwingConstants 로 정의되고 있는 정수 LEFT,CENTER,RIGHT,LEADING, 또는 TRAILING 가운데 1 개

JLabel

public JLabel(String  text)
JLabel 의 인스턴스를, 지정된 텍스트로 작성합니다. 라벨은, 표시 영역의 리딩 엣지에 가지런히 할 수 있어 수직 방향으로 centering 됩니다.

파라미터:
text - 라벨에 표시되는 텍스트

JLabel

public JLabel(Icon  image,
              int horizontalAlignment)
JLabel 의 인스턴스를, 지정된 이미지와 수평 방향의 배치 방법으로 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다.

파라미터:
image - 라벨에 표시되는 이미지
horizontalAlignment - SwingConstants 로 정의되고 있는 정수 LEFT,CENTER,RIGHT,LEADING, 또는 TRAILING 가운데 1 개

JLabel

public JLabel(Icon  image)
JLabel 의 인스턴스를, 지정된 이미지로 작성합니다. 라벨은, 표시 영역내에서 수직 방향과 수평 방향으로 centering 됩니다.

파라미터:
image - 라벨에 표시되는 이미지

JLabel

public JLabel()
JLabel 의 인스턴스를, 이미지 없음의 빈 상태(empty)의 타이틀 캐릭터 라인으로 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다. 라벨의 내용이 설정되면(자), 라벨은 표시 영역의 리딩 엣지에 표시됩니다.

메소드의 상세

getUI

public LabelUI  getUI()
이 컴퍼넌트를 draw 하는 L&F 객체를 돌려줍니다.

반환값:
LabelUI 객체

setUI

public void setUI(LabelUI  ui)
이 컴퍼넌트를 draw 하는 L&F 객체를 설정합니다.

파라미터:
ui - LabelUI L&F 객체
관련 항목:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
현재의 Look & Feel 로부터의 값에 UI 프로퍼티을 리셋 합니다.

오버라이드(override):
클래스 JComponent 내의 updateUI
관련 항목:
JComponent.updateUI()

getUIClassID

public String  getUIClassID()
이 컴퍼넌트를 draw 하는 L&F 클래스의 이름을 지정하는 캐릭터 라인을 돌려줍니다.

오버라이드(override):
클래스 JComponent 내의 getUIClassID
반환값:
캐릭터 라인 「LabelUI」
관련 항목:
JComponent.getUIClassID() , UIDefaults.getUI(javax.swing.JComponent)

getText

public String  getText()
라벨이 표시하는 텍스트 캐릭터 라인을 돌려줍니다.

반환값:
캐릭터 라인
관련 항목:
setText(java.lang.String)

setText

public void setText(String  text)
이 컴퍼넌트가 표시하는 단일행의 텍스트를 정의하는 이 컴퍼넌트가 표시하는 1 행의 텍스트를 정의합니다.  

이 프로퍼티의 디폴트 값는 null 입니다.  

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

관련 항목:
setVerticalTextPosition(int) , setHorizontalTextPosition(int) , setIcon(javax.swing.Icon)

getIcon

public Icon  getIcon()
라벨에 표시하는 그래픽 이미지 (Glyph나 아이콘)를 돌려줍니다.

반환값:
아이콘
관련 항목:
setIcon(javax.swing.Icon)

setIcon

public void setIcon(Icon  icon)
이 컴퍼넌트가 표시하는 아이콘을 정의합니다. 아이콘의 값이 null 인 경우에는, 아무것도 표시되지 않습니다.  

이 프로퍼티의 디폴트 값는 null 입니다.  

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

관련 항목:
setVerticalTextPosition(int) , setHorizontalTextPosition(int) , getIcon()

getDisabledIcon

public Icon  getDisabledIcon()
무효인 상태의 라벨의 아이콘을 돌려줍니다. 무효인 상태의 아이콘이 설정되어 있지 않은 경우는, 호출이 Look & Feel 에 전송 되어, 적절한 상태의 아이콘이 구축됩니다.  

Look & Feel 에 따라서는 무효인 상태의 아이콘이 draw 되지 않는 것이 있어, 그 경우, 무효인 상태의 아이콘은 무시됩니다.

반환값:
disabledIcon 프로퍼티
관련 항목:
setDisabledIcon(javax.swing.Icon) , LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon) , ImageIcon

setDisabledIcon

public void setDisabledIcon(Icon  disabledIcon)
이 JLabel 가 무효로 되고 있는 (JLabel.setEnabled(false)가 실행되고 있다) 경우에 표시되는 아이콘을 설정합니다.  

이 프로퍼티의 디폴트 값는 null 입니다.

파라미터:
disabledIcon - 컴퍼넌트가 무효인 경우에 표시되는 Icon
관련 항목:
getDisabledIcon() , JComponent.setEnabled(boolean)

setDisplayedMnemonic

public void setDisplayedMnemonic(int key)
니마닉(mnemonic) 키를 나타내는 키코드를 설정합니다. 이 프로퍼티은, 라벨이 큰 컴퍼넌트의 일부인 경우에 사용합니다. 라벨의 labelFor 프로퍼티이 null 가 아닌 경우, 라벨은 니마닉(mnemonic)의 기동시에, labelFor 프로퍼티으로 지정되고 있는 컴퍼넌트의 requestFocus 메소드를 호출합니다.

관련 항목:
getLabelFor() , setLabelFor(java.awt.Component)

setDisplayedMnemonic

public void setDisplayedMnemonic(char aChar)
displayedMnemonic 를 char 값로 설정합니다.

파라미터:
aChar - 표시되는 니마닉(mnemonic)를 지정하는 char
관련 항목:
setDisplayedMnemonic(int)

getDisplayedMnemonic

public int getDisplayedMnemonic()
니마닉(mnemonic) 키를 나타내는 키코드를 돌려줍니다. 이 프로퍼티은, 라벨이 큰 컴퍼넌트의 일부인 경우에 사용합니다. 라벨의 labelFor 프로퍼티이 null 가 아닌 경우, 라벨은 니마닉(mnemonic)의 기동시에, labelFor 프로퍼티으로 지정되고 있는 컴퍼넌트의 requestFocus 메소드를 호출합니다.

반환값:
니마닉(mnemonic) 키의 코드를 나타내는 int 치
관련 항목:
getLabelFor() , setLabelFor(java.awt.Component)

setDisplayedMnemonicIndex

public void setDisplayedMnemonicIndex(int index)
                               throws IllegalArgumentException 
니마닉(mnemonic)를 나타내기 위해서(때문에) 텍스트의 어느 문자를 장식할까에 대한 힌트를, Look & Feel 에 제공합니다. 모든 Look & Feel 가 이것을 지원하고 있는 것은 아닙니다. 값 -1 은 니마닉(mnemonic)가 없는지, 니마닉(mnemonic) 문자가 캐릭터 라인에 포함되지 않은지, 개발자가 니마닉(mnemonic)를 표시시키지 않게 하고 있는 것을 나타냅니다.  

이 값은, 니마닉(mnemonic)의 변경 (니마닉(mnemonic) 자신 또는 텍스트의 변경등)에 관련하는 프로퍼티으로서 갱신됩니다. 디폴트의 문자를 밑줄 첨부가 아니게 하는 경우, 이만큼을 호출할 필요가 있습니다. 예를 들어, 니마닉(mnemonic) 「a」를 가지는 텍스트 「Save As」에 대해, 「Save As」와 같이 「A」를 수식하는 경우는,setDisplayedMnemonic(KeyEvent.VK_A) 을 호출하고 나서 setDisplayedMnemonicIndex(5) 를 호출합니다.

파라미터:
index - 밑줄을 붙이는 String 에 대한 인덱스
예외:
IllegalArgumentException - index = 텍스트의 길이, 또는 < -1 의 경우
도입된 버젼:
1.4

getDisplayedMnemonicIndex

public int getDisplayedMnemonicIndex()
Look & Feel 가 니마닉(mnemonic) 문자를 나타내기 위한 수식을 제공하는 문자를 인덱스로서 돌려줍니다.

반환값:
니마닉(mnemonic) 문자를 나타내는 인덱스
도입된 버젼:
1.4
관련 항목:
setDisplayedMnemonicIndex(int)

checkHorizontalKey

protected int checkHorizontalKey(int key,
                                 String  message)
horizontalAlignment 프로퍼티에 대해서 키가 정당한 값일지 어떨지를 판정합니다.

파라미터:
key - 체크하는 프로퍼티치
message - IllegalArgumentException 의 상세 메세지
예외:
IllegalArgumentException - 키가 LEFT, CENTER, RIGHT, LEADING, TRAILING 의 어떤 것도 아닌 경우
관련 항목:
setHorizontalTextPosition(int) , setHorizontalAlignment(int)

checkVerticalKey

protected int checkVerticalKey(int key,
                               String  message)
verticalAlignment 또는 verticalTextPosition 프로퍼티에 대해서 키가 정당한 값일지 어떨지를 판정합니다.

파라미터:
key - 체크하는 프로퍼티치
message - IllegalArgumentException 의 상세 메세지
예외:
IllegalArgumentException - 키가 TOP, CENTER, 또는 BOTTOM 가 아닌 경우
관련 항목:
setVerticalAlignment(int) , setVerticalTextPosition(int)

getIconTextGap

public int getIconTextGap()
이 라벨에 표시되고 있는 텍스트와 아이콘과의 거리를 돌려줍니다.

반환값:
텍스트, 아이콘간의 픽셀수를 나타내는 int 치
관련 항목:
setIconTextGap(int)

setIconTextGap

public void setIconTextGap(int iconTextGap)
아이콘 프로퍼티과 텍스트 프로퍼티이 양쪽 모두 설정되어 있는 경우에, 이 프로퍼티은 그러한 사이의 거리를 정의합니다.  

이 프로퍼티의 디폴트 값는 4 픽셀입니다.  

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

관련 항목:
getIconTextGap()

getVerticalAlignment

public int getVerticalAlignment()
라벨의 내용의 Y 축으로 따른 배치 방법을 돌려줍니다.

반환값:
verticalAlignment 프로퍼티의 값. SwingConstants 로 정의되고 있는 정수 TOP,CENTER, 또는 BOTTOM 가운데 1 개
관련 항목:
SwingConstants , setVerticalAlignment(int)

setVerticalAlignment

public void setVerticalAlignment(int alignment)
라벨의 내용의 Y 축으로 따른 배치 방법을 설정합니다.  

이 프로퍼티의 디폴트 값는 CENTER 입니다.

파라미터:
alignment - SwingConstants 로 정의되고 있는 정수 TOP,CENTER (디폴트), 또는 BOTTOM 가운데 1 개
관련 항목:
SwingConstants , getVerticalAlignment()

getHorizontalAlignment

public int getHorizontalAlignment()
라벨의 내용의 X 축으로 따른 배치 방법을 돌려줍니다.

반환값:
horizontalAlignment 프로퍼티의 값. SwingConstants 로 정의되고 있는 정수 LEFT,CENTER,RIGHT,LEADING, 또는 TRAILING 가운데 1 개
관련 항목:
setHorizontalAlignment(int) , SwingConstants

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)
라벨의 내용의 X 축으로 따른 배치 방법을 설정합니다.  

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

파라미터:
alignment - SwingConstants 로 정의되고 있는 정수. LEFT,CENTER (이미지만의 라벨의 디폴트),RIGHT,LEADING (텍스트만의 라벨의 디폴트),TRAILING 의 어떤 것이나
관련 항목:
SwingConstants , getHorizontalAlignment()

getVerticalTextPosition

public int getVerticalTextPosition()
라벨 텍스트의 이미지에 대한 수직 위치를 돌려줍니다.

반환값:
SwingConstants 로 정의되고 있는 정수 TOP,CENTER, 또는 BOTTOM 가운데 1 개
관련 항목:
setVerticalTextPosition(int) , SwingConstants

setVerticalTextPosition

public void setVerticalTextPosition(int textPosition)
라벨의 이미지에 대한 텍스트의 수직 위치를 설정합니다.  

이 프로퍼티의 디폴트 값는 CENTER 입니다.  

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

파라미터:
textPosition - SwingConstants 로 정의되고 있는 정수 TOP,CENTER (디폴트), 또는 BOTTOM 가운데 1 개
관련 항목:
SwingConstants , getVerticalTextPosition()

getHorizontalTextPosition

public int getHorizontalTextPosition()
라벨 텍스트의 이미지에 대한 수평 위치를 돌려줍니다.

반환값:
SwingConstants 로 정의되고 있는 정수 LEFT,CENTER,RIGHT,LEADING, 또는 TRAILING 가운데 1 개
관련 항목:
SwingConstants

setHorizontalTextPosition

public void setHorizontalTextPosition(int textPosition)
라벨 텍스트의 이미지에 대한 수평 위치를 설정합니다.

파라미터:
textPosition - SwingConstants 로 정의되고 있는 정수 LEFT,CENTER,RIGHT,LEADING, 또는 TRAILING (디폴트) 가운데 1 개
예외:
IllegalArgumentException
관련 항목:
SwingConstants

imageUpdate

public boolean imageUpdate(Image  img,
                           int infoflags,
                           int x,
                           int y,
                           int w,
                           int h)
현재의 Icon 의 Image 가, 건네받은 Image 의 img 와 다른 경우는, false 를 돌려주어 오버라이드(override) 합니다.

정의:
인터페이스 ImageObserver 내의 imageUpdate
오버라이드(override):
클래스 Component 내의 imageUpdate
파라미터:
img - 표시되는 이미지
infoflags - 자세한 것은 imageUpdate 를 참조
x - x 좌표
y - y 좌표
w - 폭
h - 높이
반환값:
이미지 전체가 로드 되는 것을 infoflags 가 가리키는 경우는 false, 그렇지 않은 경우는 true
관련 항목:
ImageObserver , Component.imageUpdate(java.awt.Image, int, int, int, int, int)

paramString

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

오버라이드(override):
클래스 JComponent 내의 paramString
반환값:
이 JLabel 의 캐릭터 라인 표현

getLabelFor

public Component  getLabelFor()
이 라벨을 할당할 수 있고 있는 컴퍼넌트를 돌려줍니다.

반환값:
이 라벨을 할당할 수 있고 있는 컴퍼넌트. 이 라벨을 컴퍼넌트에 할당할 수 있지 않은 경우는 null. displayedMnemonic 프로퍼티과 labelFor 프로퍼티이 설정되어 있는 경우, 라벨은 니마닉(mnemonic)가 액티브하게 되었을 때에, labelFor 프로퍼티으로 지정되고 있는 컴퍼넌트의 requestFocus 메소드 (을)를 호출하는
관련 항목:
getDisplayedMnemonic() , setDisplayedMnemonic(int)

setLabelFor

public void setLabelFor(Component  c)
이 라벨을 할당할 수 있고 있는 컴퍼넌트를 설정합니다. 이 라벨을 컴퍼넌트에 할당할 수 있지 않은 경우는 null 를 돌려줍니다. displayedMnemonic 프로퍼티이 설정되어 있어, labelFor 프로퍼티도 설정되어 있는 경우에는, 라벨은 니마닉(mnemonic)가 액티브하게 되었을 때에, labelFor 프로퍼티으로 지정되고 있는 컴퍼넌트의 requestFocus 메소드를 호출합니다.

파라미터:
c - 라벨을 할당할 수 있고 있는 컴퍼넌트. 라벨을 컴퍼넌트에 할당할 수 있지 않은 경우는 null
관련 항목:
getDisplayedMnemonic() , setDisplayedMnemonic(int)

getAccessibleContext

public AccessibleContext  getAccessibleContext()
이 객체의 AccessibleContext 를 돌려줍니다.

정의:
인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):
클래스 JComponent 내의 getAccessibleContext
반환값:
이 객체의 AccessibleContext

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.