QAccessibleActionInterface Class
QAccessibleActionInterface 类在接口中实现了对可调用操作的支持。更多
| 头文件： | #include <QAccessibleActionInterface> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake： | QT += gui |
| 继承于 |
- 所有成员（包括继承成员）的列表
- 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 & | toggleAction() |
详细说明
无障碍对象如果支持用户交互，则应实现动作接口。通常，该接口由同时实现QAccessibleInterface 的类来实现。
支持的动作应使用该类中提供的预定义动作，除非它们不适合预定义动作。在这种情况下，可以添加自定义动作。
在子类化 QAccessibleActionInterface 时，您需要提供actionNames 的列表，这是发现可用操作的主要途径。动作名称从不本地化。为了向用户展示动作，有两个函数需要返回动作名称的本地化版本并给出动作描述。对于预定义的操作名称，请使用QAccessibleActionInterface::localizedActionName() 和QAccessibleActionInterface::localizedActionDescription() 返回其本地化的对应名称。
一般来说，除非描述的操作不符合预定义的操作名称，否则应使用预定义的操作名称：
| 操作名称 | 说明 |
|---|---|
| toggleAction() | 切换项目（复选框、单选按钮、开关...） |
| decreaseAction() | 减小可访问项目的值（如旋转框） |
| increaseAction() | 增加可访问项（如自旋框）的值 |
| pressAction() | 按下或点击或激活可访问对象（应与用鼠标点击对象相对应） |
| setFocusAction() | 将焦点设置为该可访问对象 |
| showMenuAction() | 显示上下文菜单，对应于右键单击 |
为了调用操作，doAction() 会被调用一个操作名称。
大多数 widget 只需执行pressAction() 即可。当通过点击、按空格或类似方式激活部件时，就会发生这种情况。
成员函数文档
[virtual noexcept] QAccessibleActionInterface::~QAccessibleActionInterface()
[pure virtual] QStringList QAccessibleActionInterface::actionNames() const
返回此可访问对象支持的操作列表。返回的操作应按优先顺序排列，即用户最有可能触发的操作应首先返回，而最不可能触发的操作应最后返回。
该列表只包含可以调用的操作。它不会返回禁用的操作或与禁用的用户界面控件相关的操作。
列表可以为空。
请注意，该列表未本地化。如需本地化表示，请重新实现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()
返回按键默认动作的名称。
另请参阅 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::toggleAction()
返回切换默认操作的名称。
另请参阅 actionNames() 和localizedActionName()。
© 2025 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.
