SWING - JLabel 类

简介

JLabel 类可以显示文本、图像或两者。 Label 的内容通过在其显示区域设置垂直和水平对齐来对齐。 默认情况下,标签在其显示区域中垂直居中。 默认情况下,纯文本标签前缘对齐; 默认情况下,仅图像标签水平居中。


类声明

以下是 javax.swing.JLabel 类的声明 −

public class JLabel
   extends JComponent
      implements SwingConstants, Accessible

字段

以下是 javax.swing.JLabel 类的字段 −

protected Component labelFor


类构造函数

序号 构造函数 & 描述
1

JLabel()

创建一个没有图像且标题为空字符串的 JLabel 实例。

2

JLabel(Icon image)

创建具有指定图像的 JLabel 实例。

3

JLabel(Icon image, int horizontalAlignment)

创建具有指定图像和水平对齐的 JLabel 实例。

4

JLabel(String text)

创建具有指定文本的 JLabel 实例。

5

JLabel(String text, Icon icon, int horizontalAlignment)

创建具有指定文本、图像和水平对齐方式的 JLabel 实例。

6

JLabel(String text, int horizontalAlignment)

创建具有指定文本和水平对齐的 JLabel 实例。


类方法

序号 方法 & 描述
1

protected int checkHorizontalKey(int key, String message)

验证 key 是 HorizontalAlignment 属性的合法值。

2

protected int checkVerticalKey(int key, String message)

验证 key 是 verticalAlignment 或 verticalTextPosition 属性的合法值。

3

AccessibleContext getAccessibleContext()

获取此对象的 AccessibleContext。

4

Icon getDisabledIcon()

返回标签禁用时使用的图标。

5

int getDisplayedMnemonic()

返回表示助记键的键码。

6

int getDisplayedMnemonicIndex()

以索引的形式返回外观应为其提供装饰的字符,以表示助记符。

7

int getHorizontalAlignment()

返回标签内容沿 X 轴的对齐方式。

8

int getHorizontalTextPosition()

返回标签文本相对于其图像的水平位置。

9

Icon getIcon()

返回标签显示的图形图像(字形、图标)。

10

int getIconTextGap()

返回此标签中显示的文本和图标之间的空间量。

11

Component getLabelFor()

获取正在标记的组件。

12

String getText()

返回标签显示的文本字符串。

13

LabelUI getUI()

返回呈现此组件的 L&F 对象。

14

String getUIClassID()

返回一个字符串,该字符串指定呈现此组件的 l&f 类的名称。

15

int getVerticalAlignment()

返回标签内容沿 Y 轴的对齐方式。

16

int getVerticalTextPosition()

返回标签文本相对于其图像的垂直位置。

17

boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)

如果当前 Icon 的图像不等于传入的 Image 图像,这将被覆盖以返回 false。

18

protected String paramString()

返回此 JLabel 的字符串表示形式。

19

void setDisabledIcon(Icon disabledIcon)

设置此 JLabel 为"disabled"时要显示的图标 (JLabel.setEnabled(false))。

20

void setDisplayedMnemonic(char aChar)

将显示的助记符指定为 char 值。

21

void setDisplayedMnemonic(int key)

指定一个表示助记键的键码。

22

void setDisplayedMnemonicIndex(int index)

提供有关应修饰文本中的哪个字符以表示助记符的外观提示。

23

void setHorizontalAlignment(int alignment)

设置标签内容沿 X 轴的对齐方式。

24

void setHorizontalTextPosition(int textPosition)

设置标签文本相对于其图像的水平位置。

25

void setIcon(Icon icon)

定义此组件将显示的图标。

26

void setIconTextGap(int iconTextGap)

如果同时设置了 icon 和 text 属性,则此属性定义它们之间的空间。

27

void setLabelFor(Component c)

设置组件,这是标签。

28

void setText(String text)

定义此组件将显示的单行文本。

29

void setUI(LabelUI ui)

设置呈现此组件的 L&F 对象。

30

void setVerticalAlignment(int alignment)

设置标签内容沿 Y 轴的对齐方式。

31

void setVerticalTextPosition(int textPosition)

设置标签文本相对于其图像的垂直位置。

32

void updateUI()

将 UI 属性重置为当前外观的值。


继承的方法

这个类继承了以下类的方法 −

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

JLabel 示例

D:/ > SWING > com > tutorialspoint > gui > 中使用您选择的任何编辑器创建以下 Java 程序

SwingControlDemo.java
package com.tutorialspoint.gui;
 
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
 
public class SwingControlDemo {
   private JFrame mainFrame;
   private JLabel headerLabel;
   private JLabel statusLabel;
   private JPanel controlPanel;

   public SwingControlDemo(){
      prepareGUI();
   }
   public static void main(String[] args){
      SwingControlDemo  swingControlDemo = new SwingControlDemo();      
      swingControlDemo.showLabelDemo();
   }
   private void prepareGUI(){
      mainFrame = new JFrame("Java Swing Examples");
      mainFrame.setSize(400,400);
      mainFrame.setLayout(new GridLayout(3, 1));
      
      mainFrame.addWindowListener(new WindowAdapter() {
         public void windowClosing(WindowEvent windowEvent){
            System.exit(0);
         }        
      });    
      headerLabel = new JLabel("", JLabel.CENTER);        
      statusLabel = new JLabel("",JLabel.CENTER);    
      statusLabel.setSize(350,100);
      controlPanel = new JPanel();
      controlPanel.setLayout(new FlowLayout());

      mainFrame.add(headerLabel);
      mainFrame.add(controlPanel);
      mainFrame.add(statusLabel);
      mainFrame.setVisible(true);  
   }
   private void showLabelDemo(){
      headerLabel.setText("Control in action: JLabel");      
      JLabel label  = new JLabel("", JLabel.CENTER);        
      label.setText("Welcome to TutorialsPoint Swing Tutorial.");
      label.setOpaque(true);
      label.setBackground(Color.GRAY);
      label.setForeground(Color.WHITE);
      controlPanel.add(label);
      
      mainFrame.setVisible(true);  
   }
}

使用命令提示符编译程序。 转到 D:/ > SWING 并键入以下命令。

D:\SWING>javac com\tutorialspoint\gui\SwingControlDemo.java

如果没有报错,说明编译成功。 使用以下命令运行程序。

D:\SWING>java com.tutorialspoint.gui.SwingControlDemo

验证以下输出。

Swing JLabel

❮ SWING 控件