模块 java.desktop

软件包 javax.swing

Class BorderFactory

java.lang.Object

javax.swing.BorderFactory

public class BorderFactoryextends Object

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

从以下版本开始：

1.2

方法摘要

变量和类型	方法	描述
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)	使用指定的定位，字体和颜色向现有边框添加标题。

声明方法的类 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 - 行 rounded是否应该是圆的

结果

Border对象

异常

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

从以下版本开始：

1.7