QAccessibleTextInterface 类

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

头文件 #include <QAccessibleTextInterface>
CMakefind_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmakeQT += gui

公共函数

虚拟~QAccessibleTextInterface()
虚拟 voidaddSelection(int startOffset, int endOffset) = 0
虚拟 QStringattributes(int offset, int *startOffset, int *endOffset) const = 0
虚拟 intcharacterCount() const = 0
虚拟 QRectcharacterRect(int offset) const = 0
虚拟 intcursorPosition() const = 0
虚拟 intoffsetAtPoint(const QPoint &point) const = 0
虚拟 voidremoveSelection(int selectionIndex) = 0
虚拟 voidscrollToSubstring(int startIndex, int endIndex) = 0
虚拟 voidselection(int selectionIndex, int *startOffset, int *endOffset) const = 0
虚拟 intselectionCount() const = 0
虚拟 voidsetCursorPosition(int position) = 0
虚拟 voidsetSelection(int selectionIndex, int startOffset, int endOffset) = 0
虚拟 QStringtext(int startOffset, int endOffset) const = 0
虚拟 QStringtextAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
虚拟 QStringtextAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
虚拟 QStringtextBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

详细信息

此接口对应于 IAccessibleText 接口。它应该用于显示比普通标签更多文本的小部件。标签应仅通过QAccessibleInterface来表示,并将它们的文本作为名称返回(使用QAccessibleInterface::text() 与 QAccessible::Name 作为类型)。QAccessibleTextInterface 通常用于文本,屏幕阅读器可能希望逐行读取,以及支持文本选择和输入的小部件。从这个接口的示例来看,它被用于QLineEdit

IAccessible2 规范

成员函数说明

[虚拟 noexcept] QAccessibleTextInterface::~QAccessibleTextInterface()

销毁 QAccessibleTextInterface

[纯虚] void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)

startOffsetendOffset 选择文本。其中 startOffset 是将被选择的第一个字符。而 endOffset 是不会被选择的第一个字符。

当对象支持多选(例如在文字处理软件中)时,这将添加一个新的选择,否则将替换之前的选择。

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

[纯虚] QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const

返回位置 offset 的文本属性。此外,在 startOffsetendOffset 中返回属性的范筹。

[纯虚] int QAccessibleTextInterface::characterCount() const

返回文本的长度(包括空格在内的总大小)。

[纯虚] QRect QAccessibleTextInterface::characterRect(int offset) const

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

[纯虚] int QAccessibleTextInterface::cursorPosition() const

返回当前的游标位置。

另请参阅 setCursorPosition

[纯虚] int QAccessibleTextInterface::offsetAtPoint(const QPoint &point) const

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

[纯虚] void QAccessibleTextInterface::removeSelection(int selectionIndex)

清除具有索引 selectionIndex 的选择。

[纯虚] void QAccessibleTextInterface::scrollToSubstring(int startIndex, int endIndex)

确保从 startIndexendIndex 的文本是可见的。

[纯虚函数] void QAccessibleTextInterface::selection(int selectionIndex, int *startOffset, int *endOffset) const

返回一个选择项。选择项的大小返回在 startOffsetendOffset 中。如果没有选择项,则两个 startOffsetendOffset 都是 nullptr

无障碍API支持多重选择。但对于大多数小部件来说,只支持通过 selectionIndex 等于 0 的单一选择。

另请参阅:setSelection().

[纯虚函数] int QAccessibleTextInterface::selectionCount() const

返回此文本中的选择项数量。

[纯虚函数] void QAccessibleTextInterface::setCursorPosition(int position)

将光标移动到 position

另请参阅:cursorPosition().

[纯虚函数] void QAccessibleTextInterface::setSelection(int selectionIndex, int startOffset, int endOffset)

将选择项 selectionIndex 设置为从 startOffsetendOffset 的范围。

另请参阅:selection(),addSelection() 以及 removeSelection()。

[纯虚函数] QString QAccessibleTextInterface::text(int startOffset, int endOffset) const

返回从 startOffsetendOffset 的文本。其中 startOffset 是要返回的第一个字符。而 endOffset 是不应返回的第一个字符。

[虚函数] QString QAccessibleTextInterface::textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

返回在偏移量 offset 之后,类型为 boundaryType 的文本项,并将 startOffsetendOffset 的值设置为该项目的起始和结束位置;如果没有此类项目,返回空字符串。在错误的情况下,将 startOffsetendOffset 的值设置为 -1。

此默认实现是针对小型文本编辑提供的。文字处理器或文本编辑器应该提供自己的高效实现。此函数在对段落和行之间不进行区分。

注意:此函数无法考虑光标位置。按照惯例,offset 的 -2 表示该函数应将光标位置用作偏移。因此,在调用此函数之前必须将偏移量 -2 转换为光标位置。偏移量为 -1 用于文本长度,且此函数的定制实现必须返回类似长度传递为偏移量时的结果。

[虚拟] QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

返回偏移量offset处类型为boundaryType的文本项,并将startOffsetendOffset的值设为该项的起始和结束位置;如果没有这样的项,则返回空字符串。出错时将startOffsetendOffset的值设置为-1。

此默认实现是针对小型文本编辑提供的。文字处理器或文本编辑器应该提供自己的高效实现。此函数在对段落和行之间不进行区分。

注意:此函数无法考虑光标位置。按照惯例,offset 的 -2 表示该函数应将光标位置用作偏移。因此,在调用此函数之前必须将偏移量 -2 转换为光标位置。偏移量为 -1 用于文本长度,且此函数的定制实现必须返回类似长度传递为偏移量时的结果。

[虚拟] QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const

返回靠近偏移量offset的类型为boundaryType的文本项,并将startOffsetendOffset的值设为该项的起始和结束位置;如果没有这样的项,则返回空字符串。出错时将startOffsetendOffset的值设置为-1。

此默认实现是针对小型文本编辑提供的。文字处理器或文本编辑器应该提供自己的高效实现。此函数在对段落和行之间不进行区分。

注意:此函数无法考虑光标位置。按照惯例,offset 的 -2 表示该函数应将光标位置用作偏移。因此,在调用此函数之前必须将偏移量 -2 转换为光标位置。偏移量为 -1 用于文本长度,且此函数的定制实现必须返回类似长度传递为偏移量时的结果。

© 2024 The Qt Company Ltd. 包含在本文档中的文档贡献归各自所有者所有。在此提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3的条款许可的。Qt和相关的商标在芬兰和其他国家/地区是世界各地的The Qt Company Ltd.的商标。所有其他商标均为各自所有者的财产。