qt - QAction

官方介绍

The QAction class provides an abstract user interface action that can be inserted into widgets.

In applications many common commands can be invoked via menus, toolbar buttons, and keyboard shortcuts. Since the user expects each command to be performed in the same way, regardless of the user interface used, it is useful to represent each command as an action.

Actions can be added to menus and toolbars, and will automatically keep them in sync. For example, in a word processor, if the user presses a Bold toolbar button, the Bold menu item will automatically be checked.

Actions can be created as independent objects, but they may also be created during the construction of menus; the QMenu class contains convenience functions for creating actions suitable for use as menu items.

A QAction may contain an icon, menu text, a shortcut, status text, "What's This?" text, and a tooltip. Most of these can be set in the constructor. They can also be set independently with setIcon(), setText(), setIconText(), setShortcut(), setStatusTip(), setWhatsThis(), and setToolTip(). For menu items, it is possible to set an individual font with setFont().

Actions are added to widgets using QWidget::addAction() or QGraphicsWidget::addAction(). Note that an action must be added to a widget before it can be used; this is also true when the shortcut should be global (i.e., Qt::ApplicationShortcut as Qt::ShortcutContext).

QAction类提供了抽象的用户界面action，这些action可以被放置在widgets.。 

应用程序可以通过菜单，工具栏按钮以及键盘快捷键来调用通用的命令。由于用户期望每个命令都能以相同的方式执行，而不管命令所使用的用户界面，这个时候使用action来表示这些命令就显得十分有用。

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

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

QAction可以包括一个图标，菜单文本，快捷键，状态文本，"What`s This"文本以及一个tooltip。这些内容的绝大部分都可以在构造函数中设置。也可以通过setIcon()，setIconText()，setShortCut()，setStatusTip()，setWhatsThis和SetToolTip()函数分别设置。对于菜单项，我们还可以通过setFont()单独为它们设置font。

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

 

QAction 继承与 QObject

 示例代码

const QIcon openIcon = QIcon::fromTheme("document-open", QIcon(":/images/open.png"));
      QAction *openAct = new QAction(openIcon, tr("&Open..."), this);
      openAct->setShortcuts(QKeySequence::Open);
      openAct->setStatusTip(tr("Open an existing file"));
      connect(openAct, &QAction::triggered, this, &MainWindow::open);
      fileMenu->addAction(openAct);
      fileToolBar->addAction(openAct);

 QAction 的作用

action的作用简单来讲，

1、将交互抽象成动作action，将一个不同地方的操作统一成一个，例如：在menu中的打开操作，和bar中的打开状态。

2、可以支持 icon 和一些其他属性，在action被触发只有，发送一个信号triggered ，主窗口槽函数可以接收信号进行处理

 

action处理快捷键，会拦截快捷键，然后发送Trigger信号。

bool
QAction::event(QEvent *e)
{
#ifndef QT_NO_SHORTCUT
    if (e->type() == QEvent::Shortcut) {
        QShortcutEvent *se = static_cast<QShortcutEvent *>(e);
        Q_ASSERT_X(se->key() == d_func()->shortcut || d_func()->alternateShortcuts.contains(se->key()),
                   "QAction::event",
                   "Received shortcut event from incorrect shortcut");
        if (se->isAmbiguous())
            qWarning("QAction::event: Ambiguous shortcut overload: %s", se->key().toString(QKeySequence::NativeText).toLatin1().constData());
        else
            activate(Trigger);
        return true;
    }
#endif
    return QObject::event(e);
}