JavaTM Platform
Standard Ed. 6

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 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 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 必须具有一个有效大小(例如,它已被添加到其祖先容器是有效顶级窗口的父容器中),以便此方法能够返回一个有意义的(非空)值。

指定者:
接口 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 - 要获取的 CHARACTERWORDSENTENCELINEATTRIBUTE_RUN
index - 文本中的索引
返回:
如果 partindex 有效,则返回指定文本的 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 - 要获取的 CHARACTERWORDSENTENCELINEATTRIBUTE_RUN
index - 文本中的索引
返回:
如果 partindex 有效,则返回指定文本的 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 - 要获取的 CHARACTERWORDSENTENCELINEATTRIBUTE_RUN
index - 文本中的索引
返回:
如果 partindex 有效,则返回指定文本的 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()

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策