本文主要涉及以下三个类:
QAction可称为动作类,它一般可当作菜单中的项组成菜单,也可作为工具栏上的按钮,它主要由图标、文本及快捷键三部分组成。QActionGroup用于将QAction分组,设置组内各QAction的互斥性质(exclusive ),设置后,组内的动作,在外观上形成多选框(不互斥)或单选框(互斥)。QWidgetAction继承自QAction,它可将自定义的小部件插入到菜单项中,用于QSystemTrayIcon(托盘图标)的右键菜单似乎很合适。
公有函数如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
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(QObject * parent) virtual ~QWidgetAction() QWidget * defaultWidget() const void releaseWidget(QWidget * widget) QWidget * requestWidget(QWidget * parent) void setDefaultWidget(QWidget * widget)//主要用这个设置自定义部件
————————————————————————————————————————————————————————————————————
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; }