Module java.desktop

软件包 javax.swing

Class BorderFactory

java.lang.Object

javax.swing.BorderFactory

public class BorderFactory
extends Object

出厂标准为Border对象。 只要有可能，本工厂将提供对共享的Border实例的引用。 有关更多信息和示例，请参阅“Java教程”中的“ How to Use Borders ”一节。

从以下版本开始：

1.2

方法摘要

Modifier and Type	方法	描述
static Border	createBevelBorder(int type)	创建指定类型的斜角边框，使用组件的当前背景颜色的较亮的阴影突出显示，阴影的阴影更暗。
static Border	createBevelBorder(int type, Color highlight, Color shadow)	使用指定的高亮和阴影创建指定类型的斜角边框。
static Border	createBevelBorder(int type, Color highlightOuter, Color highlightInner, Color shadowOuter, Color shadowInner)	创建指定类型的斜角边框，使用指定的颜色进行内部和外部高亮和阴影区域。
static CompoundBorder	createCompoundBorder()	创建一个 null内边缘和 null外边缘的复合边框。
static CompoundBorder	createCompoundBorder(Border outsideBorder, Border insideBorder)	创建一个复合边框，指定要用于外边和内边的边框对象。
static Border	createDashedBorder(Paint paint)	创建指定的 paint的虚线边框。
static Border	createDashedBorder(Paint paint, float length, float spacing)	创建指定的 paint ，相对 length和相对 spacing的虚线边框。
static Border	createDashedBorder(Paint paint, float thickness, float length, float spacing, boolean rounded)	创建指定的 paint ， thickness ，相对 length和相对 spacing的虚线边框。
static Border	createEmptyBorder()	创建一个不占用空间的空白边框。
static Border	createEmptyBorder(int top, int left, int bottom, int right)	创建一个占用空间的空白边框，但没有绘制，指定顶部，左侧，底部和右侧的宽度。
static Border	createEtchedBorder()	使用组件的当前背景颜色创建具有“蚀刻”外观的边框，以突出显示和着色。
static Border	createEtchedBorder(int type)	使用组件的当前背景颜色创建具有“蚀刻”外观的边框，以突出显示和着色。
static Border	createEtchedBorder(int type, Color highlight, Color shadow)	使用指定的高亮和阴影颜色创建一个“蚀刻”外观的边框。
static Border	createEtchedBorder(Color highlight, Color shadow)	使用指定的高亮和阴影颜色创建一个“蚀刻”外观的边框。
static Border	createLineBorder(Color color)	创建具有指定颜色的线边框。
static Border	createLineBorder(Color color, int thickness)	创建具有指定颜色和宽度的线边框。
static Border	createLineBorder(Color color, int thickness, boolean rounded)	创建具有指定颜色，粗细和拐角形状的线条边框。
static Border	createLoweredBevelBorder()	使用降低的斜边创建边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。
static Border	createLoweredSoftBevelBorder()	创建一个具有下降边缘和软化角的斜边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。
static MatteBorder	createMatteBorder(int top, int left, int bottom, int right, Color color)	使用纯色创建无光泽的边框。
static MatteBorder	createMatteBorder(int top, int left, int bottom, int right, Icon tileIcon)	创建由指定图标的多个图块组成的无光泽边框。
static Border	createRaisedBevelBorder()	使用凸起的斜边创建边框，使用组件当前背景颜色的较亮的阴影突出显示，阴影阴影更暗。
static Border	createRaisedSoftBevelBorder()	使用凸起的边缘和软化的角落创建斜面边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。
static Border	createSoftBevelBorder(int type)	创建具有软化角的指定类型的斜切边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。
static Border	createSoftBevelBorder(int type, Color highlight, Color shadow)	使用指定的高亮和阴影创建具有软化角的指定类型的斜切边框。
static Border	createSoftBevelBorder(int type, Color highlightOuter, Color highlightInner, Color shadowOuter, Color shadowInner)	创建具有软化角的指定类型的斜切边框，使用指定的颜色用于突出显示的内边缘和外边缘以及阴影区域。
static Border	createStrokeBorder(BasicStroke stroke)	创建指定的边框 stroke 。
static Border	createStrokeBorder(BasicStroke stroke, Paint paint)	创建指定的 stroke和 paint 。
static TitledBorder	createTitledBorder(String title)	创建一个带有指定标题的新标题边框，默认边框类型（由当前外观确定），默认文本位置（由当前外观确定），默认对齐（前导）和默认字体，文字颜色（由目前的外观所决定）。
static TitledBorder	createTitledBorder(Border border)	创建一个新的标题边框，一个空的标题，指定的边框对象，默认的文本位置（由当前的外观和感觉确定），默认对齐（前导）和默认的字体和文本颜色（由当前的外观和感觉）。
static TitledBorder	createTitledBorder(Border border, String title)	将标题添加到现有边框，默认定位（由当前外观确定），默认对齐（前导）和默认字体和文字颜色（由当前外观确定）。
static TitledBorder	createTitledBorder(Border border, String title, int titleJustification, int titlePosition)	将标题添加到现有边框中，并使用指定的定位，并使用默认的字体和文字颜色（由当前外观确定）。
static TitledBorder	createTitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont)	使用指定的定位和字体，使用默认文本颜色（由当前外观确定）将标题添加到现有边框。
static TitledBorder	createTitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont, Color titleColor)	使用指定的定位，字体和颜色将标题添加到现有边框。

Methods inherited from class java.lang.Object

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

方法详细信息

createLineBorder

public static Border createLineBorder(Color color)

创建具有指定颜色的线边框。

参数

color - 一条 Color用于线路

结果

Border对象

createLineBorder

public static Border createLineBorder(Color color,
                                      int thickness)

创建具有指定颜色和宽度的线边框。 宽度适用于边框的所有四边。 要为顶部，底部，左侧和右侧单独指定宽度，请使用createMatteBorder(int,int,int,int,Color) 。

参数

color - 一条 Color用于该行

thickness - 指定宽度（以像素为单位）的整数

结果

Border对象

createLineBorder

public static Border createLineBorder(Color color,
                                      int thickness,
                                      boolean rounded)

创建具有指定颜色，粗细和拐角形状的线条边框。

参数

color - 边框的颜色

thickness - 边框的厚度

rounded - 边角是否圆形

结果

Border对象

从以下版本开始：

1.7

另请参见：

LineBorder(Color, int, boolean)

createRaisedBevelBorder

public static Border createRaisedBevelBorder()

使用凸起的斜边创建边框，使用组件当前背景颜色的较亮的阴影突出显示，阴影阴影更暗。 （在一个凸起的边界，突出显示在顶部，阴影在下面。）

结果

Border对象

createLoweredBevelBorder

public static Border createLoweredBevelBorder()

使用降低的斜边创建边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。 （在下降的边界，阴影在上面，突出显示在下面。）

结果

Border对象

createBevelBorder

public static Border createBevelBorder(int type)

创建指定类型的斜角边框，使用组件的当前背景颜色的较亮的阴影突出显示，阴影的阴影更暗。 （在下降的边界，阴影在上面，突出显示在下面。）

参数

type - 指定 BevelBorder.LOWERED或 BevelBorder.RAISED的整数

结果

Border对象

createBevelBorder

public static Border createBevelBorder(int type,
                                       Color highlight,
                                       Color shadow)

使用指定的高亮和阴影创建指定类型的斜角边框。 突出显示区域的外边缘使用高亮颜色的较亮的阴影。 阴影区域的内边缘使用阴影颜色的较亮的阴影。

参数

type - 指定 BevelBorder.LOWERED或 BevelBorder.RAISED的整数

highlight - 一个 Color对象的亮点

shadow - 一个 Color对象的阴影

结果

Border对象

createBevelBorder

public static Border createBevelBorder(int type,
                                       Color highlightOuter,
                                       Color highlightInner,
                                       Color shadowOuter,
                                       Color shadowInner)

创建指定类型的斜角边框，使用指定的颜色进行内部和外部高亮和阴影区域。

参数

type - 指定 BevelBorder.LOWERED或 BevelBorder.RAISED的整数

highlightOuter - 一个 Color对象，用于突出显示区域的外边缘

highlightInner - 一个 Color对象，用于突出显示区域的内边缘

shadowOuter - 一个 Color对象，用于阴影区域的外边缘

shadowInner - 一个 Color对象，用于阴影区域的内边缘

结果

Border对象

createRaisedSoftBevelBorder

public static Border createRaisedSoftBevelBorder()

使用凸起的边缘和软化的角落创建斜面边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。 在一个凸起的边界，突出显示在顶部，阴影在下面。

结果

Border对象

从以下版本开始：

1.7

createLoweredSoftBevelBorder

public static Border createLoweredSoftBevelBorder()

创建一个具有下降边缘和软化角的斜边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。 在一个下降的边界，阴影在上面，突出显示在下面。

结果

Border对象

从以下版本开始：

1.7

createSoftBevelBorder

public static Border createSoftBevelBorder(int type)

创建具有软化角的指定类型的斜切边框，使用组件当前背景颜色的更亮的阴影突出显示，阴影阴影更暗。 该类型是BevelBorder.RAISED或BevelBorder.LOWERED 。

参数

type - 一种斜面的类型

结果

Border对象或 null如果指定的类型无效

从以下版本开始：

1.7

另请参见：

BevelBorder(int)

createSoftBevelBorder

public static Border createSoftBevelBorder(int type,
                                           Color highlight,
                                           Color shadow)

使用指定的高亮和阴影创建具有软化角的指定类型的斜切边框。 该类型是BevelBorder.RAISED或BevelBorder.LOWERED 。 突出显示区域的外边缘使用更亮的色彩，颜色为highlight 。 阴影区域的内部边缘使用更明亮的阴影，颜色为shadow 。

参数

type - 一种斜面的类型

highlight - 高亮区域的基本颜色

shadow - 阴影区域的基本颜色

结果

Border对象

从以下版本开始：

1.7

另请参见：

BevelBorder(int, Color, Color)

createSoftBevelBorder

public static Border createSoftBevelBorder(int type,
                                           Color highlightOuter,
                                           Color highlightInner,
                                           Color shadowOuter,
                                           Color shadowInner)

创建具有软化角的指定类型的斜切边框，使用指定的颜色用于突出显示的内边缘和外边缘以及阴影区域。 该类型是BevelBorder.RAISED或BevelBorder.LOWERED 。 注意：阴影内外颜色切换为降低的斜边。

参数

type - 一种斜面的类型

highlightOuter - 高亮区域的外边缘的颜色

highlightInner - 高亮区域的内边缘的颜色

shadowOuter - 阴影区域的外边缘的颜色

shadowInner - 阴影区域的内边缘的颜色

结果

Border对象

从以下版本开始：

1.7

另请参见：

BevelBorder(int, Color, Color, Color, Color)

createEtchedBorder

public static Border createEtchedBorder()

使用组件的当前背景颜色创建具有“蚀刻”外观的边框，以突出显示和着色。

结果

Border对象

createEtchedBorder

public static Border createEtchedBorder(Color highlight,
                                        Color shadow)

使用指定的高亮和阴影颜色创建一个“蚀刻”外观的边框。

参数

highlight - 一个 Color对象的边框亮点

shadow - 一个 Color对象的边框阴影

结果

Border对象

createEtchedBorder

public static Border createEtchedBorder(int type)

使用组件的当前背景颜色创建具有“蚀刻”外观的边框，以突出显示和着色。

参数

type -一个 EtchedBorder.RAISED ，或 EtchedBorder.LOWERED

结果

Border对象

异常

IllegalArgumentException - 如果类型不是 EtchedBorder.RAISED或 EtchedBorder.LOWERED

从以下版本开始：

1.3

createEtchedBorder

public static Border createEtchedBorder(int type,
                                        Color highlight,
                                        Color shadow)

使用指定的高亮和阴影颜色创建一个“蚀刻”外观的边框。

参数

type -一个 EtchedBorder.RAISED ，或 EtchedBorder.LOWERED

highlight - 一个 Color对象的边框亮点

shadow - 一个用于边框阴影的 Color对象

结果

Border对象

从以下版本开始：

1.3

createTitledBorder

public static TitledBorder createTitledBorder(String title)

创建一个带有指定标题的新标题边框，默认边框类型（由当前外观确定），默认文本位置（由当前外观确定），默认对齐（前导）和默认字体，文字颜色（由目前的外观所决定）。

参数

title - 一个包含标题文本的 String

结果

TitledBorder对象

createTitledBorder

public static TitledBorder createTitledBorder(Border border)

创建一个新的标题边框，一个空的标题，指定的边框对象，默认的文本位置（由当前的外观和感觉确定），默认对齐（前导）和默认的字体和文本颜色（由当前的外观和感觉）。

参数

border - 要添加标题的Border对象; 如果null是Border是由目前的外观决定的。

结果

TitledBorder对象

createTitledBorder

public static TitledBorder createTitledBorder(Border border,
                                              String title)

将标题添加到现有边框，默认定位（由当前外观确定），默认对齐（前导）和默认字体和文字颜色（由当前外观确定）。

参数

border - 要添加标题的 Border对象

title - 一个包含标题文本的 String

结果

TitledBorder对象

createTitledBorder

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

将标题添加到现有边框中，并使用指定的定位，并使用默认的字体和文字颜色（由当前外观确定）。

参数

border - 要添加标题的 Border对象

title - 一个包含标题文本的 String

titleJustification - 一个指定标题对齐的整数 - 以下之一：

• TitledBorder.LEFT
• TitledBorder.CENTER
• TitledBorder.RIGHT
• TitledBorder.LEADING
• TitledBorder.TRAILING
• TitledBorder.DEFAULT_JUSTIFICATION （领先）

titlePosition - 指定文本相对于边框的垂直位置的整数 - 以下之一：

• TitledBorder.ABOVE_TOP
• TitledBorder.TOP （坐在顶线）
• TitledBorder.BELOW_TOP
• TitledBorder.ABOVE_BOTTOM
• TitledBorder.BOTTOM （坐在底线）
• TitledBorder.BELOW_BOTTOM
• TitledBorder.DEFAULT_POSITION （标题位置由目前的外观所决定）

结果

TitledBorder对象

createTitledBorder

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

使用指定的定位和字体，使用默认文本颜色（由当前外观确定）将标题添加到现有边框。

参数

border - 要添加标题的 Border对象

title - 一个包含标题文本的 String

titleJustification - 一个指定标题对齐的整数 - 以下之一：

• TitledBorder.LEFT
• TitledBorder.CENTER
• TitledBorder.RIGHT
• TitledBorder.LEADING
• TitledBorder.TRAILING
• TitledBorder.DEFAULT_JUSTIFICATION （领先）

titlePosition - 指定文本相对于边框的垂直位置的整数 - 以下之一：

• TitledBorder.ABOVE_TOP
• TitledBorder.TOP （坐在顶线）
• TitledBorder.BELOW_TOP
• TitledBorder.ABOVE_BOTTOM
• TitledBorder.BOTTOM （坐在底线）
• TitledBorder.BELOW_BOTTOM
• TitledBorder.DEFAULT_POSITION （标题位置由目前的外观所决定）

titleFont - 指定标题字体的Font对象

结果

TitledBorder对象

createTitledBorder

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

使用指定的定位，字体和颜色将标题添加到现有边框。

参数

border - 要添加标题的 Border对象

title - 一个包含标题文本的 String

titleJustification - 指定标题对齐的整数 - 以下之一：

• TitledBorder.LEFT
• TitledBorder.CENTER
• TitledBorder.RIGHT
• TitledBorder.LEADING
• TitledBorder.TRAILING
• TitledBorder.DEFAULT_JUSTIFICATION （领先）

titlePosition - 指定文本相对于边框的垂直位置的整数 - 以下之一：

• TitledBorder.ABOVE_TOP
• TitledBorder.TOP （坐在顶线）
• TitledBorder.BELOW_TOP
• TitledBorder.ABOVE_BOTTOM
• TitledBorder.BOTTOM （坐在底线）
• TitledBorder.BELOW_BOTTOM
• TitledBorder.DEFAULT_POSITION （标题位置由目前的外观决定）

titleFont - 一个 Font对象，指定标题字体

titleColor - 指定标题颜色的 Color对象

结果

TitledBorder对象

createEmptyBorder

public static Border createEmptyBorder()

创建一个不占用空间的空白边框。 （顶部，底部，左侧和右侧的宽度全部为零）

结果

Border对象

createEmptyBorder

public static Border createEmptyBorder(int top,
                                       int left,
                                       int bottom,
                                       int right)

创建一个占用空间的空白边框，但没有绘制，指定顶部，左侧，底部和右侧的宽度。

参数

top - 指定顶部宽度的整数，以像素为单位

left - 指定左侧宽度的整数，以像素为单位

bottom - 指定底部宽度的整数（以像素为单位）

right - 指定右侧宽度的整数，以像素为单位

结果

Border对象

createCompoundBorder

public static CompoundBorder createCompoundBorder()

创建具有 null内边缘和 null外边缘的复合边框。

结果

CompoundBorder对象

createCompoundBorder

public static CompoundBorder createCompoundBorder(Border outsideBorder,
                                                  Border insideBorder)

创建一个复合边框，指定要用于外边和内边的边框对象。

参数

outsideBorder - 复合边框外边缘的一个 Border对象

insideBorder - 复合边框内边缘的一个 Border对象

结果

CompoundBorder对象

createMatteBorder

public static MatteBorder createMatteBorder(int top,
                                            int left,
                                            int bottom,
                                            int right,
                                            Color color)

使用纯色创建无光泽的边框。 （此边框与线边框之间的差异在于您可以指定单个边框尺寸。）

参数

top - 指定顶部宽度的整数（以像素为单位）

left - 指定左侧宽度的整数（以像素为单位）

bottom - 指定右侧宽度的整数，以像素为单位

right - 指定底部宽度的整数（以像素为单位）

color - 一个 Color用于边界

结果

MatteBorder对象

createMatteBorder

public static MatteBorder createMatteBorder(int top,
                                            int left,
                                            int bottom,
                                            int right,
                                            Icon tileIcon)

创建由指定图标的多个图块组成的无光泽边框。 图标的多个副本并排放置以填满边框区域。

注意：
如果图标未加载，则边框区域呈灰色。

参数

top - 指定顶部宽度的整数（以像素为单位）

left - 指定左侧宽度的整数，以像素为单位

bottom - 指定右侧宽度的整数，以像素为单位

right - 指定底部宽度的整数（以像素为单位）

tileIcon - 用于边框的 Icon对象

结果

MatteBorder对象

createStrokeBorder

public static Border createStrokeBorder(BasicStroke stroke)

创建指定的边框stroke 。 组件的前景颜色将用于渲染边框。

参数

stroke - 用于描边形状的BasicStroke对象

结果

Border对象

异常

NullPointerException - 如果指定的 stroke是 null

从以下版本开始：

1.7

createStrokeBorder

public static Border createStrokeBorder(BasicStroke stroke,
                                        Paint paint)

创建指定的stroke和paint 。 如果指定的paint是null ，组件的前景颜色将用于渲染边框。

参数

stroke - 用于描边形状的BasicStroke对象

paint - 用于生成颜色的Paint对象

结果

Border对象

异常

NullPointerException - 如果指定的 stroke是 null

从以下版本开始：

1.7

createDashedBorder

public static Border createDashedBorder(Paint paint)

创建指定的paint的虚线边框。 如果指定的paint是null ，组件的前景颜色将用于渲染边框。 虚线的宽度等于1 。 虚线的相对长度和虚线之间的相对间距等于1 。 虚线不圆。

参数

paint - 用于生成颜色的Paint对象

结果

Border对象

从以下版本开始：

1.7

createDashedBorder

public static Border createDashedBorder(Paint paint,
                                        float length,
                                        float spacing)

创建指定的paint ，相对length和相对spacing的虚线边框。 如果指定的paint为null ，组件的前景颜色将用于渲染边框。 虚线的宽度等于1 。 虚线不圆。

参数

paint - 用于生成颜色的Paint对象

length - 虚线的相对长度

spacing - 虚线之间的相对间距

结果

Border对象

异常

IllegalArgumentException - 如果指定的 length小于 1 ，或者指定的 spacing小于 0

从以下版本开始：

1.7

createDashedBorder

public static Border createDashedBorder(Paint paint,
                                        float thickness,
                                        float length,
                                        float spacing,
                                        boolean rounded)

创建指定的paint ， thickness ，相对length和相对spacing的虚线边框。 如果指定的paint是null ，组件的前景颜色将用于渲染边框。

参数

paint - 用于生成颜色的Paint对象

thickness - 虚线的宽度

length - 虚线的相对长度

spacing - 虚线之间的相对间距

rounded - 线端是否应圆

结果

Border对象

异常

IllegalArgumentException - 如果指定的 thickness小于 1 ，或者指定的 length小于 1 ，或者指定的 spacing小于 0

从以下版本开始：

1.7