java.awt.geom.RectangularShape
java.awt.geom.Rectangle2D
java.awt.Rectangle
javax.swing.text.DefaultCaret
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: 상자 | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public class DefaultCaret
Caret 디폴트의 구현입니다. caret는 관련된 JTextComponent CaretColor 프로퍼티로 지정된 색의 수직선으로서 렌더링 됩니다. 또, BlinkRate 프로퍼티로 지정한 속도로 점멸시킬 수가 있습니다.
이 구현은 비동기 통지의 소스가 2개
있는 것을 전제로 합니다. 타이머 thread는 비동기에게 트리거 되어 이것에 의해
caret는 최신의 바운딩박스에 페인트 다시 합니다. 또, caret는 문서가 갱신될 때마다 변경을 추적합니다. 보통, 문서의 갱신은 마우스 이벤트 또는 키보드 이벤트에
한 이벤트디스패치스레드에 대해 발생합니다. caret의 동작은 문서의 동기적인 갱신에서도 비동기적인 갱신에서도, UpdatePolicy 프로퍼티에 의해 제어됩니다. 새로운 caret 위치의 재페인트는 반드시 이벤트 thread에 위에서 발생합니다. 이것은, modelToView
호출이 이벤트 thread상에서만 안전하기 때문에입니다.
caret는 인스톨처의 텍스트 컴퍼넌트로 마우스 및 포커스 리스너로서 행동해, caret의 시멘틱스를 그러한 이벤트에 근거해 정의합니다. 시멘틱스를 변경하려면, 리스너의 메서드를 다시 구현합니다. 디폴트에서는 마우스의 제 1 버튼을 사용해 포커스와 caret 위치를 설정합니다. 제 1 버튼을 사용해 마우스 포인터를 드래그 하면, 모델내의 인접하는 선택 부분을 넓힐 수가 있습니다. 관련된 텍스트 컴퍼넌트가 편집 가능한 경우는 caret는 포커스를 얻었을 때에 가시가 되어, 포커스를 잃었을 때에 불가시가 됩니다.
관련된 텍스트에의 Highlighter 경계는 디폴트에서는 선택 부분을 렌더링 하기 위해서 사용됩니다. 선택 부분의 표시는 하이라이트에 사용하는 페인타를 제공하는 것으로 커스터마이즈 할 수 있습니다. 디폴트에서는 관련된 텍스트 컴퍼넌트의 SelectionColor 프로퍼티로 지정된 솔리드색으로 렌더링 됩니다. 이것은, getSelectionHighlighter 메서드를 다시 구현하는 것으로 간단하게 변경할 수 있습니다.
caret의 외관은 paint 메서드를 다시 구현하는 것으로 커스터마이즈 할 수 있습니다. paint 메서드를 변경하는 경우에는 damage 메서드도 다시 구현해, caret의 렌더링에 사용되는 영역을 렌더링 다시의해 주세요. caret는 Rectangle 클래스를 확장하고 있기 때문에 caret가 마지막에 렌더링 된 바운딩박스를 보관 유지하고 있습니다. 이것에 의해 caret가 이동했을 때에 모델의 갱신과 뷰의 수복동안에서 동작이 불안정한 modelToView 메서드를 호출하는 일 없이, thread에 대해서 안전한 방법으로 렌더링 다시 할 수 있습니다 (modelToView 메서드에서는 DocumentListener 에의 전달의 순서가 보증되지 않는다).
caret 위값이 변경될 때, 매직 caret의 위치는 null 로 설정되어 있습니다. 타이머를 사용해, caret 변경 후의 새로운 위치를 지정합니다. 타이머가 트리거 하면, 매직 caret의 위값이 아직 null인 경우, 현재의 caret 위치에 리셋 됩니다. caret 위치를 변경해, 매직 caret의 위치를 그대로의해 두는 액션의 경우는 모두, 매직 caret의 위치를 기억해 커서를 변경하고 나서, 매직 caret의 위치를 그 원래의 위치로 설정합니다. 이 메서드에는 매직 caret의 위치를 지속시키는 (오픈 또는 다운시키는 등) 액션만이 그것을 알고 있으면 좋다고 하는 이점이 있습니다.
경고: 이 클래스의 직렬화 된 객체는 향후의 Swing 릴리즈와
호환되지 않을 예정입니다. 현재의 직렬화의 지원은
단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전
1.4 이후, 모든 JavaBeans™
장기간의 운용 지원은
java.beans 패키지에 추가되고 있습니다. 자세한 내용은 XMLEncoder를
참조하십시오.
Caret | 중첩(Nested) 클래스 개요 |
|---|
| 클래스 java.awt.geom. Rectangle2D 로부터 상속된 중첩(Nested) 클래스/인터페이스 |
|---|
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)
JTextComponent 인터페이스로부터 UI를 삭제하고 있을 때에 호출합니다. |
|
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의 현재의 위치를 꺼냅니다. |
|
|
getListeners (Class <T> listenerType)
이 caret상에서 FooListener로
서 현재 등록되어 있는 모든 객체로부터 되는 배열을 리턴합니다. |
|
Point |
getMagicCaretPosition ()
보존되고 있는 caret의 위치를 리턴합니다. |
|
int |
getMark ()
마크의 현재의 위치를 꺼냅니다. |
|
protected Highlighter.HighlightPainter |
getSelectionPainter ()
하이 Writer에 사용하는 페인타를 리턴합니다. |
|
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 |
paint (Graphics g)
caret를 수직선으로서 렌더링 합니다. |
|
protected void |
positionCaret (MouseEvent e)
viewToModel()를 사용해, 마우스 이벤트의 좌표로부터 caret의 위치의 설정을 시도합니다. |
|
void |
removeChangeListener (ChangeListener l)
caret의 이동을 추적하고 있는 리스너를 삭제합니다. |
|
protected void |
repaint ()
caret를 렌더링 합니다. |
|
void |
setBlinkRate (int rate)
caret의 점멸 간격을 설정합니다. |
|
void |
setDot (int dot)
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 |
| 필드의 상세 |
|---|
public static final int UPDATE_WHEN_ON_EDT
setUpdatePolicy(int),
getUpdatePolicy(),
정수 필드값 public static final int NEVER_UPDATE
setUpdatePolicy(int),
getUpdatePolicy(),
정수 필드값 public static final int ALWAYS_UPDATE
setUpdatePolicy(int),
getUpdatePolicy(),
정수 필드값 protected EventListenerList listenerList
protected transient ChangeEvent changeEvent
| 생성자 상세 |
|---|
public DefaultCaret()
| 메서드의 상세 |
|---|
public void setUpdatePolicy(int policy)
BACKSPACE를 입력하면, caret 위치전에 있는 문자가 삭제되었기 때문에 caret의 절대 위값이 감소합니다. 경우에 따라서는 caret 위치의 갱신을 오프로 해, 문서의 갱신에 관계없이, 문서 위치에 있어서의 caret의 절대 위치를 같은 로의해 두는 것이 유효한 일도 있습니다.
다음의 갱신 정책를 설정할 수 있습니다.
NEVER_UPDATE: 삭제의 탓으로 문서의 길이가 현재의 caret 위치보다 짧아지는 경우를 제외해, 문서의 갱신에 관계없이, 문서내의 caret의 절대 위값이 변함없는 것을 나타냅니다. 문서의 길이가 현재의 caret 위치보다 짧아지는 경우는 문서의 말미에 맞추어 caret 위값이 조정됩니다. 이 정책
의 사용시는 caret는 관련한 뷰를 스크롤 해, caret 자체를 가시 상태로의해 두려고는 하지 않습니다. ALWAYS_UPDATE: caret는 항상 문서의 변경을 추적합니다. 보통
의 변경에서는 caret의 현재 위치전또는 그 위치에 삽입을 하면, caret 위값이 증가해, caret의 현재 위치전에 삭제를 하면, caret 위값이 감소합니다. 갱신을 바탕으로 되돌리거나 재실행하거나 하는 경우, caret는 항상 갱신을 한 위치로 이동합니다. 또, caret는 adjustVisibility 메서드를 호출해, caret 자체를 가시 상태로의해 두려고 합니다. UPDATE_WHEN_ON_EDT: 문서의 갱신이 이벤트디스패치스레드에 대해서 행해졌을 경우는 ALWAYS_UPDATE와
같이 동작해, 다른 thread에 대해서 행해졌을 경우는 NEVER_UPDATE와
같이 동작합니다.
디폴트의 프로퍼티치는 UPDATE_WHEN_ON_EDT 입니다.
policy - UPDATE_WHEN_ON_EDT, NEVER_UPDATE, ALWAYS_UPDATE
몇개의 값
IllegalArgumentException - 건네받은 값이 무효인 경우getUpdatePolicy(),
adjustVisibility(java.awt.Rectangle),
UPDATE_WHEN_ON_EDT,
NEVER_UPDATE,
ALWAYS_UPDATE public int getUpdatePolicy()
UPDATE_WHEN_ON_EDT, NEVER_UPDATE, ALWAYS_UPDATE
몇개의 값setUpdatePolicy(int),
UPDATE_WHEN_ON_EDT,
NEVER_UPDATE,
ALWAYS_UPDATE protected final JTextComponent getComponent()
protected final void repaint()
이 메서드는 thread에 대해서 안전합니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.
protected void damage(Rectangle r)
r - caret의 현재의 위치paint(java.awt.Graphics) protected void adjustVisibility(Rectangle nloc)
nloc - 스크롤처의 새로운 위치protected Highlighter.HighlightPainter getSelectionPainter()
protected void positionCaret(MouseEvent e)
e - 마우스 이벤트protected void moveCaret(MouseEvent e)
e - 마우스 이벤트public void focusGained(FocusEvent e)
FocusListener 내의 focusGained e - 포커스 이벤트FocusListener.focusGained(java.awt.event.FocusEvent) public void focusLost(FocusEvent e)
FocusListener 내의 focusLost e - 포커스 이벤트FocusListener.focusLost(java.awt.event.FocusEvent) public void mouseClicked(MouseEvent e)
MouseListener 내의 mouseClicked e - 마우스 이벤트MouseListener.mouseClicked(java.awt.event.MouseEvent) public void mousePressed(MouseEvent e)
MouseListener 내의 mousePressed e - 마우스 이벤트MouseListener.mousePressed(java.awt.event.MouseEvent) public void mouseReleased(MouseEvent e)
MouseListener 내의 mouseReleased e - 마우스 이벤트MouseListener.mouseReleased(java.awt.event.MouseEvent) public void mouseEntered(MouseEvent e)
MouseListener 내의 mouseEntered e - 마우스 이벤트MouseListener.mouseEntered(java.awt.event.MouseEvent) public void mouseExited(MouseEvent e)
MouseListener 내의 mouseExited e - 마우스 이벤트MouseListener.mouseExited(java.awt.event.MouseEvent) public void mouseDragged(MouseEvent e)
MouseMotionListener 내의 mouseDragged e - 마우스 이벤트MouseMotionListener.mouseDragged(java.awt.event.MouseEvent) public void mouseMoved(MouseEvent e)
MouseMotionListener 내의 mouseMoved e - 마우스 이벤트MouseMotionListener.mouseMoved(java.awt.event.MouseEvent) public void paint(Graphics g)
관련한 문서에 복수의 텍스트 방향이 있는 경우는 caret의 바이어스를 나타내는 플래그가 렌더링 됩니다. 이것은 관련된 문서가 AbstractDocument 서브 클래스이며, 한편, BIDI 요소 구조내에 복수의 BIDI 레벨이 존재하는 경우 (즉, 텍스트가 텍스트 자신에게 관련한 복수의 방향을 가지고 있는 경우)에게만 발생합니다.
Caret 내의 paint g - 그래픽 컨텍스트
damage(java.awt.Rectangle) public void install(JTextComponent c)
Caret 내의 install c - 컴퍼넌트Caret.install(javax.swing.text.JTextComponent) public void deinstall(JTextComponent c)
Caret 내의 deinstall c - 컴퍼넌트Caret.deinstall(javax.swing.text.JTextComponent) public void addChangeListener(ChangeListener l)
Caret 내의 addChangeListener l - 리스너Caret.addChangeListener(javax.swing.event.ChangeListener) public void removeChangeListener(ChangeListener l)
Caret 내의 removeChangeListener l - 리스너Caret.removeChangeListener(javax.swing.event.ChangeListener) public ChangeListener [] getChangeListeners()
ChangeListener 모두. 변경 리스너가 등록되지 않은 경우는 비어있는 배열addChangeListener(javax.swing.event.ChangeListener),
removeChangeListener(javax.swing.event.ChangeListener) protected void fireStateChanged()
EventListenerList public <T extends EventListener > T[] getListeners(Class <T> listenerType)
FooListener로
서 현재 등록되어 있는 모든 객체로부터 되는 배열을 리턴합니다. FooListener
등록에는 addFooListener 메서드가 사용됩니다.
FooListener.class 등의 클래스 리터럴을 사용해, listenerType인수를 지정할 수 있습니다. 예를 들어 아래의 코드를 사용해, DefaultCaret c를, 그 변경 리스너에게 조회할 수 있습니다.
ChangeListener[] cls = (ChangeListener[])(c.getListeners(ChangeListener.class));이런 종류의 리스너가 존재하지 않는 경우, 이 메서드에서는 비어있는 배열이 리턴됩니다 .
listenerType - 요구되는 리스너의 타입. 이 파라미터는 java.util.EventListener로
부터 파생하는 인터페이스를 지정한다
FooListener로
서 등록된 모든 객체로부터 되는 배열. 이런 종류의 리스너가 추가되어 있지 않은 경우는 비어있는 배열
ClassCastException - listenerType로
java.util.EventListener를 구현하는 클래스나 인터페이스를 지정하지 않는 경우getChangeListeners() public void setSelectionVisible(boolean vis)
Caret 내의 setSelectionVisible vis - 새로운 가시성public boolean isSelectionVisible()
Caret 내의 isSelectionVisible public boolean isActive()
이 메서드는 Caret이 현재 점멸 상태에 있을지 어떨지를 리턴합니다. caret의 점멸이 현재 온 또는 오프의 어느 쪽이 되어 있을까의 정보는 돌려주지 않습니다. caret가 현재 페인트 될지 어떨지를 확인하려면,
isVisible 메서드를 사용해 주세요.
true, 그렇지 않은 경우는 falseisVisible() public boolean isVisible()
isActive는
caret가 점멸 상태에 있을지 어떨지를 나타냅니다. 예를 들어
caret를 가시로 할 수 있는 경우, isVisible는 caret가 실제로 가시 상태인가 어떤가를 나타냅니다.
다른 점멸하는 caret를 렌더링 하는 경우는 서브 클래스에서 paint 메서드를 오버라이드(override) 해, 그 메서드가 true를 돌려주었을 경우에게만 caret를 페인트 합니다.
Caret 내의 isVisible Caret.isVisible(),
isActive() public void setVisible(boolean e)
isVisible 및 isActive와
의 관계를 이해하는 것이 중요합니다. 이 메서드를 true값으로 호출하면, caret의 점멸이 활성화
됩니다. 이것을 false로
설정하면, caret의 점멸이 완전하게 오프가 됩니다. 점멸이 활성화되었는가
어떤가를 확인하려면,
isActive를 호출할 필요가 있습니다. 요컨데, isActive는 이 메서드의 적절한 대응하는 get 메서드입니다. isVisible를 사용하면, caret의 현재의 가시성, 즉 caret가 현재 페인트 될지 어떨지를 꺼낼 수가 있습니다. 이 상태는 caret의 점멸의 온/오프에 수반해 바뀝니다.
다음에
이 메서드를 호출해 나중에
isActive 및 isVisible를 생각되는 반환값의 리스트를 나타냅니다.
setVisible(true):
setVisible(false):
Caret 내의 setVisible e - 가시성 지정자isActive(),
Caret.setVisible(boolean) public void setBlinkRate(int rate)
Caret 내의 setBlinkRate rate - 밀리 세컨드 단위의 간격으로 0인 경우는 점멸을 정지Caret.setBlinkRate(int) public int getBlinkRate()
Caret 내의 getBlinkRate Caret.getBlinkRate() public int getDot()
Caret 내의 getDot Caret.getDot() public int getMark()
Caret 내의 getMark Caret.getMark() public void setDot(int dot)
Caret 내의 setDot dot - 위치 >= 0Caret.setDot(int) public void moveDot(int dot)
Caret 내의 moveDot dot - 위치 >= 0Caret.moveDot(int) public void setMagicCaretPosition(Point p)
Caret 내의 setMagicCaretPosition p - 위치getMagicCaretPosition() public Point getMagicCaretPosition()
Caret 내의 getMagicCaretPosition Caret.setMagicCaretPosition(java.awt.Point) public boolean equals(Object obj)
Rectangle 내의 equals obj - 이 폰트라고 비교되는 객체true, 그렇지 않은 경우는 falseObject.hashCode(),
Hashtable public String toString()
Rectangle
기술: Rectangle 및 그 값을 나타내는 String 표현을 리턴합니다.
Rectangle 내의 toString Rectangle 객체의 좌표와 사이즈의 값을 나타내는 String
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: 상자 | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.