当前页面: 在线文档首页 > JDK 5 Documentation v1.5.0, Java 2 SDK 英文文档

TitledBorder (Java 2 Platform SE 5.0) - JDK 5 Documentation v1.5.0, Java 2 SDK 英文文档

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		JavaTM 2 Platform Standard Ed. 5.0
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

javax.swing.border
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 constuctor 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^TM has been added to the java.beans package. Please see XMLEncoder.

---

Field Summary
static int	ABOVE_BOTTOM           Position the title above the border's bottom line.
static int	ABOVE_TOP           Position the title above the border's top line.
static int	BELOW_BOTTOM           Position the title below the border's bottom line.
static int	BELOW_TOP           Position the title below the border's top line.
protected  Border	border
static int	BOTTOM           Position the title in the middle of the border's bottom line.
static int	CENTER           Position title text in the center of the border line.
static int	DEFAULT_JUSTIFICATION           Use the default justification for the title text.
static int	DEFAULT_POSITION           Use the default vertical orientation for the title text.
protected static int	EDGE_SPACING
static 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.
static int	LEFT           Position title text at the left side of the border line.
static int	RIGHT           Position title text at the right side of the border line.
protected static int	TEXT_INSET_H
protected static int	TEXT_SPACING
protected  String	title
protected  Color	titleColor
protected  Font	titleFont
protected  int	titleJustification
protected  int	titlePosition
static int	TOP           Position the title in the middle of the border's top line.
static 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.

 

Constructor Summary
TitledBorder(Border border)           Creates a TitledBorder instance with the specified border and an empty title.
TitledBorder(Border border, String title)           Creates a TitledBorder instance with the specified border and title.
TitledBorder(Border border, String title, int titleJustification, int titlePosition)           Creates a TitledBorder instance with the specified border, title, title-justification, and title-position.
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.
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.
TitledBorder(String title)           Creates a TitledBorder instance.

 

Method Summary
Border	getBorder()           Returns the border of the titled border.
Insets	getBorderInsets(Component c)           Returns the insets of the border.
Insets	getBorderInsets(Component c, Insets insets)           Reinitialize the insets parameter with this Border's current Insets.
protected  Font	getFont(Component c)
Dimension	getMinimumSize(Component c)           Returns the minimum dimensions this border requires in order to fully display the border and title.
String	getTitle()           Returns the title of the titled border.
Color	getTitleColor()           Returns the title-color of the titled border.
Font	getTitleFont()           Returns the title-font of the titled border.
int	getTitleJustification()           Returns the title-justification of the titled border.
int	getTitlePosition()           Returns the title-position of the titled border.
boolean	isBorderOpaque()           Returns whether or not the border is opaque.
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.
void	setBorder(Border border)           Sets the border of the titled border.
void	setTitle(String title)           Sets the title of the titled border.
void	setTitleColor(Color titleColor)           Sets the title-color of the titled border.
void	setTitleFont(Font titleFont)           Sets the title-font of the titled border.
void	setTitleJustification(int titleJustification)           Sets the title-justification of the titled border.
void	setTitlePosition(int titlePosition)           Sets the title-position of the titled border.

 

Methods inherited from class javax.swing.border.AbstractBorder
getInteriorRectangle, getInteriorRectangle

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Field Detail

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.

See Also:

Constant Field Values

---

ABOVE_TOP

public static final int ABOVE_TOP

Position the title above the border's top line.

See Also:

Constant Field Values

---

TOP

public static final int TOP

Position the title in the middle of the border's top line.

See Also:

Constant Field Values

---

BELOW_TOP

public static final int BELOW_TOP

Position the title below the border's top line.

See Also:

Constant Field Values

---

ABOVE_BOTTOM

public static final int ABOVE_BOTTOM

Position the title above the border's bottom line.

See Also:

Constant Field Values

---

BOTTOM

public static final int BOTTOM

Position the title in the middle of the border's bottom line.

See Also:

Constant Field Values

---

BELOW_BOTTOM

public static final int BELOW_BOTTOM

Position the title below the border's bottom line.

See Also:

Constant Field Values

---

DEFAULT_JUSTIFICATION

public static final int DEFAULT_JUSTIFICATION

Use the default justification for the title text.

See Also:

Constant Field Values

---

LEFT

public static final int LEFT

Position title text at the left side of the border line.

See Also:

Constant Field Values

---

CENTER

public static final int CENTER

Position title text in the center of the border line.

See Also:

Constant Field Values

---

RIGHT

public static final int RIGHT

Position title text at the right side of the border line.

See Also:

Constant Field Values

---

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.

See Also:

Constant Field Values

---

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.

See Also:

Constant Field Values

---

EDGE_SPACING

protected static final int EDGE_SPACING

See Also:

Constant Field Values

---

TEXT_SPACING

protected static final int TEXT_SPACING

See Also:

Constant Field Values

---

TEXT_INSET_H

protected static final int TEXT_INSET_H

See Also:

Constant Field Values

Constructor Detail

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

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

Method Detail

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 interface Border

Overrides:

paintBorder in class AbstractBorder

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)

Returns the insets of the border.

Specified by:

getBorderInsets in interface Border

Overrides:

getBorderInsets in class AbstractBorder

Parameters:

c - the component for which this border insets value applies

Returns:

the new Insets object initialized to 0

---

getBorderInsets

public Insets getBorderInsets(Component c,
                              Insets insets)

Reinitialize the insets parameter with this Border's current Insets.

Overrides:

getBorderInsets in class AbstractBorder

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 interface Border

Overrides:

isBorderOpaque in class AbstractBorder

Returns:

false

---

getTitle

public String getTitle()

Returns the title of the titled border.

---

getBorder

public Border getBorder()

Returns the border of the titled border.

---

getTitlePosition

public int getTitlePosition()

Returns the title-position of the titled border.

---

getTitleJustification

public int getTitleJustification()

Returns the title-justification of the titled border.

---

getTitleFont

public Font getTitleFont()

Returns the title-font of the titled border.

---

getTitleColor

public Color getTitleColor()

Returns the title-color of the titled border.

---

setTitle

public void setTitle(String title)

Sets the title of the titled border. param 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

---

getFont

protected Font getFont(Component c)

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		JavaTM 2 Platform Standard Ed. 5.0
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.