Класс BorderFactory

java.lang.Object

javax.swing.BorderFactory

public class BorderFactory extends Object

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

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

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

public static Border createStrokeBorder(BasicStroke stroke, Paint paint)

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

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

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

public static Border createDashedBorder(Paint paint)

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

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

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

public static Border createDashedBorder(Paint paint, float length, float spacing)

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

Параметры:: paint - объект Paint, используемый для генерации цвета; length - относительная длина штриха; spacing - относительное расстояние между штрихами
Возвращает:: объект Border
Исключения:: IllegalArgumentException - если указанная длина штриха меньше 1, или если указанное расстояние между штрихами меньше 0
С:: 1.7

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

public static Border createDashedBorder(Paint paint, float thickness, float length, float spacing, boolean rounded)

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

Параметры:: paint - объект Paint, используемый для генерации цвета; thickness - ширина штриха; length - относительная длина штриха; spacing - относительное расстояние между штрихами; rounded - указывает, должны ли концы линии быть закруглёнными
Возвращает:: объект Border
Исключения:: IllegalArgumentException - если указанная ширина штриха меньше 1, или если указанная длина штриха меньше 1, или если указанное расстояние между штрихами меньше 0
С:: 1.7

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/BorderFactory.html