Troubleshooting:Qt LINK2001 及moc

本文介绍一个Qt程序出现的链接错误及解决方法,顺便学习下Qt的moc机制。

环境:Qt Creator + VS2008

只写一个hello_notepad.cpp文件,在Qt Creator中编译运行。

 源代码如下:

 1 #include <QtGui>
 2 
 3 class Notepad : public QWidget
 4 {
 5     Q_OBJECT
 6 
 7 public:
 8     Notepad();
 9 
10 private slots:
11     void quit();
12 
13 private:
14     QTextEdit *textEdit;
15     QPushButton *quitButton;
16 };
17 
18 Notepad::Notepad()
19 {
20     textEdit = new QTextEdit;
21     quitButton = new QPushButton(tr("Quit"));
22 
23     connect(quitButton, SIGNAL(clicked()), this, SLOT(quit()));
24 
25     QVBoxLayout *layout = new QVBoxLayout;
26     layout->addWidget(textEdit);
27     layout->addWidget(quitButton);
28 
29     setLayout(layout);
30 
31     setWindowTitle(tr("Notepad"));
32 }
33 
34 void Notepad::quit()
35 {
36     QMessageBox messageBox;
37     messageBox.setWindowTitle(tr("Notepad"));
38     messageBox.setText(tr("Do you really want to quit?"));
39     messageBox.setStandardButtons(QMessageBox::Yes | QMessageBox::No);
40     messageBox.setDefaultButton(QMessageBox::No);
41     if(messageBox.exec() == QMessageBox::Yes)
42         qApp->quit();
43 }
44 
45 int main(int argv, char **args)
46 {
47     QApplication app(argv, args);
48     Notepad notepad;
49     notepad.show();
50 
51     return app.exec();
52 }
53 
54 #include "hello_notepad.moc"

 

编译链接时出现如下错误:

 

原因:链接时无法找到对应的moc文件。如果用到信号槽,但类的定义没有放在.h文件中, qmake不会自动调moc, 你就需要写#include "hello_notepad.moc" 告诉qmake有文件需要。

 

解决方法:在hello_notepad.cpp文件末尾加入#include "hello_notepad.moc"

 

最后的运行结果:

 

moc是QT的预编译器,用来处理代码中的slot,signal,emit,Q_OBJECT等。moc文件是对应的处理代码,也就是Q_OBJECT宏的实现部分,在官方帮助文档“Meta-Object System”中有详细说明。而MOC文件的工作方式在官方帮助文档“Using the Meta-Object Compiler (moc)”中有详细说明。

Qt 不是使用的“标准的” C++ 语言,而是对其进行了一定程度的“扩展”。这里我们从Qt新增加的关键字就可以看出来:signals、slots 或者 emit。所以有人会觉得 Qt 的程序编译速度慢,这主要是因为在 Qt 将源代码交给标准 C++ 编译器,如 gcc 之前,需要事先将这些扩展的语法去除掉。完成这一操作的就是 moc。
moc 全称是 Meta-Object Compiler,也就是“元对象编译器”。Qt 程序在交由标准编译器编译之前,先要使用 moc 分析 C++ 源文件。如果它发现在一个头文件中包含了宏 Q_OBJECT,则会生成另外一个 C++ 源文件。这个源文件中包含了 Q_OBJECT 宏的实现代码。这个新的文件名字将会是原文件名前面加上 moc_ 构成。这个新的文件同样将进入编译系统,最终被链接到二进制代码中去。因此我们可以知道,这个新的文件不是“替换”掉旧的文件,而是与原文件一起参与编译。另外,我们还可以看出一点,moc 的执行是在预处理器之前。因为预处理器执行之后,Q_OBJECT 宏就不存在了。既然每个源文件都需要 moc 去处理,那么我们在什么时候调用了它呢?实际上,如果你使用 qmake 的话,这一步调用会在生成的 makefile 中展现出来。从本质上来说,qmake 不过是一个 makefile 生成器,因此,最终执行还是通过 make 完成的。

 

 

【参考文献】

moc 元对象编译器介绍 http://news.ccidnet.com/art/32855/20100726/2128903_1.html

posted @ 2012-08-11 22:29  水芊芊  阅读(1248)  评论(0编辑  收藏  举报