javax.accessibility
인터페이스 AccessibleText

기존의 서브 인터페이스의 일람:

AccessibleEditableText , AccessibleHypertext

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

AbstractButton.AccessibleAbstractButton , JEditorPane.JEditorPaneAccessibleHypertextSupport , JLabel.AccessibleJLabel , JTextComponent.AccessibleJTextComponent , TextComponent.AccessibleAWTTextComponent

public interface AccessibleText

AccessibleText 인터페이스는 텍스트 정보를 화면에 표시하는 모든 클래스에 의해 구현될 필요가 있습니다. 이 인터페이스는 텍스트 컨텐츠, 속성, 및 공간 위치를 사용해 그 텍스트에 액세스하기 위한 유저 보조 기능을 제공합니다. 어플리케이션은 오브젝트의 AccessibleContext (Accessible 를 참조)를 취득하고 나서, AccessibleContext 의 AccessibleContext.getAccessibleText() 메소드를 호출하면(자), 오브젝트가 AccessibleText 인터페이스를 서포트할지 어떨지를 판정할 수 있습니다. 반환값이 null 가 아니면, 그 오브젝트는 이 인터페이스를 서포트하고 있습니다.

관련 항목:

Accessible , Accessible.getAccessibleContext() , AccessibleContext , AccessibleContext.getAccessibleText()

필드의 개요

static int	CHARACTER 꺼낼 필요가 있는 텍스트의 일부가 캐릭터인 것을 나타내는데 사용하는 정수입니다.
static int	SENTENCE 꺼낼 필요가 있는 텍스트의 일부가 문장인 것을 나타내는데 사용하는 정수입니다.
static int	WORD 꺼낼 필요가 있는 텍스트의 일부가 단어인 것을 나타내는데 사용하는 정수입니다.

메소드의 개요

String	getAfterIndex (int part, int index) 지정된 인덱스의 뒤의 캐릭터 라인을 돌려줍니다.
String	getAtIndex (int part, int index) 지정된 인덱스에서의 캐릭터 라인을 돌려줍니다.
String	getBeforeIndex (int part, int index) 지정된 인덱스의 전의 캐릭터 라인을 돌려줍니다.
int	getCaretPosition () caret의 제로로부터 시작되는 오프셋(offset)를 돌려줍니다.
AttributeSet	getCharacterAttribute (int i) 지정된 인덱스의 위치에 있는 지정된 캐릭터의 AttributeSet 를 돌려줍니다.
Rectangle	getCharacterBounds (int i) 지정된 캐릭터 라인의 인덱스의 위치에 있는 캐릭터의 바운딘그복스를 판정합니다.
int	getCharCount () 캐릭터의 수를 돌려줍니다 (유효한 인덱스).
int	getIndexAtPoint (Point p) 로컬 오프셋(offset)로 포인트를 지정해, 그 Point 하의 캐릭터의 제로로부터 시작되는 인덱스를 돌려줍니다.
String	getSelectedText () 선택되고 있는 텍스트의 일부를 돌려줍니다.
int	getSelectionEnd () 선택되고 있는 텍스트내에서의 종료 오프셋(offset)를 돌려줍니다.
int	getSelectionStart () 선택되고 있는 텍스트내에서의 개시 오프셋(offset)를 돌려줍니다.

필드의 상세

CHARACTER

public static final int CHARACTER

꺼낼 필요가 있는 텍스트의 일부가 캐릭터인 것을 나타내는데 사용하는 정수입니다.

관련 항목:

getAtIndex(int, int) , getAfterIndex(int, int) , getBeforeIndex(int, int) , 정수 필드치

WORD

public static final int WORD

꺼낼 필요가 있는 텍스트의 일부가 단어인 것을 나타내는데 사용하는 정수입니다.

관련 항목:

getAtIndex(int, int) , getAfterIndex(int, int) , getBeforeIndex(int, int) , 정수 필드치

SENTENCE

public static final int SENTENCE

꺼낼 필요가 있는 텍스트의 일부가 문장인 것을 나타내는데 사용하는 정수입니다.

관련 항목:

getAtIndex(int, int) , getAfterIndex(int, int) , getBeforeIndex(int, int) , 정수 필드치

메소드의 상세

getIndexAtPoint

public int getIndexAtPoint(Point  p)

로컬 오프셋(offset)로 포인트를 지정해, 그 Point 하의 캐릭터의 제로로부터 시작되는 인덱스를 돌려줍니다. 포인트가 무효인 경우, 이 메소드는 -1 을 돌려줍니다.

파라미터:

p - 로컬 오프셋(offset)의 Point

반환값:

Point p 에 있는 캐릭터의 제로로부터 시작되는 인덱스. Point 가 무효인 경우는 -1 을 돌려준다

getCharacterBounds

public Rectangle  getCharacterBounds(int i)

지정된 캐릭터 라인의 인덱스의 위치에 있는 캐릭터의 바운딘그복스를 판정합니다. 경계는 로컬 오프셋(offset)로 돌려주어집니다. 인덱스가 무효인 경우, 하늘의 구형이 돌려주어집니다.

파라미터:

i - String 에 대한 인덱스

반환값:

캐릭터의 바운딘그복스의 화면 오프셋(offset). 인덱스가 무효인 경우는 하늘의 구형을 돌려준다

getCharCount

public int getCharCount()

캐릭터의 수를 돌려줍니다 (유효한 인덱스).

반환값:

캐릭터수

getCaretPosition

public int getCaretPosition()

caret의 제로로부터 시작되는 오프셋(offset)를 돌려줍니다. 주: caret의 우측에서는 오프셋(offset)치와 인덱스치가 같게 됩니다. caret는 2 개의 캐릭터의 사이에 있습니다.

반환값:

caret의 제로로부터 시작되는 오프셋(offset)

getAtIndex

public String  getAtIndex(int part,
                         int index)

지정된 인덱스에서의 캐릭터 라인을 돌려줍니다.

파라미터:

part - 꺼내는 CHARACTER, WORD, 또는 SENTENCE

index - 텍스트내의 캐릭터 인덱스

반환값:

캐릭터, 단어, 또는 문장

getAfterIndex

public String  getAfterIndex(int part,
                            int index)

지정된 인덱스의 뒤의 캐릭터 라인을 돌려줍니다.

파라미터:

part - 꺼내는 CHARACTER, WORD, 또는 SENTENCE

index - 텍스트내의 캐릭터 인덱스

반환값:

캐릭터, 단어, 또는 문장

getBeforeIndex

public String  getBeforeIndex(int part,
                             int index)

지정된 인덱스의 전의 캐릭터 라인을 돌려줍니다.

파라미터:

part - 꺼내는 CHARACTER, WORD, 또는 SENTENCE

index - 텍스트내의 캐릭터 인덱스

반환값:

캐릭터, 단어, 또는 문장

getCharacterAttribute

public AttributeSet  getCharacterAttribute(int i)

지정된 인덱스의 위치에 있는 지정된 캐릭터의 AttributeSet 를 돌려줍니다.

파라미터:

i - 텍스트에 대한 제로로부터 시작되는 인덱스

반환값:

캐릭터의 AttributeSet

getSelectionStart

public int getSelectionStart()

선택되고 있는 텍스트내에서의 개시 오프셋(offset)를 돌려줍니다. 선택되고 있는 텍스트가 없고, caret는 있는 경우는 개시 오프셋(offset)와 종료 오프셋(offset)는 같게 됩니다.

반환값:

선택 범위의 선두의 텍스트에 대한 인덱스

getSelectionEnd

public int getSelectionEnd()

선택되고 있는 텍스트내에서의 종료 오프셋(offset)를 돌려줍니다. 선택되고 있는 텍스트가 없고, caret는 있는 경우는 개시 오프셋(offset)와 종료 오프셋(offset)는 같게 됩니다.

반환값:

선택 범위의 말미의 텍스트에 대한 인덱스

getSelectedText

public String  getSelectedText()

선택되고 있는 텍스트의 일부를 돌려줍니다.

반환값:

선택되고 있는 텍스트의 String 부분