Класс TitledBorder

java.lang.Object

javax.swing.border.AbstractBorder

javax.swing.border.TitledBorder

Все реализуемые интерфейсы:: Serializable, Border

Прямые известные подклассы:: BorderUIResource.TitledBorderUIResource

public class TitledBorder extends AbstractBorder

Класс, реализующий произвольную границу с добавлением строкового заголовка в заданном положении и с заданным выравниванием.

Если значения свойств границы, шрифта или цвета не заданы в конструкторе или при вызове соответствующих методов set, текущий стиль оформления определит их значения, используя следующие имена свойств в таблице значений по умолчанию:

"TitledBorder.border"
"TitledBorder.font"
"TitledBorder.titleColor"

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4 в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`ABOVE_BOTTOM`	Располагает заголовок над нижней линией границы.
`static final int`	`ABOVE_TOP`	Располагает заголовок над верхней линией границы.
`static final int`	`BELOW_BOTTOM`	Располагает заголовок под нижней линией границы.
`static final int`	`BELOW_TOP`	Располагает заголовок под верхней линией границы.
`protected Border`	`border`	Граница.
`static final int`	`BOTTOM`	Располагает заголовок посередине нижней линии границы.
`static final int`	`CENTER`	Располагает текст заголовка по центру линии границы.
`static final int`	`DEFAULT_JUSTIFICATION`	Использует выравнивание текста заголовка по умолчанию.
`static final int`	`DEFAULT_POSITION`	Использует вертикальную ориентацию текста заголовка по умолчанию.
`protected static final int`	`EDGE_SPACING`	Расстояние между границей и краем компонента
`static final int`	`LEADING`	Располагает текст заголовка у левого края линии границы при направлении слева направо и у правого края линии границы при направлении справа налево.
`static final int`	`LEFT`	Располагает текст заголовка у левого края линии границы.
`static final int`	`RIGHT`	Располагает текст заголовка у правого края линии границы.
`protected static final int`	`TEXT_INSET_H`	Горизонтальный отступ текста, выровненного по левому или правому краю
`protected static final int`	`TEXT_SPACING`	Расстояние между границей и текстом
`protected String`	`title`	Заголовок, отображаемый границей.
`protected Color`	`titleColor`	Цвет заголовка.
`protected Font`	`titleFont`	Шрифт для отображения заголовка.
`protected int`	`titleJustification`	Выравнивание заголовка.
`protected int`	`titlePosition`	Положение заголовка.
`static final int`	`TOP`	Располагает заголовок посередине верхней линии границы.
`static final int`	`TRAILING`	Располагает текст заголовка у правого края линии границы при направлении слева направо и у левого края линии границы при направлении справа налево.

Краткое описание конструкторов

Конструктор	Описание
`TitledBorder(String title)`	Создает экземпляр TitledBorder.
`TitledBorder(Border border)`	Создает экземпляр TitledBorder с указанной границей и пустым заголовком.
`TitledBorder(Border border, String title)`	Создает экземпляр TitledBorder с указанными границей и заголовком.
`TitledBorder(Border border, String title, int titleJustification, int titlePosition)`	Создает экземпляр TitledBorder с указанными границей, заголовком, выравниванием и положением заголовка.
`TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont)`	Создает экземпляр TitledBorder с указанными границей, заголовком, выравниванием, положением и шрифтом заголовка.
`TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont, Color titleColor)`	Создает экземпляр TitledBorder с указанными границей, заголовком, выравниванием, положением, шрифтом и цветом заголовка.

Краткое описание методов

Модификатор и тип	Метод	Описание
`int`	`getBaseline(Component c, int width, int height)`	Возвращает базовую линию.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior(Component c)`	Возвращает перечисление, указывающее, как изменяется базовая линия границы при изменении размера.
`Border`	`getBorder()`	Возвращает границу рамки с заголовком.
`Insets`	`getBorderInsets(Component c, Insets insets)`	Повторно инициализирует параметр insets текущими значениями Insets этой границы.
`protected Font`	`getFont(Component c)`	Возвращает шрифт рамки с заголовком по умолчанию.
`Dimension`	`getMinimumSize(Component c)`	Возвращает минимальные размеры, необходимые этой границе для полного отображения границы и заголовка.
`String`	`getTitle()`	Возвращает заголовок рамки с заголовком.
`Color`	`getTitleColor()`	Возвращает цвет заголовка рамки с заголовком.
`Font`	`getTitleFont()`	Возвращает шрифт заголовка рамки с заголовком.
`int`	`getTitleJustification()`	Возвращает выравнивание заголовка рамки с заголовком.
`int`	`getTitlePosition()`	Возвращает положение заголовка рамки с заголовком.
`boolean`	`isBorderOpaque()`	Возвращает признак непрозрачности границы.
`void`	`paintBorder(Component c, Graphics g, int x, int y, int width, int height)`	Рисует границу для указанного компонента в заданном положении и с заданным размером.
`void`	`setBorder(Border border)`	Задает границу рамки с заголовком.
`void`	`setTitle(String title)`	Задает заголовок рамки с заголовком.
`void`	`setTitleColor(Color titleColor)`	Задает цвет заголовка рамки с заголовком.
`void`	`setTitleFont(Font titleFont)`	Задает шрифт заголовка рамки с заголовком.
`void`	`setTitleJustification(int titleJustification)`	Задает выравнивание заголовка рамки с заголовком.
`void`	`setTitlePosition(int titlePosition)`	Задает положение заголовка рамки с заголовком.

Методы, объявленные в классе AbstractBorder

getBorderInsets, getInteriorRectangle, getInteriorRectangle

Модификатор и тип	Метод	Описание
`Insets`	`getBorderInsets(Component c)`	Эта реализация по умолчанию возвращает новый объект `Insets`, инициализированный методом `AbstractBorder.getBorderInsets(Component,Insets)`.
`Rectangle`	`getInteriorRectangle(Component c, int x, int y, int width, int height)`	Этот вспомогательный метод вызывает статический метод.
`static Rectangle`	`getInteriorRectangle(Component c, Border b, int x, int y, int width, int height)`	Возвращает прямоугольник, полученный из аргументов за вычетом отступов границы.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и подлежит удалению в будущем выпуске.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.

Подробное описание полей

title

protected String title

Заголовок, который должна отображать рамка.

border

protected Border border

Рамка.

titlePosition

protected int titlePosition

Положение заголовка.

titleJustification

protected int titleJustification

Выравнивание заголовка.

titleFont

protected Font titleFont

Шрифт для отображения заголовка.

titleColor

protected Color titleColor

Цвет заголовка.

DEFAULT_POSITION

public static final int DEFAULT_POSITION

Использовать вертикальное расположение текста заголовка по умолчанию.

См. также:

ABOVE_TOP

public static final int ABOVE_TOP

Расположить заголовок над верхней линией рамки.

См. также:

TOP

public static final int TOP

Расположить заголовок посередине верхней линии рамки.

См. также:

BELOW_TOP

public static final int BELOW_TOP

Расположить заголовок под верхней линией рамки.

См. также:

ABOVE_BOTTOM

public static final int ABOVE_BOTTOM

Расположить заголовок над нижней линией рамки.

См. также:

BOTTOM

public static final int BOTTOM

Расположить заголовок посередине нижней линии рамки.

См. также:

BELOW_BOTTOM

public static final int BELOW_BOTTOM

Расположить заголовок под нижней линией рамки.

См. также:

DEFAULT_JUSTIFICATION

public static final int DEFAULT_JUSTIFICATION

Использовать выравнивание текста заголовка по умолчанию.

См. также:

LEFT

public static final int LEFT

Расположить текст заголовка слева на линии рамки.

См. также:

CENTER

public static final int CENTER

Расположить текст заголовка по центру линии рамки.

См. также:

RIGHT

public static final int RIGHT

Расположить текст заголовка справа на линии рамки.

См. также:

LEADING

public static final int LEADING

Расположить текст заголовка слева на линии рамки при направлении письма слева направо и справа на линии рамки при направлении письма справа налево.

См. также:

TRAILING

public static final int TRAILING

Расположить текст заголовка справа на линии рамки при направлении письма слева направо и слева на линии рамки при направлении письма справа налево.

См. также:

EDGE_SPACING

protected static final int EDGE_SPACING

Расстояние между рамкой и краем компонента

См. также:

TEXT_SPACING

protected static final int TEXT_SPACING

Расстояние между рамкой и текстом

См. также:

TEXT_INSET_H

protected static final int TEXT_INSET_H

Горизонтальный отступ текста, выровненного по левому или правому краю

См. также:

Подробное описание конструкторов

TitledBorder

public TitledBorder(String title)

Создает экземпляр TitledBorder.

Параметры:: title — заголовок, который должна отображать рамка

TitledBorder

public TitledBorder(Border border)

Создает экземпляр TitledBorder с указанной рамкой и пустым заголовком.

Параметры:: border — рамка

TitledBorder

public TitledBorder(Border border, String title)

Создает экземпляр TitledBorder с указанной рамкой и заголовком.

Параметры:: border — рамка; title — заголовок, который должна отображать рамка

TitledBorder

public TitledBorder(Border border, String title, int titleJustification, int titlePosition)

Создает экземпляр TitledBorder с указанными рамкой, заголовком, выравниванием заголовка и положением заголовка.

Параметры:: border — рамка; title — заголовок, который должна отображать рамка; titleJustification — выравнивание заголовка; titlePosition — положение заголовка

TitledBorder

public TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont)

Создает экземпляр TitledBorder с указанными рамкой, заголовком, выравниванием заголовка, положением заголовка и шрифтом заголовка.

Параметры:: border — рамка; title — заголовок, который должна отображать рамка; titleJustification — выравнивание заголовка; titlePosition — положение заголовка; titleFont — шрифт для отображения заголовка

TitledBorder

@ConstructorProperties({"border","title","titleJustification","titlePosition","titleFont","titleColor"}) public TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont, Color titleColor)

Создает экземпляр TitledBorder с указанными рамкой, заголовком, выравниванием заголовка, положением заголовка, шрифтом заголовка и цветом заголовка.

Параметры:: border — рамка; title — заголовок, который должна отображать рамка; titleJustification — выравнивание заголовка; titlePosition — положение заголовка; titleFont — шрифт заголовка; titleColor — цвет заголовка

Подробное описание методов

paintBorder

public void paintBorder(Component c, Graphics g, int x, int y, int width, int height)

Рисует рамку для указанного компонента в указанном положении и размере.

Определен в:: paintBorder в интерфейсе Border
Переопределяет:: paintBorder в классе AbstractBorder
Параметры:: c — компонент, для которого рисуется эта рамка; g — графический контекст для рисования; x — координата x нарисованной рамки; y — координата y нарисованной рамки; width — ширина нарисованной рамки; height — высота нарисованной рамки

getBorderInsets

public Insets getBorderInsets(Component c, Insets insets)

Повторно инициализирует параметр insets текущими значениями Insets этой рамки.

Переопределяет:: getBorderInsets в классе AbstractBorder
Параметры:: c — компонент, для которого применяется значение внутренних отступов этой рамки; insets — объект для повторной инициализации
Возвращает:: объект insets
Вызывает исключение:: NullPointerException — если указанный insets равен null

isBorderOpaque

public boolean isBorderOpaque()

Возвращает значение, указывающее, является ли рамка непрозрачной.

Определен в:: isBorderOpaque в интерфейсе Border
Переопределяет:: isBorderOpaque в классе AbstractBorder
Возвращает:: false

getTitle

public String getTitle()

Возвращает заголовок рамки с заголовком.

Возвращает:: заголовок рамки с заголовком

getBorder

public Border getBorder()

Возвращает рамку рамки с заголовком.

Возвращает:: рамку рамки с заголовком

getTitlePosition

public int getTitlePosition()

Возвращает положение заголовка рамки с заголовком.

Возвращает:: положение заголовка рамки с заголовком

getTitleJustification

public int getTitleJustification()

Возвращает выравнивание заголовка рамки с заголовком.

Возвращает:: выравнивание заголовка рамки с заголовком

getTitleFont

public Font getTitleFont()

Возвращает шрифт заголовка рамки с заголовком.

Возвращает:: шрифт заголовка рамки с заголовком

getTitleColor

public Color getTitleColor()

Возвращает цвет заголовка рамки с заголовком.

Возвращает:: цвет заголовка рамки с заголовком

setTitle

public void setTitle(String title)

Устанавливает заголовок рамки с заголовком.

Параметры:: title — заголовок рамки

setBorder

public void setBorder(Border border)

Устанавливает рамку рамки с заголовком.

Параметры:: border — рамка

setTitlePosition

public void setTitlePosition(int titlePosition)

Устанавливает положение заголовка рамки с заголовком.

Параметры:: titlePosition — положение заголовка рамки

setTitleJustification

public void setTitleJustification(int titleJustification)

Устанавливает выравнивание заголовка рамки с заголовком.

Параметры:: titleJustification — выравнивание заголовка рамки

setTitleFont

public void setTitleFont(Font titleFont)

Устанавливает шрифт заголовка рамки с заголовком.

Параметры:: titleFont — шрифт заголовка рамки

setTitleColor

public void setTitleColor(Color titleColor)

Устанавливает цвет заголовка рамки с заголовком.

Параметры:: titleColor — цвет заголовка рамки

getMinimumSize

public Dimension getMinimumSize(Component c)

Возвращает минимальные размеры, необходимые этой рамке для полного отображения рамки и заголовка.

Параметры:: c — компонент, на котором будет отображаться эта рамка
Возвращает:: объект Dimension

getBaseline

public int getBaseline(Component c, int width, int height)

Возвращает базовую линию.

Переопределяет:

getBaseline в классе AbstractBorder

Параметры:

c — Component, для которого запрашивается базовая линия

width — ширина, для которой нужно получить базовую линию

height — высота, для которой нужно получить базовую линию

Возвращает:

базовую линию или значение < 0, указывающее, что подходящей базовой линии нет

Вызывает:

NullPointerException — если Component имеет значение null

IllegalArgumentException — если ширина или высота меньше < 0

Начиная с:

1.6

См. также:

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(Component c)

Возвращает перечисление, указывающее, как изменяется базовая линия рамки при изменении её размера.

Переопределяет:

getBaselineResizeBehavior в классе AbstractBorder

Параметры:

c — Component, для которого нужно вернуть поведение базовой линии при изменении размера

Возвращает:

перечисление, указывающее, как изменяется базовая линия при изменении размера рамки

Вызывает:

NullPointerException — если Component имеет значение null

Начиная с:

1.6

См. также:

getFont

protected Font getFont(Component c)

Возвращает шрифт по умолчанию для рамки с заголовком.

Параметры:: c — компонент
Возвращает:: шрифт по умолчанию для рамки с заголовком

© 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.