javax.accessibility
인터페이스 AccessibleText

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

AccessibleEditableText , AccessibleHypertext

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

AbstractButton.AccessibleAbstractButton , JButton.AccessibleJButton , JCheckBox.AccessibleJCheckBox , JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem , JEditorPane.AccessibleJEditorPane , JEditorPane.AccessibleJEditorPaneHTML , JEditorPane.JEditorPaneAccessibleHypertextSupport , JLabel.AccessibleJLabel , JMenu.AccessibleJMenu , JMenuItem.AccessibleJMenuItem , JPasswordField.AccessibleJPasswordField , JRadioButton.AccessibleJRadioButton , JRadioButtonMenuItem.AccessibleJRadioButtonMenuItem , JSpinner.AccessibleJSpinner , JTextArea.AccessibleJTextArea , JTextComponent.AccessibleJTextComponent , JTextField.AccessibleJTextField , JToggleButton.AccessibleJToggleButton , ProgressMonitor.AccessibleProgressMonitor , TextArea.AccessibleAWTTextArea , TextComponent.AccessibleAWTTextComponent , TextField.AccessibleAWTTextField

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) 로컬 좌표로 포인트를 지정해, 그 Point 하의 문자의 제로로부터 시작되는 인덱스를 돌려줍니다.
String	getSelectedText () 선택되고 있는 텍스트의 일부를 돌려줍니다.
int	getSelectionEnd () 선택한 텍스트내의 종료 오프셋(offset)를 돌려줍니다.
int	getSelectionStart () 선택한 텍스트내의 개시 오프셋(offset)를 돌려줍니다.

필드의 상세

CHARACTER

static final int CHARACTER

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

관련 항목:

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

WORD

static final int WORD

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

관련 항목:

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

SENTENCE

static final int SENTENCE

꺼낼 필요가 있는 텍스트의 일부가 문장인 것을 나타내는데 사용하는 정수입니다. 문장이란, 주장, 질문, 명령, 소망, 감탄, 행위의 실행등을 표현한다, 단어로부터 완성되는 캐릭터 라인입니다. 영어 로케일의 경우, 캐릭터 라인은 일반적으로 대문자로 시작되어, 피리어드, 물음표, 감탄부등이 적절한 구두점으로써 끝납니다. 다른 로케일에서는, 대문자 사용이나 구두점이 다른 경우가 있습니다.

관련 항목:

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

메소드의 상세

getIndexAtPoint

int getIndexAtPoint(Point  p)

로컬 좌표로 포인트를 지정해, 그 Point 하의 문자의 제로로부터 시작되는 인덱스를 돌려줍니다. 포인트가 무효인 경우, 이 메소드는 -1 을 돌려줍니다.

파라미터:

p - 로컬 좌표의 Point

반환값:

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

getCharacterBounds

Rectangle  getCharacterBounds(int i)

캐릭터 라인에 대한 지정된 인덱스로 문자의 바운딩 박스를 결정합니다. 이 바운딩 박스는 로컬 좌표로 돌려주어집니다. 인덱스가 무효인 경우, 빈 상태(empty)의 구형이 돌려주어집니다.

파라미터:

i - String 에 대한 인덱스

반환값:

문자의 바운딩 박스의 화면 좌표. 인덱스가 무효인 경우는 빈 상태(empty)의 구형을 돌려준다

getCharCount

int getCharCount()

문자의 수를 돌려줍니다 (유효한 인덱스).

반환값:

문자수

getCaretPosition

int getCaretPosition()

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

반환값:

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

getAtIndex

String  getAtIndex(int part,
                  int index)

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

파라미터:

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

index - 텍스트내의 문자 인덱스

반환값:

문자, 단어, 또는 문장

getAfterIndex

String  getAfterIndex(int part,
                     int index)

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

파라미터:

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

index - 텍스트내의 문자 인덱스

반환값:

문자, 단어, 또는 문장

getBeforeIndex

String  getBeforeIndex(int part,
                      int index)

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

파라미터:

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

index - 텍스트내의 문자 인덱스

반환값:

문자, 단어, 또는 문장

getCharacterAttribute

AttributeSet  getCharacterAttribute(int i)

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

파라미터:

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

반환값:

문자의 AttributeSet

getSelectionStart

int getSelectionStart()

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

반환값:

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

getSelectionEnd

int getSelectionEnd()

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

반환값:

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

getSelectedText

String  getSelectedText()

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

반환값:

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