JavaTM 2 Platform
Standard Ed. 6

javax.swing.text
类 LabelView

java.lang.Object
  继承者 javax.swing.text.View
      继承者 javax.swing.text.GlyphView
          继承者 javax.swing.text.LabelView
所有已实现的接口:
Cloneable, SwingConstants, TabableView
直接已知子类:
InlineView

public class LabelView
extends GlyphView
implements TabableView

LabelView 是一个样式化文本存储块,它表示映射文本模型中某个元素的视图。它缓存用于呈现的字符级属性。


嵌套类摘要
 
从类 javax.swing.text.GlyphView 继承的嵌套类/接口
GlyphView.GlyphPainter
 
字段摘要
 
从类 javax.swing.text.View 继承的字段
BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
 
从接口 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
 
构造方法摘要
LabelView(Element elem)
          构造在元素上包装的新视图。
 
方法摘要
 void changedUpdate(DocumentEvent e, Shape a, ViewFactory f)
          发出通知,通知文档此视图负责的位置处的属性已更改。
 Color getBackground()
          获取用于呈现字形的背景色。
 Font getFont()
          获取字形应该以其为依据的字体。
protected  FontMetrics getFontMetrics()
          已过时。 FontMetrics 不用于在 JDK 中运行时的字形呈现。
 Color getForeground()
          获取用于呈现字形的前景色。
 boolean isStrikeThrough()
          确定字形是否应该有删除线。
 boolean isSubscript()
          确定字形是否应该呈现为上标。
 boolean isSuperscript()
          确定字形是否应该呈现为下标。
 boolean isUnderline()
          确定字形是否应加下划线。
protected  void setBackground(Color bg)
          设置视图的背景色。
protected  void setPropertiesFromAttributes()
          从属性集设置缓存的属性。
protected  void setStrikeThrough(boolean s)
          设置视图是否具有删除线。
protected  void setSubscript(boolean s)
          设置视图是否有下标。
protected  void setSuperscript(boolean s)
          设置视图是否有上标。
protected  void setUnderline(boolean u)
          设置视图是否加下划线。
 
从类 javax.swing.text.GlyphView 继承的方法
breakView, checkPainter, clone, createFragment, getAlignment, getBreakWeight, getEndOffset, getGlyphPainter, getNextVisualPositionFrom, getPartialSpan, getPreferredSpan, getStartOffset, getTabbedSpan, getTabExpander, getText, insertUpdate, modelToView, paint, removeUpdate, setGlyphPainter, viewToModel
 
从类 javax.swing.text.View 继承的方法
append, forwardUpdate, forwardUpdateToView, getAttributes, getChildAllocation, getContainer, getDocument, getElement, getGraphics, getMaximumSpan, getMinimumSpan, getParent, getResizeWeight, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, setSize, updateChildren, updateLayout, viewToModel
 
从类 java.lang.Object 继承的方法
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
从接口 javax.swing.text.TabableView 继承的方法
getPartialSpan, getTabbedSpan
 

构造方法详细信息

LabelView

public LabelView(Element elem)
构造在元素上包装的新视图。

参数:
elem - 元素
方法详细信息

setUnderline

protected void setUnderline(boolean u)
设置视图是否加下划线。注意,此 setter 受保护,其真正意图仅为确定是否需要在设置时更新某些附加状态。

参数:
u - 如果视图加下划线,则为 true;否则为 false
另请参见:
isUnderline()

setStrikeThrough

protected void setStrikeThrough(boolean s)
设置视图是否具有删除线。注意,此 setter 受保护,其真正意图仅为确定是否需要在设置时更新某些附加状态。

参数:
s - 如果视图有删除线,则为 true;否则为 false
另请参见:
isStrikeThrough()

setSuperscript

protected void setSuperscript(boolean s)
设置视图是否有上标。注意,此 setter 受保护,其真正意图仅为确定是否需要在设置时更新某些附加状态。

参数:
s - 如果视图有上标,则为 true;否则为 false
另请参见:
isSuperscript()

setSubscript

protected void setSubscript(boolean s)
设置视图是否有下标。注意,此 setter 受保护,其真正意图仅为确定是否需要在设置时更新某些附加状态。

参数:
s - 如果视图有下标,则为 true;否则为 false
另请参见:
isSubscript()

setBackground

protected void setBackground(Color bg)
设置视图的背景色。此方法通常作为配置此 View 的一部分调用。如果需要自定义背景色,则应重写 setPropertiesFromAttributes 并调用此方法。null 值指示不应呈现背景,这样将始终显示父级 View 的背景。

参数:
bg - 背景色,或 null
从以下版本开始:
1.5
另请参见:
setPropertiesFromAttributes()

setPropertiesFromAttributes

protected void setPropertiesFromAttributes()
从属性集设置缓存的属性。


getFontMetrics

@Deprecated
protected FontMetrics getFontMetrics()
已过时。 FontMetrics 不用于在 JDK 中运行时的字形呈现。

获取用于此视图的 FontMetrics


getBackground

public Color getBackground()
获取用于呈现字形的背景色。实现此方法以返回缓存的背景色,该颜色默认为 null

覆盖:
GlyphView 中的 getBackground
返回:
缓存的背景色
从以下版本开始:
1.3

getForeground

public Color getForeground()
获取用于呈现字形的前景色。实现此方法以返回缓存的前景色,该颜色默认为 null

覆盖:
GlyphView 中的 getForeground
返回:
缓存的前景色
从以下版本开始:
1.3

getFont

public Font getFont()
获取字形应该以其为依据的字体。实现此方法以返回缓存的字体。

覆盖:
GlyphView 中的 getFont
返回:
缓存的字体

isUnderline

public boolean isUnderline()
确定字形是否应加下划线。如果为 true,则应通过基线绘制下划线。实现此方法以返回缓存的 underline 属性。

当请求此属性时,LabelView 会重新将其状态与 ElementAttributeSet 属性同步。如果 ElementAttributeSet 没有此属性设置,则它将转换为 false。

覆盖:
GlyphView 中的 isUnderline
返回:
缓存的 underline 属性的值
从以下版本开始:
1.3

isStrikeThrough

public boolean isStrikeThrough()
确定字形是否应该有删除线。如果为 true,则会通过字形的中心划线。实现此方法以返回缓存的 strikeThrough 属性。

当请求此属性时,LabelView 会重新将其状态与 ElementAttributeSet 属性同步。如果 ElementAttributeSet 没有此属性设置,则它将转换为 false。

覆盖:
GlyphView 中的 isStrikeThrough
返回:
缓存的 strikeThrough 属性的值
从以下版本开始:
1.3

isSubscript

public boolean isSubscript()
确定字形是否应该呈现为上标。

覆盖:
GlyphView 中的 isSubscript
返回:
缓存的 subscript 属性的值

当请求此属性时,LabelView 会重新将其状态与 ElementAttributeSet 属性同步。如果 ElementAttributeSet 没有此属性设置,则它将转换为 false。

从以下版本开始:
1.3

isSuperscript

public boolean isSuperscript()
确定字形是否应该呈现为下标。

当请求此属性时,LabelView 会重新将其状态与 ElementAttributeSet 属性同步。如果 ElementAttributeSet 没有此属性设置,则它将转换为 false。

覆盖:
GlyphView 中的 isSuperscript
返回:
缓存的 superscript 属性的值
从以下版本开始:
1.3

changedUpdate

public void changedUpdate(DocumentEvent e,
                          Shape a,
                          ViewFactory f)
发出通知,通知文档此视图负责的位置处的属性已更改。

覆盖:
GlyphView 中的 changedUpdate
参数:
e - 来自相关文档的更改信息
a - 视图的当前分配区域
f - 用于重建的工厂(如果该视图有子级)
另请参见:
View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策