Spec-Zone.ru › OpenJDK 25

Класс TitledBorder

java.lang.Object
javax.swing.border.AbstractBorder
javax.swing.border.TitledBorder
Все реализуемые интерфейсы:
Serializable, Border
Прямые известные подклассы:
BorderUIResource.TitledBorderUIResource
public class TitledBorder extends AbstractBorder
Класс, реализующий произвольную рамку с текстовым заголовком String, размещённым в заданном месте и выровненным заданным образом.

Если значения свойств рамки, шрифта или цвета не заданы в конструкторе или вызовом соответствующих методов 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

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

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

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

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)
Повторно инициализирует параметр отступов текущими отступами этой рамки.
Переопределяет:
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
См. также:
  • JComponent.getBaseline(int, int)

getBaselineResizeBehavior

public Component.BaselineResizeBehavior getBaselineResizeBehavior(Component c)
Возвращает перечисление, указывающее, как изменяется базовая линия рамки при изменении ее размера.
Переопределяет:
getBaselineResizeBehavior в классе AbstractBorder
Параметры:
c — Component, для которого возвращается поведение базовой линии при изменении размера
Возвращает:
перечисление, указывающее, как изменяется базовая линия при изменении размера рамки
Исключения:
NullPointerException — если Component имеет значение null
С версии:
1.6
См. также:
  • JComponent.getBaseline(int, int)

getFont

protected Font getFont(Component c)
Возвращает шрифт по умолчанию рамки с заголовком.
Параметры:
c — компонент
Возвращает:
шрифт по умолчанию рамки с заголовком

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/border/TitledBorder.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API