QAccessibleTextInterface 类
QAccessibleTextInterface 类实现了对文本处理的支持。 更多信息...
头文件 | #include <QAccessibleTextInterface> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake | QT += gui |
- 所有成员列表,包括继承成员
- QAccessibleTextInterface 是 辅助功能类 的一部分。
公共函数
虚拟 | ~QAccessibleTextInterface() |
虚拟 void | addSelection(int startOffset, int endOffset) = 0 |
虚拟 QString | attributes(int offset, int *startOffset, int *endOffset) const = 0 |
虚拟 int | characterCount() const = 0 |
虚拟 QRect | characterRect(int offset) const = 0 |
虚拟 int | cursorPosition() const = 0 |
虚拟 int | offsetAtPoint(const QPoint &point) const = 0 |
虚拟 void | removeSelection(int selectionIndex) = 0 |
虚拟 void | scrollToSubstring(int startIndex, int endIndex) = 0 |
虚拟 void | selection(int selectionIndex, int *startOffset, int *endOffset) const = 0 |
虚拟 int | selectionCount() const = 0 |
虚拟 void | setCursorPosition(int position) = 0 |
虚拟 void | setSelection(int selectionIndex, int startOffset, int endOffset) = 0 |
虚拟 QString | text(int startOffset, int endOffset) const = 0 |
虚拟 QString | textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const |
虚拟 QString | textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const |
虚拟 QString | textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const |
详细信息
此接口对应于 IAccessibleText 接口。它应该用于显示比普通标签更多文本的小部件。标签应仅通过QAccessibleInterface来表示,并将它们的文本作为名称返回(使用QAccessibleInterface::text() 与 QAccessible::Name 作为类型)。QAccessibleTextInterface 通常用于文本,屏幕阅读器可能希望逐行读取,以及支持文本选择和输入的小部件。从这个接口的示例来看,它被用于QLineEdit。
成员函数说明
[虚拟 noexcept]
QAccessibleTextInterface::~QAccessibleTextInterface()
[纯虚]
void QAccessibleTextInterface::addSelection(int startOffset, int endOffset)
从 startOffset 到 endOffset 选择文本。其中 startOffset 是将被选择的第一个字符。而 endOffset 是不会被选择的第一个字符。
当对象支持多选(例如在文字处理软件中)时,这将添加一个新的选择,否则将替换之前的选择。
选择的长度将是 endOffset - startOffset 个字符。
[纯虚]
QString QAccessibleTextInterface::attributes(int offset, int *startOffset, int *endOffset) const
返回位置 offset 的文本属性。此外,在 startOffset 和 endOffset 中返回属性的范筹。
[纯虚]
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)
确保从 startIndex 到 endIndex 的文本是可见的。
[纯虚函数]
void QAccessibleTextInterface::selection(int selectionIndex, int *startOffset, int *endOffset) const
返回一个选择项。选择项的大小返回在 startOffset 和 endOffset 中。如果没有选择项,则两个 startOffset 和 endOffset 都是 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 设置为从 startOffset 到 endOffset 的范围。
另请参阅:selection(),addSelection() 以及 removeSelection()。
[纯虚函数]
QString QAccessibleTextInterface::text(int startOffset, int endOffset) const
返回从 startOffset 到 endOffset 的文本。其中 startOffset 是要返回的第一个字符。而 endOffset 是不应返回的第一个字符。
[虚函数]
QString QAccessibleTextInterface::textAfterOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
返回在偏移量 offset 之后,类型为 boundaryType 的文本项,并将 startOffset 和 endOffset 的值设置为该项目的起始和结束位置;如果没有此类项目,返回空字符串。在错误的情况下,将 startOffset 和 endOffset 的值设置为 -1。
此默认实现是针对小型文本编辑提供的。文字处理器或文本编辑器应该提供自己的高效实现。此函数在对段落和行之间不进行区分。
注意:此函数无法考虑光标位置。按照惯例,offset 的 -2 表示该函数应将光标位置用作偏移。因此,在调用此函数之前必须将偏移量 -2 转换为光标位置。偏移量为 -1 用于文本长度,且此函数的定制实现必须返回类似长度传递为偏移量时的结果。
[虚拟]
QString QAccessibleTextInterface::textAtOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
返回偏移量offset处类型为boundaryType的文本项,并将startOffset和endOffset的值设为该项的起始和结束位置;如果没有这样的项,则返回空字符串。出错时将startOffset和endOffset的值设置为-1。
此默认实现是针对小型文本编辑提供的。文字处理器或文本编辑器应该提供自己的高效实现。此函数在对段落和行之间不进行区分。
注意:此函数无法考虑光标位置。按照惯例,offset 的 -2 表示该函数应将光标位置用作偏移。因此,在调用此函数之前必须将偏移量 -2 转换为光标位置。偏移量为 -1 用于文本长度,且此函数的定制实现必须返回类似长度传递为偏移量时的结果。
[虚拟]
QString QAccessibleTextInterface::textBeforeOffset(int offset, QAccessible::TextBoundaryType boundaryType, int *startOffset, int *endOffset) const
返回靠近偏移量offset的类型为boundaryType的文本项,并将startOffset和endOffset的值设为该项的起始和结束位置;如果没有这样的项,则返回空字符串。出错时将startOffset和endOffset的值设置为-1。
此默认实现是针对小型文本编辑提供的。文字处理器或文本编辑器应该提供自己的高效实现。此函数在对段落和行之间不进行区分。
注意:此函数无法考虑光标位置。按照惯例,offset 的 -2 表示该函数应将光标位置用作偏移。因此,在调用此函数之前必须将偏移量 -2 转换为光标位置。偏移量为 -1 用于文本长度,且此函数的定制实现必须返回类似长度传递为偏移量时的结果。
© 2024 The Qt Company Ltd. 包含在本文档中的文档贡献归各自所有者所有。在此提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3的条款许可的。Qt和相关的商标在芬兰和其他国家/地区是世界各地的The Qt Company Ltd.的商标。所有其他商标均为各自所有者的财产。