Класс 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

создатьГраницуШтрихом

public static Border createStrokeBorder(BasicStroke stroke)

Создает границу указанным stroke. Цвет переднего плана компонента будет использован для отрисовки границы.

Параметры:: stroke - объект BasicStroke, используемый для штриховки фигуры
Возвращает:: объект Border
Исключение:: NullPointerException - если указанный stroke является null
С:: 1.7

создатьГраницуШтрихом

public static Border createStrokeBorder(BasicStroke stroke, Paint paint)

Создает границу указанным stroke и paint. Если указанный paint является null, цвет переднего плана компонента будет использован для отрисовки границы.

Параметры:: stroke - объект BasicStroke, используемый для штриховки фигуры; paint - объект Paint, используемый для генерации цвета
Возвращает:: объект Border
Исключение:: NullPointerException - если указанный stroke является null
С:: 1.7

создатьШтриховуюГраницу

public static Border createDashedBorder(Paint paint)

Создает штриховую границу указанным paint. Если указанный paint является null, цвет переднего плана компонента будет использован для отрисовки границы. Ширина штриха равна 1. Относительная длина штриха и относительное расстояние между штрихами равны 1. Штрих не скруглен.

Параметры:: paint - объект Paint, используемый для генерации цвета
Возвращает:: объект Border
С:: 1.7

создатьШтриховуюГраницу

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

создатьШтриховуюГраницу

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, 2023, 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/21/docs/api/java.desktop/javax/swing/BorderFactory.html