QAccessibleActionInterface 类
The QAccessibleActionInterface class implements support for invocable actions in the interface. 更多信息...
| 头文件 | #include <QAccessibleActionInterface> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake | QT += gui |
| 继承自 |
- 包含所有成员列表，包括继承的成员
- QAccessibleActionInterface 是 辅助功能类 的一部分。
公共函数
| 虚拟 | ~QAccessibleActionInterface() |
| 虚拟 QStringList | actionNames() const = 0 |
| 虚拟 void | doAction(const QString &actionName) = 0 |
| 虚拟 QStringList | keyBindingsForAction(const QString &actionName) const = 0 |
| 虚拟 QString | localizedActionDescription(const QString &actionName) const |
| 虚拟 QString | localizedActionName(const QString &actionName) const |
静态公共成员
| const QString & | decreaseAction() |
| const QString & | increaseAction() |
| QString | nextPageAction() |
| const QString & | pressAction() |
| QString | previousPageAction() |
| QString | scrollDownAction() |
| QString | scrollLeftAction() |
| QString | scrollRightAction() |
| QString | scrollUpAction() |
| const QString & | setFocusAction() |
| const QString & | showMenuAction() |
| const QString & | toggleAction() |
详细描述
具有用户交互功能的可访问对象应该实现动作接口。通常此接口由同时实现 QAccessibleInterface 的类实现。
支持的操作应使用此类中提供的预定义操作，除非它们不适合预定义操作。在这种情况下，可以添加自定义操作。
当子类化 QAccessibleActionInterface 时，需要提供 actionNames 列表，这是发现可用操作的主要方式。动作名称永远不会本地化。为了向用户展示操作，有两个函数需要返回名称的本地化版本，并提供操作的描述。对于预定义的动作名称，使用 QAccessibleActionInterface::localizedActionName() 和 QAccessibleActionInterface::localizedActionDescription() 返回它们的本地化版本。
通常，你应该使用预定义的动作名称之一，除非描述不适用于这些名称的动作
| 动作名称 | 描述 |
|---|---|
| toggleAction() | 切换项（复选框、单选按钮、开关等） |
| decreaseAction() | 降低可访问对象（例如，旋转框）的值 |
| increaseAction() | 增加可访问对象（例如旋转框）的值 |
| pressAction() | 按或点击或激活可访问对象（应对应于用鼠标点击对象） |
| setFocusAction() | 将焦点设置到这个可访问对象 |
| showMenuAction() | 显示上下文菜单，对应于右键点击 |
为了调用动作，通过动作名称调用doAction()。
大多数小部件将简单实现pressAction()。当小部件通过点击、空格键或类似操作被激活时，就会发生这种情况。
成员函数说明
[虚拟 noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
[纯虚] QStringList QAccessibleActionInterface::actionNames() const
返回由这个可访问对象支持的动作用户列表。返回的动作应按首选顺序排列，例如，最可能被用户触发的操作应首先返回，而最不可能的操作应最后返回。
列表仅包含可以调用的动作。它不会返回禁用的动作或与禁用的 UI 控件关联的动作。
列表可以为空。
请注意，此列表未本地化。如需本地化表示，请重新实现localizedActionName()和localizedActionDescription()。
另请参阅 doAction，localizedActionName和localizedActionDescription。
[静态] const QString &QAccessibleActionInterface::decreaseAction()
返回默认减少操作的名称。
另请参阅 actionNames()和localizedActionName。
[纯虚] void QAccessibleActionInterface::doAction(const QString &actionName)
请求actionName指定的操作。请注意，actionName是未本地化的名称，由actionNames() 返回。此函数通常通过调用相同的函数来实现，它们可以触发其他用户交互，如点击对象。
另请参阅 actionNames。
[静态] const QString &QAccessibleActionInterface::increaseAction()
返回默认增加操作的名称。
另请参阅 actionNames()和localizedActionName。
[纯虚] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
返回命名操作actionName可用的快捷键列表。
这很重要，可以让用户通过强调键盘来学习使用应用程序的替代方法。
另请参阅 actionNames。
[虚拟] QString QAccessibleActionInterface::localizedActionDescription(const QString &actionName) const
返回动作 actionName 的本地化描述。
当使用默认名称之一时，可以在QAccessibleActionInterface中调用此函数以获取本地化字符串。
另请参阅 actionNames()和localizedActionName。
[虚拟] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
返回动作 actionName 的本地化名称。
对于自定义动作，必须重新实现此函数。当使用默认名称之一时，可以在QAccessibleActionInterface中调用此函数以获取本地化字符串。
另请参阅 actionNames() 和 localizedActionDescription()。
[静态] QString QAccessibleActionInterface::nextPageAction()
返回下一页默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] const QString &QAccessibleActionInterface::pressAction()
返回按下默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] QString QAccessibleActionInterface::previousPageAction()
返回上一页默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] QString QAccessibleActionInterface::scrollDownAction()
返回滚下默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] QString QAccessibleActionInterface::scrollLeftAction()
返回滚左默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] QString QAccessibleActionInterface::scrollRightAction()
返回滚右默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] QString QAccessibleActionInterface::scrollUpAction()
返回滚上默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] const QString &QAccessibleActionInterface::setFocusAction()
返回设置焦点默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] const QString &QAccessibleActionInterface::showMenuAction()
返回显示菜单默认动作的名称。
另请参阅 actionNames()和localizedActionName。
[静态] const QString &QAccessibleActionInterface::toggleAction()
返回切换默认动作的名称。
另请参阅 actionNames()和localizedActionName。
© 2024 The Qt Company Ltd. 本文档中包含的贡献文档的版权属于各自的所有者。提供的文档是根据自由软件基金会发布的GNU自由文档许可协议版本1.3进行许可的。Qt及其相关徽标是芬兰和/或在全世界的一些国家的The Qt Company的商标。所有其他商标均为各自所有者的财产。
