Класс BorderFactory

public class BorderFactory
extends Object

Класс-фабрика для создания стандартных Border объектов. По возможности, эта фабрика выдаёт ссылки на общие Border экземпляры. Для получения дополнительной информации и примеров см. Как использовать границы — раздел в Руководстве по Java.

Since:
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 - цвет для использования в линии
Возвращает:
объект Border

createLineBorder

public static Border createLineBorder(Color color,
                                      int thickness)

Создаёт линию рамки с указанным цветом и шириной. Ширина применяется ко всем четырём сторонам рамки. Для указания отдельных ширин для верхней, нижней, левой и правой сторон используйте createMatteBorder(int,int,int,int,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 - строка, содержащая текст заголовка
Возвращает:
объект TitledBorder

createTitledBorder

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

Добавляет заголовок к существующей рамке с указанным позиционированием, используя стандартный шрифт и цвет текста (определяется текущим стилем отображения).

Параметры:
border - объект Border, которому нужно добавить заголовок
title - строка, содержащая текст заголовка
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 - строка, содержащая текст заголовка
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 - строка, содержащая текст заголовка
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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/BorderFactory.html

Spec-Zone .ru
спецификации, руководства, описания, API