javax.swing.text
介面 Caret

所有已知實作類別：

BasicTextUI.BasicCaret, DefaultCaret

public interface Caret

文檔視圖中的一個位置，它表示文檔模型中能插入其他內容的位置。插入符在文檔中有一個稱作點的位置。點就是插入符當前在模型中的位置。插入符還保留一個位置，它表示選定項的另一端，稱為標記。如果沒有選定項，點和標記將相等。如果存在選定項，這兩個值將不相同。

通過調用 setDot 或 moveDot 可以放置點。設置點能夠移除任何以前存在的選定項。點和標記將相等。移動點將能夠創建選定項，而標記將保留在它以前所在的任何位置。

方法摘要

void	addChangeListener(ChangeListener l) 添加作為追蹤任何插入符位置更改的偵聽器。
void	deinstall(JTextComponent c) 在將 UI 從 JTextComponent 的介面中移除時調用。
int	getBlinkRate() 獲取插入符的閃爍率。
int	getDot() 獲取插入符的當前位置。
Point	getMagicCaretPosition() 獲取當前插入符可見位置。
int	getMark() 獲取標記的當前位置。
void	install(JTextComponent c) 在將 UI 安裝到 JTextComponent 的介面中時調用。
boolean	isSelectionVisible() 確定選定項當前是否可見。
boolean	isVisible() 確定插入符當前是否可見。
void	moveDot(int dot) 將插入符位置（點）移動到其他某個位置，放在標記後面。
void	paint(Graphics g) 呈現插入符。
void	removeChangeListener(ChangeListener l) 移除追蹤插入符位置更改的偵聽器。
void	setBlinkRate(int rate) 設置插入符的閃爍率。
void	setDot(int dot) 將插入符位置設置為其他某個位置。
void	setMagicCaretPosition(Point p) 設置當前插入符的可視位置。
void	setSelectionVisible(boolean v) 設置選定項的可見性
void	setVisible(boolean v) 設置插入符的可見性。

方法詳細資訊

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 - 用於所保存位置的 Point。它可以為 null，表示無可見位置。

getMagicCaretPosition

Point getMagicCaretPosition()

獲取當前插入符可見位置。

返回：

可見位置。

另請參見：

setMagicCaretPosition(java.awt.Point)

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