|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JLabel
public class JLabel
짧은 텍스트 캐릭터 라인이나 이미지의 표시 영역입니다. 양쪽 모두를 함께 표시할 수도 있습니다. 라벨은 입력 이벤트에는 반응하지 않습니다. 그 때문에, 라벨은 키보드 포커스를 취득하지 않습니다. 그러나, 근처에 있는 컴퍼넌트에 키보드 쇼트 컷을 할당할 수 있고 있어, 그 컴퍼넌트가 스스로 쇼트 컷을 표시할 수 없는 경우에는, 라벨을 이용해 표시할 수가 있습니다.
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 프로퍼티을 리셋 합니다. |
클래스 java.lang. Object 로부터 상속된 메소드 |
---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
필드의 상세 |
---|
protected Component labelFor
생성자 의 상세 |
---|
public JLabel(String text, Icon icon, int horizontalAlignment)
JLabel
의 인스턴스를 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다. 텍스트는 이미지의 트레이 링 엣지에 표시됩니다.
text
- 라벨에 표시되는 텍스트icon
- 라벨에 표시되는 이미지horizontalAlignment
- SwingConstants
로 정의되고 있는 정수 LEFT
,CENTER
,RIGHT
,LEADING
, 또는 TRAILING
가운데 1 개public JLabel(String text, int horizontalAlignment)
JLabel
의 인스턴스를, 지정된 텍스트와 수평 방향의 배치 방법으로 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다.
text
- 라벨에 표시되는 텍스트horizontalAlignment
- SwingConstants
로 정의되고 있는 정수 LEFT
,CENTER
,RIGHT
,LEADING
, 또는 TRAILING
가운데 1 개public JLabel(String text)
JLabel
의 인스턴스를, 지정된 텍스트로 작성합니다. 라벨은, 표시 영역의 리딩 엣지에 가지런히 할 수 있어 수직 방향으로 centering 됩니다.
text
- 라벨에 표시되는 텍스트public JLabel(Icon image, int horizontalAlignment)
JLabel
의 인스턴스를, 지정된 이미지와 수평 방향의 배치 방법으로 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다.
image
- 라벨에 표시되는 이미지horizontalAlignment
- SwingConstants
로 정의되고 있는 정수 LEFT
,CENTER
,RIGHT
,LEADING
, 또는 TRAILING
가운데 1 개public JLabel(Icon image)
JLabel
의 인스턴스를, 지정된 이미지로 작성합니다. 라벨은, 표시 영역내에서 수직 방향과 수평 방향으로 centering 됩니다.
image
- 라벨에 표시되는 이미지public JLabel()
JLabel
의 인스턴스를, 이미지 없음의 빈 상태(empty)의 타이틀 캐릭터 라인으로 작성합니다. 라벨은, 표시 영역내에서 수직 방향으로 centering 됩니다. 라벨의 내용이 설정되면(자), 라벨은 표시 영역의 리딩 엣지에 표시됩니다.
메소드의 상세 |
---|
public LabelUI getUI()
public void setUI(LabelUI ui)
ui
- LabelUI L&F 객체UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
JComponent
내의 updateUI
JComponent.updateUI()
public String getUIClassID()
JComponent
내의 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public String getText()
setText(java.lang.String)
public void setText(String text)
이 프로퍼티의 디폴트 값는 null 입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
setVerticalTextPosition(int)
,
setHorizontalTextPosition(int)
,
setIcon(javax.swing.Icon)
public Icon getIcon()
setIcon(javax.swing.Icon)
public void setIcon(Icon icon)
이 프로퍼티의 디폴트 값는 null 입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
setVerticalTextPosition(int)
,
setHorizontalTextPosition(int)
,
getIcon()
public Icon getDisabledIcon()
Look & Feel 에 따라서는 무효인 상태의 아이콘이 draw 되지 않는 것이 있어, 그 경우, 무효인 상태의 아이콘은 무시됩니다.
disabledIcon
프로퍼티setDisabledIcon(javax.swing.Icon)
,
LookAndFeel.getDisabledIcon(javax.swing.JComponent, javax.swing.Icon)
,
ImageIcon
public void setDisabledIcon(Icon disabledIcon)
이 프로퍼티의 디폴트 값는 null 입니다.
disabledIcon
- 컴퍼넌트가 무효인 경우에 표시되는 IcongetDisabledIcon()
,
JComponent.setEnabled(boolean)
public void setDisplayedMnemonic(int key)
getLabelFor()
,
setLabelFor(java.awt.Component)
public void setDisplayedMnemonic(char aChar)
aChar
- 표시되는 니마닉(mnemonic)를 지정하는 charsetDisplayedMnemonic(int)
public int getDisplayedMnemonic()
getLabelFor()
,
setLabelFor(java.awt.Component)
public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
이 값은, 니마닉(mnemonic)의 변경 (니마닉(mnemonic) 자신 또는 텍스트의 변경등)에 관련하는 프로퍼티으로서 갱신됩니다. 디폴트의 문자를 밑줄 첨부가 아니게 하는 경우, 이만큼을 호출할 필요가 있습니다. 예를 들어, 니마닉(mnemonic) 「a」를 가지는 텍스트 「Save As」에 대해, 「Save As」와 같이 「A」를 수식하는 경우는,setDisplayedMnemonic(KeyEvent.VK_A)
을 호출하고 나서 setDisplayedMnemonicIndex(5)
를 호출합니다.
index
- 밑줄을 붙이는 String 에 대한 인덱스
IllegalArgumentException
- index
= 텍스트의 길이, 또는 < -1 의 경우public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
protected int checkHorizontalKey(int key, String message)
key
- 체크하는 프로퍼티치message
- IllegalArgumentException 의 상세 메세지
IllegalArgumentException
- 키가 LEFT, CENTER, RIGHT, LEADING, TRAILING 의 어떤 것도 아닌 경우setHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String message)
key
- 체크하는 프로퍼티치message
- IllegalArgumentException 의 상세 메세지
IllegalArgumentException
- 키가 TOP, CENTER, 또는 BOTTOM 가 아닌 경우setVerticalAlignment(int)
,
setVerticalTextPosition(int)
public int getIconTextGap()
setIconTextGap(int)
public void setIconTextGap(int iconTextGap)
이 프로퍼티의 디폴트 값는 4 픽셀입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
getIconTextGap()
public int getVerticalAlignment()
SwingConstants
로 정의되고 있는 정수 TOP
,CENTER
, 또는 BOTTOM
가운데 1 개SwingConstants
,
setVerticalAlignment(int)
public void setVerticalAlignment(int alignment)
이 프로퍼티의 디폴트 값는 CENTER 입니다.
alignment
- SwingConstants
로 정의되고 있는 정수 TOP
,CENTER
(디폴트), 또는 BOTTOM
가운데 1 개SwingConstants
,
getVerticalAlignment()
public int getHorizontalAlignment()
SwingConstants
로 정의되고 있는 정수 LEFT
,CENTER
,RIGHT
,LEADING
, 또는 TRAILING
가운데 1 개setHorizontalAlignment(int)
,
SwingConstants
public void setHorizontalAlignment(int alignment)
이것은 JavaBeans 바운드 프로퍼티입니다.
alignment
- SwingConstants
로 정의되고 있는 정수. LEFT
,CENTER
(이미지만의 라벨의 디폴트),RIGHT
,LEADING
(텍스트만의 라벨의 디폴트),TRAILING
의 어떤 것이나SwingConstants
,
getHorizontalAlignment()
public int getVerticalTextPosition()
SwingConstants
로 정의되고 있는 정수 TOP
,CENTER
, 또는 BOTTOM
가운데 1 개setVerticalTextPosition(int)
,
SwingConstants
public void setVerticalTextPosition(int textPosition)
이 프로퍼티의 디폴트 값는 CENTER 입니다.
이것은 JavaBeans 바운드 프로퍼티입니다.
textPosition
- SwingConstants
로 정의되고 있는 정수 TOP
,CENTER
(디폴트), 또는 BOTTOM
가운데 1 개SwingConstants
,
getVerticalTextPosition()
public int getHorizontalTextPosition()
SwingConstants
로 정의되고 있는 정수 LEFT
,CENTER
,RIGHT
,LEADING
, 또는 TRAILING
가운데 1 개SwingConstants
public void setHorizontalTextPosition(int textPosition)
textPosition
- SwingConstants
로 정의되고 있는 정수 LEFT
,CENTER
,RIGHT
,LEADING
, 또는 TRAILING
(디폴트) 가운데 1 개
IllegalArgumentException
SwingConstants
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
img
와 다른 경우는, false 를 돌려주어 오버라이드(override) 합니다.
ImageObserver
내의 imageUpdate
Component
내의 imageUpdate
img
- 표시되는 이미지infoflags
- 자세한 것은 imageUpdate
를 참조x
- x 좌표y
- y 좌표w
- 폭h
- 높이
false
,
그렇지 않은 경우는 true
ImageObserver
,
Component.imageUpdate(java.awt.Image, int, int, int, int, int)
protected String paramString()
null
로는 되지 않습니다.
JComponent
내의 paramString
public Component getLabelFor()
getDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public void setLabelFor(Component c)
c
- 라벨을 할당할 수 있고 있는 컴퍼넌트.
라벨을 컴퍼넌트에 할당할 수 있지 않은 경우는 nullgetDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public AccessibleContext getAccessibleContext()
Accessible
내의 getAccessibleContext
JComponent
내의 getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.