Caret (Java Platform SE 7)

既知のすべての実装クラス:

BasicTextUI.BasicCaret, DefaultCaret
```
public interface Caret
```
ドキュメントモデル内に内容を挿入できる、ドキュメントビュー内の場所を示します。キャレットの位置は、ドットと言われるドキュメント内にあります。ドットは、キャレットがモデル内に配置されているところです。マークと呼ばれる選択範囲の終点を表すキャレットが維持する 2 番目の位置があります。選択範囲がない場合は、ドットとマークは同じです。選択範囲が存在する場合は、この 2 つは異なります。
ドットは、setDot または moveDot のどちらかを呼び出して配置できます。ドットを設定すると、以前に存在していた可能性のあるすべての選択範囲を削除するという効果があります。ドットとマークは同じになります。ドットを移動すると、以前に存在していたどんな位置であってもマークが残っているので選択範囲を作成するという効果があります。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`void`	`addChangeListener(ChangeListener l)` キャレットの移動を常に追跡するために、リスナーを追加します。
`void`	`deinstall(JTextComponent c)` UI が JTextComponent のインタフェースから削除されたときに呼び出されます。
`int`	`getBlinkRate()` キャレットの点滅間隔を返します。
`int`	`getDot()` キャレットの現在の位置を取り出します。
`Point`	`getMagicCaretPosition()` キャレットの現在の可視位置を取得します。
`int`	`getMark()` マークの現在の位置を取り出します。
`void`	`install(JTextComponent c)` JTextComponent のインタフェースに UI がインストールされるときに呼び出されます。
`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)
```
    JTextComponent のインタフェースに UI がインストールされるときに呼び出されます。このメソッドを使うと、このインタフェースの実装によってナビゲートされているモデルにアクセスできます。
    
    パラメータ:
    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)
```
    キャレットの点滅間隔を設定します。キャレットに注意を向けるための一般的な方法の 1 つである、キャレットの点滅の有無および速度を決定します。
    
    パラメータ:
    rate - ミリ秒単位の遅延。0 以上。キャレットの点滅がない場合は 0。
  - getBlinkRate
```
int getBlinkRate()
```
    キャレットの点滅間隔を返します。キャレットに注意を向けるための一般的な方法の 1 つである、キャレットの点滅の有無および速度を決定します。
    
    戻り値:
    ミリ秒単位の遅延。0 以上。キャレットの点滅がない場合は 0。
  - getDot
```
int getDot()
```
    キャレットの現在の位置を取り出します。
    
    戻り値:
    位置 >= 0
  - getMark
```
int getMark()
```
    マークの現在の位置を取り出します。選択範囲がある場合、マークはドットとは異なります。
    
    戻り値:
    位置 >= 0
  - setDot
```
void setDot(int dot)
```
    キャレットの位置を設定します。マークとドットの位置が同じになり、選択範囲は事実上ゼロに設定されます。
    キャレットは、パラメータが負の値である場合は先頭に、パラメータがドキュメントの長さより長い場合は末尾に配置されます。
    
    パラメータ:
    dot - キャレットの新しい位置
  - moveDot
```
void moveDot(int dot)
```
    キャレットの位置 (ドット) を移動します。マークは元の位置にとどまります。選択範囲のマーキングに便利です。
    
    パラメータ:
    dot - キャレットを移動する位置 >= 0

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース Caret

メソッドのサマリー

メソッドの詳細

install

deinstall

paint

addChangeListener

removeChangeListener

isVisible

setVisible

isSelectionVisible

setSelectionVisible

setMagicCaretPosition

getMagicCaretPosition

setBlinkRate

getBlinkRate

getDot

getMark

setDot

moveDot