Module java.desktop
Package javax.swing

Class BorderFactory

java.lang.Object
javax.swing.BorderFactory
public class BorderFactory extends Object
用于提供标准边框对象的工厂类。在可能的情况下，此工厂将提供对共享边框实例的引用。有关更多信息和示例，请参阅如何使用边框，这是Java教程中的一个部分。
自：
1.2

  • Method Summary

    Modifier and Type
    Method
    Description
    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、相对长度和相对间距的虚线边框。
    static Border
    createDashedBorder(Paint paint, float thickness, float length, float spacing, boolean rounded)
    创建指定paint、thickness、线形、相对长度和相对间距的虚线边框。
    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 declared in class java.lang.Object

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

  • Method Details

    • createLineBorder

      public static Border createLineBorder(Color color)
      创建具有指定颜色的线边框。
      参数：
      color - 用于线条的Color
      返回：
      边框对象

    • createLineBorder

      public static Border createLineBorder(Color color, int thickness)
      创建具有指定颜色和宽度的线边框。宽度适用于边框的四个边。要为顶部、底部、左侧和右侧分别指定宽度，请使用createMatteBorder(int,int,int,int,Color)。
      参数：
      color - 用于线条的Color
      thickness - 指定宽度（以像素为单位的整数）
      返回：
      边框对象

    • createLineBorder

      public static Border createLineBorder(Color color, int thickness, boolean rounded)
      创建具有指定颜色、厚度和角形状的线边框。
      参数：
      color - 边框的颜色
      thickness - 边框的厚度
      rounded - 边框角是否应为圆角
      返回：
      边框对象
      自：
      1.7
      参见：

    • createRaisedBevelBorder

      public static Border createRaisedBevelBorder()
      创建具有提升斜角边缘的边框，使用组件当前背景颜色的较亮色进行突出显示，并使用较暗色进行阴影处理。（在提升边框中，突出显示在顶部，阴影在底部。）
      返回：
      边框对象

    • createLoweredBevelBorder

      public static Border createLoweredBevelBorder()
      创建具有降低斜角边缘的边框，使用组件当前背景颜色的较亮色进行突出显示，并使用较暗色进行阴影处理。（在降低边框中，阴影在顶部，突出显示在底部。）
      返回：
      边框对象

    • createBevelBorder

      public static Border createBevelBorder(int type)
      创建指定类型的斜角边框，使用组件当前背景颜色的较亮色进行突出显示，并使用较暗色进行阴影处理。（在降低边框中，阴影在顶部，突出显示在底部。）
      参数：
      type - 指定BevelBorder.LOWERED或BevelBorder.RAISED的整数
      返回：
      边框对象

    • createBevelBorder

      public static Border createBevelBorder(int type, Color highlight, Color shadow)
      创建指定类型的斜角边框，使用指定的突出显示和阴影处理。突出显示区域的外边缘使用较亮的突出显示颜色。阴影区域的内边缘使用较亮的阴影颜色。
      参数：
      type - 指定BevelBorder.LOWERED或BevelBorder.RAISED的整数
      highlight - 用于突出显示的Color对象
      shadow - 用于阴影处理的Color对象
      返回：
      边框对象

    • 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对象
      返回：
      边框对象

    • createRaisedSoftBevelBorder

      public static Border createRaisedSoftBevelBorder()
      创建具有提升边缘和柔化角的斜角边框，使用组件当前背景颜色的较亮色进行突出显示，并使用较暗色进行阴影处理。在提升边框中，突出显示在顶部，阴影在底部。
      返回：
      边框对象
      自：
      1.7

    • createLoweredSoftBevelBorder

      public static Border createLoweredSoftBevelBorder()
      创建具有降低边缘和柔化角的斜角边框，使用组件当前背景颜色的较亮色进行突出显示，并使用较暗色进行阴影处理。在降低边框中，阴影在顶部，突出显示在底部。
      返回：
      边框对象
      自：
      1.7

    • createSoftBevelBorder

      public static Border createSoftBevelBorder(int type)
      创建具有指定类型的斜角边框，使用组件当前背景颜色的较亮色进行突出显示，并使用较暗色进行阴影处理。类型可以是BevelBorder.RAISED或BevelBorder.LOWERED。
      参数：
      type - 斜角的类型
      返回：
      边框对象或null（如果指定的类型无效）
      自：
      1.7
      参见：

    • createSoftBevelBorder

      public static Border createSoftBevelBorder(int type, Color highlight, Color shadow)
      创建指定类型的斜角边框，使用指定的高亮和阴影。类型可以是BevelBorder.RAISED或BevelBorder.LOWERED。高亮区域的外边缘使用更亮的highlight颜色。阴影区域的内边缘使用更亮的shadow颜色。
      参数:
      type - 斜角边框的类型
      highlight - 高亮区域的基本颜色
      shadow - 阴影区域的基本颜色
      返回:
      Border对象
      自版本:
      1.7
      参见:

    • 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
      参见:

    • 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)
      创建一个新的带有指定标题的标题边框，使用默认边框类型（由当前外观决定），默认文本位置（由当前外观决定），默认对齐方式（leading），以及默认字体和文本颜色（由当前外观决定）。
      参数:
      title - 包含标题文本的String
      返回:
      TitledBorder对象

    • createTitledBorder

      public static TitledBorder createTitledBorder(Border border)
      创建一个新的带有空标题的标题边框，使用指定的边框对象，默认文本位置（由当前外观决定），默认对齐方式（leading），以及默认字体和文本颜色（由当前外观决定）。
      参数:
      border - 要添加标题的Border对象；如果为null，则由当前外观决定Border。
      返回:
      TitledBorder对象

    • createTitledBorder

      public static TitledBorder createTitledBorder(Border border, String title)
      向现有边框添加标题，使用默认定位（由当前外观决定），默认对齐方式（leading）和默认字体和文本颜色（由当前外观决定）。
      参数:
      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（leading）
      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（leading）
      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（leading）
      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