java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JLabel
public class JLabel
用于短文本字符串或图像或二者的显示区。标签不对输入事件作出反应。因此,它无法获得键盘焦点。但是,标签可以为具有键盘替换功能却无法显示的邻近组件方便地显示其键盘替换功能。
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 属性重置为当前外观的值。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
|
---|