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。

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 必须具有一个有效大小（例如，它已被添加到其祖先容器是有效顶级窗口的父容器中），以便此方法能够返回一个有意义的（非空）值。

指定者：

接口 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()

版权所有 2008 Sun Microsystems, Inc. 保留所有权利。请遵守GNU General Public License, version 2 only。