Module java.desktop
Package javax.swing.text

Interface Caret

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

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

  • Method Details

    • install

      void install(JTextComponent c)
      当UI被安装到JTextComponent的界面中时调用。这可用于访问由此接口的实现导航的模型。
      参数:
      c - JTextComponent

    • deinstall

      void deinstall(JTextComponent c)
      当UI从JTextComponent的界面中移除时调用。用于注销附加的任何监听器。
      参数:
      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()
      获取插入符的当前位置。
      返回:
      位置 >=0

    • getMark

      int getMark()
      获取标记的当前位置。如果存在选择，标记将不同于点。
      返回:
      位置 >=0

    • setDot

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

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

      参数:
      dot - 要将插入符设置为的新位置

    • moveDot

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