javax.swing.text
인터페이스 Caret

기존의 구현 클래스의 일람:

BasicTextUI.BasicCaret , DefaultCaret

public interface Caret

문서 모델내에 내용을 삽입할 수 있는, 드큐먼트뷰내의 장소를 나타냅니다. caret의 위치는, 닷이라고 해지는 문서내에 있습니다. 닷은, caret가 모델내에 배치되고 있는 곳(중)입니다. 마크로 불리는 선택 범위의 종점을 나타내는 caret가 유지하는 2 번째의 위치가 있습니다. 선택 범위가 없는 경우는, 닷과 마크는 같습니다. 선택 범위가 존재하는 경우는, 이 2 개(살)은 다릅니다.

닷은,setDot 또는 moveDot 의 어느 쪽인지를 호출해 배치할 수가 있습니다. 닷을 설정하면(자), 이전에 존재하고 있던 가능성이 있는 모든 선택 범위를 삭제한다고 하는 효과가 있습니다. 닷과 마크는 같게 됩니다. 닷을 이동하면(자), 이전에 존재하고 있던 어떤 위치에서 만나도 마크가 남아 있으므로 선택 범위를 작성한다고 하는 효과가 있습니다.

메소드의 개요

void	addChangeListener (ChangeListener l) caret의 이동을 항상 추적하기 위해서, 청취자를 추가합니다.
void	deinstall (JTextComponent c) UI 가 JTextComponent 의 인터페이스로부터 삭제되었을 때에 불려 갑니다.
int	getBlinkRate () caret의 점멸 간격을 돌려줍니다.
int	getDot () caret의 현재의 위치를 꺼냅니다.
Point	getMagicCaretPosition () caret의 현재의 가시 위치를 돌려줍니다.
int	getMark () 마크의 현재의 위치를 꺼냅니다.
void	install (JTextComponent c) JTextComponent 의 인터페이스에 UI 가 인스톨 될 때에 불려 갑니다.
boolean	isSelectionVisible () 선택 범위가 현재도 가시일지 어떨지를 판정합니다.
boolean	isVisible () caret가 현재 가시일지 어떨지를 판정합니다.
void	moveDot (int dot) caret의 위치 (닷)를 이동합니다.
void	paint (Graphics g) caret를 draw 합니다.
void	removeChangeListener (ChangeListener l) caret의 이동을 추적하고 있는 청취자를 삭제합니다.
void	setBlinkRate (int rate) caret의 점멸 간격을 설정합니다.
void	setDot (int dot) caret의 위치를 설정합니다.
void	setMagicCaretPosition (Point p) 현재의 caret 가시 위치를 설정합니다.
void	setSelectionVisible (boolean v) 선택 범위의 가시 또는 불가시를 설정합니다.
void	setVisible (boolean v) caret의 가시 또는 불가시를 설정합니다.

메소드의 상세

install

void install(JTextComponent  c)

JTextComponent 의 인터페이스에 UI 가 인스톨 될 때에 불려 갑니다. 이 메소드를 사용하면(자), 이 인터페이스의 구현에 의해 안내되고 있는 모델에 액세스 할 수 있습니다.

파라미터:

c - JTextComponent

deinstall

void deinstall(JTextComponent  c)

UI 가 JTextComponent 의 인터페이스로부터 삭제되었을 때에 불려 갑니다. 이 메소드는, 추가된 청취자의 등록을 해제하기 위해서 사용됩니다.

파라미터:

c - JTextComponent

paint

void paint(Graphics  g)

caret를 draw 합니다. 이 메소드는 UI 클래스에 의해 불려 갑니다.

파라미터:

g - 그래픽스 문맥

addChangeListener

void addChangeListener(ChangeListener  l)

caret의 이동을 항상 추적하기 위해서, 청취자를 추가합니다.

파라미터:

l - 변경 청취자

removeChangeListener

void removeChangeListener(ChangeListener  l)

caret의 이동을 추적하고 있는 청취자를 삭제합니다.

파라미터:

l - 변경 청취자

isVisible

boolean isVisible()

caret가 현재 가시일지 어떨지를 판정합니다.

반환값:

caret가 가시의 경우는 true, 그렇지 않은 경우는 false

setVisible

void setVisible(boolean v)

caret의 가시 또는 불가시를 설정합니다.

파라미터:

v - caret를 표시하는 경우는 true, caret를 비표시로 하는 경우는 false

isSelectionVisible

boolean isSelectionVisible()

선택 범위가 현재도 가시일지 어떨지를 판정합니다.

반환값:

caret가 가시의 경우는 true, 그렇지 않은 경우는 false

setSelectionVisible

void setSelectionVisible(boolean v)

선택 범위의 가시 또는 불가시를 설정합니다.

파라미터:

v - caret를 표시하는 경우는 true, caret를 비표시로 하는 경우는 false

setMagicCaretPosition

void setMagicCaretPosition(Point  p)

현재의 caret 가시 위치를 설정합니다. caret의 상하에 움직이는 등의 끝 위치가 균등이 아닌 행간을 이동할 경우에 사용할 수 있습니다. 텍스트가 왼쪽에서 오른쪽, 금방 다른 곳으로 플로우 하면(자), x 축은 수직 방향의 움직임에 대해서 필요한 네비게이션 위치를 나타냅니다. 텍스트가 상하 방향으로 플로우 하면(자), y 축이 수평 방향의 움직임에 대해서 필요한 네비게이션의 위치를 나타냅니다.

파라미터:

p - 위치의 보존에 사용하는 Point. 가시가 아닌 위치가 있는 것을 나타내는 경우는 null 도 가능

getMagicCaretPosition

Point  getMagicCaretPosition()

caret의 현재의 가시 위치를 돌려줍니다.

반환값:

가시 위치

관련 항목:

setMagicCaretPosition(java.awt.Point)

setBlinkRate

void setBlinkRate(int rate)

caret의 점멸 간격을 설정합니다. caret에 주의를 향하기 위한 일반적인 방법의 하나인, caret의 점멸의 유무 및 속도를 결정합니다.

파라미터:

rate - 밀리 세컨드 단위의 지연 >= 0. caret의 점멸은 없음

getBlinkRate

int getBlinkRate()

caret의 점멸 간격을 돌려줍니다. caret에 주의를 향하기 위한 일반적인 방법의 하나인, caret의 점멸의 유무 및 속도를 결정합니다.

반환값:

밀리 세컨드 단위의 지연 >= 0. caret의 점멸은 없음

getDot

int getDot()

caret의 현재의 위치를 꺼냅니다.

반환값:

위치 >= 0

getMark

int getMark()

마크의 현재의 위치를 꺼냅니다. 선택 범위가 있는 경우, 마크는 닷과는 다릅니다.

반환값:

위치 >= 0

setDot

void setDot(int dot)

caret의 위치를 설정합니다. 마크와 닷의 위치가 같게 되어, 선택 범위는 사실상 제로로 설정됩니다.

caret는, 파라미터가 0 보다 작은 값인 경우는 선두에, 파라미터가 문서의 길이보다 긴 경우는 말미에 배치됩니다.

파라미터:

dot - caret의 새로운 위치

moveDot

void moveDot(int dot)

caret의 위치 (닷)를 이동합니다. 마크는 원래의 위치에 머무릅니다. 선택 범위의 마킹에 편리합니다.

파라미터:

dot - caret를 이동하는 위치 >= 0