class QAccessibleTextInterface#

QAccessibleTextInterface 类实现了对文本处理的支持。 更多...

概要

虚拟方法

注意

此文档可能包含来自 C++ 的自动翻译代码片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，您也可以通过在 https:/bugreports.qt.io/projects/PYSIDE 上创建一个工单来告诉我们。

详细描述#

此接口对应于 IAccessibleText 接口。对于显示比普通标签更多文本的小部件，应实现此接口。标签应仅表示为 QAccessibleInterface 并将其文本作为名称（使用 text() 方法并以 Name 作为类型返回）。对于可能逐行读取屏幕阅读器文本的小部件以及支持文本选择和输入的小部件，通常使用 QAccessibleTextInterface。此接口例如在 QLineEdit 中实现。

IAccessible2 规格

abstract addSelection(startOffset, endOffset)#
参数:

  • startOffset – int

  • endOffset – int

从 startOffset 到 endOffset 选择文本。startOffset 是将被选择的第一个字符。而 endOffset 是将不被选择的第一个字符。

当对象支持多个选择时（例如在字处理器中），这将添加一个新的选择，否则它将替换以前的选择。

选择的长度将为 endOffset - startOffset 个字符。

abstract attributes(offset, startOffset, endOffset)#
参数:

  • offset – int

  • startOffset – int

  • endOffset – int

返回类型:

str

返回位置 offset 处的文本属性。同时，属性的范围在 startOffset 和 endOffset 之间返回。

抽象 characterCount()#
返回类型:

int

返回文本长度（包括空格的总大小）。

抽象 characterRect(offset)#
参数:

offset – int

返回类型:

QRect

返回屏幕坐标中位置 offset 的字符的位置和大小。

抽象 cursorPosition()#
返回类型:

int

返回当前光标位置。

另请参阅

setCursorPosition()

抽象 offsetAtPoint(point)#
参数:

point – QPoint

返回类型:

int

返回屏幕坐标中 point 点的字符的偏移量。

抽象 removeSelection(selectionIndex)#
参数:

selectionIndex – int

清除索引为 selectionIndex 的选择。

抽象 scrollToSubstring(startIndex, endIndex)#
参数:

  • startIndex – int

  • endIndex – int

确保从 startIndex 到 endIndex 的文本可见。

抽象 selection(selectionIndex, startOffset, endOffset)#
参数:

  • selectionIndex – int

  • startOffset – int

  • endOffset – int

返回一个选择。选择的大小返回在 startOffset 和 endOffset。如果没有选择，则 startOffset 和 endOffset 都是 None。

辅助功能API支持多选。尽管如此，对于大多数小部件来说，只有通过 selectionIndex 等于0来实现一个选择。

另请参阅

setSelection()

抽象 selectionCount()#
返回类型:

int

返回文本中的选择数量。

抽象 setCursorPosition(position)#
参数:

position – int

将光标移动到位置 position。

另请参阅

cursorPosition()

抽象 setSelection(selectionIndex, startOffset, endOffset)#
参数:

  • selectionIndex – int

  • startOffset – int

  • endOffset – int

将选择 selectionIndex 设置为从 startOffset 到 endOffset 的范围。

抽象 text(startOffset, endOffset)#
参数:

  • startOffset – int

  • endOffset – int

返回类型:

str

返回从 startOffset 到 endOffset 的文本。其中 startOffset 是将返回的第一个字符。 endOffset 是将不返回的第一个字符。

textAfterOffset(offset, boundaryType, startOffset, endOffset)#
参数:

  • offset – int

  • boundaryType – TextBoundaryType

  • startOffset – int

  • endOffset – int

返回类型:

str

返回 boundaryType 类型的文本项，位于偏移量 offset 之后，并将 startOffset 和 endOffset 值设置为此项的开始和结束位置；如果没有这样的项，则返回空字符串。如果发生错误，将 startOffset 和 endOffset 设置为 -1。

此默认实现是为小文本编辑提供的。字处理器或文本编辑器应该提供它们自己的高效实现。此函数不区分段落和行。

注意

此函数无法考虑光标位置。按照惯例，offset 为 -2 表示此函数应使用光标位置作为偏移量。因此，在调用此函数之前，必须将偏移量 -2 转换为光标位置。使用偏移量 -1 用于文本长度，此函数的自定义实现必须返回好像长度作为偏移量传递时的结果。

textAtOffset(offset, boundaryType, startOffset, endOffset)#
参数:

  • offset – int

  • boundaryType – TextBoundaryType

  • startOffset – int

  • endOffset – int

返回类型:

str

返回偏移量为 offset 的类型为 boundaryType 的文本项，并将 startOffset 和 endOffset 的值设置为该项的起始和结束位置；如果没有此类项，则返回空字符串。在发生错误时，将 startOffset 和 endOffset 的值设置为 -1。

此默认实现是为小文本编辑提供的。字处理器或文本编辑器应该提供它们自己的高效实现。此函数不区分段落和行。

注意

此函数无法考虑光标位置。按照惯例，offset 为 -2 表示此函数应使用光标位置作为偏移量。因此，在调用此函数之前，必须将偏移量 -2 转换为光标位置。使用偏移量 -1 用于文本长度，此函数的自定义实现必须返回好像长度作为偏移量传递时的结果。

textBeforeOffset(offset, boundaryType, startOffset, endOffset)#
参数:

  • offset – int

  • boundaryType – TextBoundaryType

  • startOffset – int

  • endOffset – int

返回类型:

str

返回类型为 boundaryType 且接近偏移量 offset 的文本项，并将 startOffset 和 endOffset 的值设置为该项的起始和结束位置；如果没有此类项，则返回空字符串。在发生错误时，将 startOffset 和 endOffset 的值设置为 -1。

此默认实现是为小文本编辑提供的。字处理器或文本编辑器应该提供它们自己的高效实现。此函数不区分段落和行。

注意

此函数无法考虑光标位置。按照惯例，offset 为 -2 表示此函数应使用光标位置作为偏移量。因此，在调用此函数之前，必须将偏移量 -2 转换为光标位置。使用偏移量 -1 用于文本长度，此函数的自定义实现必须返回好像长度作为偏移量传递时的结果。