QAction类

QAction类提供了抽象的用户界面action，这些action可以放置到窗口部件中。

应用程序可以通过菜单，工具栏按钮以及键盘快捷键来调用通用的命令。由于用户期望每个命令都能以相同的方式执行，而不管命令所使用的用户界面。

这个时候action来表示这些命令就显得十分有用，

Actions可以被添加到菜单和工具栏中，并且可以自动保持在菜单和工具栏中的同步。例如，在一个字处理软件中，如果用户在工具栏中按下了Bold按钮，那么菜单中的Bold选项就会自动被选中。

Actions可以作为独立的对象被创建，但是我们也可以在构建菜单的时候创建它们；QMenu类包含了非常简便的方法用于创建适合用作菜单项的actions。

可以通过QWidget::addAction()或者是QGraphicsWidget::addAction()函数将Actions添加到窗口部件上。注意，只有将Actions添加到窗口部件上之后，我们才可以使用这些actions；当actions的快捷键是全局的时候，我们也必须先将actions添加到窗口部件上。

一旦QAction被创建了，那么就必须将它添加到相关的菜单和工具栏上，然后将它们链接到实现相应action功能的槽函数上。例如：

QToolBar* toolBar = addToolBar("File Action");
QMenu* menu = menuBar()->addMenu("File");
QAction* actionSave = menu->addAction(tr("&Save"));
// 设置快捷键
actionSave->setShortcut(QKeySequence::Save);
actionSave->setStatusTip("Save Content");
toolBar->addAction(actionSave);
connect(actionSave, &QAction::triggered, this, []() {
    qDebug() << "triggered";
});

我们建议将actions作为使用它们的窗口的孩子创建。在绝大多数情况下，actions都是应用程序主窗口的孩子。

类的枚举成员变量：
enum QAction::ActionEvent
This enum type is used when calling QAction::activate()

这个枚举类型主要是在调用QAction::activate()函数的时候被使用到。我们来看看QAction::activate()函数的原型：

void QAction::activate(QAction::ActionEvent event)
Sends the relevant signals for ActionEvent event.
Action based widgets use this API to cause the QAction to emit signals 
as well as emitting their own.

从上面可以看出，我们使用该函数发射信号，而参数event则指明了发射的信号类型。基于action的widgets可以自己发射信号，然而我们也可以显式的调用本API来发射信号。

enum QAction::MenuRole

由于Mac OS X系统的一些特性，Qt 会对一些菜单项进行自动排列。比如，如果你的菜单是“关于”、“设置”、“首选项”、“退出”等等，我们可以给它们分配一个角色，Qt 则会根据这些角色对菜单项的顺序作出正确的排列。方法是，设置 QAction::menuRole 属性，例如：AboutRole、PreferencesRole、QuitRole 或者 NoRole。举例来说，我们可以将“设置”菜单项作为 Mac OS X 的 Application::preferences。

QAction::MenuRole类型的枚举主要描述了在Mac OS X系统上，action如何移动到应用程序的菜单上。设置这个值只对菜单上的直接菜单有效，对子菜单无效。例如：如果有一个File菜单，该File菜单又包含有子菜单，那么如果你针对子菜单设置这些值，那么这些值永远不会起作用。

enum QAction::Priority

该优先级用于表明action在用户界面上的优先级。例如，当你的工具栏设置了Qt::ToolButtonTextBesideIcon模式，那么低优先级的actions将不会显示出标签。

示例

头文件

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QAction>
#include <QDebug>
#include <QMainWindow>
#include <QMenu>
#include <QToolBar>
QT_BEGIN_NAMESPACE
namespace Ui {
class MainWindow;
}
QT_END_NAMESPACE
class MainWindow : public QMainWindow {
    Q_OBJECT
public:
    MainWindow(QWidget* parent = nullptr);
    ~MainWindow();
private:
    void initMenu();
    void initToolBar();
    void initConnect();
private:
    Ui::MainWindow* ui;
    QToolBar* fileToolBar;
    QMenu* fileMenu;
    QAction* fileOpenAction;
    QAction* fileSaveAction;
    QToolBar* editToolBar;
    QMenu* editMenu;
    QAction* editCopyAction;
    QAction* editCutAction;
};
#endif // MAINWINDOW_H

实现

#include "mainwindow.h"
#include "ui_mainwindow.h"
MainWindow::MainWindow(QWidget* parent)
    : QMainWindow(parent)
{
    this->setWindowTitle("aciton");
    this->resize(240, 120);
    initMenu();
    initToolBar();
    initConnect();
}
// 构建菜单栏
void MainWindow::initMenu()
{
    // 初始化File菜单
    fileMenu = new QMenu(tr("File"), this);
    fileOpenAction = new QAction("&Open...", this);
    fileSaveAction = new QAction("&Save...", this);
    fileMenu->addAction(fileOpenAction);
    fileMenu->addAction(fileSaveAction);
    // 初始化Edit菜单
    editMenu = new QMenu("&Edit");
    editCopyAction = editMenu->addAction("&Copy");
    QString path = ":/cut.svg";
    editCutAction = editMenu->addAction(QIcon(path), "&Cut");
    // 设置低优先级(只显示图片 不会显示文字),如果不设置QIcon,则该优先级无效
    editCutAction->setPriority(QAction::LowPriority);
    // 将菜单添加到菜单栏上
    QMenuBar* menuBar = this->menuBar();
    menuBar->addMenu(fileMenu);
    menuBar->addMenu(editMenu);
}
// 构建工具栏
void MainWindow::initToolBar()
{
    // 初始化FileToolBar
    fileToolBar = new QToolBar(this);
    fileToolBar->addAction(fileOpenAction);
    fileToolBar->addAction(fileSaveAction);
    // 初始化EditToolBar
    editToolBar = new QToolBar(this);
    editToolBar->addAction(editCopyAction);
    editToolBar->addAction(editCutAction);
    // 将工具添加到工具栏上
    addToolBar(Qt::TopToolBarArea, fileToolBar);
    addToolBar(Qt::TopToolBarArea, editToolBar);
    // 设置工具栏为Qt::ToolButtonTextBesideIcon(图标在文字左侧)
    this->setToolButtonStyle(Qt::ToolButtonTextBesideIcon);
}
// 测试QAction::activate(QAction::ActionEvent)
void MainWindow::initConnect()
{
    connect(fileOpenAction, &QAction::triggered, this, [=]() {
        // 这将导致fileSaveAction发送信号QAction::hovered()
        fileSaveAction->activate(QAction::Hover);
    });
    connect(fileSaveAction, &QAction::hovered, this, []() {
        qDebug("file save action");
    });
}
MainWindow::~MainWindow()
{
}

结果

![Z1B@R@O`G4(RC$KUCFHX(A.png