qaction不显示_QAction系列详解

QAction系列详解

一、QAction类详解

【详细描述】

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

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

这个时候使用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添加到窗口部件上。注意，只有将Actions添加到窗口部件上之后，我们才可以使用这些actions；当actions的快捷键是全局的时候，我们也必须先将actions添加到窗口部件上。

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

openAct = new QAction(QIcon(":/images/open.png"), tr("&Open..."), this);

openAct->setShortcuts(QKeySequence::Open);

openAct->setStatusTip(tr("Open an existing file"));

connect(openAct, SIGNAL(triggered()), this, SLOT(open()));

fileMenu->addAction(openAct);

fileToolBar->addAction(openAct);

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

类的枚举成员变量：

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

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

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

来说，我们可以将“设置”菜单项作为 Mac OS X 的 Application::preferences。

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

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

【示例】

(1) 使用Act