JavaTM 2 Platform
Standard Ed. 5.0

javax.swing.text
类 FieldView

java.lang.Object
  继承者 javax.swing.text.View
      继承者 javax.swing.text.PlainView
          继承者 javax.swing.text.FieldView
所有已实现的接口:
SwingConstants, TabExpander
直接已知子类:
PasswordView

public class FieldView
extends PlainView

扩展多行纯文本视图,使其适合单行编辑器视图。如果为视图分配了额外的空间,则该字段必须调整视图,使之适合该空间。如果承载组件是 JTextField,此视图将管理相关 BoundedRangeModel 的范围并调整水平分配区域以便与 JTextField 的当前可见性设置相匹配。

另请参见:
View

字段摘要
 
从类 javax.swing.text.PlainView 继承的字段
metrics
 
从类 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
 
构造方法摘要
FieldView(Element elem)
          构造包装了元素的新 FieldView。
 
方法摘要
protected  Shape adjustAllocation(Shape a)
          调整给定视图的分配区域,使其适合文本字段的分配区域。
protected  FontMetrics getFontMetrics()
          获取与承载此视图组件相关的字体规格。
 float getPreferredSpan(int axis)
          确定此视图沿某轴的首选区域。
 int getResizeWeight(int axis)
          确定视图沿给定轴的大小可调整性。
 void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)
          通知在文档中此视图负责的某个位置已插入内容。
 Shape modelToView(int pos, Shape a, Position.Bias b)
          提供从文档模型坐标空间到所映射的视图坐标空间的映射。
 void paint(Graphics g, Shape a)
          使用给定呈现面和该表面的区域呈现。
 void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)
          通知在文档中此视图负责的某个位置已插入内容。
 int viewToModel(float fx, float fy, Shape a, Position.Bias[] bias)
          提供从视图坐标空间到该模型的逻辑坐标空间的映射。
 
从类 javax.swing.text.PlainView 继承的方法
changedUpdate, damageLineRange, drawLine, drawSelectedText, drawUnselectedText, getLineBuffer, getTabSize, lineToRect, nextTabStop, setSize, updateDamage, updateMetrics
 
从类 javax.swing.text.View 继承的方法
append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getAlignment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, updateChildren, updateLayout, viewToModel
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

FieldView

public FieldView(Element elem)
构造包装了元素的新 FieldView。

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

getFontMetrics

protected FontMetrics getFontMetrics()
获取与承载此视图组件相关的字体规格。

返回:
字体规格

adjustAllocation

protected Shape adjustAllocation(Shape a)
调整给定视图的分配区域,使其适合文本字段的分配区域。如果在垂直方向上分配该视图的区域超过了首选区域,则会更改该分配区域以便垂直居中。根据相关 JTextField 上的水平对齐属性设置,该视图将在水平方向上进行调整(如果其为承载组件的类型)。

参数:
a - 指定给视图的分配区域,该分配区域可能需要调整大小。
返回:
超类应该使用的分配区域。

paint

public void paint(Graphics g,
                  Shape a)
使用给定呈现面和该表面的区域呈现。该视图可能需要进行布置和创建子视图,以使它本身能够在给定的分配区域呈现。

覆盖:
PlainView 中的 paint
参数:
g - 要使用的呈现表面
a - 要在其中呈现的分配区域
另请参见:
View.paint(java.awt.Graphics, java.awt.Shape)

getPreferredSpan

public float getPreferredSpan(int axis)
确定此视图沿某轴的首选区域。

覆盖:
PlainView 中的 getPreferredSpan
参数:
axis - 可以是 View.X_AXIS 或 View.Y_AXIS
返回:
视图可能要在其中呈现的区域,该值 >= 0。通常会告知该视图在返回的区域中呈现,但不保证一定如此。父级可选择重新调整视图大小或拆分视图。
另请参见:
View.getPreferredSpan(int)

getResizeWeight

public int getResizeWeight(int axis)
确定视图沿给定轴的大小可调整性。0 或更小的值表示大小不可调整。

覆盖:
View 中的 getResizeWeight
参数:
axis - View.X_AXIS 或 View.Y_AXIS
返回:
权重,如果 > 1,表示为 View.X_AXIS,如果为 0,表示 View.Y_AXIS

modelToView

public Shape modelToView(int pos,
                         Shape a,
                         Position.Bias b)
                  throws BadLocationException
提供从文档模型坐标空间到所映射的视图坐标空间的映射。

覆盖:
PlainView 中的 modelToView
参数:
pos - 要转换的位置,其值 >= 0
a - 分配的要在其中呈现的区域
b - 当位置是两个视图的边界时,该参数是离由偏移量表示的前一个字符或者下一个字符的偏差;b 将是这些值之一:
  • Position.Bias.Forward
  • Position.Bias.Backward
返回:
给定位置的边界框
抛出:
BadLocationException - 如果给定位置在所关联的文档中不是一个有效位置
另请参见:
View.modelToView(int, java.awt.Shape, javax.swing.text.Position.Bias)

viewToModel

public int viewToModel(float fx,
                       float fy,
                       Shape a,
                       Position.Bias[] bias)
提供从视图坐标空间到该模型的逻辑坐标空间的映射。

覆盖:
PlainView 中的 viewToModel
参数:
fx - X 坐标,该值 >= 0.0f
fy - Y 坐标,该值 >= 0.0f
a - 要在其中呈现的分配区域
返回:
模型中最能代表视图中给定点的位置
另请参见:
View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

insertUpdate

public void insertUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)
通知在文档中此视图负责的某个位置已插入内容。

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

removeUpdate

public void removeUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)
通知在文档中此视图负责的某个位置已插入内容。

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

JavaTM 2 Platform
Standard Ed. 5.0

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

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