模块  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)
        从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 - 如果应显示插入符， 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的新位置