模块 java.desktop
包 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 的实现。

Warning: 此类的序列化对象将与未来的 Swing 版本不兼容。当前的序列化支持适用于运行相同版本 Swing 的应用程序之间的短期存储或 RMI。从 1.4 开始，对所有 JavaBeans 的长期存储的支持已添加到 java.beans 包中。请参阅 XMLEncoder 。

  • 构造方法详细信息

    • AccessibleJText组件

      public AccessibleJTextComponent()
      构造一个 AccessibleJTextComponent。添加一个监听来跟踪插入符号的变化。

  • 方法详情

    • caretUpdate

      public void caretUpdate(CaretEvent  e)
      处理插入符更新（触发适当的属性更改事件，即 AccessibleContext.ACCESSIBLE_CARET_PROPERTY 和 AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY）。这会在内部跟踪点位置。当插入符号移动时，内部位置会在触发事件后更新。
      指定者：
      caretUpdate 在接口 CaretListener 中
      参数：
      e - CaretEvent

    • insertUpdate

      public void insertUpdate(DocumentEvent  e)
      处理文档插入（触发适当的属性更改事件，即 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。这通过事件跟踪更改的偏移量。
      指定者：
      insertUpdate 在接口 DocumentListener 中
      参数：
      e - 文档事件

    • removeUpdate

      public void removeUpdate(DocumentEvent  e)
      处理文档删除（触发适当的属性更改事件，即 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。这通过事件跟踪更改的偏移量。
      指定者：
      removeUpdate 在接口 DocumentListener 中
      参数：
      e - 文档事件

    • changedUpdate

      public void changedUpdate(DocumentEvent  e)
      处理文档删除（触发适当的属性更改事件，即 AccessibleContext.ACCESSIBLE_TEXT_PROPERTY）。这通过事件跟踪更改的偏移量。
      指定者：
      changedUpdate 在接口 DocumentListener 中
      参数：
      e - 文档事件

    • getAccessibleStateSet

      public AccessibleStateSet  getAccessibleStateSet()
      获取 JTextComponent 的状态集。对象的 AccessibleStateSet 由一组唯一的 AccessibleState 组成。对象的 AccessibleStateSet 中的更改将导致针对 AccessibleContext.ACCESSIBLE_STATE_PROPERTY 属性触发 PropertyChangeEvent。
      重写：
      getAccessibleStateSet 在类 JComponent.AccessibleJComponent 中
      返回：
      包含对象当前状态集的 AccessibleStateSet 实例
      参见：

    • getAccessibleRole

      public AccessibleRole  getAccessibleRole()
      获取此对象的角色。
      重写：
      getAccessibleRole 在类 JComponent.AccessibleJComponent 中
      返回：
      描述对象角色的 AccessibleRole 实例 (AccessibleRole.TEXT)
      参见：

    • getAccessibleText

      public AccessibleText  getAccessibleText()
      获取与此对象关联的 AccessibleText。在为该类实现Java Accessibility API时，返回该对象，该对象负责代表自身实现AccessibleText接口。
      重写：
      getAccessibleText 在类 AccessibleContext 中
      返回：
      这个对象
      参见：

    • getIndexAtPoint

      public int getIndexAtPoint(Point  p)
      给定局部坐标中的一个点，返回该点下字符的从零开始的索引。如果该点无效，则此方法返回 -1。
      指定者：
      getIndexAtPoint 在接口 AccessibleText 中
      参数：
      p - 本地坐标中的点
      返回：
      点 p 下字符的从零开始的索引。

    • getCharacterBounds

      public Rectangle  getCharacterBounds(int i)
      确定字符串中给定索引处字符的边界框。边界以局部坐标返回。如果索引无效，则返回一个空矩形。如果 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 必须有一个有效的大小（例如，已经被添加到一个父容器，其祖先容器是一个有效的顶级窗口）才能使这个方法能够返回一个有意义的（非空）值。
      指定者：
      getCharacterBounds 在接口 AccessibleText 中
      参数：
      i - String ≥ 0 的索引
      返回：
      角色边界框的屏幕坐标

    • getCharCount

      public int getCharCount()
      返回字符数（有效索引）
      指定者：
      getCharCount 在接口 AccessibleText 中
      返回：
      字符数≥0

    • getCaretPosition

      public int getCaretPosition()
      返回插入符号从零开始的偏移量。注意：插入符号右侧的字符将具有与偏移量相同的索引值（插入符号位于两个字符之间）。
      指定者：
      getCaretPosition 在接口 AccessibleText 中
      返回：
      插入符号从零开始的偏移量。

    • getCharacterAttribute

      public AttributeSet  getCharacterAttribute(int i)
      返回给定字符（在给定索引处）的 AttributeSet。
      指定者：
      getCharacterAttribute 在接口 AccessibleText 中
      参数：
      i - 从零开始的文本索引
      返回：
      角色的属性集

    • getSelectionStart

      public int getSelectionStart()
      返回所选文本中的起始偏移量。如果没有选择，但有插入符号，则开始和结束偏移量将相同。如果文本为空，则返回 0，如果没有选择，则返回插入符号位置。
      指定者：
      getSelectionStart 在接口 AccessibleText 中
      返回：
      所选内容开头文本的索引 ≥ 0

    • getSelectionEnd

      public int getSelectionEnd()
      返回所选文本中的结束偏移量。如果没有选择，但有插入符号，则开始和结束偏移量将相同。如果文本为空，则返回 0，如果没有选择，则返回插入符号位置。
      指定者：
      getSelectionEnd 在接口 AccessibleText 中
      返回：
      选择结束的文本索引 ≥ 0

    • getSelectedText

      public String  getSelectedText()
      返回选定的文本部分。
      指定者：
      getSelectedText 在接口 AccessibleText 中
      返回：
      文本，如果没有选择则为 null

    • getAtIndex

      public String  getAtIndex(int part, int index)
      返回给定索引处的字符串。单词之间的空格被视为一个单词。
      指定者：
      getAtIndex 在接口 AccessibleText 中
      参数：
      part - 要检索的字符、单词或句子
      index - 文本中的索引
      返回：
      字母、单词或句子。

    • getAfterIndex

      public String  getAfterIndex(int part, int index)
      返回给定索引后的字符串。单词之间的空格被视为一个单词。
      指定者：
      getAfterIndex 在接口 AccessibleText 中
      参数：
      part - 要检索的字符、单词或句子
      index - 文本中的索引
      返回：
      字母、单词或句子。

    • getBeforeIndex

      public String  getBeforeIndex(int part, int index)
      返回给定索引之前的字符串。单词之间的空格被视为一个单词。
      指定者：
      getBeforeIndex 在接口 AccessibleText 中
      参数：
      part - 要检索的字符、单词或句子
      index - 文本中的索引
      返回：
      字母、单词或句子。

    • getAccessibleEditableText

      public AccessibleEditableText  getAccessibleEditableText()
      返回此文本组件的 AccessibleEditableText 接口。
      重写：
      getAccessibleEditableText 在类 AccessibleContext 中
      返回：
      AccessibleEditableText 接口
      自从：
      1.4
      参见：

    • setTextContents

      public void setTextContents(String  s)
      将文本内容设置为指定的字符串。
      指定者：
      setTextContents 在接口 AccessibleEditableText 中
      参数：
      s - 设置文本内容的字符串
      自从：
      1.4

    • insertTextAtIndex

      public void insertTextAtIndex(int index, String  s)
      在给定索引处插入指定字符串
      指定者：
      insertTextAtIndex 在接口 AccessibleEditableText 中
      参数：
      index - 文本中将插入字符串的索引
      s - 要在文本中插入的字符串
      自从：
      1.4

    • getTextRange

      public String  getTextRange(int startIndex, int endIndex)
      返回两个索引之间的文本字符串。
      指定者：
      getTextRange 在接口 AccessibleEditableText 中
      指定者：
      getTextRange 在接口 AccessibleExtendedText 中
      参数：
      startIndex - 文本中的起始索引
      endIndex - 文本中的结束索引
      返回：
      索引之间的文本字符串
      自从：
      1.4

    • delete

      public void delete(int startIndex, int endIndex)
      删除两个索引之间的文本
      指定者：
      delete 在接口 AccessibleEditableText 中
      参数：
      startIndex - 文本中的起始索引
      endIndex - 文本中的结束索引
      自从：
      1.4

    • cut

      public void cut(int startIndex, int endIndex)
      将两个索引之间的文本剪切到系统剪贴板中。
      指定者：
      cut 在接口 AccessibleEditableText 中
      参数：
      startIndex - 文本中的起始索引
      endIndex - 文本中的结束索引
      自从：
      1.4

    • paste

      public void paste(int startIndex)
      将系统剪贴板中的文本粘贴到指定索引处开始的文本中。
      指定者：
      paste 在接口 AccessibleEditableText 中
      参数：
      startIndex - 文本中的起始索引
      自从：
      1.4

    • replaceText

      public void replaceText(int startIndex, int endIndex, String  s)
      用指定的字符串替换两个索引之间的文本。
      指定者：
      replaceText 在接口 AccessibleEditableText 中
      参数：
      startIndex - 文本中的起始索引
      endIndex - 文本中的结束索引
      s - 替换两个索引之间文本的字符串
      自从：
      1.4

    • selectText

      public void selectText(int startIndex, int endIndex)
      选择两个索引之间的文本。
      指定者：
      selectText 在接口 AccessibleEditableText 中
      参数：
      startIndex - 文本中的起始索引
      endIndex - 文本中的结束索引
      自从：
      1.4

    • setAttributes

      public void setAttributes(int startIndex, int endIndex, AttributeSet  as)
      为两个索引之间的文本设置属性。
      指定者：
      setAttributes 在接口 AccessibleEditableText 中
      参数：
      startIndex - 文本中的起始索引
      endIndex - 文本中的结束索引
      as - 属性集
      自从：
      1.4
      参见：

    • getTextSequenceAt

      public AccessibleTextSequence  getTextSequenceAt(int part, int index)
      返回给定 index 处的 AccessibleTextSequence。
      指定者：
      getTextSequenceAt 在接口 AccessibleExtendedText 中
      参数：
      part - 要检索的 CHARACTER、WORD、SENTENCE、LINE 或 ATTRIBUTE_RUN
      index - 文本中的索引
      返回：
      如果 part 和 index 有效，则 AccessibleTextSequence 指定文本。否则返回 null
      自从：
      1.6
      参见：

    • getTextSequenceAfter

      public AccessibleTextSequence  getTextSequenceAfter(int part, int index)
      在给定的 index 之后返回 AccessibleTextSequence。
      指定者：
      getTextSequenceAfter 在接口 AccessibleExtendedText 中
      参数：
      part - 要检索的 CHARACTER、WORD、SENTENCE、LINE 或 ATTRIBUTE_RUN
      index - 文本中的索引
      返回：
      如果 part 和 index 有效，则 AccessibleTextSequence 指定文本。否则返回 null
      自从：
      1.6
      参见：

    • getTextSequenceBefore

      public AccessibleTextSequence  getTextSequenceBefore(int part, int index)
      在给定的 index 之前返回 AccessibleTextSequence。
      指定者：
      getTextSequenceBefore 在接口 AccessibleExtendedText 中
      参数：
      part - 要检索的 CHARACTER、WORD、SENTENCE、LINE 或 ATTRIBUTE_RUN
      index - 文本中的索引
      返回：
      如果 part 和 index 有效，则 AccessibleTextSequence 指定文本。否则返回 null
      自从：
      1.6
      参见：

    • getTextBounds

      public Rectangle  getTextBounds(int startIndex, int endIndex)
      返回包含两个索引之间文本的 Rectangle。
      指定者：
      getTextBounds 在接口 AccessibleExtendedText 中
      参数：
      startIndex - 文本中的起始索引
      endIndex - 文本中的结束索引
      返回：
      如果索引有效，则为文本的边界矩形。否则返回 null
      自从：
      1.6

    • getAccessibleActionCount

      public int getAccessibleActionCount()
      返回此对象中可用的可访问操作的数量如果有多个，则第一个被认为是对象的“默认”操作。
      指定者：
      getAccessibleActionCount 在接口 AccessibleAction 中
      返回：
      此对象中从零开始的操作数
      自从：
      1.4

    • getAccessibleActionDescription

      public String  getAccessibleActionDescription(int i)
      返回对象的指定操作的描述。
      指定者：
      getAccessibleActionDescription 在接口 AccessibleAction 中
      参数：
      i - 动作的从零开始的索引
      返回：
      操作的字符串描述
      自从：
      1.4
      参见：

    • doAccessibleAction

      public boolean doAccessibleAction(int i)
      对对象执行指定的操作
      指定者：
      doAccessibleAction 在接口 AccessibleAction 中
      参数：
      i - 从零开始的动作索引
      返回：
      如果执行了操作，则为真；否则为假。
      自从：
      1.4
      参见：