Java javax.swing 类 JLabel（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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 对象可以显示文本、图像或同时显示二者。可以通过设置垂直和水平对齐方式，指定标签显示区中标签内容在何处对齐。默认情况下，标签在其显示区内垂直居中对齐。默认情况下，只显示文本的标签是开始边对齐；而只显示图像的标签则水平居中对齐。

还可以指定文本相对于图像的位置。默认情况下，文本位于图像的结尾边上，文本和图像都垂直对齐。

根据标签的 ComponentOrientation 属性值确定其开始边和结尾边。目前，默认的 ComponentOrientation 设置将开始边映射到左边，将结尾边映射到右边。

最后，还可以使用 setIconTextGap 方法指定文本和图像之间应该出现多少像素。默认情况下为 4 个像素。

有关进一步的文档，请参阅《The Java Tutorial》中的 How to Use Labels 一节。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

---

嵌套类摘要
protected  class	JLabel.AccessibleJLabel           该类用于获得此对象的可访问性职责。

 

从类 javax.swing.JComponent 继承的嵌套类/接口
JComponent.AccessibleJComponent

 

从类 java.awt.Container 继承的嵌套类/接口
Container.AccessibleAWTContainer

 

从类 java.awt.Component 继承的嵌套类/接口
Component.AccessibleAWTComponent, 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。
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()           返回指示助记符键的键代码。
int	getDisplayedMnemonicIndex()           以索引的形式返回字符，外观应提供该字符的装饰以表示助记符。
int	getHorizontalAlignment()           返回标签内容沿 X 轴的对齐方式。
int	getHorizontalTextPosition()           返回标签的文本相对其图像的水平位置。
Icon	getIcon()           返回该标签显示的图形图像（字形、图标）。
int	getIconTextGap()           返回此标签中显示的文本和图标之间的间隔量。
Component	getLabelFor()           获得将标签添加到的组件。
String	getText()           返回该标签所显示的文本字符串。
LabelUI	getUI()           返回呈现此组件的 L&F 对象。
String	getUIClassID()           返回一个指定 L&F 类名称的字符串，该类呈现此组件。
int	getVerticalAlignment()           返回标签内容沿 Y 轴的对齐方式。
int	getVerticalTextPosition()           返回标签的文本相对其图像的垂直位置。
boolean	imageUpdate(Image img, int infoflags, int x, int y, int w, int h)           如果当前图标的图像不等于传入的图像 img，则重写此方法以返回 false。
protected  String	paramString()           返回此 JLabel 的字符串表示形式。
void	setDisabledIcon(Icon disabledIcon)           设置如果此 JLabel 是“禁用的”(JLabel.setEnabled(false))，则要显示的图标。
void	setDisplayedMnemonic(char aChar)           指定 displayedMnemonic 为一个 char 值。
void	setDisplayedMnemonic(int key)           指定一个指示助记符键的键代码。
void	setDisplayedMnemonicIndex(int index)           关于应该装饰文本中的哪个字符以表示助记符，为外观提供一个提示。
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)           定义此组件将要显示的单行文本。
void	setUI(LabelUI ui)           设置呈现此组件的 L&F 对象。
void	setVerticalAlignment(int alignment)           设置标签内容沿 Y 轴的对齐方式。
void	setVerticalTextPosition(int textPosition)           设置标签的文本相对其图像的垂直位置。
void	updateUI()           根据当前外观将 UI 属性重置为某个值。

 

从类 javax.swing.JComponent 继承的方法

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, 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 实例。该标签在其显示区内垂直居中对齐。文本位于图像的结尾边上。

参数：

text - 由标签显示的文本。

icon - 由标签显示的图像。

horizontalAlignment - SwingConstants 中定义的以下常量之一：LEFT、CENTER、RIGHT、LEADING 或 TRAILING。

---

JLabel

public JLabel(String text,
              int horizontalAlignment)

创建具有指定文本和水平对齐方式的 JLabel 实例。该标签在其显示区内垂直居中对齐。

参数：

text - 由标签显示的文本。

horizontalAlignment - 在 SwingConstants 中定义的以下常量之一：LEFT、CENTER、RIGHT、LEADING 或 TRAILING。

---

JLabel

public JLabel(String text)

创建具有指定文本的 JLabel 实例。该标签与其显示区的开始边对齐，并垂直居中。

参数：

text - 由标签显示的文本。

---

JLabel

public JLabel(Icon image,
              int horizontalAlignment)

创建具有指定图像和水平对齐方式的 JLabel 实例。该标签在其显示区内垂直居中对齐。

参数：

image - 由标签显示的图像。

horizontalAlignment - 在 SwingConstants 中定义的以下常量之一：LEFT、CENTER、RIGHT、LEADING 或 TRAILING。

---

JLabel

public JLabel(Icon image)

创建具有指定图像的 JLabel 实例。该标签在其显示区内垂直和水平居中对齐。

参数：

image - 由标签显示的图像。

---

JLabel

public JLabel()

创建无图像并且其标题为空字符串的 JLabel。该标签在其显示区内垂直居中对齐。一旦设置了标签的内容，该内容就会显示在标签显示区的开始边上。

方法详细信息

getUI

public LabelUI getUI()

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

返回：

LabelUI 对象

---

setUI

public void setUI(LabelUI ui)

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

参数：

ui - LabelUI L&F 对象

另请参见：

UIDefaults.getUI(javax.swing.JComponent)