Класс BorderFactory
java.lang.Object
javax.swing.BorderFactory
public class BorderFactory extends Object
Класс-фабрика для создания стандартных объектов
Border. По возможности эта фабрика возвращает ссылки на общие экземпляры Border. Дополнительные сведения и примеры см. в разделе Использование границ учебника Учебник Java.- Начиная с версии:
- 1.2
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static Border |
createBevelBorder |
Создает рельефную границу указанного типа, используя для подсветки более светлые оттенки текущего цвета фона компонента, а для теней — более темные оттенки. |
static Border |
createBevelBorder |
Создает рельефную границу указанного типа, используя заданные цвета подсветки и тени. |
static Border |
createBevelBorder |
Создает рельефную границу указанного типа, используя заданные цвета для внутренних и внешних областей подсветки и тени. |
static CompoundBorder |
createCompoundBorder() |
Создает составную границу с внутренним краем null и внешним краем null. |
static CompoundBorder |
createCompoundBorder |
Создает составную границу, задавая объекты границ для внешнего и внутреннего краев. |
static Border |
createDashedBorder |
Создает пунктирную границу с указанным paint. |
static Border |
createDashedBorder |
Создает пунктирную границу с указанным paint, относительным length и относительным spacing. |
static Border |
createDashedBorder |
Создает пунктирную границу с указанным paint, thickness, формой линии, относительным length и относительным spacing. |
static Border |
createEmptyBorder() |
Создает пустую границу, не занимающую места. |
static Border |
createEmptyBorder |
Создает пустую границу, которая занимает место, но ничего не рисует; задаются ширина верхней, левой, нижней и правой сторон. |
static Border |
createEtchedBorder() |
Создает границу с эффектом гравировки, используя текущий цвет фона компонента для подсветки и затенения. |
static Border |
createEtchedBorder |
Создает границу с эффектом гравировки, используя текущий цвет фона компонента для подсветки и затенения. |
static Border |
createEtchedBorder |
Создает границу с эффектом гравировки, используя заданные цвета подсветки и затенения. |
static Border |
createEtchedBorder |
Создает границу с эффектом гравировки, используя заданные цвета подсветки и затенения. |
static Border |
createLineBorder |
Создает линейную границу указанного цвета. |
static Border |
createLineBorder |
Создает линейную границу указанного цвета и ширины. |
static Border |
createLineBorder |
Создает линейную границу указанного цвета и толщины, с заданной формой углов. |
static Border |
createLoweredBevelBorder() |
Создает границу с углубленным рельефным краем, используя для подсветки более светлые оттенки текущего цвета фона компонента, а для теней — более темные оттенки. |
static Border |
createLoweredSoftBevelBorder() |
Создает рельефную границу с углубленным краем и сглаженными углами, используя для подсветки более светлые оттенки текущего цвета фона компонента, а для теней — более темные оттенки. |
static MatteBorder |
createMatteBorder |
Создает границу с матовой поверхностью, используя сплошной цвет. |
static MatteBorder |
createMatteBorder |
Создает границу с матовой поверхностью, состоящую из множества плиток заданного значка. |
static Border |
createRaisedBevelBorder() |
Создает границу с выступающим рельефным краем, используя для подсветки более светлые оттенки текущего цвета фона компонента, а для теней — более темные оттенки. |
static Border |
createRaisedSoftBevelBorder() |
Создает рельефную границу с выступающим краем и сглаженными углами, используя для подсветки более светлые оттенки текущего цвета фона компонента, а для теней — более темные оттенки. |
static Border |
createSoftBevelBorder |
Создает рельефную границу указанного типа со сглаженными углами, используя для подсветки более светлые оттенки текущего цвета фона компонента, а для теней — более темные оттенки. |
static Border |
createSoftBevelBorder |
Создает рельефную границу указанного типа со сглаженными углами, используя заданные цвета подсветки и тени. |
static Border |
createSoftBevelBorder |
Создает рельефную границу указанного типа со сглаженными углами, используя заданные цвета для внутренних и внешних краев областей подсветки и тени. |
static Border |
createStrokeBorder |
Создает границу указанного stroke. |
static Border |
createStrokeBorder |
Создает границу указанного stroke и paint. |
static TitledBorder |
createTitledBorder |
Создает новую границу с заголовком, используя указанный текст заголовка, тип границы по умолчанию (определяемый текущим оформлением), позицию текста по умолчанию (определяемую текущим оформлением), выравнивание по умолчанию (начальное), а также шрифт и цвет текста по умолчанию (определяемые текущим оформлением). |
static TitledBorder |
createTitledBorder |
Создает новую границу с заголовком и пустым текстом заголовка, используя указанный объект границы, позицию текста по умолчанию (определяемую текущим оформлением), выравнивание по умолчанию (начальное), а также шрифт и цвет текста по умолчанию (определяемые текущим оформлением). |
static TitledBorder |
createTitledBorder |
Добавляет заголовок к существующей границе, используя позицию по умолчанию (определяемую текущим оформлением), выравнивание по умолчанию (начальное), а также шрифт и цвет текста по умолчанию (определяемые текущим оформлением). |
static TitledBorder |
createTitledBorder |
Добавляет заголовок к существующей границе, используя указанную позицию, а также шрифт и цвет текста по умолчанию (определяемые текущим оформлением). |
static TitledBorder |
createTitledBorder |
Добавляет заголовок к существующей границе, используя указанную позицию и шрифт, а также цвет текста по умолчанию (определяемый текущим оформлением). |
static TitledBorder |
createTitledBorder |
Добавляет заголовок к существующей границе, используя указанную позицию, шрифт и цвет. |
Подробное описание методов
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
- См. также:
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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/BorderFactory.html