QAccessibleActionInterface Class
QAccessibleActionInterface 类在接口中实现了对可调用操作的支持。更多内容...
| 头文件： | #include <QAccessibleActionInterface> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 由以下接口继承： |
- 所有成员列表（包括继承的成员）
- QAccessibleActionInterface 属于辅助功能类。
公共函数
| QAccessibleActionInterface() | |
| virtual | ~QAccessibleActionInterface() |
| virtual QStringList | actionNames() const = 0 |
| virtual void | doAction(const QString &actionName) = 0 |
| virtual QStringList | keyBindingsForAction(const QString &actionName) const = 0 |
| virtual QString | localizedActionDescription(const QString &actionName) const |
| virtual 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 & | showOnScreenAction() |
| const QString & | toggleAction() |
详细说明
如果可访问对象支持用户交互，则应实现该操作接口。通常，实现此接口的类也会同时实现QAccessibleInterface 。
支持的操作应使用本类中提供的预定义操作，除非它们不符合任何预定义操作。在这种情况下，可以添加自定义操作。
在继承 QAccessibleActionInterface 时，您需要提供一个actionNames 列表，这是发现可用操作的主要途径。 操作名称绝不进行本地化。为了向用户展示操作，有两个函数需要返回名称的本地化版本并提供操作的描述。对于预定义的操作名称，请使用QAccessibleActionInterface::localizedActionName()和QAccessibleActionInterface::localizedActionDescription()来返回其本地化版本。
通常情况下，您应使用预定义的操作名称之一，除非需要描述不符合这些名称的操作：
| 操作名称 | 描述 |
|---|---|
| toggleAction() | 切换该控件（复选框、单选按钮、开关等） |
| decreaseAction() | 减少可操作控件（如旋转框）的数值 |
| increaseAction() | 增加可访问控件（如旋转框）的数值 |
| pressAction() | 按下、单击或激活可访问控件（应相当于用鼠标单击该对象） |
| setFocusAction() | 将焦点设置到该可访问控件上 |
| showOnScreenAction() | 将此可访问对象移入视口 |
| showMenuAction() | 显示上下文菜单，相当于右键单击 |
要调用该操作，需传入操作名称并调用 `doAction()`。
大多数控件只需实现pressAction() 方法即可。当控件通过点击、按空格键或类似操作被激活时，就会触发该方法。
成员函数文档
[constexpr noexcept default] QAccessibleActionInterface::QAccessibleActionInterface()
默认构造一个QAccessibleActionInterface 的实例。
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
销毁QAccessibleActionInterface 。
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
返回此可访问对象支持的操作列表。返回的操作应按优先顺序排列，即用户最有可能想要触发的操作应排在首位，而最不可能触发的操作应排在末位。
该列表仅包含可调用的操作。它不会返回已禁用的操作，也不会返回与已禁用 UI 控件相关联的操作。
该列表可能为空。
请注意，此列表未经过本地化处理。如需本地化版本，请重写localizedActionName() 和localizedActionDescription() 方法
另请参阅 doAction()、localizedActionName() 和localizedActionDescription()。
[static] const QString &QAccessibleActionInterface::decreaseAction()
返回“减少”默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[pure virtual] void QAccessibleActionInterface::doAction(const QString &actionName)
调用由actionName 指定的操作。请注意，actionName 是actionNames()返回的未本地化名称。该函数通常通过调用其他用户交互（例如点击对象）所触发的相同函数来实现。
另请参阅 actionNames()。
[static] const QString &QAccessibleActionInterface::increaseAction()
返回“增加”默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[pure virtual] QStringList QAccessibleActionInterface::keyBindingsForAction(const QString &actionName) const
返回一个列表，其中包含可用于调用名为actionName 的操作的键盘快捷键。
这对于通过强调键盘操作，让用户了解使用该应用程序的其他方式非常重要。
另请参阅 actionNames()。
[virtual] QString QAccessibleActionInterface::localizedActionDescription(const QString &actionName) const
返回操作actionName 的本地化描述。
当使用默认名称之一时，您可以在 `QAccessibleActionInterface ` 中调用此函数以获取本地化字符串。
另请参阅 actionNames() 和localizedActionName()。
[virtual] QString QAccessibleActionInterface::localizedActionName(const QString &actionName) const
返回actionName 的本地化操作名称。
对于自定义操作，必须重写此函数。当使用默认名称之一时，可在 `QAccessibleActionInterface ` 中调用此函数以获取本地化字符串。
另请参阅 actionNames() 和localizedActionDescription()。
[static] QString QAccessibleActionInterface::nextPageAction()
返回下一页的默认操作名称。
另请参阅 actionNames() 和localizedActionName()。
[static] const QString &QAccessibleActionInterface::pressAction()
返回“press”默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[static] QString QAccessibleActionInterface::previousPageAction()
返回上一页的默认操作名称。
另请参阅 actionNames() 和localizedActionName()。
[static] QString QAccessibleActionInterface::scrollDownAction()
返回向下滚动默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[static] QString QAccessibleActionInterface::scrollLeftAction()
返回“向左滚动”默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[static] QString QAccessibleActionInterface::scrollRightAction()
返回“向右滚动”默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[static] QString QAccessibleActionInterface::scrollUpAction()
返回“向上滚动”默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[static] const QString &QAccessibleActionInterface::setFocusAction()
返回“设置焦点”默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
[static] const QString &QAccessibleActionInterface::showMenuAction()
返回“显示菜单”默认操作的名称。
另请参阅 ` actionNames()` 和 `localizedActionName()`。
[static] const QString &QAccessibleActionInterface::showOnScreenAction()
返回屏幕上显示的节目名称（默认操作）。
另请参阅 actionNames() 和localizedActionName()。
[static] const QString &QAccessibleActionInterface::toggleAction()
返回切换按钮默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
