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<QKeySequence> & shortcuts)
void    setShortcuts(QKeySequence::StandardKey key)  

QActionGroup *  actionGroup() const
void    activate(ActionEvent event)
QList<QGraphicsWidget *>  associatedGraphicsWidgets() const
QList<QWidget *>  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<QKeySequence>   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()

Signals

void	changed()
void	hovered()
void	toggled(bool checked)//切换
void	triggered(bool checked = false)//触发

1，enum QAction::MenuRole

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 <application name>". The application name is fetched from the Info.plistfile in the application's bundle (See Deploying an Application on Mac OS X).
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.

2，enum QAction::Priority

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<QAction *>  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 <QListWidget>
#include <QWidgetAction>
#include <QAction>
#include <QMenu>
#include <QIcon>
#include <QKeySequence>
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;
}