JavaTM Platform
Standard Ed. 6

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

Caret 의 디폴트의 구현입니다. caret는, 관련하는 JTextComponent 의 CaretColor 프로퍼티으로 지정된 색의 수직선으로서 draw 됩니다. 또, BlinkRate 프로퍼티으로 지정한 속도로 점멸시킬 수가 있습니다.

이 구현은, 비동기 통지의 소스가 2 개 있는 것을 전제로 합니다. 타이머 thread는 비동기에게 트리거되어 이것에 의해, caret는 최신의 바운딩 박스에 페인트 다시 합니다. 또, caret는 문서가 갱신될 때마다 변경을 추적합니다. 일반적으로, 문서의 갱신은, 마우스 이벤트 또는 키보드 이벤트에 의한 이벤트발송쓰레드에 대해 발생합니다. caret의 동작은, 문서의 동기적인 갱신에서도 비동기적인 갱신에서도,UpdatePolicy 프로퍼티에 의해 제어됩니다. 새로운 caret 위치의 재페인트는, 반드시 이벤트 thread에 위에서 발생합니다. 이것은,modelToView 의 호출이 이벤트 thread상에서만 안전하기 때문에입니다.

caret는, 인스톨처의 텍스트 컴퍼넌트로 마우스 및 포커스 청취자로서 행동해, caret의 시멘틱스를 그러한 이벤트에 근거해 정의합니다. 시멘틱스를 변경하려면 , 청취자의 메소드를 다시 구현합니다. 디폴트에서는, 마우스의 제 1 버튼을 사용해 포커스와 caret 위치를 설정합니다. 제 1 버튼을 사용해 마우스 포인터를 드래그 하면(자), 모델내의 인접하는 선택 부분을 넓힐 수가 있습니다. 관련하는 텍스트 컴퍼넌트가 편집 가능한 경우는, caret는 포커스를 얻었을 때에 가시가 되어, 포커스를 잃었을 때에 불가시가 됩니다.

관련하는 텍스트에의 Highlighter 경계는, 디폴트에서는 선택 부분을 draw 하기 위해서 사용됩니다. 선택 부분의 표시는, 하이라이트에 사용하는 페인타를 제공하는 것으로 커스터마이즈 할 수 있습니다. 디폴트에서는, 관련하는 텍스트 컴퍼넌트의 SelectionColor 프로퍼티으로 지정된 솔리드색으로 draw 됩니다. 이것은,getSelectionHighlighter 메소드를 다시 구현하는 것으로 간단하게 변경할 수 있습니다.

caret의 외관은, paint 메소드를 다시 구현하는 것으로 커스터마이즈 할 수 있습니다. paint 메소드를 변경하는 경우에는, damage 메소드도 다시 구현해 , caret의 draw에 사용되는 영역을 draw 다시 해 주세요. caret는, Rectangle 클래스를 확장하고 있기 (위해)때문에, caret가 마지막에 draw 된 바운딩 박스를 보관 유지하고 있습니다. 이것에 의해, caret가 이동했을 때에, 모델의 갱신과 뷰의 수복동안에서 동작이 불안정한 modelToView 메소드를 호출하는 일 없이, thread에 대해서 안전한 방법으로 draw 다시 할 수가 있습니다 (modelToView 메소드에서는, DocumentListener 에의 전달의 순서가 보증되지 않는다).

caret 위치가 변경될 때, 매직 caret의 위치는 null 로 설정되어 있습니다. 타이머를 사용해, caret 변경 후의 새로운 위치를 지정합니다. 타이머가 트리거하면(자), 매직 caret의 위치가 아직 null 의 경우, 현재의 caret 위치에 리셋 됩니다. caret 위치를 변경해, 매직 caret의 위치를 그대로 해 두는 액션의 경우는 모두, 매직 caret의 위치를 기억해 커서를 변경하고 나서, 매직 caret의 위치를 그 원래의 위치로 설정합니다. 이 메소드에는, 매직 caret의 위치를 지속시키는 (오픈 또는 다운시키는 등) 액션만이 그것을 알고 있으면 좋다고 하는 이점이 있습니다.

경고: 이 클래스의 직렬화 된 객체는, 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 지원는, 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK Version 1.4 이후, 모든 JavaBeans 의 장기간의 운용 지원는,java.beans 패키지에 추가되고 있습니다. 자세한 것은,XMLEncoder 를 참조해 주세요.

관련 항목:
Caret

상자의 클래스의 개요
 
클래스 java.awt.geom. Rectangle2D 로부터 상속된 상자의 클래스/인터페이스
Rectangle2D.Double , Rectangle2D.Float
 
필드의 개요
static int ALWAYS_UPDATE
          문서의 갱신이 이벤트발송쓰레드로 행해질지 어떨지에 관계없이, 문서의 변경에 따라 caret 위치가 반드시 갱신되는 것을 나타냅니다.
protected  ChangeEvent changeEvent
          모델의 변경을 나타내는 이벤트입니다.
protected  EventListenerList listenerList
          이벤트 청취자의 리스트입니다.
static int NEVER_UPDATE
          삭제의 탓으로 문서의 길이가 현재의 caret 위치보다 짧아지는 경우를 제외해, 문서의 갱신에 관계없이, 문서내의 caret의 절대 위치가 변함없는 것을 나타냅니다.
static int UPDATE_WHEN_ON_EDT
          이벤트발송쓰레드로 문서의 변경을 하는 경우에게만 caret 위치가 갱신되는 것을 나타냅니다.
 
클래스 java.awt. Rectangle 로부터 상속된 필드
height , width , x , y
 
클래스 java.awt.geom. Rectangle2D 로부터 상속된 필드
OUT_BOTTOM , OUT_LEFT , OUT_RIGHT , OUT_TOP
 
생성자 의 개요
DefaultCaret ()
          디폴트의 caret를 구축합니다.
 
메소드의 개요
 void addChangeListener (ChangeListener  l)
          caret의 이동을 항상 추적하기 위해서, 청취자를 추가합니다.
protected  void adjustVisibility (Rectangle  nloc)
          필요에 따라서, 관련하는 뷰를 스크롤 해, caret를 표시합니다.
protected  void damage (Rectangle  r)
          caret를 둘러싸는 영역을 부수어, 새로운 위치에 재페인트 되도록(듯이) 합니다.
 void deinstall (JTextComponent  c)
          UI 가 JTextComponent 의 인터페이스로부터 삭제되었을 때에 불려 갑니다.
 boolean equals (Object  obj)
          이 객체가 지정된 객체와 비교합니다.
protected  void fireStateChanged ()
          통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다.
 void focusGained (FocusEvent  e)
          caret를 포함한 컴퍼넌트가 포커스를 얻었을 때에 불려 갑니다.
 void focusLost (FocusEvent  e)
          caret를 포함한 컴퍼넌트가 포커스를 잃었을 때에 불려 갑니다.
 int getBlinkRate ()
          caret의 점멸 간격을 가져옵니다.
 ChangeListener [] getChangeListeners ()
          이 caret에 등록된, 모든 변경 청취자로부터 되는 배열을 돌려줍니다.
protected  JTextComponent getComponent ()
          이 caret를 사용하는 텍스트 문자 편집기 컴퍼넌트를 돌려줍니다.
 int getDot ()
          caret의 현재의 위치를 가져옵니다.
 Position.Bias getDotBias ()
          caret의 위치의 바이어스를 돌려줍니다.
<T extends EventListener >
T[]
getListeners (Class <T> listenerType)
          이 caret에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다.
 Point getMagicCaretPosition ()
          보존되고 있는 caret의 위치를 돌려줍니다.
 int getMark ()
          마크의 현재의 위치를 가져옵니다.
 Position.Bias getMarkBias ()
          마크의 바이어스를 돌려줍니다.
protected  Highlighter.HighlightPainter getSelectionPainter ()
          하이 라이터에 사용하는 페인타를 가져옵니다.
 int getUpdatePolicy ()
          문서의 갱신에 대한 caret 이동 정책를 가져옵니다.
 void install (JTextComponent  c)
          JTextComponent 의 인터페이스에 UI 를 인스톨 하고 있을 때 불려 갑니다.
 boolean isActive ()
          caret가 현재 액티브한지 어떤지를 판정합니다.
 boolean isSelectionVisible ()
          현재의 선택 범위가 가시일지 어떨지를 판정합니다.
 boolean isVisible ()
          caret가 현재 가시 상태일지 어떨지를 나타냅니다.
 void mouseClicked (MouseEvent  e)
          마우스가 클릭되었을 때에 불려 갑니다.
 void mouseDragged (MouseEvent  e)
          마우스 포인터의 현재 위치에 따라, caret를 이동합니다.
 void mouseEntered (MouseEvent  e)
          마우스가 있는 영역에 들어갔을 때에 불려 갑니다.
 void mouseExited (MouseEvent  e)
          마우스가 있는 영역에서 나왔을 때에 불려 갑니다.
 void mouseMoved (MouseEvent  e)
          마우스가 이동했을 때에 불려 갑니다.
 void mousePressed (MouseEvent  e)
          이 메소드는, 버튼 1 이 클릭되었을 경우에, 관련하는 텍스트 컴퍼넌트에의 포커스를 요구해, caret의 위치를 설정하기 위해서 구현되고 있습니다.
 void mouseReleased (MouseEvent  e)
          mouse button를 떼어 놓았을 때에 불려 갑니다.
protected  void moveCaret (MouseEvent  e)
          viewToModel()를 사용해, 마우스 이벤트의 좌표로부터 caret의 이동을 시도합니다.
 void moveDot (int dot)
          전송 바이어스를 사용해, caret 위치가 지정된 위치로 이동합니다.
 void moveDot (int dot, Position.Bias  dotBias)
          지정된 바이어스를 사용해, caret 위치가 지정된 위치로 이동합니다.
 void paint (Graphics  g)
          caret를 수직선으로서 draw 합니다.
protected  void positionCaret (MouseEvent  e)
          viewToModel()를 사용해, 마우스 이벤트의 좌표로부터 caret의 위치의 설정을 시도합니다.
 void removeChangeListener (ChangeListener  l)
          caret의 이동을 추적하고 있는 청취자를 삭제합니다.
protected  void repaint ()
          caret를 draw 합니다.
 void setBlinkRate (int rate)
          caret의 점멸 간격을 설정합니다.
 void setDot (int dot)
          전송 바이어스를 사용해, caret 위치를 설정해, 지정된 위치를 마크 합니다.
 void setDot (int dot, Position.Bias  dotBias)
          지정된 바이어스를 사용해, caret 위치를 설정해, 지정된 위치를 마크 합니다.
 void setMagicCaretPosition (Point  p)
          caret의 현재의 위치를 보존합니다.
 void setSelectionVisible (boolean vis)
          선택 범위의 가시성을 변경합니다.
 void setUpdatePolicy (int policy)
          문서의 갱신에 대한 caret 이동 정책를 설정합니다.
 void setVisible (boolean e)
          caret의 가시성을 설정해, caret를 재그립니다.
 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
이벤트발송쓰레드로 문서의 변경을 하는 경우에게만 caret 위치가 갱신되는 것을 나타냅니다.

도입된 버젼:
1.5
관련 항목:
setUpdatePolicy(int) , getUpdatePolicy() , 정수 필드치

NEVER_UPDATE

public static final int NEVER_UPDATE
삭제의 탓으로 문서의 길이가 현재의 caret 위치보다 짧아지는 경우를 제외해, 문서의 갱신에 관계없이, 문서내의 caret의 절대 위치가 변함없는 것을 나타냅니다. 문서의 길이가 현재의 caret 위치보다 짧아지는 경우는, 문서의 말미에 맞추어 caret 위치가 조정됩니다.

도입된 버젼:
1.5
관련 항목:
setUpdatePolicy(int) , getUpdatePolicy() , 정수 필드치

ALWAYS_UPDATE

public static final int ALWAYS_UPDATE
문서의 갱신이 이벤트발송쓰레드로 행해질지 어떨지에 관계없이, 문서의 변경에 따라 caret 위치가 반드시 갱신되는 것을 나타냅니다.

도입된 버젼:
1.5
관련 항목:
setUpdatePolicy(int) , getUpdatePolicy() , 정수 필드치

listenerList

protected EventListenerList  listenerList
이벤트 청취자의 리스트입니다.


changeEvent

protected transient ChangeEvent  changeEvent
모델의 변경을 나타내는 이벤트입니다. 이벤트 전용 (read 전용) 상태가 소스 프로퍼티이므로, 필요한 ChangeEvent 의 수는 모델 인스턴스 마다 1 개(살)입니다. 여기서 생성된 이벤트의 소스는, 항상 「this」입니다.

생성자 의 상세

DefaultCaret

public DefaultCaret()
디폴트의 caret를 구축합니다.

메소드의 상세

setUpdatePolicy

public void setUpdatePolicy(int policy)
문서의 갱신에 대한 caret 이동 정책를 설정합니다. 일반적으로은, caret 위치전또는 그 위치에 삽입을 했을 경우, 혹은 caret 위치전에 삭제를 했을 경우에, 문서내의 caret의 절대 위치가 갱신됩니다. 여기서의 「절대 위치」란, 문서의 선두를 기준으로 한 위치입니다. 예를 들어, 편집 가능한 텍스트 컴퍼넌트내에 문자를 입력하면(자), 그 문자는 caret 위치에 삽입되어 caret는 삽입의 탓으로 문서내의 다음의 절대 위치로 이동합니다. 다음에,BACKSPACE 를 입력하면(자), caret 위치전에 있는 문자가 삭제되었기 때문에 caret의 절대 위치가 감소합니다. 경우에 따라서는, caret 위치의 갱신을 오프로 해, 문서의 갱신에 관계없이, 문서 위치에 있어서의 caret의 절대 위치를 같은 로 해 두는 것이 유효한 일도 있습니다.

다음의 갱신 정책를 설정할 수 있습니다.

디폴트의 프로퍼티치는 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()
문서의 갱신에 대한 caret 이동 정책를 가져옵니다.

반환값:
다음의 값의 언젠가. 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()
이 caret를 사용하는 텍스트 문자 편집기 컴퍼넌트를 돌려줍니다.

반환값:
컴퍼넌트

repaint

protected final void repaint()
caret를 draw 합니다. draw 다시 하는 영역은, caret의 바운딩 박스 (caret의 구형, 즉 this)입니다.

이 메소드는 thread에 대해서 안전합니다만, 대부분의 Swing 메소드는 다릅니다. 자세한 것은,「How to Use Threads」를 참조해 주세요.


damage

protected void damage(Rectangle  r)
caret를 둘러싸는 영역을 부수어, 새로운 위치에 재페인트 되도록(듯이) 합니다. paint()의 구현을 다시 했을 경우는, 이 메소드도 다시 구현해 주세요. 이 메소드는, caret의 경계 (x, y, 폭, 높이)를 갱신합니다.

파라미터:
r - caret의 현재의 위치
관련 항목:
paint(java.awt.Graphics)

adjustVisibility

protected void adjustVisibility(Rectangle  nloc)
필요에 따라서, 관련하는 뷰를 스크롤 해, caret를 표시합니다. 이 조작의 처리 방법은 정책에 의해 바뀌므로, 메소드의 구현을 다시 해 동작을 변경해도 괜찮습니다. 디폴트에서는, 관련하는 컴퍼넌트로 scrollRectToVisible 메소드가 불려 갑니다.

파라미터:
nloc - 스크롤처의 새로운 위치

getSelectionPainter

protected Highlighter.HighlightPainter  getSelectionPainter()
하이 라이터에 사용하는 페인타를 가져옵니다.

반환값:
페인타

positionCaret

protected void positionCaret(MouseEvent  e)
viewToModel()를 사용해, 마우스 이벤트의 좌표로부터 caret의 위치의 설정을 시도합니다.

파라미터:
e - 마우스 이벤트

moveCaret

protected void moveCaret(MouseEvent  e)
viewToModel()를 사용해, 마우스 이벤트의 좌표로부터 caret의 이동을 시도합니다. 닷과 마크의 위치가 다른 경우는, 범위의 선택이 됩니다.

파라미터:
e - 마우스 이벤트

focusGained

public void focusGained(FocusEvent  e)
caret를 포함한 컴퍼넌트가 포커스를 얻었을 때에 불려 갑니다. 편집 가능한 컴퍼넌트의 caret를 가시로 설정하기 위해서 구현되고 있습니다.

정의:
인터페이스 FocusListener 내의 focusGained
파라미터:
e - 포커스 이벤트
관련 항목:
FocusListener.focusGained(java.awt.event.FocusEvent)

focusLost

public void focusLost(FocusEvent  e)
caret를 포함한 컴퍼넌트가 포커스를 잃었을 때에 불려 갑니다. caret의 가시 속성을 false 로 설정하기 위해서 구현되고 있습니다.

정의:
인터페이스 FocusListener 내의 focusLost
파라미터:
e - 포커스 이벤트
관련 항목:
FocusListener.focusLost(java.awt.event.FocusEvent)

mouseClicked

public void mouseClicked(MouseEvent  e)
마우스가 클릭되었을 때에 불려 갑니다. 버튼 1 이 클릭되었을 경우, 더블 클릭에서는 단어를, 트리플 클릭에서는 현재의 행 (1 행)을 선택합니다.

정의:
인터페이스 MouseListener 내의 mouseClicked
파라미터:
e - 마우스 이벤트
관련 항목:
MouseListener.mouseClicked(java.awt.event.MouseEvent)

mousePressed

public void mousePressed(MouseEvent  e)
이 메소드는, 버튼 1 이 클릭되었을 경우에, 관련하는 텍스트 컴퍼넌트에의 포커스를 요구해, caret의 위치를 설정하기 위해서 구현되고 있습니다. Shift 키를 누른 채로라고, caret는 선택 범위내에 이동되는 일도 있습니다. 누르지 않으면, caret의 위치는 새로운 위치로 설정됩니다. 컴퍼넌트가 유효하게 되지 않은 경우는, 포커스의 요구는 나오지 않습니다.

정의:
인터페이스 MouseListener 내의 mousePressed
파라미터:
e - 마우스 이벤트
관련 항목:
MouseListener.mousePressed(java.awt.event.MouseEvent)

mouseReleased

public void mouseReleased(MouseEvent  e)
mouse button를 떼어 놓았을 때에 불려 갑니다.

정의:
인터페이스 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)
마우스 포인터의 현재 위치에 따라, caret를 이동합니다. 사실상, 선택 범위를 연장하게 됩니다. 디폴트에서는, mouse button 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)
caret를 수직선으로서 draw 합니다. 이 구현을 다시 했을 경우는, damage 메소드의 구현도 다시 해 주세요. 이것은, damage 메소드가, caret의 형상을 수직선과 가정하고 있기 때문입니다. caret의 색은, getCaretColor()의 반환값에 따라 설정합니다.

관련한 문서에 복수의 텍스트 방향이 있는 경우는, caret의 바이어스를 나타내는 플래그가 draw 됩니다. 이것은, 관련하는 문서가 AbstractDocument 의 서브 클래스이며, 한편, BIDI 요소 구조내에 복수의 BIDI 레벨이 존재하는 경우 (즉, 텍스트가 텍스트 자신에게 관련한 복수의 방향을 가지고 있는 경우)에게만 발생합니다.

정의:
인터페이스 Caret 내의 paint
파라미터:
g - 그래픽스 문맥
관련 항목:
damage(java.awt.Rectangle)

install

public void install(JTextComponent  c)
JTextComponent 의 인터페이스에 UI 를 인스톨 하고 있을 때 불려 갑니다. 이 메소드를 사용하면(자), 이 인터페이스의 구현에 의해 안내되고 있는 모델에 액세스 할 수 있습니다. dot 와 mark 를 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의 이동을 항상 추적하기 위해서, 청취자를 추가합니다.

정의:
인터페이스 Caret 내의 addChangeListener
파라미터:
l - 청취자
관련 항목:
Caret.addChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener  l)
caret의 이동을 추적하고 있는 청취자를 삭제합니다.

정의:
인터페이스 Caret 내의 removeChangeListener
파라미터:
l - 청취자
관련 항목:
Caret.removeChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener [] getChangeListeners()
이 caret에 등록된, 모든 변경 청취자로부터 되는 배열을 돌려줍니다.

반환값:
이 caret의 changeListener 전부. 변경 청취자가 현재 등록되지 않은 경우는 빈 상태(empty)의 배열
도입된 버젼:
1.4
관련 항목:
addChangeListener(javax.swing.event.ChangeListener) , removeChangeListener(javax.swing.event.ChangeListener)

fireStateChanged

protected void fireStateChanged()
통지의 전달 대상을, 지정된 이벤트형으로 등록한 모든 청취자에게 통지합니다. 이벤트 인스턴스는, fire 메소드에게 건네지는 파라미터를 사용해 간단하게 생성됩니다. 청취자의 리스트는, 최후로부터 선두로 향해 처리됩니다.

관련 항목:
EventListenerList

getListeners

public <T extends EventListener > T[] getListeners(Class <T> listenerType)
이 caret에 FooListener 로서 현재 등록되어 모든 객체의 배열을 돌려줍니다. FooListener 는,addFooListener 메소드를 사용해 등록합니다.

FooListener.class 라고 하는 클래스 리터럴을 사용해,listenerType 인수를 지정할 수 있습니다. 예를 들어 이하의 코드를 사용해,DefaultCaret c 를, 그 변경 청취자에게 조회할 수 있습니다.

ChangeListener[] cls = (ChangeListener[])(c.getListeners(ChangeListener.class));
이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.

파라미터:
listenerType - 요구되는 청취자의 형태. 이 파라미터는, java.util.EventListener 의 하위 인터페이스를 지정한다
반환값:
이 컴퍼넌트에 FooListener 로서 등록되어 있다 모든 객체의 배열. 그러한 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열
예외:
ClassCastException - listenerTypejava.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가 현재 액티브한지 어떤지를 판정합니다.

이 메소드는,Caret 가 현재 점멸 상태에 있을지 어떨지를 돌려줍니다. caret의 점멸이 현재 온 또는 오프의 어느 쪽이 되어 있을까의 정보는 돌려주지 않습니다. caret가 현재 페인트 될지 어떨지를 확인하려면 ,isVisible 메소드를 사용해 주세요.

반환값:
액티브한 경우는 true, 그렇지 않은 경우는 false
도입된 버젼:
1.5
관련 항목:
isVisible()

isVisible

public boolean isVisible()
caret가 현재 가시 상태일지 어떨지를 나타냅니다. caret는 점멸하기 (위해)때문에, 이 메소드의 반환값은, caret가 페인트 되는 경우는 true 가 되어, caret가 페인트 되지 않는 경우는 false 가 됩니다. isActive 는, caret가 점멸 상태에 있을지 어떨지를 나타냅니다. 예를 들어, caret를 가시로 할 수 있는 경우,isVisible 는 caret가 실제로 가시 상태인가 어떤가를 나타냅니다.

다른 점멸하는 caret를 draw 하는 경우는, 서브 클래스에서 paint 메소드를 오버라이드(override) 해, 그 메소드가 true 를 돌려주었을 경우에게만 caret를 그립니다.

정의:
인터페이스 Caret 내의 isVisible
반환값:
가시의 경우는 true, 그렇지 않은 경우는 false
관련 항목:
Caret.isVisible() , isActive()

setVisible

public void setVisible(boolean e)
caret의 가시성을 설정해, caret를 재그립니다. 이 메소드와isVisibleisActive 와의 관계를 이해하는 것이 중요합니다. 이 메소드를 true 의 값으로 호출하면(자), caret의 점멸이 액티브하게 됩니다. 이것을 false 로 설정하면(자), caret의 점멸이 완전하게 오프가 됩니다. 점멸이 액티브한가 어떤가를 확인하려면 ,isActive 를 호출할 필요가 있습니다. 요컨데,isActive 는 이 메소드의 적절한 대응하는 get 메소드입니다. isVisible 를 사용하면(자), caret의 현재의 가시성, 즉 caret가 현재 페인트 될지 어떨지를 꺼낼 수가 있습니다. 이 상태는, caret의 점멸의 온/오프에 수반해 바뀝니다.

다음에, 이 메소드를 호출해 나중에,isActiveisVisible 를 생각되는 반환값의 리스트를 나타냅니다.

setVisible(true):

setVisible(false):

정의:
인터페이스 Caret 내의 setVisible
파라미터:
e - 가시성 지정자
관련 항목:
isActive() , Caret.setVisible(boolean)

setBlinkRate

public void setBlinkRate(int rate)
caret의 점멸 간격을 설정합니다.

정의:
인터페이스 Caret 내의 setBlinkRate
파라미터:
rate - 밀리 세컨드 단위의 간격으로, 0 의 경우는 점멸을 정지
관련 항목:
Caret.setBlinkRate(int)

getBlinkRate

public int getBlinkRate()
caret의 점멸 간격을 가져옵니다.

정의:
인터페이스 Caret 내의 getBlinkRate
반환값:
밀리 세컨드 단위의 지연. 이것이 0 의 경우, caret의 점멸은 이루어
관련 항목:
Caret.getBlinkRate()

getDot

public int getDot()
caret의 현재의 위치를 가져옵니다.

정의:
인터페이스 Caret 내의 getDot
반환값:
위치는 0 이상
관련 항목:
Caret.getDot()

getMark

public int getMark()
마크의 현재의 위치를 가져옵니다. 선택 범위가 있는 경우, dot 와 mark 는 같게는 되지 않습니다.

정의:
인터페이스 Caret 내의 getMark
반환값:
위치는 0 이상
관련 항목:
Caret.getMark()

setDot

public void setDot(int dot)
전송 바이어스를 사용해, caret 위치를 설정해, 지정된 위치를 마크 합니다. 선택 범위가, 암묵중에 제로로 설정됩니다.

정의:
인터페이스 Caret 내의 setDot
파라미터:
dot - 위치는 0 이상
관련 항목:
setDot(int, Position.Bias) , Caret.setDot(int)

moveDot

public void moveDot(int dot)
전송 바이어스를 사용해, caret 위치가 지정된 위치로 이동합니다.

정의:
인터페이스 Caret 내의 moveDot
파라미터:
dot - 위치는 0 이상
관련 항목:
moveDot(int, javax.swing.text.Position.Bias) , Caret.moveDot(int)

moveDot

public void moveDot(int dot,
                    Position.Bias  dotBias)
지정된 바이어스를 사용해, caret 위치가 지정된 위치로 이동합니다.

파라미터:
dot - 위치는 0 이상
dotBias - 위치의 바이어스 (null 이외)
예외:
IllegalArgumentException - 바이어스가 null 의 경우
도입된 버젼:
1.6
관련 항목:
Caret.moveDot(int)

setDot

public void setDot(int dot,
                   Position.Bias  dotBias)
지정된 바이어스를 사용해, caret 위치를 설정해, 지정된 위치를 마크 합니다. 선택 범위가, 암묵중에 제로로 설정됩니다.

파라미터:
dot - 위치는 0 이상
dotBias - 위치의 바이어스 (null 이외)
예외:
IllegalArgumentException - 바이어스가 null 의 경우
도입된 버젼:
1.6
관련 항목:
Caret.setDot(int)

getDotBias

public Position.Bias  getDotBias()
caret의 위치의 바이어스를 돌려줍니다.

반환값:
caret의 위치의 바이어스
도입된 버젼:
1.6

getMarkBias

public Position.Bias  getMarkBias()
마크의 바이어스를 돌려줍니다.

반환값:
마크의 바이어스
도입된 버젼:
1.6

setMagicCaretPosition

public void setMagicCaretPosition(Point  p)
caret의 현재의 위치를 보존합니다. caret가 상하에 움직여, 끝 위치가 균등이 아닌 행의 사이를 이동하는 경우에 사용합니다.

정의:
인터페이스 Caret 내의 setMagicCaretPosition
파라미터:
p - 위치
관련 항목:
getMagicCaretPosition()

getMagicCaretPosition

public Point  getMagicCaretPosition()
보존되고 있는 caret의 위치를 돌려줍니다.

정의:
인터페이스 Caret 내의 getMagicCaretPosition
반환값:
위치 #setMagicCaretPosition 를 참조
관련 항목:
Caret.setMagicCaretPosition(java.awt.Point)

equals

public boolean equals(Object  obj)
이 객체가 지정된 객체와 비교합니다. 구형을 비교한다고 하는 슈퍼 클래스의 동작은 필요없기 때문에, Object 동작으로 변경됩니다.

오버라이드(override):
클래스 Rectangle 내의 equals
파라미터:
obj - 이 폰트라고 비교되는 객체
반환값:
객체가 동일한 경우는 true 그렇지 않은 경우는 false
관련 항목:
Object.hashCode() , Hashtable

toString

public String  toString()
클래스 Rectangle 의 기술:
Rectangle 및 그 값을 나타내는 String 표현을 돌려줍니다.

오버라이드(override):
클래스 Rectangle 내의 toString
반환값:
Rectangle 객체의 좌표 및 사이즈의 값을 나타내는 String

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.