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) JTextComponent 인터페이스로부터 UI를 삭제하고 있을 때에 호출합니다.
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를 렌더링 합니다.
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)

JTextComponent 인터페이스로부터 UI를 삭제하고 있을 때에 호출합니다. 이 메서드를 사용하면, 접속되고 있던 리스너의 등록을 모두 해제할 수 있습니다.

파라미터:

c - JTextComponent

paint

void paint(Graphics  g)

caret를 렌더링 합니다.

파라미터:

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. 이 값이 0인 경우, caret의 점멸은 없음

getBlinkRate

int getBlinkRate()

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

반환값:

밀리 세컨드 단위의 지연 >= 0. 이 값이 0인 경우, caret의 점멸은 없음

getDot

int getDot()

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

반환값:

위치 >= 0

getMark

int getMark()

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

반환값:

위치 >= 0

setDot

void setDot(int dot)

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

파라미터:

dot - caret의 새로운 위치 >= 0

moveDot

void moveDot(int dot)

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

파라미터:

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