JLabel — 라벨 컴포넌트

JLabel — 라벨 컴포넌트

JLabel은 짧은 텍스트 문자열이나 이미지, 또는 둘 다를 표시하는 컴포넌트입니다. 라벨은 입력 이벤트에 반응하지 않습니다.

출처: Java API Reference

본문

public class JLabel extends JComponent implements SwingConstants, Accessible

짧은 텍스트 문자열이나 이미지, 또는 둘 다를 표시하는 표시 영역입니다. 라벨은 입력 이벤트에 반응하지 않으므로 키보드 포커스를 얻을 수 없습니다. 그러나 키보드 대안이 있는 가까운 컴포넌트의 편의를 위해 키보드 대안을 표시할 수는 있습니다. JLabel 객체는 텍스트나 이미지, 또는 둘 다를 표시할 수 있습니다. 수직·수평 정렬을 설정해 라벨 표시 영역 안에서 내용이 어디에 정렬될지 지정할 수 있습니다. 기본적으로 라벨은 표시 영역에서 수직 중앙에 놓입니다. 텍스트만 있는 라벨은 기본적으로 선두 모서리 정렬이고, 이미지만 있는 라벨은 기본적으로 수평 중앙 정렬입니다. 이미지에 대한 텍스트의 위치도 지정할 수 있습니다. 기본적으로 텍스트는 이미지의 후미 모서리에 있으며, 텍스트와 이미지는 수직으로 정렬됩니다. 라벨의 선두·후미 모서리는 ComponentOrientation 프로퍼티 값으로 결정됩니다. 현재 기본 ComponentOrientation 설정은 선두 모서리를 왼쪽, 후미 모서리를 오른쪽에 매핑합니다. 마지막으로 setIconTextGap 메서드로 텍스트와 이미지 사이에 몇 픽셀을 둘지 지정할 수 있습니다. 기본값은 4픽셀입니다. 자세한 문서는 The Java Tutorial의 "How to Use Labels"를 참고하세요. 경고: Swing은 스레드에 안전하지 않습니다. 이 클래스의 직렬화된 객체는 향후 Swing 버전과 호환되지 않을 수 있습니다. 현재 직렬화 지원은 단기 저장이나 같은 버전의 Swing을 실행하는 애플리케이션 간 RMI에 적합합니다. 1.4부터 모든 JavaBean의 장기 저장 지원이 java.beans 패키지에 추가되었으니 XMLEncoder를 참고하세요.

labelFor

protected Component labelFor

이 라벨이 연결된 Component. 라벨이 컴포넌트의 라벨이 아니면 null입니다.

JLabel

public JLabel()

빈 문자열과 왼쪽 정렬로 JLabel을 만듭니다.

JLabel

public JLabel(String text)

지정된 텍스트로 JLabel을 만듭니다.

  • 매개변수: text - 라벨에 표시할 텍스트

JLabel

public JLabel(Icon image)

지정된 이미지로 JLabel 인스턴스를 만듭니다.

  • 매개변수: image - 라벨에 표시할 이미지

JLabel

public JLabel(Icon image, int horizontalAlignment)

지정된 이미지와 수평 정렬로 JLabel 인스턴스를 만듭니다.

  • 매개변수: image - 라벨에 표시할 이미지
  • 매개변수: horizontalAlignment - LEFT, CENTER, RIGHT 중 하나

JLabel

public JLabel(String text, Icon icon, int horizontalAlignment)

지정된 텍스트, 이미지, 수평 정렬로 JLabel 인스턴스를 만듭니다.

  • 매개변수: text - 라벨에 표시할 텍스트
  • 매개변수: icon - 라벨에 표시할 이미지
  • 매개변수: horizontalAlignment - LEFT, CENTER, RIGHT 중 하나

setText

public void setText(String text)

이 라벨에 표시할 텍스트를 정의합니다.

  • 매개변수: text - 표시할 텍스트

getText

public String getText()

라벨이 표시하는 텍스트를 반환합니다.

  • 반환값: 라벨의 텍스트

setIcon

public void setIcon(Icon icon)

이 컴포넌트가 표시하는 아이콘을 정의합니다.

  • 매개변수: icon - 표시할 아이콘

getIcon

public Icon getIcon()

라벨이 표시하는 그래픽 이미지(글리프, 아이콘)를 반환합니다.

  • 반환값: 아이콘

setLabelFor

public void setLabelFor(Component c)

이 라벨이 연결될 컴포넌트를 설정합니다. 라벨의 mnemonic이 눌리면 연결된 컴포넌트에 포커스가 주어집니다.

  • 매개변수: c - 이 라벨이 연결될 컴포넌트

getLabelFor

public Component getLabelFor()

이 라벨이 연결된 컴포넌트를 가져옵니다.

  • 반환값: 이 라벨의 labelFor 프로퍼티, 라벨이 아무 컴포넌트와도 연결되지 않았으면 null

setVerticalAlignment

public void setVerticalAlignment(int alignment)

라벨 내용의 수직 정렬을 설정합니다.

  • 매개변수: alignment - TOP, CENTER, BOTTOM 중 하나

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)

라벨 내용의 수평 정렬을 설정합니다.

  • 매개변수: alignment - LEFT, CENTER, RIGHT 중 하나

setIconTextGap

public void setIconTextGap(int iconTextGap)

텍스트와 아이콘 사이의 간격을 설정합니다.

  • 매개변수: iconTextGap - 텍스트와 아이콘 사이의 픽셀 수

getIconTextGap

public int getIconTextGap()

이 라벨의 텍스트와 아이콘 사이의 간격을 반환합니다.

  • 반환값: 텍스트와 아이콘 사이의 픽셀 수

더 알아보기