模块 java.desktop
包 javax.swing.text

接口 Caret

所有已知的实现类：
BasicTextUI.BasicCaret , DefaultCaret
public interface Caret
文档视图中的一个位置，表示可以将内容插入到文档模型中的位置。插入符号在文档中的位置称为点。点是插入符当前在模型中的位置。插入符号保留了第二个位置，代表所选内容的另一端，称为标记。如果没有选择，点和标记将相等。如果存在选择，则这两个值将不同。

可以通过调用 setDot 或 moveDot 来放置点。设置点具有删除之前可能存在的任何选择的效果。点和标记将相等。移动点具有创建选择的效果，因为标记保留在它之前的任何位置。

  • 方法详情

    • install

      void install(JTextComponent  c)
      在将 UI 安装到 JTextComponent 的界面时调用。这可用于访问通过此接口的实现正在导航的模型。
      参数：
      c - JTextComponent

    • deinstall

      void deinstall(JTextComponent  c)
      从 JTextComponent 的界面中删除 UI 时调用。这用于注销任何附加的监听。
      参数：
      c - JTextComponent

    • paint

      void paint(Graphics  g)
      呈现插入符。此方法由 UI 类调用。
      参数：
      g - 图形上下文

    • addChangeListener

      void addChangeListener(ChangeListener  l)
      添加一个监听以在插入符号位置更改时进行跟踪。
      参数：
      l - 变化监听器

    • removeChangeListener

      void removeChangeListener(ChangeListener  l)
      删除跟踪插入符位置更改的监听。
      参数：
      l - 变化监听器

    • isVisible

      boolean isVisible()
      确定插入符当前是否可见。
      返回：
      如果插入符号可见，则为 true 否则为 false

    • setVisible

      void setVisible(boolean v)
      设置插入符号的可见性。
      参数：
      v - 如果应该显示插入符则为 true，如果应该隐藏插入符则为 false

    • isSelectionVisible

      boolean isSelectionVisible()
      确定选择当前是否可见。
      返回：
      如果插入符号可见，则为 true 否则为 false

    • setSelectionVisible

      void setSelectionVisible(boolean v)
      设置选择的可见性
      参数：
      v - 如果应该显示插入符则为 true，如果应该隐藏插入符则为 false

    • setMagicCaretPosition

      void setMagicCaretPosition(Point  p)
      设置当前插入符号的视觉位置。这可以在具有不均匀结束位置的行之间移动时使用（例如当发生插入符号向上或向下操作时）。如果文本从左到右或从右到左流动，则 x 坐标将指示垂直移动所需的导航位置。如果文本流从上到下，则 y 坐标将指示水平移动所需的导航位置。
      参数：
      p - 用于保存位置的点。这可以为 null 以指示没有可视位置。

    • getMagicCaretPosition

      Point  getMagicCaretPosition()
      获取当前插入符号的可视位置。
      返回：
      视觉位置。
      参见：

    • setBlinkRate

      void setBlinkRate(int rate)
      设置插入符号的闪烁率。这决定了插入符是否闪烁以及闪烁的速度，通常用作吸引对插入符的注意的一种方式。
      参数：
      rate - 以毫秒为单位的延迟 >=0。如果这是零，插入符号将不会闪烁。

    • getBlinkRate

      int getBlinkRate()
      获取插入符的闪烁率。这决定了插入符是否闪烁以及闪烁的速度，通常用作吸引对插入符的注意的一种方式。
      返回：
      以毫秒为单位的延迟 >=0。如果这是零，插入符号将不会闪烁。

    • getDot

      int getDot()
      获取插入符号的当前位置。
      返回：
      position >=0

    • getMark

      int getMark()
      获取标记的当前位置。如果有选择，标记将不会与点相同。
      返回：
      position >=0

    • setDot

      void setDot(int dot)
      将插入符号位置设置为某个位置。这会使标记变得与点相同，有效地将选择范围设置为零。

      如果参数为负或超出文档的长度，则插入符号分别放在开头或结尾。

      参数：
      dot - 将插入符设置到的新位置

    • moveDot

      void moveDot(int dot)
      将插入符号位置（点）移动到其他位置，留下标记。这对于进行选择很有用。
      参数：
      dot - 将插入符号移动到 >=0 的新位置