|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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 |
字段详细信息 |
---|
protected Component labelFor
构造方法详细信息 |
---|
public JLabel(String text, Icon icon, int horizontalAlignment)
JLabel
实例。该标签在其显示区内垂直居中对齐。文本位于图像的结尾边上。
text
- 由标签显示的文本。icon
- 由标签显示的图像。horizontalAlignment
- SwingConstants
中定义的以下常量之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。public JLabel(String text, int horizontalAlignment)
JLabel
实例。该标签在其显示区内垂直居中对齐。
text
- 由标签显示的文本。horizontalAlignment
- 在 SwingConstants
中定义的以下常量之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。public JLabel(String text)
JLabel
实例。该标签与其显示区的开始边对齐,并垂直居中。
text
- 由标签显示的文本。public JLabel(Icon image, int horizontalAlignment)
JLabel
实例。该标签在其显示区内垂直居中对齐。
image
- 由标签显示的图像。horizontalAlignment
- 在 SwingConstants
中定义的以下常量之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。public JLabel(Icon image)
JLabel
实例。该标签在其显示区内垂直和水平居中对齐。
image
- 由标签显示的图像。public JLabel()
JLabel
。该标签在其显示区内垂直居中对齐。一旦设置了标签的内容,该内容就会显示在标签显示区的开始边上。
方法详细信息 |
---|
public LabelUI getUI()
public void setUI(LabelUI ui)
ui
- LabelUI L&F 对象UIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
JComponent
中的 updateUI
public String getUIClassID()
JComponent
中的 getUIClassID
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
public String getText()
setText(java.lang.String)
public void setText(String text)
此属性的默认值为 null。
这是一个 JavaBeans 绑定属性。
public Icon getIcon()
setIcon(javax.swing.Icon)
public void setIcon(Icon icon)
此属性的默认值为 null。
这是一个 JavaBeans 绑定属性。
public Icon getDisabledIcon()
某些外观可能无法呈现禁用图标,在此情况下,外观将忽略此图标。
public void setDisabledIcon(Icon disabledIcon)
此属性的默认值为 null。
disabledIcon
- 组件禁用时要显示的图标getDisabledIcon()
,
JComponent.setEnabled(boolean)
public void setDisplayedMnemonic(int key)
public void setDisplayedMnemonic(char aChar)
aChar
- 指定要显示的助记符的 charsetDisplayedMnemonic(int)
public int getDisplayedMnemonic()
getLabelFor()
,
setLabelFor(java.awt.Component)
public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
此值随着与助记符相关属性的变化(如助记符本身、文本……)而得到更新。只有不希望对默认字符加下划线时,才必须调用此方法。例如,如果文本为 'Save As',助记符为 'a',而您希望装饰 'A',使文本显示为 'Save As',那么您必须在调用 setDisplayedMnemonic(KeyEvent.VK_A)
之后调用 setDisplayedMnemonicIndex(5)
。
index
- 要加下划线的 String 中的索引
IllegalArgumentException
- 在 index
>= 文本长度或< -1 时抛出public int getDisplayedMnemonicIndex()
setDisplayedMnemonicIndex(int)
protected int checkHorizontalKey(int key, String message)
key
- 要检查的属性值message
- IllegalArgumentException 详细消息
IllegalArgumentException
- 如果 key 不是 LEFT、CENTER、RIGHT、LEADING 或 TRAILING。setHorizontalTextPosition(int)
,
setHorizontalAlignment(int)
protected int checkVerticalKey(int key, String message)
key
- 要检查的属性值message
- IllegalArgumentException 详细消息
IllegalArgumentException
- 如果 key 不是 TOP、CENTER 或 BOTTOM。setVerticalAlignment(int)
,
setVerticalTextPosition(int)
public int getIconTextGap()
setIconTextGap(int)
public void setIconTextGap(int iconTextGap)
此属性的默认值为 4 个像素。
这是一个 JavaBeans 绑定属性。
getIconTextGap()
public int getVerticalAlignment()
SwingConstants
中定义的以下常量之一:TOP
、CENTER
或 BOTTOM
。SwingConstants
,
setVerticalAlignment(int)
public void setVerticalAlignment(int alignment)
此属性的默认值为 CENTER。
alignment
- SwingConstants
中定义的以下常量之一:TOP
、CENTER
(默认)或 BOTTOM
。SwingConstants
,
getVerticalAlignment()
public int getHorizontalAlignment()
SwingConstants
中定义的以下常量之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。setHorizontalAlignment(int)
,
SwingConstants
public void setHorizontalAlignment(int alignment)
这是一个 JavaBeans 绑定属性。
alignment
- SwingConstants
中定义的以下常量之一:LEFT
、CENTER
(只显示图像的标签的默认值)、RIGHT
、LEADING
(只显示文本的标签的默认值)或 TRAILING
。SwingConstants
,
getHorizontalAlignment()
public int getVerticalTextPosition()
SwingConstants
中定义的以下常量之一:TOP
、CENTER
或 BOTTOM
。setVerticalTextPosition(int)
,
SwingConstants
public void setVerticalTextPosition(int textPosition)
此属性的默认值为 CENTER。
这是一个 JavaBeans 绑定属性。
textPosition
- SwingConstants
中定义的以下常量之一:TOP
、CENTER
(默认)或 BOTTOM
。SwingConstants
,
getVerticalTextPosition()
public int getHorizontalTextPosition()
SwingConstants
中定义的以下常量之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
。SwingConstants
public void setHorizontalTextPosition(int textPosition)
textPosition
- SwingConstants
中定义的以下常量之一:LEFT
、CENTER
、RIGHT
、LEADING
或 TRAILING
(默认)。
IllegalArgumentException
SwingConstants
public boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
img
,则重写此方法以返回 false。
ImageObserver
中的 imageUpdate
Component
中的 imageUpdate
img
- 正观察的图像infoflags
- 有关更多信息,请参阅 imageUpdate
x
- x 坐标y
- y 坐标w
- 宽度h
- 高度
false
;否则返回 true
。ImageObserver
,
Component.imageUpdate(java.awt.Image, int, int, int, int, int)
protected String paramString()
null
。
JComponent
中的 paramString
public Component getLabelFor()
getDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public void setLabelFor(Component c)
c
- 要添加此标签的 Component,如果该标签不是组件的标签,则为 nullgetDisplayedMnemonic()
,
setDisplayedMnemonic(int)
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
JComponent
中的 getAccessibleContext
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。