找回密码
 立即注册
收起左侧

Qt学习之路第8篇 添加动作

29
回复
57351
查看
[复制链接]
累计签到:3 天
连续签到:1 天
来源: 2013-9-8 20:18:10 显示全部楼层 |阅读模式
版权声明
该文章原创于Qter开源社区(www.qter.org),作者devbean,博客www.devbean.net转载请注明出处!


本节,我们将在前面主窗口基础之上,添加菜单和工具栏等的动作。虽然 Qt Creator 已经帮我们实现了主窗口的框架代码,但是具体的功能,还是需要我们一行行添加。


Qt 使用 QAction 类作为动作。顾名思义,这个类就是代表了窗口的一个“动作”,这个动作可能显示在菜单,作为一个菜单项,当用户点击该菜单项,对用户的点击做出响应;也可能在工具栏,作为一个工具栏按钮,用户点击这个按钮就可以执行相应的操作。有一点值得注意:无论是出现在菜单栏还是工具栏,用户选择之后,所执行的动作应该都是一样的。因此,Qt 并没有专门的菜单项类,只是使用一个 QAction 类,抽象出公共的动作。当我们把 QAction 对象添加到菜单,就显示成一个菜单项,添加到工具栏,就显示成一个工具按钮。用户可以通过点击菜单项、点击工具栏按钮、点击快捷键来激活这个动作。


QAction 包含了图标、菜单文字、快捷键、状态栏文字、浮动帮助等信息。当把一个 QAction 对象添加到程序中时,Qt 自己选择使用哪个属性来显示,无需我们关心。同时,Qt 能够保证把 QAction 对象添加到不同的菜单、工具栏时,显示内容是同步的。也就是说,如果我们在菜单中修改了 QAction 的图标,那么在工具栏上面这个 QAction 所对应的按钮的图标也会同步修改。


下面我们来看看如何在 QMainWindow 中使用 QAction:

  1. // !!! Qt 5
  2. // ========== mainwindow.h
  3. #ifndef MAINWINDOW_H
  4. #define MAINWINDOW_H

  5. #include <QMainWindow>

  6. class MainWindow : public QMainWindow
  7. {
  8.     Q_OBJECT
  9. public:
  10.     MainWindow(QWidget *parent = 0);
  11.     ~MainWindow();

  12. private:
  13.     void open();

  14.     QAction *openAction;
  15. };

  16. #endif // MAINWINDOW_H

  17. // ========== mainwindow.cpp
  18. #include <QAction>
  19. #include <QMenuBar>
  20. #include <QMessageBox>
  21. #include <QStatusBar>
  22. #include <QToolBar>

  23. #include "mainwindow.h"

  24. MainWindow::MainWindow(QWidget *parent) :
  25.     QMainWindow(parent)
  26. {
  27.     setWindowTitle(tr("Main Window"));

  28.     openAction = new QAction(QIcon(":/images/doc-open"), tr("&Open..."), this);
  29.     openAction->setShortcuts(QKeySequence::Open);
  30.     openAction->setStatusTip(tr("Open an existing file"));
  31.     connect(openAction, &QAction::triggered, this, &MainWindow::open);

  32.     QMenu *file = menuBar()->addMenu(tr("&File"));
  33.     file->addAction(openAction);

  34.     QToolBar *toolBar = addToolBar(tr("&File"));
  35.     toolBar->addAction(openAction);

  36.     statusBar() ;
  37. }

  38. MainWindow::~MainWindow()
  39. {
  40. }

  41. void MainWindow::open()
  42. {
  43.     QMessageBox::information(this, tr("Information"), tr("Open"));
  44. }
复制代码

上面的代码分别属于两个文件:mainwindow.h 和 mainwindow.cpp。为了让 MainWindow 运行起来,我们还需要修改 main() 函数如下:

  1. int main(int argc, char *argv[])
  2. {
  3.     QApplication app(argc, argv);

  4.     MainWindow win;
  5.     win.show();

  6.     return app.exec();
  7. }
复制代码

当我们编辑好文件,点击运行,可以看到 MainWindow 的运行结果:




这是一个相对完整的程序。首先,我们在 MainWindow 类中添加了一个私有函数 open() 和一个私有变量 openAction。在 MainWindow 的构造函数中,第一行我们调用了 setWindowTitle(),设置主窗口的标题。注意我们的文本使用 tr() 函数,这是一个用于 Qt 国际化的函数。在后续章节中我们可以看到,我们可以使用 Qt 提供的国际化工具,将 tr() 函数的字符串提取出来,进行国际化。由于所需进行国际化的文本应该被大多数人认识,所以,tr() 函数里面一般会是英文文本。


然后,我们在堆上创建了 openAction 对象。在 QAction 构造函数,我们传入了一个图标、一个文本和 this 指针。我们将在后面的文章中解释 this 指针的含义。


图标我们使用了 QIcon,传入值是一个字符串,这个字符串对应于 Qt 资源文件中的一段路径。Qt 资源文件的后缀名是 qrc。如果我们使用 Qt Creator,我们可以在新建文件中看到 Qt 资源文件。Qt 资源文件其实是一个 XML 描述的文件,表示 Qt 应用程序所需要的各个资源。我们可以使用普通文本编辑器打开这个文件:

  1. <RCC>
  2.     <qresource prefix="/images">
  3.         <file alias="doc-open">document-open.png</file>
  4.     </qresource>
  5. </RCC>
复制代码

我们会在后面的章节中详细介绍 Qt 资源文件(注意,资源文件需要在 pro 文件中使用 RESOURCES 引入。)。这里只需要了解,QIcon 的参数,以 : 开始,意味着从资源文件中查找资源。:/images/doc-open 就是找到了这里的 document-open.png 这个文件。(我们使用的是 png 格式的图片,这是 Qt 内置支持的图片格式。其他格式的图片,比如 jpg、gif 则需要插件支持。这些插件实际已经随着 Qt 一同发布。)




QAction 第二个参数中,文本值前面有一个 &,意味着这将成为一个快捷键。注意看截图中 File 的 F 有一个下划线。


下面一句,我们使用了 setShortcut() 函数,用于说明这个 QAction 的快捷键。Qt 的 QKeySequence 为我们定义了很多内置的快捷键,比如我们使用的 Open。你可以通过查阅 API 文档获得所有的快捷键列表。 这个与我们自己定义的有什么区别呢?简单来说,我们完全可以自己定义一个 tr(“Ctrl+O”) 来实现快捷键。原因在于,这是 Qt 跨平台性的体现。比如 PC 键盘和 Mac 键盘是不一样的,一些键在 PC 键盘上有,而 Mac 键盘上可能并不存在,或者反之。使用 QKeySequence 类来添加快捷键,会根据平台的不同来定义相应的快捷键。


setStatusTip() 则实现了当用户鼠标滑过这个 action 时,会在主窗口下方的状态栏显示相应的提示。


后面的 connect() 函数,将这个 QAction 的 triggered() 信号与 MainWindow 类的 open() 函数连接起来。当用户点击了这个 QAction 时,会自动触发 MainWindow 的 open() 函数。这是我们之前已经了解过的。


下面的 menuBar()、toolBar() 和 statusBar() 三个是 QMainWindow 的函数,用于创建并返回菜单栏、工具栏和状态栏。我们可以从代码清楚地看出,我们向菜单栏添加了一个 File 菜单,并且把这个 QAction 对象添加到这个菜单;同时新增加了一个 File 工具栏,也把 QAction 对象添加到了这个工具栏。我们可以看到,在菜单中,这个对象被显示成一个菜单项,在工具栏变成了一个按钮。至于状态栏,则是出现在窗口最下方,用于显示动作对象的提示信息的。


至于 open() 函数中的内容,我们会在后文介绍。这里可以运行一下,你会看到,触发这个动作,程序会弹出一个提示框。


下面是 Qt 4 版本的程序,具体非常类似,这里不再赘述。

  1. // !!! Qt 4
  2. // ========== mainwindow.h
  3. #ifndef MAINWINDOW_H
  4. #define MAINWINDOW_H

  5. #include <QMainWindow>

  6. class MainWindow : public QMainWindow
  7. {
  8.     Q_OBJECT
  9. public:
  10.     MainWindow(QWidget *parent = 0);
  11.     ~MainWindow();

  12. private slots:
  13.     void open();

  14. private:
  15.     QAction *openAction;
  16. };

  17. #endif // MAINWINDOW_H

  18. // ========== mainwindow.cpp
  19. #include <QAction>
  20. #include <QMenuBar>
  21. #include <QMessageBox>
  22. #include <QToolBar>

  23. #include "mainwindow.h"

  24. MainWindow::MainWindow(QWidget *parent) :
  25.     QMainWindow(parent)
  26. {
  27.     setWindowTitle(tr("Main Window"));

  28.     openAction = new QAction(QIcon(":/images/doc-open"), tr("&Open..."), this);
  29.     openAction->setShortcuts(QKeySequence::Open);
  30.     openAction->setStatusTip(tr("Open an existing file"));
  31.     connect(openAction, SIGNAL(triggered()), this, SLOT(open()));

  32.     QMenu *file = menuBar()->addMenu(tr("&File"));
  33.     file->addAction(openAction);

  34.     QToolBar *toolBar = addToolBar(tr("&File"));
  35.     toolBar->addAction(openAction);

  36.     statusBar();
  37. }

  38. MainWindow::~MainWindow()
  39. {
  40. }

  41. void MainWindow::open()
  42. {
  43.     QMessageBox::information(this, tr("Information"), tr("Open"));
  44. }
复制代码




本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x
回复

使用道具 举报

累计签到:4 天
连续签到:1 天
2015-5-31 16:54:59 显示全部楼层
一开始怎么都没能添加图标,但改为绝对路径后就可以了。如下所示,没能添加的可以试试
openAction = new QAction(QIcon("d:/Qt/QtPrj/ex4/document-open24.png"), tr("&Open..."), this);
回复 支持 5 反对 0

使用道具 举报

累计签到:8 天
连续签到:1 天
2014-1-20 18:13:06 显示全部楼层
问一下,那个icon的png是要放在项目文件中的image文件夹中么?
回复 支持 反对

使用道具 举报

累计签到:17 天
连续签到:1 天
2014-8-20 16:01:26 显示全部楼层
图标添加讲的不是很明白,编译不显示图标
回复 支持 反对

使用道具 举报

尚未签到

2014-12-15 09:23:46 显示全部楼层
图标添加讲的不是很明白,编译不显示图标
回复 支持 反对

使用道具 举报

累计签到:4 天
连续签到:1 天
2014-12-26 18:51:13 显示全部楼层
讲的还是太简单,应该具体讲一下动作类到底是个什么东东。
回复 支持 反对

使用道具 举报

累计签到:17 天
连续签到:1 天
2015-4-28 12:37:32 显示全部楼层
越来越复杂了。

动作:??????????????。
回复 支持 反对

使用道具 举报

累计签到:17 天
连续签到:1 天
2015-4-29 14:47:19 显示全部楼层
&File &没起作用,什么情况导致的?
回复 支持 反对

使用道具 举报

累计签到:20 天
连续签到:1 天
2016-5-15 17:27:20 显示全部楼层
又仔细的看了一遍,有味道
回复 支持 反对

使用道具 举报

累计签到:4 天
连续签到:1 天
2016-9-7 14:15:09 显示全部楼层
2016.09.07,打卡,希望能够坚持下去好好学习
回复 支持 反对

使用道具 举报

累计签到:15 天
连续签到:1 天
2016-10-12 16:18:46 显示全部楼层
额。。楼主为什么不直接在ui设计界面编辑窗口呢?这样用程序感觉蛮麻烦的
回复 支持 反对

使用道具 举报

尚未签到

2016-12-12 14:01:02 显示全部楼层
已阅
回复 支持 反对

使用道具 举报

累计签到:12 天
连续签到:1 天
2017-2-8 21:19:25 显示全部楼层
这是我的代码,构建方式shadow build
//openAction=new QAction(QIcon("E:/QT/Helloword/Helloword/filenew.png"),tr("&Open... ..."),this);
    openAction=new QAction(QIcon(":/images/filenew-png"),tr("&Open... ..."),this);

按照博主的写的,也是写相对路径的时候不显示,写绝对路径的时候有,资源文件已经添加了,与.qrc在同一目录下,但就是不显示,希望能得到解答。。。
回复 支持 反对

使用道具 举报

累计签到:1 天
连续签到:1 天
2017-3-1 13:31:52 显示全部楼层
phonon99 发表于 2015-5-31 16:54
一开始怎么都没能添加图标,但改为绝对路径后就可以了。如下所示,没能添加的可以试试
openAction = new QA ...

多谢~解决了这个困扰已久的问题
回复 支持 反对

使用道具 举报

累计签到:3 天
连续签到:1 天
2017-4-24 10:19:39 显示全部楼层
phonon99 发表于 2015-5-31 16:54
一开始怎么都没能添加图标,但改为绝对路径后就可以了。如下所示,没能添加的可以试试
openAction = new QA ...

这样的确是可以的,而且“\”要改成“/”,不过不明白为什么
回复 支持 反对

使用道具 举报

累计签到:153 天
连续签到:5 天
2017-6-28 16:18:37 显示全部楼层
666666,,,这个例子很好,,,
回复 支持 反对

使用道具 举报

累计签到:15 天
连续签到:1 天
2017-6-28 16:51:52 显示全部楼层
每个章节没有工程代码下载吗 ?
回复 支持 反对

使用道具 举报

累计签到:1 天
连续签到:1 天
2017-7-15 22:33:43 显示全部楼层
越来越深入了。图标没出来。
回复 支持 反对

使用道具 举报

尚未签到

2017-8-6 22:11:56 显示全部楼层
谢谢老师,都是些干货呢
回复 支持 反对

使用道具 举报

累计签到:31 天
连续签到:1 天
2017-10-24 19:10:31 显示全部楼层
图标添加后,进行编译时,为什么有的显示,有的不显示?
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

公告
可以关注我们的微信公众号yafeilinux_friends获取最新动态,或者加入QQ会员群进行交流:190741849、186601429(已满) 我知道了