javax.swing.border
类 TitledBorder

java.lang.Object
  javax.swing.border.AbstractBorder
      javax.swing.border.TitledBorder

所有已实现的接口：

Serializable, Border

直接已知子类：

BorderUIResource.TitledBorderUIResource

public class TitledBorder
extends AbstractBorder

该类实现在指定位置以指定对齐方式显示字符串标题的任意边框。

如果构造方法中未指定边框、字体或颜色属性，也没有调用相应的设置方法来设置这些属性值，则当前外观将按照“默认表”中的如下属性名称定义属性值：

• "TitledBorder.border"
• "TitledBorder.font"
• "TitledBorder.titleColor"

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

字段摘要

static int	ABOVE_BOTTOM 将标题置于边框底端线的顶部。
static int	ABOVE_TOP 将标题置于边框顶端线的上部。
static int	BELOW_BOTTOM 将标题置于边框底端线的底部。
static int	BELOW_TOP 将标题置于边框顶端线的底部。
protected Border	border
static int	BOTTOM 将标题置于边框底端线的中部。
static int	CENTER 将标题文本置于边框线的中心。
static int	DEFAULT_JUSTIFICATION 标题文本使用默认的对齐方式。
static int	DEFAULT_POSITION 标题文本使用默认的垂直方向。
protected static int	EDGE_SPACING
static int	LEADING 从左到右排列时将标题文本置于边框线的左边，从右到左排列时将标题文本置于边框线的右边。
static int	LEFT 将标题文本置于边框线的左边。
static int	RIGHT 将标题文本置于边框线的右边。
protected static int	TEXT_INSET_H
protected static int	TEXT_SPACING
protected String	title
protected Color	titleColor
protected Font	titleFont
protected int	titleJustification
protected int	titlePosition
static int	TOP 将标题置于边框顶端线的中部。
static int	TRAILING 从左到右排列时将标题文本置于边框线的右边，从右到左排列时将标题文本置于边框线的左边。

构造方法摘要

TitledBorder(Border border)
创建具有指定边框和空标题的 TitledBorder 实例。

TitledBorder(Border border, String title)
创建具有指定边框和标题的 TitledBorder 实例。

TitledBorder(Border border, String title, int titleJustification, int titlePosition)
用指定的边框、标题、标题对齐方式和标题位置创建 TitledBorder 实例。

TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont)
用指定的边框、标题、标题对齐方式、标题位置和标题字体创建 TitledBorder 实例。

TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont, Color titleColor)
用指定的边框、标题、标题对齐方式、标题位置、标题字体和标题颜色创建 TitledBorder 实例。

TitledBorder(String title)
创建 TitledBorder 实例。

方法摘要

Border	getBorder() 返回带标题边框的边框。
Insets	getBorderInsets(Component c) 返回边框的 insets。
Insets	getBorderInsets(Component c, Insets insets) 用此边框的当前 Insets 重新初始化 insets 参数。
protected Font	getFont(Component c)
Dimension	getMinimumSize(Component c) 返回此边框完全显示边框和标题所需的最小尺寸。
String	getTitle() 返回带标题边框的标题。
Color	getTitleColor() 返回带标题边框的标题颜色。
Font	getTitleFont() 返回带标题边框的标题字体。
int	getTitleJustification() 返回带标题边框的标题对齐方式。
int	getTitlePosition() 返回带标题边框的标题位置。
boolean	isBorderOpaque() 返回边框是否透明。
void	paintBorder(Component c, Graphics g, int x, int y, int width, int height) 按照指定的位置和尺寸为指定的组件绘制边框。
void	setBorder(Border border) 设置带标题边框的边框。
void	setTitle(String title) 设置带标题边框的标题。
void	setTitleColor(Color titleColor) 设置带标题边框的标题颜色。
void	setTitleFont(Font titleFont) 设置带标题边框的标题字体。
void	setTitleJustification(int titleJustification) 设置带标题边框的标题对齐方式。
void	setTitlePosition(int titlePosition) 设置带标题边框的标题位置。

从类 javax.swing.border.AbstractBorder 继承的方法

getInteriorRectangle, getInteriorRectangle

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

title

protected String title

border

protected Border border

titlePosition

protected int titlePosition

titleJustification

protected int titleJustification

titleFont

protected Font titleFont

titleColor

protected Color titleColor

DEFAULT_POSITION

public static final int DEFAULT_POSITION

标题文本使用默认的垂直方向。

另请参见：

常量字段值

ABOVE_TOP

public static final int ABOVE_TOP

将标题置于边框顶端线的上部。

另请参见：

常量字段值

TOP

public static final int TOP

将标题置于边框顶端线的中部。

另请参见：

常量字段值

BELOW_TOP

public static final int BELOW_TOP

将标题置于边框顶端线的底部。

另请参见：

常量字段值

ABOVE_BOTTOM

public static final int ABOVE_BOTTOM

将标题置于边框底端线的顶部。

另请参见：

常量字段值

BOTTOM

public static final int BOTTOM

将标题置于边框底端线的中部。

另请参见：

常量字段值

BELOW_BOTTOM

public static final int BELOW_BOTTOM

将标题置于边框底端线的底部。

另请参见：

常量字段值

DEFAULT_JUSTIFICATION

public static final int DEFAULT_JUSTIFICATION

标题文本使用默认的对齐方式。

另请参见：

常量字段值

LEFT

public static final int LEFT

将标题文本置于边框线的左边。

另请参见：

常量字段值

CENTER

public static final int CENTER

将标题文本置于边框线的中心。

另请参见：

常量字段值

RIGHT

public static final int RIGHT

将标题文本置于边框线的右边。

另请参见：

常量字段值

LEADING

public static final int LEADING

从左到右排列时将标题文本置于边框线的左边，从右到左排列时将标题文本置于边框线的右边。

另请参见：

常量字段值

TRAILING

public static final int TRAILING

从左到右排列时将标题文本置于边框线的右边，从右到左排列时将标题文本置于边框线的左边。

另请参见：

常量字段值

EDGE_SPACING

protected static final int EDGE_SPACING

另请参见：

常量字段值

TEXT_SPACING

protected static final int TEXT_SPACING

另请参见：

常量字段值

TEXT_INSET_H

protected static final int TEXT_INSET_H

另请参见：

常量字段值

构造方法详细信息

TitledBorder

public TitledBorder(String title)

创建 TitledBorder 实例。

参数：

title - 边框应显示的标题

TitledBorder

public TitledBorder(Border border)

创建具有指定边框和空标题的 TitledBorder 实例。

参数：

border - 边框

TitledBorder

public TitledBorder(Border border,
                    String title)

创建具有指定边框和标题的 TitledBorder 实例。

参数：

border - 边框

title - 边框应显示的标题

TitledBorder

public TitledBorder(Border border,
                    String title,
                    int titleJustification,
                    int titlePosition)

用指定的边框、标题、标题对齐方式和标题位置创建 TitledBorder 实例。

参数：

border - 边框

title - 边框应显示的标题

titleJustification - 标题的对齐方式

titlePosition - 标题的位置

TitledBorder

public TitledBorder(Border border,
                    String title,
                    int titleJustification,
                    int titlePosition,
                    Font titleFont)

用指定的边框、标题、标题对齐方式、标题位置和标题字体创建 TitledBorder 实例。

参数：

border - 边框

title - 边框应显示的标题

titleJustification - 标题的对齐方式

titlePosition - 标题的位置

titleFont - 显示标题的字体

TitledBorder

public TitledBorder(Border border,
                    String title,
                    int titleJustification,
                    int titlePosition,
                    Font titleFont,
                    Color titleColor)

用指定的边框、标题、标题对齐方式、标题位置、标题字体和标题颜色创建 TitledBorder 实例。

参数：

border - 边框

title - 边框应显示的标题

titleJustification - 标题的对齐方式

titlePosition - 标题的位置

titleFont - 标题的字体

titleColor - 标题的颜色

方法详细信息

paintBorder

public void paintBorder(Component c,
                        Graphics g,
                        int x,
                        int y,
                        int width,
                        int height)

按照指定的位置和尺寸为指定的组件绘制边框。

指定者：

接口 Border 中的 paintBorder

覆盖：

类 AbstractBorder 中的 paintBorder

参数：

c - 要为其绘制边框的组件

g - 绘制的图形

x - 所绘制边框的 x 坐标位置

y - 所绘制边框的 y 坐标位置

width - 所绘制边框的宽度

height - 所绘制边框的高度

getBorderInsets

public Insets getBorderInsets(Component c)

返回边框的 insets。

指定者：

接口 Border 中的 getBorderInsets

覆盖：

类 AbstractBorder 中的 getBorderInsets

参数：

c - 要应用此边框 insets 值的组件

返回：

已初始化为 0 的新 Insets 对象

getBorderInsets

public Insets getBorderInsets(Component c,
                              Insets insets)

用此边框的当前 Insets 重新初始化 insets 参数。

覆盖：

类 AbstractBorder 中的 getBorderInsets

参数：

c - 应用此边框 insets 值的组件

insets - 要重新初始化的对象

返回：

insets 对象

isBorderOpaque

public boolean isBorderOpaque()

返回边框是否透明。

指定者：

接口 Border 中的 isBorderOpaque

覆盖：

类 AbstractBorder 中的 isBorderOpaque

返回：

false

getTitle

public String getTitle()

返回带标题边框的标题。

getBorder

public Border getBorder()

返回带标题边框的边框。

getTitlePosition

public int getTitlePosition()

返回带标题边框的标题位置。

getTitleJustification

public int getTitleJustification()

返回带标题边框的标题对齐方式。

getTitleFont

public Font getTitleFont()

返回带标题边框的标题字体。

getTitleColor

public Color getTitleColor()

返回带标题边框的标题颜色。

setTitle

public void setTitle(String title)

设置带标题边框的标题。参数 title 为边框的 title（标题）

setBorder

public void setBorder(Border border)

设置带标题边框的边框。

参数：

border - 边框

setTitlePosition

public void setTitlePosition(int titlePosition)

设置带标题边框的标题位置。

参数：

titlePosition - 边框的位置

setTitleJustification

public void setTitleJustification(int titleJustification)

设置带标题边框的标题对齐方式。

参数：

titleJustification - 边框标题的对齐方式

setTitleFont

public void setTitleFont(Font titleFont)

设置带标题边框的标题字体。

参数：

titleFont - 边框标题的字体

setTitleColor

public void setTitleColor(Color titleColor)

设置带标题边框的标题颜色。

参数：

titleColor - 边框标题的颜色

getMinimumSize

public Dimension getMinimumSize(Component c)

返回此边框完全显示边框和标题所需的最小尺寸。

参数：

c - 将在其上绘制此边框的组件

getFont

protected Font getFont(Component c)