javax.swing.text
類別 JTextComponent.AccessibleJTextComponent

java.lang.Object
  javax.accessibility.AccessibleContext
      java.awt.Component.AccessibleAWTComponent
          java.awt.Container.AccessibleAWTContainer
              javax.swing.JComponent.AccessibleJComponent
                  javax.swing.text.JTextComponent.AccessibleJTextComponent

所有已實作的介面：

Serializable, EventListener, AccessibleAction, AccessibleComponent, AccessibleEditableText, AccessibleExtendedComponent, AccessibleExtendedText, AccessibleText, CaretListener, DocumentListener

直接已知子類別：

JEditorPane.AccessibleJEditorPane, JTextArea.AccessibleJTextArea, JTextField.AccessibleJTextField

正在封閉類別：

JTextComponent

public class JTextComponent.AccessibleJTextComponent
extends JComponent.AccessibleJComponent
implements AccessibleText, CaretListener, DocumentListener, AccessibleAction, AccessibleEditableText, AccessibleExtendedText

此類別實作 JTextComponent 類別的可存取性支持。它提供適合選單使用者介面元素的 Java Accessibility API 的實作。

警告：此類別的已序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲或運行相同 Swing 版本的應用程序之間的 RMI。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

巢狀類別摘要

從類別 javax.swing.JComponent.AccessibleJComponent 繼承的巢狀類別/介面

JComponent.AccessibleJComponent.AccessibleContainerHandler, JComponent.AccessibleJComponent.AccessibleFocusHandler

從類別 java.awt.Component.AccessibleAWTComponent 繼承的巢狀類別/介面

Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler

欄位摘要

從類別 javax.swing.JComponent.AccessibleJComponent 繼承的欄位

accessibleContainerHandler, accessibleFocusHandler

從類別 java.awt.Component.AccessibleAWTComponent 繼承的欄位

accessibleAWTComponentHandler, accessibleAWTFocusHandler

從類別 javax.accessibility.AccessibleContext 繼承的欄位

ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent

從介面 javax.accessibility.AccessibleAction 繼承的欄位

CLICK, DECREMENT, INCREMENT, TOGGLE_EXPAND, TOGGLE_POPUP

從介面 javax.accessibility.AccessibleText 繼承的欄位

CHARACTER, SENTENCE, WORD

從介面 javax.accessibility.AccessibleExtendedText 繼承的欄位

ATTRIBUTE_RUN, LINE

建構子摘要

JTextComponent.AccessibleJTextComponent()
建構 AccessibleJTextComponent。

方法摘要

void	caretUpdate(CaretEvent e) 處理插入符更新（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_CARET_PROPERTY 和 AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY）。
void	changedUpdate(DocumentEvent e) 處理文檔移除（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。
void	cut(int startIndex, int endIndex) 將兩個索引之間的文本剪切到系統剪貼板中。
void	delete(int startIndex, int endIndex) 刪除兩個索引之間的文本
boolean	doAccessibleAction(int i) 對該物件執行指定的 Action
AccessibleAction	getAccessibleAction() 獲取與此物件關聯的可支持一個或多個動作的 AccessibleAction。
int	getAccessibleActionCount() 返回此物件中可用的可存取操作的數目，如果多於一個，則第一個視為該物件的“預設”操作。
String	getAccessibleActionDescription(int i) 返回對該物件的指定操作的描述。
AccessibleEditableText	getAccessibleEditableText() 返回此文本元件的 AccessibleEditableText 介面。
AccessibleRole	getAccessibleRole() 獲取此物件的職責。
AccessibleStateSet	getAccessibleStateSet() 獲取 JTextComponent 的狀態設置。
AccessibleText	getAccessibleText() 獲取與此物件關聯的 AccessibleText。
String	getAfterIndex(int part, int index) 返回給定索引之後的 String。
String	getAtIndex(int part, int index) 返回給定索引處的 String。
String	getBeforeIndex(int part, int index) 返回給定索引之前的 String。
int	getCaretPosition() 返回插入符的從零開始的偏移量。
AttributeSet	getCharacterAttribute(int i) 返回給定字元（位於給定索引處）的 AttributeSet。
Rectangle	getCharacterBounds(int i) 確定字元串中給定索引處的字元的邊界框。
int	getCharCount() 返回字元（有效索引）的數量
int	getIndexAtPoint(Point p) 在本地坐標中給出一個點，返回該 Point 之下的、從零開始的字元索引。
String	getSelectedText() 返回選定文本的某一部分。
int	getSelectionEnd() 返回選定文本中的結束偏移量。
int	getSelectionStart() 返回選定文本中的起始偏移量。
Rectangle	getTextBounds(int startIndex, int endIndex) 返回包圍兩個索引之間文本的 Rectangle。
String	getTextRange(int startIndex, int endIndex) 返回兩個索引之間的文本字元串。
AccessibleTextSequence	getTextSequenceAfter(int part, int index) 返回給定 index 之後的 AccessibleTextSequence。
AccessibleTextSequence	getTextSequenceAt(int part, int index) 返回給定 index 處的 AccessibleTextSequence。
AccessibleTextSequence	getTextSequenceBefore(int part, int index) 返回給定 index 之前的 AccessibleTextSequence。
void	insertTextAtIndex(int index, String s) 在給定索引處插入指定字元串
void	insertUpdate(DocumentEvent e) 處理文檔插入（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。
void	paste(int startIndex) 將系統剪貼板中的文本粘貼到指定索引的文本開始處。
void	removeUpdate(DocumentEvent e) 處理文檔移除（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。
void	replaceText(int startIndex, int endIndex, String s) 使用指定字元串替換兩個索引之間的文本。
void	selectText(int startIndex, int endIndex) 選擇兩個索引之間的文本。
void	setAttributes(int startIndex, int endIndex, AttributeSet as) 設置兩個索引之間的文本的屬性。
void	setTextContents(String s) 將文本內容設置為指定字元串。

從類別 javax.swing.JComponent.AccessibleJComponent 繼承的方法

addPropertyChangeListener, getAccessibleChild, getAccessibleChildrenCount, getAccessibleDescription, getAccessibleKeyBinding, getAccessibleName, getBorderTitle, getTitledBorderText, getToolTipText, removePropertyChangeListener

從類別 java.awt.Container.AccessibleAWTContainer 繼承的方法

getAccessibleAt

從類別 java.awt.Component.AccessibleAWTComponent 繼承的方法

addFocusListener, contains, getAccessibleComponent, getAccessibleIndexInParent, getAccessibleParent, getBackground, getBounds, getCursor, getFont, getFontMetrics, getForeground, getLocale, getLocation, getLocationOnScreen, getSize, isEnabled, isFocusTraversable, isShowing, isVisible, removeFocusListener, requestFocus, setBackground, setBounds, setCursor, setEnabled, setFont, setForeground, setLocation, setSize, setVisible

從類別 javax.accessibility.AccessibleContext 繼承的方法

firePropertyChange, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

從介面 javax.accessibility.AccessibleComponent 繼承的方法

addFocusListener, contains, getAccessibleAt, getBackground, getBounds, getCursor, getFont, getFontMetrics, getForeground, getLocation, getLocationOnScreen, getSize, isEnabled, isFocusTraversable, isShowing, isVisible, removeFocusListener, requestFocus, setBackground, setBounds, setCursor, setEnabled, setFont, setForeground, setLocation, setSize, setVisible

建構子詳細資訊

JTextComponent.AccessibleJTextComponent

public JTextComponent.AccessibleJTextComponent()

建構 AccessibleJTextComponent。添加追蹤插入符更改的偵聽器。

方法詳細資訊

caretUpdate

public void caretUpdate(CaretEvent e)

處理插入符更新（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_CARET_PROPERTY 和 AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY）。此類別追蹤內部點位置。當插入符移動時，內部位置就會在觸發事件後更新。

指定者：

介面 CaretListener 中的 caretUpdate

參數：

e - CaretEvent

insertUpdate

public void insertUpdate(DocumentEvent e)

處理文檔插入（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。此類別通過事件追蹤更改的偏移量。

指定者：

介面 DocumentListener 中的 insertUpdate

參數：

e - DocumentEvent

removeUpdate

public void removeUpdate(DocumentEvent e)

處理文檔移除（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。此類別通過該事件追蹤更改的偏移量。

指定者：

介面 DocumentListener 中的 removeUpdate

參數：

e - DocumentEvent

changedUpdate

public void changedUpdate(DocumentEvent e)

處理文檔移除（觸發適當的屬性更改事件 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。此類別通過該事件追蹤更改的偏移量。

指定者：

介面 DocumentListener 中的 changedUpdate

參數：

e - DocumentEvent

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

獲取 JTextComponent 的狀態設置。物件的 AccessibleStateSet 是由唯一的 AccessibleState 的集合組成的。物件的 AccessibleStateSet 中的更改將導致為 AccessibleContext.ACCESSIBLE_STATE_PROPERTY 屬性觸發 PropertyChangeEvent。

覆寫：

類別 JComponent.AccessibleJComponent 中的 getAccessibleStateSet

返回：

包含物件的當前狀態設置的 AccessibleStateSet 的實例

另請參見：

AccessibleStateSet, AccessibleState, JComponent.AccessibleJComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleRole

public AccessibleRole getAccessibleRole()

獲取此物件的職責。

覆寫：

類別 JComponent.AccessibleJComponent 中的 getAccessibleRole

返回：

描述物件 (AccessibleRole.TEXT) 職責的 AccessibleRole 實例

另請參見：

AccessibleRole

getAccessibleText

public AccessibleText getAccessibleText()

獲取與此物件關聯的 AccessibleText。在此類別的 Java Accessibility API 實作中，返回此物件，它負責以自己的方式實作 AccessibleText 介面。

覆寫：

類別 AccessibleContext 中的 getAccessibleText

返回：

此物件

另請參見：

AccessibleText

getIndexAtPoint

public int getIndexAtPoint(Point p)

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

指定者：

介面 AccessibleText 中的 getIndexAtPoint

參數：

p - 本地坐標中的 Point

返回：

Point p 之下的、從零開始的字元索引。

getCharacterBounds

public Rectangle getCharacterBounds(int i)

確定字元串中給定索引處的字元的邊界框。以本地坐標形式返回邊界。如果索引無效，則返回一個 null 矩形。 如果 JTextComponent 套件含在 JScrollPane 中（在此情況下，得到的矩形應該由父坐標組成），則返回的螢幕坐標為“不滾動的坐標”。要使用的好演算法是：Accessible a: AccessibleText at = a.getAccessibleText(); AccessibleComponent ac = a.getAccessibleComponent(); Rectangle r = at.getCharacterBounds(); Point p = ac.getLocation(); r.x += p.x; r.y += p.y; 註：JTextComponent 必須具有一個有效大小（例如，它已被添加到其祖先容器是有效頂級視窗的父容器中），以便此方法能夠返回一個有意義的（非空(null)）值。

指定者：

介面 AccessibleText 中的 getCharacterBounds

參數：

i - String 中的索引，該值 >= 0

返回：

字元邊界框的螢幕坐標

getCharCount

public int getCharCount()

返回字元（有效索引）的數量

指定者：

介面 AccessibleText 中的 getCharCount

返回：

字元數，該值 >= 0

getCaretPosition

public int getCaretPosition()

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

指定者：

介面 AccessibleText 中的 getCaretPosition

返回：

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

getCharacterAttribute

public AttributeSet getCharacterAttribute(int i)

返回給定字元（位於給定索引處）的 AttributeSet。

指定者：

介面 AccessibleText 中的 getCharacterAttribute

參數：

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

返回：

字元的 AttributeSet

getSelectionStart

public int getSelectionStart()

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

指定者：

介面 AccessibleText 中的 getSelectionStart

返回：

選擇文本中起始處的索引，該值 >= 0

getSelectionEnd

public int getSelectionEnd()

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

指定者：

介面 AccessibleText 中的 getSelectionEnd

返回：

選擇文本中結束處的索引，該值 >= 0

getSelectedText

public String getSelectedText()

返回選定文本的某一部分。

指定者：

介面 AccessibleText 中的 getSelectedText

返回：

文本，如果沒有選擇文本，則返回 null

getAtIndex

public String getAtIndex(int part,
                         int index)

返回給定索引處的 String。單詞之間的空白視為一個單詞。

指定者：

介面 AccessibleText 中的 getAtIndex

參數：

part - 要獲取的 CHARACTER、WORD 或 SENTENCE

index - 文本中的索引

返回：

字母、單詞或句子

getAfterIndex

public String getAfterIndex(int part,
                            int index)

返回給定索引之後的 String。單詞之間的空白視為一個單詞。

指定者：

介面 AccessibleText 中的 getAfterIndex

參數：

part - 要獲取的 CHARACTER、WORD 或 SENTENCE

index - 文本中的索引

返回：

字母、單詞或句子

getBeforeIndex

public String getBeforeIndex(int part,
                             int index)

返回給定索引之前的 String。單詞之間的空白視為一個單詞。

指定者：

介面 AccessibleText 中的 getBeforeIndex

參數：

part - 要獲取的 CHARACTER、WORD 或 SENTENCE

index - 文本中的索引

返回：

字母、單詞或句子

getAccessibleEditableText

public AccessibleEditableText getAccessibleEditableText()

返回此文本元件的 AccessibleEditableText 介面。

覆寫：

類別 AccessibleContext 中的 getAccessibleEditableText

返回：

該 AccessibleEditableText 介面

從以下版本開始：

1.4

另請參見：

AccessibleEditableText

setTextContents

public void setTextContents(String s)

將文本內容設置為指定字元串。

指定者：

介面 AccessibleEditableText 中的 setTextContents

參數：

s - 要設置文本內容的字元串

從以下版本開始：

1.4

insertTextAtIndex

public void insertTextAtIndex(int index,
                              String s)

在給定索引處插入指定字元串

指定者：

介面 AccessibleEditableText 中的 insertTextAtIndex

參數：

index - 將要插入字元串處的文本索引

s - 要插入文本中的字元串

從以下版本開始：

1.4

getTextRange

public String getTextRange(int startIndex,
                           int endIndex)

返回兩個索引之間的文本字元串。

指定者：

介面 AccessibleEditableText 中的 getTextRange

指定者：

介面 AccessibleExtendedText 中的 getTextRange

參數：

startIndex - 文本中的開始索引

endIndex - 文本中的結尾索引

返回：

兩個索引之間的文本字元串

從以下版本開始：

1.4

delete

public void delete(int startIndex,
                   int endIndex)

刪除兩個索引之間的文本

指定者：

介面 AccessibleEditableText 中的 delete

參數：

startIndex - 文本中的開始索引

endIndex - 文本中的結尾索引

從以下版本開始：

1.4

cut

public void cut(int startIndex,
                int endIndex)

將兩個索引之間的文本剪切到系統剪貼板中。

指定者：

介面 AccessibleEditableText 中的 cut

參數：

startIndex - 文本中的開始索引

endIndex - 文本中的結尾索引

從以下版本開始：

1.4

paste

public void paste(int startIndex)

將系統剪貼板中的文本粘貼到指定索引的文本開始處。

指定者：

介面 AccessibleEditableText 中的 paste

參數：

startIndex - 文本中的開始索引

從以下版本開始：

1.4

replaceText

public void replaceText(int startIndex,
                        int endIndex,
                        String s)

使用指定字元串替換兩個索引之間的文本。

指定者：

介面 AccessibleEditableText 中的 replaceText

參數：

startIndex - 文本中的開始索引

endIndex - 文本中的結尾索引

從以下版本開始：

1.4

selectText

public void selectText(int startIndex,
                       int endIndex)

選擇兩個索引之間的文本。

指定者：

介面 AccessibleEditableText 中的 selectText

參數：

startIndex - 文本中的開始索引

endIndex - 文本中的結尾索引

從以下版本開始：

1.4

setAttributes

public void setAttributes(int startIndex,
                          int endIndex,
                          AttributeSet as)

設置兩個索引之間的文本的屬性。

指定者：

介面 AccessibleEditableText 中的 setAttributes

參數：

startIndex - 文本中的開始索引

endIndex - 文本中的結尾索引

as - 屬性集

從以下版本開始：

1.4

另請參見：

AttributeSet

getTextSequenceAt

public AccessibleTextSequence getTextSequenceAt(int part,
                                                int index)

返回給定 index 處的 AccessibleTextSequence。

指定者：

介面 AccessibleExtendedText 中的 getTextSequenceAt

參數：

part - 要獲取的 CHARACTER、WORD、SENTENCE、LINE 或 ATTRIBUTE_RUN

index - 文本中的索引

返回：

如果 part 和 index 有效，則返回指定文本的 AccessibleTextSequence。否則，返回 null

從以下版本開始：

1.6

另請參見：

AccessibleText.CHARACTER, AccessibleText.WORD, AccessibleText.SENTENCE, AccessibleExtendedText.LINE, AccessibleExtendedText.ATTRIBUTE_RUN

getTextSequenceAfter

public AccessibleTextSequence getTextSequenceAfter(int part,
                                                   int index)

返回給定 index 之後的 AccessibleTextSequence。

指定者：

介面 AccessibleExtendedText 中的 getTextSequenceAfter

參數：

part - 要獲取的 CHARACTER、WORD、SENTENCE、LINE 或 ATTRIBUTE_RUN

index - 文本中的索引

返回：

如果 part 和 index 有效，則返回指定文本的 AccessibleTextSequence。否則，返回 null

從以下版本開始：

1.6

另請參見：

AccessibleText.CHARACTER, AccessibleText.WORD, AccessibleText.SENTENCE, AccessibleExtendedText.LINE, AccessibleExtendedText.ATTRIBUTE_RUN

getTextSequenceBefore

public AccessibleTextSequence getTextSequenceBefore(int part,
                                                    int index)

返回給定 index 之前的 AccessibleTextSequence。

指定者：

介面 AccessibleExtendedText 中的 getTextSequenceBefore

參數：

part - 要獲取的 CHARACTER、WORD、SENTENCE、LINE 或 ATTRIBUTE_RUN

index - 文本中的索引

返回：

如果 part 和 index 有效，則返回指定文本的 AccessibleTextSequence。否則，返回 null

從以下版本開始：

1.6

另請參見：

AccessibleText.CHARACTER, AccessibleText.WORD, AccessibleText.SENTENCE, AccessibleExtendedText.LINE, AccessibleExtendedText.ATTRIBUTE_RUN

getTextBounds

public Rectangle getTextBounds(int startIndex,
                               int endIndex)

返回包圍兩個索引之間文本的 Rectangle。

指定者：

介面 AccessibleExtendedText 中的 getTextBounds

參數：

startIndex - 文本中的開始索引

endIndex - 文本中的結束索引

返回：

如果索引有效，則返回文本的有界矩形。否則，返回 null

從以下版本開始：

1.6

getAccessibleAction

public AccessibleAction getAccessibleAction()

從類別 AccessibleContext 複製的描述

獲取與此物件關聯的可支持一個或多個動作的 AccessibleAction。

覆寫：

類別 AccessibleContext 中的 getAccessibleAction

返回：

如果受物件支持，則返回 AccessibleAction；否則返回 null

另請參見：

AccessibleAction

getAccessibleActionCount

public int getAccessibleActionCount()

返回此物件中可用的可存取操作的數目，如果多於一個，則第一個視為該物件的“預設”操作。

指定者：

介面 AccessibleAction 中的 getAccessibleActionCount

返回：

此物件中從 0 開始的 Action 數

從以下版本開始：

1.4

getAccessibleActionDescription

public String getAccessibleActionDescription(int i)

返回對該物件的指定操作的描述。

指定者：

介面 AccessibleAction 中的 getAccessibleActionDescription

參數：

i - 從 0 開始的操作索引

返回：

該操作的 String 描述

從以下版本開始：

1.4

另請參見：

getAccessibleActionCount()

doAccessibleAction

public boolean doAccessibleAction(int i)

對該物件執行指定的 Action

指定者：

介面 AccessibleAction 中的 doAccessibleAction

參數：

i - 操作的從零開始的索引

返回：

如果執行了該操作，則返回 true；否則，返回 false。

從以下版本開始：

1.4

另請參見：

getAccessibleActionCount()