Module java.desktop

软件包 javax.swing.text

Class FieldView

java.lang.Object

javax.swing.text.View

javax.swing.text.PlainView

javax.swing.text.FieldView

All Implemented Interfaces:

SwingConstants ， TabExpander

已知直接子类：

PasswordView

public class FieldView
extends PlainView

将多行纯文本视图扩展为适合单行编辑器视图。 如果视图被分配了额外的空间，则该字段必须进行调整。 如果托管组件是JTextField，则该视图将管理相关联的BoundedRangeModel的范围，并调整水平分配以匹配JTextField的当前可见性设置。

另请参见：

View

Field Summary

Fields inherited from class javax.swing.text.PlainView

metrics

Fields inherited from 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

Fields inherited from class javax.swing.text.View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

构造方法摘要

构造方法

Constructor	描述
FieldView(Element elem)	构造一个包含在元素上的新FieldView。

方法摘要

Modifier and Type	方法	描述
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)	提供从视图坐标空间到模型的逻辑坐标空间的映射。

Methods inherited from class java.lang.Object

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

Methods inherited from class javax.swing.text.PlainView

changedUpdate, damageLineRange, drawLine, drawLine, drawSelectedText, drawSelectedText, drawUnselectedText, drawUnselectedText, getLineBuffer, getTabSize, lineToRect, nextTabStop, setSize, updateDamage, updateMetrics

Methods inherited from class 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

构造方法详细信息

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)

渲染使用给定的渲染表面和该表面上的区域。 该视图可能需要进行布局并创建子视图，以使其自身能够呈现给定的分配。

重写：

paint在 PlainView

参数

g - 要使用的渲染表面

a - 要分配的区域

另请参见：

View.paint(java.awt.Graphics, java.awt.Shape)

getPreferredSpan

public float getPreferredSpan(int axis)

确定沿着轴的此视图的首选跨度。

重写：

getPreferredSpan在 PlainView

参数

axis - 可以是View.X_AXIS或View.Y_AXIS

结果

视图想要呈现为> = 0的跨度。通常，视图被呈现到返回的跨度，尽管不能保证。 父母可以选择调整大小或打破视图。

另请参见：

View.getPreferredSpan(int)

getResizeWeight

public int getResizeWeight(int axis)

确定沿着给定轴的视图的可复位性。 0或更小的值不能调整大小。

重写：

getResizeWeight View

参数

axis - View.X_AXIS或View.Y_AXIS

结果

权重 - > 1为View.X_AXIS，否则为0

modelToView

public Shape modelToView(int pos,
                         Shape a,
                         Position.Bias b)
                  throws BadLocationException

提供从文档模型坐标空间映射到映射到它的视图的坐标空间的映射。

重写：

modelToView在 PlainView

参数

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)

提供从视图坐标空间到模型的逻辑坐标空间的映射。

重写：

viewToModel在 PlainView

参数

fx - X坐标> = 0.0f

fy - Y坐标> = 0.0f

a - 要分配的区域

bias - 返回的偏差

结果

模型中最能代表视图中给定点的位置

另请参见：

View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

insertUpdate

public void insertUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)

在该视图负责的位置发出通知。

重写：

insertUpdate在 PlainView

参数

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)

在该视图负责的位置发出文档中已删除某些内容的通知。

重写：

removeUpdate在 PlainView

参数

changes - 相关文件的更改信息

a - 视图的当前分配

f - 工厂使用重建如果视图有孩子

另请参见：

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