TitledBorder
Class TitledBorder
- java.lang.Object
-
- javax.swing.border.AbstractBorder
-
- javax.swing.border.TitledBorder
- All Implemented Interfaces:
- Serializable, Border
- Direct Known Subclasses:
- BorderUIResource.TitledBorderUIResource
public class TitledBorder extends AbstractBorder
A class which implements an arbitrary border with the addition of a String title in a specified position and justification.
If the border, font, or color property values are not specified in the constructor or by invoking the appropriate set methods, the property values will be defined by the current look and feel, using the following property names in the Defaults Table:
- "TitledBorder.border"
- "TitledBorder.font"
- "TitledBorder.titleColor"
Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeans™ has been added to the java.beans
package. Please see XMLEncoder
.
Fields
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
Use the default vertical orientation for the title text.
ABOVE_TOP
public static final int ABOVE_TOP
Position the title above the border's top line.
TOP
public static final int TOP
Position the title in the middle of the border's top line.
BELOW_TOP
public static final int BELOW_TOP
Position the title below the border's top line.
ABOVE_BOTTOM
public static final int ABOVE_BOTTOM
Position the title above the border's bottom line.
BOTTOM
public static final int BOTTOM
Position the title in the middle of the border's bottom line.
BELOW_BOTTOM
public static final int BELOW_BOTTOM
Position the title below the border's bottom line.
DEFAULT_JUSTIFICATION
public static final int DEFAULT_JUSTIFICATION
Use the default justification for the title text.
LEFT
public static final int LEFT
Position title text at the left side of the border line.
CENTER
public static final int CENTER
Position title text in the center of the border line.
RIGHT
public static final int RIGHT
Position title text at the right side of the border line.
LEADING
public static final int LEADING
Position title text at the left side of the border line for left to right orientation, at the right side of the border line for right to left orientation.
TRAILING
public static final int TRAILING
Position title text at the right side of the border line for left to right orientation, at the left side of the border line for right to left orientation.
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
Constructors
TitledBorder
public TitledBorder(String title)
Creates a TitledBorder instance.
- Parameters:
-
title
- the title the border should display
TitledBorder
public TitledBorder(Border border)
Creates a TitledBorder instance with the specified border and an empty title.
- Parameters:
-
border
- the border
TitledBorder
public TitledBorder(Border border, String title)
Creates a TitledBorder instance with the specified border and title.
- Parameters:
-
border
- the border -
title
- the title the border should display
TitledBorder
public TitledBorder(Border border, String title, int titleJustification, int titlePosition)
Creates a TitledBorder instance with the specified border, title, title-justification, and title-position.
- Parameters:
-
border
- the border -
title
- the title the border should display -
titleJustification
- the justification for the title -
titlePosition
- the position for the title
TitledBorder
public TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont)
Creates a TitledBorder instance with the specified border, title, title-justification, title-position, and title-font.
- Parameters:
-
border
- the border -
title
- the title the border should display -
titleJustification
- the justification for the title -
titlePosition
- the position for the title -
titleFont
- the font for rendering the title
TitledBorder
@ConstructorProperties(value={"border","title","titleJustification","titlePosition","titleFont","titleColor"}) public TitledBorder(Border border, String title, int titleJustification, int titlePosition, Font titleFont, Color titleColor)
Creates a TitledBorder instance with the specified border, title, title-justification, title-position, title-font, and title-color.
- Parameters:
-
border
- the border -
title
- the title the border should display -
titleJustification
- the justification for the title -
titlePosition
- the position for the title -
titleFont
- the font of the title -
titleColor
- the color of the title
Methods
paintBorder
public void paintBorder(Component c, Graphics g, int x, int y, int width, int height)
Paints the border for the specified component with the specified position and size.
- Specified by:
-
paintBorder
in interfaceBorder
- Overrides:
-
paintBorder
in classAbstractBorder
- Parameters:
-
c
- the component for which this border is being painted -
g
- the paint graphics -
x
- the x position of the painted border -
y
- the y position of the painted border -
width
- the width of the painted border -
height
- the height of the painted border
getBorderInsets
public Insets getBorderInsets(Component c, Insets insets)
Reinitialize the insets parameter with this Border's current Insets.
- Overrides:
-
getBorderInsets
in classAbstractBorder
- Parameters:
-
c
- the component for which this border insets value applies -
insets
- the object to be reinitialized - Returns:
- the
insets
object
isBorderOpaque
public boolean isBorderOpaque()
Returns whether or not the border is opaque.
- Specified by:
-
isBorderOpaque
in interfaceBorder
- Overrides:
-
isBorderOpaque
in classAbstractBorder
- Returns:
- false
getTitle
public String getTitle()
Returns the title of the titled border.
- Returns:
- the title of the titled border
getBorder
public Border getBorder()
Returns the border of the titled border.
- Returns:
- the border of the titled border
getTitlePosition
public int getTitlePosition()
Returns the title-position of the titled border.
- Returns:
- the title-position of the titled border
getTitleJustification
public int getTitleJustification()
Returns the title-justification of the titled border.
- Returns:
- the title-justification of the titled border
getTitleFont
public Font getTitleFont()
Returns the title-font of the titled border.
- Returns:
- the title-font of the titled border
getTitleColor
public Color getTitleColor()
Returns the title-color of the titled border.
- Returns:
- the title-color of the titled border
setTitle
public void setTitle(String title)
Sets the title of the titled border.
- Parameters:
-
title
- the title for the border
setBorder
public void setBorder(Border border)
Sets the border of the titled border.
- Parameters:
-
border
- the border
setTitlePosition
public void setTitlePosition(int titlePosition)
Sets the title-position of the titled border.
- Parameters:
-
titlePosition
- the position for the border
setTitleJustification
public void setTitleJustification(int titleJustification)
Sets the title-justification of the titled border.
- Parameters:
-
titleJustification
- the justification for the border
setTitleFont
public void setTitleFont(Font titleFont)
Sets the title-font of the titled border.
- Parameters:
-
titleFont
- the font for the border title
setTitleColor
public void setTitleColor(Color titleColor)
Sets the title-color of the titled border.
- Parameters:
-
titleColor
- the color for the border title
getMinimumSize
public Dimension getMinimumSize(Component c)
Returns the minimum dimensions this border requires in order to fully display the border and title.
- Parameters:
-
c
- the component where this border will be drawn - Returns:
- the
Dimension
object
getBaseline
public int getBaseline(Component c, int width, int height)
Returns the baseline.
- Overrides:
-
getBaseline
in classAbstractBorder
- Parameters:
-
c
-Component
baseline is being requested for -
width
- the width to get the baseline for -
height
- the height to get the baseline for - Returns:
- the baseline or < 0 indicating there is no reasonable baseline
- Throws:
NullPointerException
-
IllegalArgumentException
- if width or height is < 0 - Since:
- 1.6
- See Also:
JComponent.getBaseline(int, int)
getBaselineResizeBehavior
public Component.BaselineResizeBehavior getBaselineResizeBehavior(Component c)
Returns an enum indicating how the baseline of the border changes as the size changes.
- Overrides:
-
getBaselineResizeBehavior
in classAbstractBorder
- Parameters:
-
c
-Component
to return baseline resize behavior for - Returns:
- an enum indicating how the baseline changes as the border is resized
- Throws:
NullPointerException
- Since:
- 1.6
- See Also:
JComponent.getBaseline(int, int)
getFont
protected Font getFont(Component c)
© 1993–2017, 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.