第4篇 添加菜单图标（使用Qt资源文件 ）

版权声明

该文章原创于Qter开源社区（ http://www.qter.org ），作者 yafeilinux ，转载请注明出处！ 可以到 这里 讨论本文章！

导语

后面几篇里我们将介绍经典的Qt主窗口部件QMainWindow，主窗口部件就是一般的应用程序主窗口，它包含了菜单栏、工具栏、中心部件、状态栏和可停靠部件等。这一篇将着重介绍菜单的实现以及使用资源文件来添加菜单图标。

环境：Windows 7 + Qt 5.8.0（包含QtCreator 4.2.1）

正文

一、添加主窗口菜单

1.新建Qt Widgets Application，项目名称为mymainwindow，基类选择QMainWindow，类名为MainWindow。

2.创建完项目后，双击mainwindow.ui文件进入设计模式。在这里可以看到界面左上角的“在这里输入”，我们可以在这里添加菜单。双击“在这里输入”，将其更改为“文件(&F)”，然后按下回车键，效果如下图所示。这里的&F表明将菜单的快捷键设置为了Alt+ F，可以看到，实际的显示效果中&符号是隐藏的。

4-1添加文件菜单.png

3.同样的方法，我们在文件菜单中添加“新建(&N)”子菜单，效果如下图所示。菜单后面的那个加号图标是用来创建下一级菜单的。（PS：菜单中如果无法输入中文，可以从别处复制粘贴）

4-2 添加新建菜单.png

二、添加菜单图标

1.Qt中的一个菜单被看做是一个Action，我们在下面的Action编辑器（Action Editor）中可以看到刚才添加的“新建”菜单，如下图所示。

4-3 动作编辑器.png

2.双击该条目，会弹出编辑动作对话框，这里可以进行各项设置，比如我们可以设置菜单项的快捷键，点击一下Shortcut后面的行编辑器，然后按下键盘上的Ctrl + N，这样就可以将该菜单项的快捷键设置为Ctrl + N。如下图所示。那么大家可能会问，既然该菜单项的快捷键是这么设置的，那么菜单项名称“新建(N)”中的N是什么呢？这个可以被称为加速键，就是只有当文件菜单处于激活（显示）状态时，按下N键才会执行新建菜单的功能。

4-4编辑动作对话框.png

3.在编辑动作对话框中的“图标”后面的4-5选择图标文件按钮.png黑色箭头下拉框可以选择使用资源还是使用文件来最为图标，如果使用文件的话，那么就可以直接在弹出的文件对话框中选择本地磁盘上的一个图标文件。下面我们来讲述使用资源的方式，如果直接点击这个按钮就是默认的使用资源。现在我们先按下编辑动作对话框的OK按钮关闭它。

三、添加资源文件

1.Qt中可以使用资源文件将各种类型的文件添加到最终生成的可执行文件中，这样就可以避免使用外部文件而出现的一些问题。而且，在编译时Qt还会将资源文件进行压缩，我们可能发现生成的可执行文件比我们添加到其中的资源文件还要小。

2.我们向项目中添加新文件，模板选择Qt分类中的Qt资源文件（Qt Resource File）。如下图所示。然后将名称设置为myicon。

4-6选择资源文件模板.png

3.添加完文件后会自动打开该资源文件，需要先添加前缀，点击“添加”按钮，然后选择“添加前缀”，默认的前缀是“/new/prefix1”，这个可以随意修改（不要出现中文字符），我们这里因为要添加图片，所以修改为“/myimages”。然后再按下添加按钮来添加文件，这里最好将所有要用到的图片放到项目目录中。比如这里在项目目录中新建了一个images文件夹，然后将需要的图标文件粘贴进去。添加完文件后，如下图所示。

4-7添加完资源文件后.png

4.当添加完资源后，一定要按下Ctrl + S来保存资源文件，不然在后面可能无法显示已经添加的资源。

四、使用资源文件

1.我们重新回到设计模式打开新建菜单的编辑动作对话框，然后添加图标。在打开的选择资源对话框中，第一次可能无法显示已经存在的资源，可以按下左上角的绿箭头来更新显示。效果如下图所示。

4-8选择资源对话框.png

2.我们点击这里需要的新建图标filenew.png，按下确定即可。现在按下Ctrl + R运行程序，效果如下图所示。

4-9程序运行效果.png

五、使用代码来添加菜单和图标

1.对于添加的资源文件，在项目源码目录中可以看到，即myicons.qrc，使用写字板程序将其打开，可以发现它其实就是一个XML文档：

  1. <RCC>
  2.     <qresourceprefix="/myimages">
  3.        <file>images/filenew.png</file>
  4.        <file>images/fileopen.png</file>
  5.        <file>images/filesave.png</file>
  6.        <file>images/filesaveas.png</file>
  7.        <file>images/find.png</file>
  8.     </qresource>
  9. </RCC>

2.前面在设计模式添加了菜单项和图标，下面我们使用代码再来添加一个菜单项，并为其设置图标。在编辑模式打开mainwindow.cpp文件，并在构造函数中添加如下图所示代码：

4-10.png

这里添加图标时，就使用了资源文件中的图标。使用资源文件，需要在最开始使用冒号，然后添加前缀，后面是文件的路径。在代码中使用“文件菜单”，就是使用其objectName。主窗口上的菜单都是在菜单栏menuBar上的，因为这里使用了设计模式，所以可以通过ui->menuBar来获取菜单栏，菜单栏是QMenuBar类对象。如果不使用设计模式而使用纯代码创建项目，那么可以直接在MainWindow类中使用menuBar()方法来获取菜单栏。菜单栏上可以通过addMenu()来添加新的菜单，而菜单中可以使用QAction来创建菜单项。现在可以运行程序查看效果。

结语

这一篇中主要讲解了如何使用资源文件，讲述了在设计模式和代码中两种使用方法。希望大家可以亲自练习一下本篇的内容，在后面的章节中，对于添加菜单和图标等操作将不再进行详细讲解。