Класс BorderFactory

java.lang.Object

javax.swing.BorderFactory

public class BorderFactory extends Object

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

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

См. также:

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

См. также:

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)

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

Параметры:: 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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/BorderFactory.html