JavaTM Platform
Standard Ed. 6

javax.swing.text
类 PasswordView

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

public class PasswordView
     
extends FieldView

实现适用于 JPasswordField UI 实现的视图。这基本上是一个将其内容呈现为在相关组件中指定的回显字符的字段 ui(如果其能将组件收缩为 JPasswordField)。

另请参见:
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
 
构造方法摘要
PasswordView(Element elem)
          构造在元素上包装的新视图。
 
方法摘要
protected  int drawEchoCharacter(Graphics g, int x, int y, char c)
          呈现回显字符,或呈现用来显示密码字符的图形。
protected  int drawSelectedText(Graphics g, int x, int y, int p0, int p1)
          将模型中给定的范围呈现为选定文本。
protected  int drawUnselectedText(Graphics g, int x, int y, int p0, int p1)
          将模型中给定的范围呈现为正常的未选定文本。
 float getPreferredSpan(int axis)
          确定此视图沿某轴的首选区域。
 Shape modelToView(int pos, Shape a, Position.Bias b)
          提供从文档模型坐标空间到所映射的视图坐标空间的映射。
 int viewToModel(float fx, float fy, Shape a, Position.Bias[] bias)
          提供从视图坐标空间到该模型的逻辑坐标空间的映射。
 
从类 javax.swing.text.FieldView 继承的方法
adjustAllocation, getFontMetrics, getResizeWeight, insertUpdate, paint, removeUpdate
 
从类 javax.swing.text.PlainView 继承的方法
changedUpdate, damageLineRange, drawLine, 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
 

构造方法详细信息

PasswordView

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

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

drawUnselectedText

protected int drawUnselectedText(Graphics g,
                                 int x,
                                 int y,
                                 int p0,
                                 int p1)
                          throws BadLocationException
将模型中给定的范围呈现为正常的未选定文本。此方法可设置前景色,并能使用 getEchoChar() 返回的值回显字符。

覆盖:
PlainView 中的 drawUnselectedText
参数:
g - 图形上下文
x - 起始 X 坐标,该值 >= 0
y - 起始 Y 坐标,该值 >= 0
p0 - 模型中的起始偏移量,该值 >= 0
p1 - 模型中的结束偏移量,该值 >= p0
返回:
范围结束处的 X 位置,该值 >= 0
抛出:
BadLocationException - 如果 p0 或 p1 超出范围

drawSelectedText

protected int drawSelectedText(Graphics g,
                               int x,
                               int y,
                               int p0,
                               int p1)
                        throws BadLocationException
将模型中给定的范围呈现为选定文本。实现此方法以使用承载组件中指定的颜色呈现文本。假定 highlighter 将呈现选定的背景。使用 getEchoChar() 的结果显示字符。

覆盖:
PlainView 中的 drawSelectedText
参数:
g - 图形上下文
x - 起始 X 坐标,该值 >= 0
y - 起始 Y 坐标,该值 >= 0
p0 - 模型中的起始偏移量,该值 >= 0
p1 - 模型中的结束偏移量,该值 >= p0
返回:
范围结束处的 X 位置,该值 >= 0
抛出:
BadLocationException - 如果 p0 或 p1 超出范围

drawEchoCharacter

protected int drawEchoCharacter(Graphics g,
                                int x,
                                int y,
                                char c)
呈现回显字符,或呈现用来显示密码字符的图形。将 Graphics 对象中的颜色设置为选定文本或未选定文本的适当前景色。

参数:
g - 图形上下文
x - 起始 X 坐标,该值 >= 0
y - 起始 Y 坐标,该值 >= 0
c - 回显字符
返回:
更新的 X 位置,该值 >= 0

modelToView

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

覆盖:
FieldView 中的 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)
提供从视图坐标空间到该模型的逻辑坐标空间的映射。

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

getPreferredSpan

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

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

JavaTM Platform
Standard Ed. 6

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

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