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。
String	getAtIndex(int part, int index) 返回給定索引處的 String。
String	getBeforeIndex(int part, int index) 返回給定索引前面的 String。
int	getCaretPosition() 返回插入符從 0 開始的偏移量。
AttributeSet	getCharacterAttribute(int i) 返回給定索引處給定字元的 AttributeSet
Rectangle	getCharacterBounds(int i) 確定字元串中給定索引處的字元的邊界框。
int	getCharCount() 返回字元（有效索引）數
int	getIndexAtPoint(Point p) 給定本地坐標中的一點，返回在該點下的字元從 0 開始的索引。
String	getSelectedText() 返回選定的部分文本。
int	getSelectionEnd() 返回選定文本中的結束偏移量。
int	getSelectionStart() 返回選定文本中的起始偏移量。

欄位詳細資訊

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

用於指示應獲取的文本部分是一個語句的常數。 句子是表示陳述、疑問、命令、希望、感歎或執行動作的單詞字元串。在 English 語言環境下，該字元串通常以大寫字母開始，以適當結束標點符號（如句號、問號或感歎號）結束。其他語言環境使用不同的大寫和/或標點符號。

另請參見：

getAtIndex(int, int), getAfterIndex(int, int), getBeforeIndex(int, int), 常數欄位值

方法詳細資訊

getIndexAtPoint

int getIndexAtPoint(Point p)

給定本地坐標中的一點，返回在該點下的字元從 0 開始的索引。如果該點無效，則此方法返回 -1。

參數：

p - 本地坐標中的點

返回：

點 p 處字元從 0 開始的索引；如果該點無效，則返回 -1。

getCharacterBounds

Rectangle getCharacterBounds(int i)

確定字元串中給定索引處的字元的邊界框。以本地坐標形式返回邊界。如果索引無效，則返回一個空的矩形。

參數：

i - String 中的索引

返回：

字元邊界框的螢幕坐標；如果索引無效，則返回一個空矩形。

getCharCount

int getCharCount()

返回字元（有效索引）數

返回：

字元數

getCaretPosition

int getCaretPosition()

返回插入符從 0 開始的偏移量。 註：這表示插入符的右邊與偏移量有相同的索引值（插入符在兩個字元之間）。

返回：

插入符從 0 開始的偏移量。

getAtIndex

String getAtIndex(int part,
                  int index)

返回給定索引處的 String。

參數：

part - 要獲取的 CHARACTER、WORD 或 SENTENCE

index - 文本中的索引

返回：

字母、單詞或句子

getAfterIndex

String getAfterIndex(int part,
                     int index)

返回給定索引後面的 String。

參數：

part - 要獲取的 CHARACTER、WORD 或 SENTENCE

index - 文本中的索引

返回：

字母、單詞或句子

getBeforeIndex

String getBeforeIndex(int part,
                      int index)

返回給定索引前面的 String。

參數：

part - 要獲取的 CHARACTER、WORD 或 SENTENCE

index - 文本中的索引

返回：

字母、單詞或句子

getCharacterAttribute

AttributeSet getCharacterAttribute(int i)

返回給定索引處給定字元的 AttributeSet

參數：

i - 文本中從 0 開始的索引

返回：

字元的 AttributeSet

getSelectionStart

int getSelectionStart()

返回選定文本中的起始偏移量。如果沒有選定的文本，但有一個插入符，則起始偏移量和結束偏移量將是相同的。

返回：

選定文本起始處的索引

getSelectionEnd

int getSelectionEnd()

返回選定文本中的結束偏移量。如果沒有選定的文本，但有一個插入符，則起始偏移量和結束偏移量將是相同的。

返回：

選定文本結尾處的索引

getSelectedText

String getSelectedText()

返回選定的部分文本。

返回：

選定文本的 String 部分