javax.swing.text
類別 DefaultCaret

java.lang.Object
  java.awt.geom.RectangularShape
      java.awt.geom.Rectangle2D
          java.awt.Rectangle
              javax.swing.text.DefaultCaret

所有已實作的介面：

FocusListener, MouseListener, MouseMotionListener, Shape, Serializable, Cloneable, EventListener, Caret

直接已知子類別：

BasicTextUI.BasicCaret

public class DefaultCaret
extends Rectangle
implements Caret, FocusListener, MouseListener, MouseMotionListener

插入符的預設實作。插入符以垂直線形式呈現，顏色由相關的 JTextComponent 的 CaretColor 屬性指定。它可以按 BlinkRate 屬性中指定的速率閃爍。

此實作需要兩個非同步通知源。計時器執行緒為非同步觸發，這使得插入符只需重繪最新的邊界框。當修改文檔時，插入符還追蹤更改。通常這發生在某些鼠標或鍵盤事件引起的事件排程執行緒中。同步和非同步文檔更新中的插入符的行為是由 UpdatePolicy 屬性控制的。重繪新插入符位置在任何情況下都發生在事件執行緒上，因為只有在事件執行緒上對 modelToView 的調用才是安全的。

插入符充當它所安裝到的文本元件上的鼠標和焦點偵聽器，並根據這些事件定義插入符的語義。偵聽器方法可重新實作以更改其語義。預設情況下，第一個鼠標按鈕將用於設置焦點和插入符位置。用第一個鼠標按鈕拖動鼠標指針將在模型中劃出一個連續選定。如果關聯的文本元件為可編輯的，此插入符在獲得焦點時將為可見，在失去焦點時為不可見。

關聯的文本元件的 Highlighter 邊界預設用於呈現選定。通過提供高亮顯示所用的 painter，可定制選定的外觀。預設情況下，painter 用於需要用關聯文本元件的 SelectionColor 屬性中指定的純色呈現的情況。通過重新實作 getSelectionHighlighter 方法，可以很容易地更改此方法。

通過重新實作該 paint 方法，可獲得定制的插入符外觀。如果 paint 方法已更改，damage 方法也應重新實作，這樣可重新繪製需要的區域以便呈現插入符。插入符擴展了 Rectangle 類別，它用於保持記錄上次呈現插入符的位置的邊界框。這有助於插入符以執行緒安全的方式重繪，因為在模型更新和視圖修復期間移動插入符而不調用 modelToView 是不穩定的（即無法保證傳遞到 DocumentListeners 的順序）。

當插入符位置改變時，此變幻的插入符位置將設置為 null。使用計時器確定新的位置（在插入符改變後）。計時器觸發後，如果變幻的插入符位置仍為 null，它將重置為當前的插入符位置。任何更改插入符位置和希望變幻的插入符位置保持不變的操作都必須記住變幻的插入符位置和更改鼠標，然後將變幻的插入符位置設置為原始值。這樣做的好處是，只有希望變幻的插入符位置保持不變的操作（例如打開/向下）需要知道它的值。

警告：此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲，或適用於在運行相同 Swing 版本的應用程序之間進行 RMI（Remote Method Invocation，遠端方法調用）。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

另請參見：

Caret

巢狀類別摘要

從類別 java.awt.geom.Rectangle2D 繼承的巢狀類別/介面

Rectangle2D.Double, Rectangle2D.Float

欄位摘要

static int	ALWAYS_UPDATE 指示無論文檔更新是否是在事件排程執行緒中執行，始終根據文檔更改更新插入符位置。
protected ChangeEvent	changeEvent 此模型的更改事件。
protected EventListenerList	listenerList 事件偵聽器列表。
static int	NEVER_UPDATE 指示無論文檔有任何更新，插入符都應在文檔中保持同一絕對位置，由於刪除使文檔長度小於當前插入符位置除外。
static int	UPDATE_WHEN_ON_EDT 指示只有在事件排程執行緒中執行文檔更改時，才更新插入符位置。

從類別 java.awt.Rectangle 繼承的欄位

height, width, x, y

從類別 java.awt.geom.Rectangle2D 繼承的欄位

OUT_BOTTOM, OUT_LEFT, OUT_RIGHT, OUT_TOP

建構子摘要

DefaultCaret()
建構預設的插入符。

方法摘要

void	addChangeListener(ChangeListener l) 添加一個偵聽器，以便對插入符位置改變進行追蹤。
protected void	adjustVisibility(Rectangle nloc) 滾動關聯的視圖（如果有）以使插入符可見。
protected void	damage(Rectangle r) 毀壞圍繞插入符的區域以使該區域在新的位置重繪。
void	deinstall(JTextComponent c) 當 UI 從一個 JTextComponent 的介面移除時調用。
boolean	equals(Object obj) 將此物件與指定的物件進行比較。
protected void	fireStateChanged() 通知所有需要此事件型別的通知的已註冊偵聽器。
void	focusGained(FocusEvent e) 在包含插入符的元件獲得焦點時調用。
void	focusLost(FocusEvent e) 在包含插入符的元件失去焦點時調用。
int	getBlinkRate() 獲取插入符閃爍率。
ChangeListener[]	getChangeListeners() 返回此插入符上所有已註冊的更改偵聽器組成的陣列。
protected JTextComponent	getComponent() 獲取此插入符所綁定的文本編輯器元件。
int	getDot() 獲取插入符的當前位置。
Position.Bias	getDotBias() 返回插入符位置的偏差。
<T extends EventListener> T[]	getListeners(Class<T> listenerType) 返回目前已在此插入符上註冊為 FooListener 的所有物件組成的陣列。
Point	getMagicCaretPosition() 獲取保存的插入符位置。
int	getMark() 獲取標記的當前位置。
Position.Bias	getMarkBias() 返回標記的偏差。
protected Highlighter.HighlightPainter	getSelectionPainter() 獲取此 Highlighter 的 painter。
int	getUpdatePolicy() 獲取文檔更新時的插入符移動策略。
void	install(JTextComponent c) 當 UI 裝入一個 JTextComponent 的介面時調用。
boolean	isActive() 確定插入符當前是否處於啟動狀態。
boolean	isSelectionVisible() 檢查當前選定是否可見。
boolean	isVisible() 指示插入符當前是否可見。
void	mouseClicked(MouseEvent e) 單擊鼠標時調用。
void	mouseDragged(MouseEvent e) 根據鼠標指針當前位置移動插入符位置。
void	mouseEntered(MouseEvent e) 鼠標進入某個區域時調用。
void	mouseExited(MouseEvent e) 鼠標退出某個區域時調用。
void	mouseMoved(MouseEvent e) 移動鼠標時調用。
void	mousePressed(MouseEvent e) 如果按下 button 1，實作它可請求將焦點置於關聯的文本元件上，並設置插入符位置。
void	mouseReleased(MouseEvent e) 釋放鼠標時調用。
protected void	moveCaret(MouseEvent e) 試圖使用 viewToModel() 從鼠標事件的坐標移動插入符的位置。
void	moveDot(int dot) 將插入符位置移動到指定位置，存在向前偏差。
void	moveDot(int dot, Position.Bias dotBias) 將插入符位置移動到指定位置，存在指定偏差。
void	paint(Graphics g) 將插入符作為垂直線呈現。
protected void	positionCaret(MouseEvent e) 試圖使用 viewToModel() 從鼠標事件的坐標設置插入符的位置。
void	removeChangeListener(ChangeListener l) 移除追蹤位置更改的偵聽器。
protected void	repaint() 使得重繪插入符。
void	setBlinkRate(int rate) 設置插入符閃爍率。
void	setDot(int dot) 將插入符位置和標記設置為指定位置，存在向前偏差。
void	setDot(int dot, Position.Bias dotBias) 將插入符位置和標記設置為指定位置，存在指定偏差。
void	setMagicCaretPosition(Point p) 保存當前插入符位置。
void	setSelectionVisible(boolean vis) 更改選定的可見性。
void	setUpdatePolicy(int policy) 設置文檔更新時的插入符移動策略。
void	setVisible(boolean e) 設置插入符可見性，並重繪插入符。
String	toString() 返回表示此 Rectangle 及其值的 String。

從類別 java.awt.Rectangle 繼承的方法

add, add, add, contains, contains, contains, contains, createIntersection, createUnion, getBounds, getBounds2D, getHeight, getLocation, getSize, getWidth, getX, getY, grow, inside, intersection, intersects, isEmpty, move, outcode, reshape, resize, setBounds, setBounds, setLocation, setLocation, setRect, setSize, setSize, translate, union

從類別 java.awt.geom.Rectangle2D 繼承的方法

add, add, add, contains, contains, getPathIterator, getPathIterator, hashCode, intersect, intersects, intersectsLine, intersectsLine, outcode, setFrame, setRect, union

從類別 java.awt.geom.RectangularShape 繼承的方法

clone, contains, contains, getCenterX, getCenterY, getFrame, getMaxX, getMaxY, getMinX, getMinY, intersects, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal

從類別 java.lang.Object 繼承的方法

finalize, getClass, notify, notifyAll, wait, wait, wait

從介面 java.awt.Shape 繼承的方法

contains, contains, contains, contains, getPathIterator, getPathIterator, intersects, intersects

欄位詳細資訊

UPDATE_WHEN_ON_EDT

public static final int UPDATE_WHEN_ON_EDT

指示只有在事件排程執行緒中執行文檔更改時，才更新插入符位置。

從以下版本開始：

1.5

另請參見：

setUpdatePolicy(int), getUpdatePolicy(), 常數欄位值

NEVER_UPDATE

public static final int NEVER_UPDATE

指示無論文檔有任何更新，插入符都應在文檔中保持同一絕對位置，由於刪除使文檔長度小於當前插入符位置除外。這種情況下，插入符位置將調整到文檔的結尾。

從以下版本開始：

1.5

另請參見：

setUpdatePolicy(int), getUpdatePolicy(), 常數欄位值

ALWAYS_UPDATE

public static final int ALWAYS_UPDATE

指示無論文檔更新是否是在事件排程執行緒中執行，始終根據文檔更改更新插入符位置。

從以下版本開始：

1.5

另請參見：

setUpdatePolicy(int), getUpdatePolicy(), 常數欄位值

listenerList

protected EventListenerList listenerList

事件偵聽器列表。

changeEvent

protected transient ChangeEvent changeEvent

此模型的更改事件。由於事件的唯一狀態（只讀）為源屬性，所以每個模型實例只需要一個 ChangeEvent。這裡產生的事件源總是 "this"。

建構子詳細資訊

DefaultCaret

public DefaultCaret()

建構預設的插入符。

方法詳細資訊

setUpdatePolicy

public void setUpdatePolicy(int policy)

設置文檔更新時的插入符移動策略。通常，當在插入符位置之前或當前位置插入時，以及在插入符位置之前刪除時，插入符會更新其在文檔中的絕對位置。這裡的“絕對位置”指的是相對於文檔開頭的位置。例如，在一個可編輯的文本元件中輸入一個字元時，它將插入到插入符位置，而插入符由於此插入將移動到文檔中下一個絕對位置，如果輸入的是 BACKSPACE，插入符的絕對位置將減小，因為在它之前刪除了一個字元。有時候，關閉插入符位置更新很有用，這樣無論文檔怎麼更新，插入符都將保持在文檔中同一絕對位置。

允許以下更新策略：

• NEVER_UPDATE：無論文檔怎樣更新，插入符在文檔中都位於同一絕對位置，除非由於刪除使文檔長度小於當前插入符位置。這種情況下，插入符位置將被調整到文檔的結尾。使用此策略時，插入符不會試圖在滾動關聯的視圖時保持可見。
• ALWAYS_UPDATE：插入符始終追蹤文檔更改。對於一般的更改，如果在插入符位置之前或當前位置插入，則增加它的位置，如果在當前位置之前刪除，則減小它的位置。對於撤消/恢復更新，它總是移動到更新發生的位置。插入符總是試圖通過調用 adjustVisibility 方法保持可見。
• UPDATE_WHEN_ON_EDT：如果文檔更新在事件排程執行緒上執行，則與 ALWAYS_UPDATE 動作類似；如果文檔更新在其它執行緒上執行，則與 NEVER_UPDATE 類似。

預設屬性值為 UPDATE_WHEN_ON_EDT。

參數：

policy - 它是以下值之一：UPDATE_WHEN_ON_EDT、NEVER_UPDATE、ALWAYS_UPDATE

拋出：

IllegalArgumentException - 如果傳入無效的值

從以下版本開始：

1.5

另請參見：

getUpdatePolicy(), adjustVisibility(java.awt.Rectangle), UPDATE_WHEN_ON_EDT, NEVER_UPDATE, ALWAYS_UPDATE

getUpdatePolicy

public int getUpdatePolicy()

獲取文檔更新時的插入符移動策略。

返回：

以下值之一：UPDATE_WHEN_ON_EDT、NEVER_UPDATE、ALWAYS_UPDATE

從以下版本開始：

1.5

另請參見：

setUpdatePolicy(int), UPDATE_WHEN_ON_EDT, NEVER_UPDATE, ALWAYS_UPDATE

getComponent

protected final JTextComponent getComponent()

獲取此插入符所綁定的文本編輯器元件。

返回：

元件

repaint

protected final void repaint()

使得重繪插入符。重繪區域為插入符的邊界框（即插入符矩形或 this）。

雖然大多數 Swing 方法不是執行緒安全的，但此方法是執行緒安全的。有關更多資訊，請參閱 How to Use Threads。

damage

protected void damage(Rectangle r)

毀壞圍繞插入符的區域以使該區域在新的位置重繪。如果重新實作 paint()，此方法也應重新實作。此方法應更新插入符邊界（x、y、width 和 height）。

參數：

r - 插入符的當前位置

另請參見：

paint(java.awt.Graphics)

adjustVisibility

protected void adjustVisibility(Rectangle nloc)

滾動關聯的視圖（如果有）以使插入符可見。究竟應該如何動作在某種程度上是一個策略的問題，此方法可重新實作以更改此行為。預設情況下，scrollRectToVisible 方法在關聯的元件中調用。

參數：

nloc - 要滾動到的新位置

getSelectionPainter

protected Highlighter.HighlightPainter getSelectionPainter()

獲取此 Highlighter 的 painter。

返回：

painter

positionCaret

protected void positionCaret(MouseEvent e)

試圖使用 viewToModel() 從鼠標事件的坐標設置插入符的位置。

參數：

e - 鼠標事件

moveCaret

protected void moveCaret(MouseEvent e)

試圖使用 viewToModel() 從鼠標事件的坐標移動插入符的位置。如果點與標記不同，這將產生一個選定。

參數：

e - 鼠標事件

focusGained

public void focusGained(FocusEvent e)

在包含插入符的元件獲得焦點時調用。如果元件為可編輯，實作此方法可將插入符設置為可見。

指定者：

介面 FocusListener 中的 focusGained

參數：

e - 鼠標事件

另請參見：

FocusListener.focusGained(java.awt.event.FocusEvent)

focusLost

public void focusLost(FocusEvent e)

在包含插入符的元件失去焦點時調用。實作此方法可將插入符的可見性設置為 false。

指定者：

介面 FocusListener 中的 focusLost

參數：

e - 鼠標事件

另請參見：

FocusListener.focusLost(java.awt.event.FocusEvent)

mouseClicked

public void mouseClicked(MouseEvent e)

單擊鼠標時調用。如果單擊是由 button1 產生的，則雙擊選中一個字，三擊選中當前行。

指定者：

介面 MouseListener 中的 mouseClicked

參數：

e - 鼠標事件

另請參見：

MouseListener.mouseClicked(java.awt.event.MouseEvent)

mousePressed

public void mousePressed(MouseEvent e)

如果按下 button 1，實作它可請求將焦點置於關聯的文本元件上，並設置插入符位置。如果按住 shift 鍵，插入符將移動，潛在導致一個選定，否則插入符位置將被設置為新位置。如果該元件未啟用，則不會有任何焦點請求。

指定者：

介面 MouseListener 中的 mousePressed

參數：

e - 鼠標事件

另請參見：

MouseListener.mousePressed(java.awt.event.MouseEvent)

mouseReleased

public void mouseReleased(MouseEvent e)

釋放鼠標時調用。

指定者：

介面 MouseListener 中的 mouseReleased

參數：

e - 鼠標事件

另請參見：

MouseListener.mouseReleased(java.awt.event.MouseEvent)

mouseEntered

public void mouseEntered(MouseEvent e)

鼠標進入某個區域時調用。

指定者：

介面 MouseListener 中的 mouseEntered

參數：

e - 鼠標事件

另請參見：

MouseListener.mouseEntered(java.awt.event.MouseEvent)

mouseExited

public void mouseExited(MouseEvent e)

鼠標退出某個區域時調用。

指定者：

介面 MouseListener 中的 mouseExited

參數：

e - 鼠標事件

另請參見：

MouseListener.mouseExited(java.awt.event.MouseEvent)

mouseDragged

public void mouseDragged(MouseEvent e)

根據鼠標指針當前位置移動插入符位置。這有效地擴展了選定。預設情況下，只有鼠標按鍵 1 才能完成這一操作。

指定者：

介面 MouseMotionListener 中的 mouseDragged

參數：

e - 鼠標事件

另請參見：

MouseMotionListener.mouseDragged(java.awt.event.MouseEvent)

mouseMoved

public void mouseMoved(MouseEvent e)

移動鼠標時調用。

指定者：

介面 MouseMotionListener 中的 mouseMoved

參數：

e - 鼠標事件

另請參見：

MouseMotionListener.mouseMoved(java.awt.event.MouseEvent)

paint

public void paint(Graphics g)

將插入符作為垂直線呈現。如果重新實作此方法，則 damage 方法也應重新實作，因為它假定插入符的形狀為垂直線。將插入符顏色設置為 getCaretColor() 返回的值。

如果關聯文檔中有多個文本方向，將呈現一個指示插入符偏移的標誌。只有當關聯文檔為 AbstractDocument 的子類別並且在雙向元素結構中有多個雙向級別時（即文本關聯了多個方向），才會發生這樣的情況。

指定者：

介面 Caret 中的 paint

參數：

g - 圖形上下文

另請參見：

damage(java.awt.Rectangle)

install

public void install(JTextComponent c)

當 UI 裝入一個 JTextComponent 的介面時調用。使用此方法可獲得對由此介面的實作導航的模型的存取。將點和標記設置為 0，並建立文檔、屬性更改、焦點、鼠標及鼠標動作偵聽器。

指定者：

介面 Caret 中的 install

參數：

c - 元件

另請參見：

Caret.install(javax.swing.text.JTextComponent)

deinstall

public void deinstall(JTextComponent c)

當 UI 從一個 JTextComponent 的介面移除時調用。這可用於取消對任何所關聯偵聽器的註冊。

指定者：

介面 Caret 中的 deinstall

參數：

c - 元件

另請參見：

Caret.deinstall(javax.swing.text.JTextComponent)

addChangeListener

public void addChangeListener(ChangeListener l)

添加一個偵聽器，以便對插入符位置改變進行追蹤。

指定者：

介面 Caret 中的 addChangeListener

參數：

l - 偵聽器

另請參見：

Caret.addChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)

移除追蹤位置更改的偵聽器。

指定者：

介面 Caret 中的 removeChangeListener

參數：

l - 偵聽器

另請參見：

Caret.removeChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()

返回此插入符上所有已註冊的更改偵聽器組成的陣列。

返回：

此插入符的所有 ChangeListener， 如果當前未註冊任何改偵聽器，則返回一個空陣列

從以下版本開始：

1.4

另請參見：

addChangeListener(javax.swing.event.ChangeListener), removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()

通知所有需要此事件型別的通知的已註冊偵聽器。使用傳入此觸發方法的參數延後創建事件實例。從後向前處理偵聽器列表。

另請參見：

EventListenerList

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

返回目前已在此插入符上註冊為 FooListener 的所有物件組成的陣列。FooListener 是用 addFooListener 方法註冊的。

可以使用 class 文字值來指定 listenerType 參數，如 FooListener.class。例如，可以使用以下程式碼查詢 DefaultCaret c 以獲得其更改偵聽器：

ChangeListener[] cls = (ChangeListener[])(c.getListeners(ChangeListener.class));

如果不存在這樣的偵聽器，則此方法將返回一個空陣列。

參數：

listenerType - 所請求的偵聽器型別；此參數應該指定一個從 java.util.EventListener 繼承的介面

返回：

返回一個在此元件上作為 FooListener 註冊的所有物件的陣列，如果尚未添加這樣的偵聽器，則返回一個空陣列

拋出：

ClassCastException - 如果 listenerType 未指定一個實作 java.util.EventListener 的類別或介面

從以下版本開始：

1.3

另請參見：

getChangeListeners()

setSelectionVisible

public void setSelectionVisible(boolean vis)

更改選定的可見性。

指定者：

介面 Caret 中的 setSelectionVisible

參數：

vis - 新可見性

isSelectionVisible

public boolean isSelectionVisible()

檢查當前選定是否可見。

指定者：

介面 Caret 中的 isSelectionVisible

返回：

如果選定為可見，則返回 true

isActive

public boolean isActive()

確定插入符當前是否處於啟動狀態。

此方法返回 Caret 當前是否處於閃爍狀態。它不提供有關當前閃爍為打開或關閉的資訊。要確定插入符當前是否繪製，請使用 isVisible 方法。

返回：

如果處於啟動狀態，則返回 true；否則返回 false

從以下版本開始：

1.5

另請參見：

isVisible()

isVisible

public boolean isVisible()

指示插入符當前是否可見。由於插入符閃爍打開和關閉，它的返回值將在 true 和 false 之間改變。當繪製插入符時，返回 true；當不繪製插入符時，返回 false。isActive 指示插入符是否處於閃爍狀態，它可能為可見，而 isVisible 指示插入符是否確實為可見。

希望呈現不同的閃爍插入符的子類別應覆寫 paint，並只在此方法返回 true 時才繪製插入符。

指定者：

介面 Caret 中的 isVisible

返回：

如果可見，則返回 true；否則返回 false

另請參見：

Caret.isVisible(), isActive()

setVisible

public void setVisible(boolean e)

設置插入符可見性，並重繪插入符。理解此方法、isVisible 以及 isActive 三者之間的關係非常重要。使用 true 值調用此方法可啟動插入符閃爍。將它設置為 false 可徹底關閉閃爍。要確定閃爍是否啟動，應調用 isActive。從實際效果來看，isActive 相當於它的 "getter" 方法，isVisible 可用於獲取插入符的當前可見狀態，即當前是否繪製的狀態。此狀態將隨插入符的閃爍打開和關閉而更改。

下面的列表顯示了調用此方法後 isActive 和 isVisible 可能的返回值：

setVisible(true):

• isActive():true
• isVisible():true 或 false 取決於插入符閃爍為打開還是關閉

setVisible(false):

• isActive():false
• isVisible():false

指定者：

介面 Caret 中的 setVisible

參數：

e - 可見性指示符

另請參見：

isActive(), Caret.setVisible(boolean)

setBlinkRate

public void setBlinkRate(int rate)

設置插入符閃爍率。

指定者：

介面 Caret 中的 setBlinkRate

參數：

rate - 閃爍率，以毫秒為單位，0 為停止閃爍

另請參見：

Caret.setBlinkRate(int)

getBlinkRate

public int getBlinkRate()

獲取插入符閃爍率。

指定者：

介面 Caret 中的 getBlinkRate

返回：

延遲，以毫秒為單位。如果為 0，則插入符不閃爍。

另請參見：

Caret.getBlinkRate()

getDot

public int getDot()

獲取插入符的當前位置。

指定者：

介面 Caret 中的 getDot

返回：

位置，該位置 >= 0

另請參見：

Caret.getDot()

getMark

public int getMark()

獲取標記的當前位置。如果有選定，點和標記將不同。

指定者：

介面 Caret 中的 getMark

返回：

位置，該位置 >= 0

另請參見：

Caret.getMark()

setDot

public void setDot(int dot)

將插入符位置和標記設置為指定位置，存在向前偏差。此方法將選擇範圍隱式地設置為 0。

指定者：

介面 Caret 中的 setDot

參數：

dot - 位置，該位置 >= 0

另請參見：

setDot(int, Position.Bias), Caret.setDot(int)

moveDot

public void moveDot(int dot)

將插入符位置移動到指定位置，存在向前偏差。

指定者：

介面 Caret 中的 moveDot

參數：

dot - 位置，該位置 >= 0

另請參見：

moveDot(int, javax.swing.text.Position.Bias), Caret.moveDot(int)

moveDot

public void moveDot(int dot,
                    Position.Bias dotBias)

將插入符位置移動到指定位置，存在指定偏差。

參數：

dot - >= 0 的位置

dotBias - 此位置的偏差，不為 null

拋出：

IllegalArgumentException - 如果偏差為 null

從以下版本開始：

1.6

另請參見：

Caret.moveDot(int)

setDot

public void setDot(int dot,
                   Position.Bias dotBias)

將插入符位置和標記設置為指定位置，存在指定偏差。此方法將選擇範圍隱式地設置為 0。

參數：

dot - >= 0 的位置

dotBias - 此位置的偏差，不為 null

拋出：

IllegalArgumentException - 如果偏差為 null

從以下版本開始：

1.6

另請參見：

Caret.setDot(int)

getDotBias

public Position.Bias getDotBias()

返回插入符位置的偏差。

返回：

插入符位置的偏差

從以下版本開始：

1.6

getMarkBias

public Position.Bias getMarkBias()

返回標記的偏差。

返回：

標記的偏差

從以下版本開始：

1.6

setMagicCaretPosition

public void setMagicCaretPosition(Point p)

保存當前插入符位置。這在插入符有向上/向下動作時使用，方便在不均勻結束位置的行間移動。

指定者：

介面 Caret 中的 setMagicCaretPosition

參數：

p - 位置

另請參見：

getMagicCaretPosition()

getMagicCaretPosition

public Point getMagicCaretPosition()

獲取保存的插入符位置。

指定者：

介面 Caret 中的 getMagicCaretPosition

返回：

位置 see #setMagicCaretPosition

另請參見：

Caret.setMagicCaretPosition(java.awt.Point)

equals

public boolean equals(Object obj)

將此物件與指定的物件進行比較。比較矩形的父級類別行為是不需要的，所以這將更改為 Object 行為。

覆寫：

類別 Rectangle 中的 equals

參數：

obj - 要與此字體比較的物件

返回：

如果物件相同，則返回 true；否則，返回 false

另請參見：

Object.hashCode(), Hashtable

toString

public String toString()

從類別 Rectangle 複製的描述

返回表示此 Rectangle 及其值的 String。

覆寫：

類別 Rectangle 中的 toString

返回：

表示此 Rectangle 物件的坐標和大小值的 String。