javax.swing

接口
异常
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's Threading Policy

警告:此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 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
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, 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
 

JDK 1.6 中文手册