Module  java.desktop
软件包  javax.swing.text

Interface Caret

  • 所有已知实现类：
    BasicTextUI.BasicCaret ， DefaultCaret 

    public interface Caret
    文档视图中的一个位置，表示可以将东西插入到文档模型中。 插入符号在文档中被称为点。 该点是模型中当前位于插座的位置。 有一个第二个位置，由插入符号代表所选标记的选择的另一端。 如果没有选择，点和标记将相等。 如果选择存在，这两个值将不同。

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

    • 方法详细信息

      • 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 - 如果插入符号应该显示， v true，如果插入符应隐藏，则为false

      • isSelectionVisible

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

      • setSelectionVisible

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

      • setMagicCaretPosition

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

      • 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的新位置