JavaTM 2 Platform
Standard Ed. 5.0

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()
          返回从零开始的插入符偏移量。
 AttributeSet getCharacterAttribute(int i)
          返回给定索引处给定字符的 AttributeSet
 Rectangle getCharacterBounds(int i)
          确定字符串中给定索引处的字符的边界框。
 int getCharCount()
          返回字符(有效索引)数
 int getIndexAtPoint(Point p)
          给定本地坐标中的一点,返回在该 Point 下的字符从零开始的索引。
 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
用于指示应被检索的文本部分是一个语句的常量。

另请参见:
getAtIndex(int, int), getAfterIndex(int, int), getBeforeIndex(int, int), 常量字段值
方法详细信息

getIndexAtPoint

int getIndexAtPoint(Point p)
给定本地坐标中的一点,返回在该 Point 下的字符从零开始的索引。如果该点无效,则此方法返回 -1。

参数:
p - 本地坐标中的点
返回:
点 p 处字符从零开始的索引,如果该点无效则返回 -1。

getCharacterBounds

Rectangle getCharacterBounds(int i)
确定字符串中给定索引处的字符的边界框。以本地坐标形式返回边界。如果索引无效,则返回一个空的矩形。

参数:
i - 对 String 的索引
返回:
字符边界框的屏幕坐标,如果索引无效,则返回一个空矩形。

getCharCount

int getCharCount()
返回字符(有效索引)数

返回:
字符数

getCaretPosition

int getCaretPosition()
返回从零开始的插入符偏移量。 注:这表示插入符的右边与偏移量(插入符在两个字符之间)有相同的索引值。

返回:
插入符的从零开始的偏移量。

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 - 文本中从零开始的索引
返回:
字符的 AttributeSet

getSelectionStart

int getSelectionStart()
返回选定文本中的起始偏移量。如果没有选定的文本,但有一个插入符,则起始偏移量和结束偏移量是相同的。

返回:
所选定文本开始处的索引

getSelectionEnd

int getSelectionEnd()
返回选定文本中的结束偏移量。如果没有选定的文本,但有一个插入符,则起始偏移量和结束偏移量是相同的。

返回:
所选定文本结尾的索引

getSelectedText

String getSelectedText()
返回选中的部分文本。

返回:
选定文本的 String 部分

JavaTM 2 Platform
Standard Ed. 5.0

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

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