Класс BorderFactory

java.lang.Object
- javax.swing.BorderFactory

public class BorderFactory
extends Object

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

Методы

Модификатор и тип	Метод и описание
`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(Color highlight, Color shadow)` Создаёт границу с «выгравированным» видом, используя заданные цвета для выделения и затемнения.
`static Border`	`createEtchedBorder(int type)` Создаёт границу с «выгравированным» видом, используя текущий цвет фона компонента для выделения и затемнения.
`static Border`	`createEtchedBorder(int type, 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(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)` Добавляет заголовок к существующей границе, с заданным позиционированием, шрифтом и цветом.
`static TitledBorder`	`createTitledBorder(String title)` Создаёт новую границу с заголовком с указанным заголовком, типом границы по умолчанию (определяется текущей внешностью), позицией текста по умолчанию (определяется текущей внешностью), выравниванием по умолчанию (слева) и шрифтом и цветом текста по умолчанию (определяется текущей внешностью).

Методы, унаследованные от класса 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

createStrokeBorder

public static Border createStrokeBorder(BasicStroke stroke)

Создаёт рамку заданной stroke. Цвет компонента по умолчанию будет использован для отрисовки рамки.

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

createStrokeBorder

public static Border createStrokeBorder(BasicStroke stroke,
                                        Paint paint)

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

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

createDashedBorder

public static Border createDashedBorder(Paint paint)

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

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

createDashedBorder

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

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

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

createDashedBorder

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

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

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.