模块 java.desktop
包 javax.swing.text

类 PlainView

java.lang.Object
javax.swing.text.View
javax.swing.text.PlainView
所有已实现的接口：
SwingConstants , TabExpander
已知子类：
FieldView
public class PlainView extends View implements TabExpander
为具有一种字体和颜色的文本的简单多行文本视图实现 View 接口。该视图将每个子元素表示为一行文本。
参见：

  • 字段详细信息

    • metrics

      protected FontMetrics  metrics
      当前字体的字体规格。

  • 构造方法详细信息

    • PlainView

      public PlainView(Element  elem)
      构造一个包裹在元素上的新 PlainView。
      参数：
      elem - 元素

  • 方法详情

    • getTabSize

      protected int getTabSize()
      返回为文档设置的制表符大小，默认为 8。
      返回：
      选项卡大小

    • drawLine

      @Deprecated (since ="9") protected void drawLine(int lineIndex, Graphics  g, int x, int y)
      已弃用。
      被drawLine(int, Graphics2D, float, float) 取代
      呈现一行文本，抑制末尾的空格并展开所有选项卡。这是为了调用方法 drawUnselectedText 和 drawSelectedText 实现的，以便可以自定义呈现选定和未选定文本的方式。
      参数：
      lineIndex - 要绘制的线 >= 0
      g - Graphics 上下文
      x - 起始 X 位置 >= 0
      y - 起始 Y 位置 >= 0
      参见：

    • drawLine

      protected void drawLine(int lineIndex, Graphics2D  g, float x, float y)
      呈现一行文本，抑制末尾的空格并展开所有选项卡。这是为了调用方法 drawUnselectedText 和 drawSelectedText 实现的，以便可以自定义呈现选定和未选定文本的方式。
      参数：
      lineIndex - 要绘制的线 >= 0
      g - Graphics 上下文
      x - 起始 X 位置 >= 0
      y - 起始 Y 位置 >= 0
      自从：
      9
      参见：

    • drawUnselectedText

      @Deprecated (since ="9") protected int drawUnselectedText(Graphics  g, int x, int y, int p0, int p1) throws BadLocationException
      已弃用。
      被drawUnselectedText(Graphics2D, float, float, int, int) 取代
      将模型中的给定范围呈现为正常的未选择文本。使用前景或禁用颜色呈现文本。
      参数：
      g - 图形上下文
      x - 起始 X 坐标 >= 0
      y - 起始 Y 坐标 >= 0
      p0 - 模型中的起始位置 >= 0
      p1 - 模型中的结束位置 >= 0
      返回：
      范围结束的 X 位置 >= 0
      抛出：
      BadLocationException - 如果范围无效

    • drawUnselectedText

      protected float drawUnselectedText(Graphics2D  g, float x, float y, int p0, int p1) throws BadLocationException
      将模型中的给定范围呈现为正常的未选择文本。使用前景或禁用颜色呈现文本。
      参数：
      g - 图形上下文
      x - 起始 X 坐标 >= 0
      y - 起始 Y 坐标 >= 0
      p0 - 模型中的起始位置 >= 0
      p1 - 模型中的结束位置 >= 0
      返回：
      范围结束的 X 位置 >= 0
      抛出：
      BadLocationException - 如果范围无效
      自从：
      9

    • drawSelectedText

      @Deprecated (since ="9") protected int drawSelectedText(Graphics  g, int x, int y, int p0, int p1) throws BadLocationException
      已弃用。
      被drawSelectedText(Graphics2D, float, float, int, int) 取代
      将模型中的给定范围呈现为选定文本。这是为了以托管组件中指定的颜色呈现文本。它假定荧光笔将呈现选定的背景。
      参数：
      g - 图形上下文
      x - 起始 X 坐标 >= 0
      y - 起始 Y 坐标 >= 0
      p0 - 模型中的起始位置 >= 0
      p1 - 模型中的结束位置 >= 0
      返回：
      范围结束的位置
      抛出：
      BadLocationException - 如果范围无效

    • drawSelectedText

      protected float drawSelectedText(Graphics2D  g, float x, float y, int p0, int p1) throws BadLocationException
      将模型中的给定范围呈现为选定文本。这是为了以托管组件中指定的颜色呈现文本。它假定荧光笔将呈现选定的背景。
      参数：
      g - 图形上下文
      x - 起始 X 坐标 >= 0
      y - 起始 Y 坐标 >= 0
      p0 - 模型中的起始位置 >= 0
      p1 - 模型中的结束位置 >= 0
      返回：
      范围结束的位置
      抛出：
      BadLocationException - 如果范围无效
      自从：
      9

    • getLineBuffer

      protected final Segment  getLineBuffer()
      提供对可用于从关联文档中获取文本的缓冲区的访问权限。
      返回：
      缓冲器

    • updateMetrics

      protected void updateMetrics()
      检查字体规格和最长行是否是最新的。
      自从：
      1.4

    • getPreferredSpan

      public float getPreferredSpan(int axis)
      确定此视图沿轴的首选跨度。
      指定者：
      getPreferredSpan 在类 View 中
      参数：
      axis - 可以是 View.X_AXIS 或 View.Y_AXIS
      返回：
      视图要渲染到 >= 0 的跨度。通常，视图被告知要渲染到返回的跨度中，尽管不能保证。父级可以选择调整大小或打破视图。
      抛出：
      IllegalArgumentException - 对于无效轴

    • paint

      public void paint(Graphics  g, Shape  a)
      使用给定的渲染表面和该表面上的区域进行渲染。视图可能需要进行布局并创建子视图以使其自身能够呈现给定的分配。
      指定者：
      paint 在类 View 中
      参数：
      g - 要使用的渲染表面
      a - 要渲染到的分配区域
      参见：

    • modelToView

      public Shape  modelToView(int pos, Shape  a, Position.Bias  b) throws BadLocationException
      提供从文档模型坐标空间到映射到它的视图的坐标空间的映射。
      指定者：
      modelToView 在类 View 中
      参数：
      pos - 要转换的位置 >= 0
      a - 要渲染到的分配区域
      b - 偏移表示的前一个字符或下一个字符的偏差，以防该位置是两个视图的边界； b 将具有以下值之一：
      • Position.Bias.Forward
      • Position.Bias.Backward
      返回：
      给定位置的边界框
      抛出：
      BadLocationException - 如果给定位置不代表相关文档中的有效位置
      参见：

    • viewToModel

      public int viewToModel(float x, float y, Shape  a, Position.Bias [] bias)
      提供从视图坐标空间到模型的逻辑坐标空间的映射。
      指定者：
      viewToModel 在类 View 中
      参数：
      x - X 坐标 >= 0
      y - Y 坐标 >= 0
      a - 要渲染到的分配区域
      bias - 返回的偏差
      返回：
      模型中最能代表视图中给定点的位置 >= 0
      参见：

    • insertUpdate

      public void insertUpdate(DocumentEvent  changes, Shape  a, ViewFactory  f)
      通知某些内容已插入文档中此视图负责的位置。
      重写：
      insertUpdate 在类 View 中
      参数：
      changes - 来自关联文档的更改信息
      a - 视图的当前分配
      f - 如果视图有子视图，用于重建的工厂
      参见：

    • removeUpdate

      public void removeUpdate(DocumentEvent  changes, Shape  a, ViewFactory  f)
      通知此视图负责的位置从文档中删除了某些内容。
      重写：
      removeUpdate 在类 View 中
      参数：
      changes - 来自关联文档的更改信息
      a - 视图的当前分配
      f - 如果视图有子视图，用于重建的工厂
      参见：

    • changedUpdate

      public void changedUpdate(DocumentEvent  changes, Shape  a, ViewFactory  f)
      从文档发出通知，通知该视图负责的位置的属性已更改。
      重写：
      changedUpdate 在类 View 中
      参数：
      changes - 来自关联文档的更改信息
      a - 视图的当前分配
      f - 如果视图有子视图，用于重建的工厂
      参见：

    • setSize

      public void setSize(float width, float height)
      设置视图的大小。如果它有任何布局职责，这应该会导致视图沿给定轴布局。
      重写：
      setSize 在类 View 中
      参数：
      width - 宽度 >= 0
      height - 高度 >= 0

    • nextTabStop

      public float nextTabStop(float x, int tabOffset)
      返回给定参考位置后的下一个制表位位置。此实现不支持诸如居中之类的功能，因此它会忽略 tabOffset 参数。
      指定者：
      nextTabStop 在接口 TabExpander 中
      参数：
      x - 当前位置 >= 0
      tabOffset - 制表符在 >= 0 处出现的文本流中的位置。
      返回：
      制表位，以点为单位 >= 0

    • updateDamage

      protected void updateDamage(DocumentEvent  changes, Shape  a, ViewFactory  f)
      重新绘制给定文档事件所涵盖的更改区域。当插入/删除仅在一行上时，损坏开始范围以重写大小写的行。如果添加或删除线条，会损坏整个视图。检查最长的行以查看它是否已更改。
      参数：
      changes - 来自关联文档的更改信息
      a - 视图的当前分配
      f - 如果视图有子视图，用于重建的工厂
      自从：
      1.4

    • damageLineRange

      protected void damageLineRange(int line0, int line1, Shape  a, Component  host)
      重新绘制给定的线范围。
      参数：
      line0 - 重绘的起始行号。这必须是模型中的有效行号。
      line1 - 要重绘的结束行号。这必须是模型中的有效行号。
      a - 分配给视图渲染的区域
      host - 托管视图的组件（用于调用重绘）
      自从：
      1.4

    • lineToRect

      protected Rectangle  lineToRect(Shape  a, int line)
      确定代表给定线的矩形。
      参数：
      a - 分配给视图渲染的区域
      line - 查找区域的行号。这必须是模型中的有效行号。
      返回：
      表示给定行的矩形
      自从：
      1.4