Module java.desktop

Package javax.swing.text

Class LabelView

java.lang.Object

javax.swing.text.View

javax.swing.text.GlyphView

javax.swing.text.LabelView

All Implemented Interfaces:

Cloneable, SwingConstants, TabableView

Direct Known Subclasses:

InlineView

public class LabelView
extends GlyphView
implements TabableView

A LabelView is a styled chunk of text that represents a view mapped over an element in the text model. It caches the character level attributes used for rendering.

Nested Class Summary

Nested classes/interfaces declared in class javax.swing.text.GlyphView

GlyphView.GlyphPainter

Field Summary

Fields declared in class javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Fields declared in interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Constructor Summary

Constructors

Constructor	Description
LabelView(Element elem)	Constructs a new view wrapped on an element.

Method Summary

Modifier and Type	Method	Description
void	changedUpdate(DocumentEvent e, Shape a, ViewFactory f)	Gives notification from the document that attributes were changed in a location that this view is responsible for.
Color	getBackground()	Fetches the background color to use to render the glyphs.
Font	getFont()	Fetches the font that the glyphs should be based upon.
protected FontMetrics	getFontMetrics()	Deprecated. FontMetrics are not used for glyph rendering when running in the JDK.
Color	getForeground()	Fetches the foreground color to use to render the glyphs.
boolean	isStrikeThrough()	Determines if the glyphs should have a strikethrough line.
boolean	isSubscript()	Determines if the glyphs should be rendered as superscript.
boolean	isSuperscript()	Determines if the glyphs should be rendered as subscript.
boolean	isUnderline()	Determines if the glyphs should be underlined.
protected void	setBackground(Color bg)	Sets the background color for the view.
protected void	setPropertiesFromAttributes()	Sets the cached properties from the attributes.
protected void	setStrikeThrough(boolean s)	Sets whether or not the view has a strike/line through it.
protected void	setSubscript(boolean s)	Sets whether or not the view represents a subscript.
protected void	setSuperscript(boolean s)	Sets whether or not the view represents a superscript.
protected void	setUnderline(boolean u)	Sets whether or not the view is underlined.

Methods declared in class javax.swing.text.GlyphView

breakView, checkPainter, clone, createFragment, getAlignment, getBreakWeight, getEndOffset, getGlyphPainter, getMinimumSpan, getNextVisualPositionFrom, getPartialSpan, getPreferredSpan, getStartOffset, getTabbedSpan, getTabExpander, getText, insertUpdate, modelToView, paint, removeUpdate, setGlyphPainter, viewToModel

Methods declared in class javax.swing.text.View

append, forwardUpdate, forwardUpdateToView, getAttributes, getChildAllocation, getContainer, getDocument, getElement, getGraphics, getMaximumSpan, getParent, getResizeWeight, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, setSize, updateChildren, updateLayout, viewToModel

Methods declared in class java.lang.Object

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

Methods declared in interface javax.swing.text.TabableView

getPartialSpan, getTabbedSpan

Constructor Details

LabelView

public LabelView(Element elem)

Constructs a new view wrapped on an element.

Parameters:

elem - the element

Method Details

setUnderline

protected void setUnderline(boolean u)

Sets whether or not the view is underlined. Note that this setter is protected and is really only meant if you need to update some additional state when set.

Parameters:

u - true if the view is underlined, otherwise false

See Also:

• isUnderline()

setStrikeThrough

protected void setStrikeThrough(boolean s)

Sets whether or not the view has a strike/line through it. Note that this setter is protected and is really only meant if you need to update some additional state when set.

Parameters:

s - true if the view has a strike/line through it, otherwise false

See Also:

• isStrikeThrough()

setSuperscript

protected void setSuperscript(boolean s)

Sets whether or not the view represents a superscript. Note that this setter is protected and is really only meant if you need to update some additional state when set.

Parameters:

s - true if the view represents a superscript, otherwise false

See Also:

• isSuperscript()

setSubscript

protected void setSubscript(boolean s)

Sets whether or not the view represents a subscript. Note that this setter is protected and is really only meant if you need to update some additional state when set.

Parameters:

s - true if the view represents a subscript, otherwise false

See Also:

• isSubscript()

setBackground

protected void setBackground(Color bg)

Sets the background color for the view. This method is typically invoked as part of configuring this View. If you need to customize the background color you should override setPropertiesFromAttributes and invoke this method. A value of null indicates no background should be rendered, so that the background of the parent View will show through.

Parameters:

bg - background color, or null

Since:

1.5

See Also:

• setPropertiesFromAttributes()

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()

Sets the cached properties from the attributes.

getFontMetrics

@Deprecated
protected FontMetrics getFontMetrics()

Deprecated.

FontMetrics are not used for glyph rendering when running in the JDK.

Fetches the FontMetrics used for this view.

Returns:

the FontMetrics used for this view

getBackground

public Color getBackground()

Fetches the background color to use to render the glyphs. This is implemented to return a cached background color, which defaults to null.

Overrides:

getBackground in class GlyphView

Returns:

the cached background color

Since:

1.3

getForeground

public Color getForeground()

Fetches the foreground color to use to render the glyphs. This is implemented to return a cached foreground color, which defaults to null.

Overrides:

getForeground in class GlyphView

Returns:

the cached foreground color

Since:

1.3

getFont

public Font getFont()

Fetches the font that the glyphs should be based upon. This is implemented to return a cached font.

Overrides:

getFont in class GlyphView

Returns:

the cached font

isUnderline

public boolean isUnderline()

Determines if the glyphs should be underlined. If true, an underline should be drawn through the baseline. This is implemented to return the cached underline property.

When you request this property, LabelView re-syncs its state with the properties of the Element's AttributeSet. If Element's AttributeSet does not have this property set, it will revert to false.

Overrides:

isUnderline in class GlyphView

Returns:

the value of the cached underline property

Since:

1.3

isStrikeThrough

public boolean isStrikeThrough()

Determines if the glyphs should have a strikethrough line. If true, a line should be drawn through the center of the glyphs. This is implemented to return the cached strikeThrough property.

When you request this property, LabelView re-syncs its state with the properties of the Element's AttributeSet. If Element's AttributeSet does not have this property set, it will revert to false.

Overrides:

isStrikeThrough in class GlyphView

Returns:

the value of the cached strikeThrough property

Since:

1.3

isSubscript

public boolean isSubscript()

Determines if the glyphs should be rendered as superscript.

When you request this property, LabelView re-syncs its state with the properties of the Element's AttributeSet. If Element's AttributeSet does not have this property set, it will revert to false.

Overrides:

isSubscript in class GlyphView

Returns:

the value of the cached subscript property

Since:

1.3

isSuperscript

public boolean isSuperscript()

Determines if the glyphs should be rendered as subscript.

When you request this property, LabelView re-syncs its state with the properties of the Element's AttributeSet. If Element's AttributeSet does not have this property set, it will revert to false.

Overrides:

isSuperscript in class GlyphView

Returns:

the value of the cached superscript property

Since:

1.3

changedUpdate

public void changedUpdate(DocumentEvent e,
 Shape a,
 ViewFactory f)

Gives notification from the document that attributes were changed in a location that this view is responsible for.

Overrides:

changedUpdate in class GlyphView

Parameters:

e - the change information from the associated document

a - the current allocation of the view

f - the factory to use to rebuild if the view has children

See Also:

• View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)