javax.swing.text

Interface Caret

public interface Caret

Defines the method to be implemented by a caret that can be used in Swing text components.
Method Summary
voidaddChangeListener(ChangeListener l)
Registers a {@link ChangeListener} that is notified whenever that state of this Caret changes.
voiddeinstall(JTextComponent c)
Deinstalls this Caret from the specified text component.
intgetBlinkRate()
Returns the blink rate of this Caret in milliseconds.
intgetDot()
Returns the current position of this Caret within the Document.
PointgetMagicCaretPosition()
Returns the current visual position of this Caret.
intgetMark()
Returns the current position of the mark.
voidinstall(JTextComponent c)
Installs this Caret on the specified text component.
booleanisSelectionVisible()
Returns true if the selection is currently visible, false otherwise.
booleanisVisible()
Returns true if this Caret is currently visible, and false if it is not.
voidmoveDot(int dot)
Moves the dot location without touching the mark.
voidpaint(Graphics g)
Paints this Caret to the specified Graphics context.
voidremoveChangeListener(ChangeListener l)
Removes a {@link ChangeListener} from the list of registered listeners.
voidsetBlinkRate(int rate)
Sets the blink rate of this Caret in milliseconds.
voidsetDot(int dot)
Sets the current position of this Caret within the Document.
voidsetMagicCaretPosition(Point p)
Sets the current visual position of this Caret.
voidsetSelectionVisible(boolean v)
Sets the visiblity state of the selection.
voidsetVisible(boolean v)
Sets the visibility state of the caret.

Method Detail

addChangeListener

public void addChangeListener(ChangeListener l)
Registers a {@link ChangeListener} that is notified whenever that state of this Caret changes.

Parameters: l the listener to register to this caret

deinstall

public void deinstall(JTextComponent c)
Deinstalls this Caret from the specified text component. This usually involves removing listeners from the text component. This method is called by {@link JTextComponent#setCaret(Caret)} before this caret is removed from the text component.

Parameters: c the text component to deinstall this caret from

getBlinkRate

public int getBlinkRate()
Returns the blink rate of this Caret in milliseconds. A value of 0 means that the caret does not blink.

Returns: the blink rate of this Caret or 0 if this caret does not blink

getDot

public int getDot()
Returns the current position of this Caret within the Document.

Returns: the current position of this Caret within the Document

getMagicCaretPosition

public Point getMagicCaretPosition()
Returns the current visual position of this Caret.

Returns: the current visual position of this Caret

See Also: Caret

getMark

public int getMark()
Returns the current position of the mark. The mark marks the location in the Document that is the end of a selection. If there is no selection, the mark is the same as the dot.

Returns: the current position of the mark

install

public void install(JTextComponent c)
Installs this Caret on the specified text component. This usually involves setting up listeners. This method is called by {@link JTextComponent#setCaret(Caret)} after this caret has been set on the text component.

Parameters: c the text component to install this caret to

isSelectionVisible

public boolean isSelectionVisible()
Returns true if the selection is currently visible, false otherwise.

Returns: true if the selection is currently visible, false otherwise

isVisible

public boolean isVisible()
Returns true if this Caret is currently visible, and false if it is not.

Returns: true if this Caret is currently visible, and false if it is not

moveDot

public void moveDot(int dot)
Moves the dot location without touching the mark. This is used when making a selection.

Parameters: dot the location where to move the dot

See Also: Caret

paint

public void paint(Graphics g)
Paints this Caret to the specified Graphics context.

Parameters: g the graphics context to render to

removeChangeListener

public void removeChangeListener(ChangeListener l)
Removes a {@link ChangeListener} from the list of registered listeners.

Parameters: l the listener to remove

setBlinkRate

public void setBlinkRate(int rate)
Sets the blink rate of this Caret in milliseconds. A value of 0 means that the caret does not blink.

Parameters: rate the new blink rate to set

setDot

public void setDot(int dot)
Sets the current position of this Caret within the Document. This also sets the mark to the new location.

Parameters: dot the new position to be set

See Also: Caret

setMagicCaretPosition

public void setMagicCaretPosition(Point p)
Sets the current visual position of this Caret.

Parameters: p the Point to use for the saved location. May be null to indicate that there is no visual location

setSelectionVisible

public void setSelectionVisible(boolean v)
Sets the visiblity state of the selection.

Parameters: v true if the selection should be visible, false otherwise

setVisible

public void setVisible(boolean v)
Sets the visibility state of the caret. true shows the Caret, false hides it.

Parameters: v the visibility to set