Qt模块化笔记之Qt Widgets——动作类与小部件菜单项
本文主要涉及以下三个类：
QAction
——QWidgetAction
QActionGroup
QAction可称为动作类，它一般可当作菜单中的项组成菜单，也可作为工具栏上的按钮，它主要由图标、文本及快捷键三部分组成。QActionGroup用于将QAction分组，设置组内各QAction的互斥性质（exclusive ），设置后，组内的动作，在外观上形成多选框（不互斥）或单选框（互斥）。QWidgetAction继承自QAction，它可将自定义的小部件插入到菜单项中，用于QSystemTrayIcon（托盘图标）的右键菜单似乎很合适。
————————————————————————————————————————————————————————————————————
QAction
公有函数如下：
QAction(QObject * parent)
QAction(const QString & text, QObject * parent)
QAction(const QIcon & icon, const QString & text, QObject * parent)
~QAction()
void setText(const QString & text)//设置文本
void setSeparator(bool b)//设成分割线，为深灰色的线，用于分割功能区
void setStatusTip(const QString & statusTip)//鼠标放至图标上时，状态栏提示文本
void setToolTip(const QString & tip)//鼠标放到上方时显示的提示文本
void setWhatsThis(const QString & what)
void setIcon(const QIcon & icon)//设置图标
void setIconText(const QString & text)//如果没有setText（），则这个会显示
void setIconVisibleInMenu(bool visible)//默认图标在菜单中是可见的
void setMenu(QMenu * menu)//本action形成右方有小箭头的子菜单
void setMenuRole(MenuRole menuRole)//菜单角色设定，由于Mac OS X系统的一些特性，Qt 会对一些菜单项进行自动排列。比如，如果你的菜单是“关于”、“设置”、“首选项”、“退出”等等，我们可以给它们分配一个角色，Qt 则会根据这些角色对菜单项的顺序作出正确的排列。枚举值见1
void setCheckable(bool)//设置是否可以勾选
void setData(const QVariant & userData)//
void setFont(const QFont & font)
void setPriority(Priority priority)//设置优先级，该优先级用于表明action在用户界面上的优先级。如，当工具栏设置了Qt::ToolButtonTextBesideIcon模式，那么低优先级的actions将不会显示出标签。枚举值见2
void setActionGroup(QActionGroup * group)//将本动作添加到某组
void setAutoRepeat(bool)//当长按快捷键时，是否不断触发，默认是
void setShortcut(const QKeySequence & shortcut)//设置快捷键
void setShortcutContext(Qt::ShortcutContext context)
void setShortcuts(const QList & shortcuts)
void setShortcuts(QKeySequence::StandardKey key)
QActionGroup * actionGroup() const
void activate(ActionEvent event)
QList associatedGraphicsWidgets() const
QList associatedWidgets() const
bool autoRepeat() const
QVariant data() const
QFont font() const
QIcon icon() const
QString iconText() const
bool isCheckable() const
bool isChecked() const
bool isEnabled() const
bool isIconVisibleInMenu() const
bool isSeparator() const
bool isVisible() const
QMenu * menu() const
MenuRole menuRole() const
QWidget * parentWidget() const
Priority priority() const
QKeySequence shortcut() const
Qt::ShortcutContext shortcutContext() const
QList shortcuts() const
bool showStatusText(QWidget * widget = 0)
QString statusTip() const
QString text() const
QString toolTip() const
QString whatsThis() const Public Slots
| void | hover() |
| void | setChecked(bool)//只有设为true，才能选中 |
| void | setDisabled(bool b) |
| void | setEnabled(bool) |
| void | setVisible(bool) |
| void | toggle() |
| void | trigger() |
| void | changed() |
| void | hovered() |
| void | toggled(bool checked)//切换 |
| void | triggered(bool checked = false)//触发 |
| Constant | Value | Description |
|---|---|---|
| QAction::NoRole | 0 | This action should not be put into the application menu |
| QAction::TextHeuristicRole | 1 | This action should be put in the application menu based on the action's text as described in the QMenuBar documentation. |
| QAction::ApplicationSpecificRole | 2 | This action should be put in the application menu with an application specific role |
| QAction::AboutQtRole | 3 | This action matches handles the "About Qt" menu item. |
| QAction::AboutRole | 4 | This action should be placed where the "About" menu item is in the application menu. The text of the menu item will be set to "About |
| QAction::PreferencesRole | 5 | This action should be placed where the "Preferences..." menu item is in the application menu. |
| QAction::QuitRole | 6 | This action should be placed where the Quit menu item is in the application menu. |
| Constant | Value | Description |
|---|---|---|
| QAction::LowPriority | 0 | 低优先级 |
| QAction::NormalPriority | 128 | 中 |
| QAction::HighPriority | 256 | 高 |
————————————————————————————————————————————————————————————————————
QWidgetAction
公有函数如下：
QWidgetAction(QObject * parent)
virtual ~QWidgetAction()
QWidget * defaultWidget() const
void releaseWidget(QWidget * widget)
QWidget * requestWidget(QWidget * parent)
void setDefaultWidget(QWidget * widget)//主要用这个设置自定义部件
QActionGroup
QActionGroup(QObject * parent)
~QActionGroup()
QList actions() const
QAction * addAction(QAction * action)//返回的是原action
QAction * addAction(const QString & text)
QAction * addAction(const QIcon & icon, const QString & text)
QAction * checkedAction() const//返回当前被选中的action
bool isEnabled() const
bool isExclusive() const
bool isVisible() const
void removeAction(QAction * action) Public Slots
| void | setDisabled(bool b) |
| void | setEnabled(bool) |
| void | setExclusive(bool)//设置互斥性，默认互斥 |
| void | setVisible(bool) |
Signals
| void | hovered(QAction * action) |
| void | triggered(QAction * action) |
————————————————————————————————————————————————————————————————————
测试示例，主菜单文件中测试了QActionGroup各函数效果，工具栏测试QAction各函数，系统托盘中测试QWidgetAction，加了个列表进去。
效果如图：
代码如下：
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include
#include
#include
#include
#include
#include
MainWindow::MainWindow(QWidget *parent) :
QMainWindow(parent),
ui(new Ui::MainWindow)
{
ui->setupUi(this);
menu=new QMenu("菜单");
menu->addAction("子菜单");
//QAction
ac1=new QAction(this);
ac1->setText("setText");
//ac1->setSeparator(true);
ac1->setStatusTip("setStatusTip");
ac1->setToolTip("setToolTip");
ac1->setWhatsThis("setWhatsThis");
ac1->setIcon(QIcon("://tray.ico"));
ac1->setIconText("setIconText");
ac1->setMenu(menu);
ac1->setCheckable(true);
ac1->setData(QString("setData"));
ac1->setPriority(QAction::HighPriority);
ac1->setShortcut(QKeySequence(tr("Ctrl+P")));
ui->mainToolBar->addAction(ac1);
//QActionGroup
main_ac1=new QAction("左对齐",this);//创建动作
main_ac2=new QAction("右对齐",this);
main_ac3=new QAction("居中对齐",this);
main_ac1->setCheckable(true);//设置是否可选中
main_ac2->setCheckable(true);
main_ac3->setCheckable(true);
QActionGroup *alignmentGroup = new QActionGroup(this);
alignmentGroup->addAction(main_ac1);//将动作加入组
alignmentGroup->addAction(main_ac2);
alignmentGroup->addAction(main_ac3);
main_ac2->setChecked(true);//设置一个默认选中的
QActionGroup *Group = new QActionGroup(this);
QAction *ac_1 = Group->addAction("粗体");
QAction *ac_2 = Group->addAction("倾斜");
ac_1->setCheckable(true);
ac_2->setCheckable(true);
Group->setExclusive(false);
//connect(ac,SIGNAL(triger)……
QMenu *menu2=new QMenu("设置",this);
menu2->addAction(main_ac1);//将动作加入菜单
menu2->addAction(main_ac2);
menu2->addAction(main_ac3);
menu2->addAction(ac_1);
menu2->addAction(ac_2);
ui->menuBar->addMenu(menu2);
//QWidgetAction
//构建个自定义小部件
QListWidget *lw=new QListWidget;
lw->addItem("列表项1");
lw->addItem("列表项2");
lw->addItem("列表项3");
//将部件加入QWidgetAction
QWidgetAction *a1=new QWidgetAction(this);
a1->setDefaultWidget(lw);
//将QWidgetAction加入到QMenu
QMenu *menu3=new QMenu(this);
menu3->addAction(a1);
//建立托盘图标,将QMenu加入到托盘图标右键菜单中
QIcon icon("://tray.ico");
trayIcon = new QSystemTrayIcon(this);
trayIcon->setIcon(icon);
trayIcon->setContextMenu(menu3);
trayIcon->setVisible(true);
}
MainWindow::~MainWindow()
{
delete ui;
}