Qt 自定义信号与槽

注 对象与槽理解

    //第一个参数lineEdit是激发事件对象,信号中的方法必须在对象中存在，并在对象类头文件signals下定义，
    //第二个参数信号，
    //第三个参数this是槽方法所属类的对象，且必须在对象类的头文件的slots下定义
    //第四个参数槽方法类，槽 方法
    connect(lineEdit,SIGNAL(textChanged(QString)),this,SLOT(showArea()));

使用自定义的信号和槽，需要注意以下几点： 
1、类的声明和实现分别放在.h和.cpp文件中； 
2、类声明中包含Q_OBJECT宏； 
3、信号只要声明不要设计其的实现函数； 
4、发射信号用emit关键字; 
5、自定义槽的实现与普通成员函数的实现一样。 

6、信号和槽方法必须在类的头文件中定义

本文所示代码在windows xp + MingW3.4.2+ eclipse3.4+CDT5.0版本中调试通过
    QT系统为我们提供功能非常全面信号处理机制，它的内制信号和槽已经非常全面，因此大多数情况下，我们不需要自己设计信号和槽，但是有些时候，我们可能需要设计一些独特的信号和槽，来满足程序的需求。QT的核心机制信号和槽是独立于C++的，一般C++设计处理如按钮点击等方法，多采用回调函数，而回调函数设计上的复杂，虽然执行效率相对于QT信号与槽要高，但是其导制容易出错。况且在日常应用程序设计中来说，这种高效率相差不成比例，因此QT采用自己独门设计，来高效的编程。本文也同样倡导大家使用信号与槽。
    如何才能设计自己的信号和槽呢，阅读完本节您将会轻松实现自己的需求。
    在创建信号和槽之前首先大家需要建立三个文件：类申明文件（yourclass.h)，类实现文件(youclass.cpp),程序主体文件（main.cpp)。
    请看下面的例子，假设我们需要一个来处理文本框的内容的程序，程序主界面有两个按钮，当们点击按钮[Modify]时，文本框内容被改为“jingjing”。
1、自定义槽：
    按钮点击信号clilcked()通过继承已经存在，因此我们暂时不需要定义这个信号。那么我们要改变文本框内容，就需要自己定义一个槽，来响应点击信号。
    示例代码(类申明文件 yourclass.h)：

复制代码

1. #ifndef YOURCLASS_H_
2.     #define YOURCLASS_H_
3.     #include <QWidget>                        //QT窗口应用程序需要包含的文件
4.     #include <QPushButton>                    //制作按钮时,需要包含
5.     #include <QLineEdit>                      //制作文本框时,需要包含
6.     class MyMainWindows:public QWidget        //申明一个MyMainWindows类,这个类用于实现窗体
7.     {                                                         
8.      Q_OBJECT                            //Q_OBJECT是在定制信号和槽和必须包含的一条宏语句
9.     public:                                                   
10.         MyMainWindows();                    //类构造函数（用于实现程序的主体部份）
11.     public slots:                              //所有的槽函数都必须申明public slots语句内
12.           void SlotTest();                    //这个槽函数用于显应点击按钮时改变文本框内容
13.     private:
14.         QPushButton * pb;                    //申请一个按钮QPushButton
15.         QLineEdit * ledit;                      //申请一个文本框ledit
16.     };
17.     #endif /* YOURClASS_H_ */   

    在上面的示例代码中,我们申明了一窗口应用程序类文件,它的功能是申明程序所需要全部元素信息。在这个类中，我们申明了自己的槽SlotTest()函数，来响应按钮点击的信号。如下所示：

复制代码

1. public slots:                              //所有的槽函数都必须申明public slots语句内
2.           void SlotTest();                    //这个槽函数用于显应点击按钮时改变文本框内容

    正如代码中注释说明，在自定义槽和信号是有两点是至关重要的：
    第一点：所有的槽函数都需要包含在public slots语句下面。它的申明和类的公有函数方法pulic是类似的。如果你有多个槽函数，只要需要一一列出即可。
    第二点；在类的文件开始部份应含Q_OBJECT宏语句，请记住它不需要标点符号，所以不要加[；]符号。所有的QT自定义槽和信号都需要有它的存在。
    下面是制作第二个文件：类实现文件yourclass.cpp。在这个文件用于yourclass.h中申明的元素实现部份。
    示例代码（类实现文件yourclass.cpp)

复制代码

1. #include "yourclass.h"                                  //包含yourclass.h类申明文件
2. MyMainWindows::MyMainWindows()                    //实现构造函数
3. {
4.   setGeometry(90,90,300,200);                          //绘制主窗体，大小为300X200
5.   pb = new QPushButton("Modify",this);                  //实现pb按钮，被设计其名字为Modify
6.   pb->setGeometry(10,10,100,20);                        //绘制pb按钮的位置(10,10)和大小(100,20)
7.   ledit = new QLineEdit("what's your name",this);          //实现ledit文件框，其内容为what's your name
8.   ledit->setGeometry(10,30,200,150);                    //绘制ledit文件框位置(10,30)和大小(200,150)
9.   connect(pb,SIGNAL(clicked()),this,SLOT(SlotTest()));    //连接pb按钮的点击clicked()信号和自定义槽SlotTest()
10. }
11. void MyMainWindows::SlotTest()                        //自定义槽函数的实现方法，重置文本框的内容
12. {
13.   ledit->setText("jingjing");                            //“jingjing”为点击按钮Modify后的内容
14. }

在yourclass.cpp中，我们实现了程序的全部功能，程序的执行还需要有一个入口。它的主体部分mian.cpp。

复制代码

1. #include <QApplication>              //所有QT应用程序都要包含QApplication头文件
2. #include "yourclass.h"                //包含类定义文件yourclass.h
3. int main(int argc,char * argv[])
4. {
5.   QApplication app(argc,argv);        //申明一个QT应用程序对像app
6.   MyMainWindows w;                      //申明我们实现MyMainWindows窗体对像 w.
7.   w.show();                                //显示这个w 窗体
8.   return app.exec();
9. }

程序编译完成后执行当点击Modify按钮，文本内容what's your name 被修改为jingjing
2、自定义信号
    在上例中，我们了解了怎样来实现自己的槽函数，在下文中我们将介绍怎么实现自己的信号。QT信号的申明与实现，相对QT槽函数来说，要更加容易一些。它相当于一系列函数原型。不需要有具体实现处理内容。在上文中，我们是通过点击clicked()这个信号，来连接槽函数SlotTest（）,并达到修改文本框的内容。本例中，我们将在窗体添加一个文字标签label，然后在槽函数SlotTest()中测试label内容是否发生变化，如果发生了变化，就引发信号SigTest()。该信号连接到槽函数SlotTest2（），将文本框内容修改为"SigSig"。
    下面为实现文件：
    请打开上节中的yourclass.h文件，在代码加入一个槽函数SlotTest2()，和一个信号SigTest()。红色代码为新增加内容，如下所示：

复制代码

1. #ifndef YOURCLASS_H_
2.     #define YOURCLASS_H_
3.     #include <QWidget>                        //QT窗口应用程序需要包含的文件
4.     #include <QPushButton>                    //制作按钮时,需要包含
5.     #include <QLineEdit>                      //制作文本框时,需要包含
6.     #include <QLabel>                        //制作文本标签时，需要包含
7.     class MyMainWindows:public QWidget        //申明一个MyMainWindows类,这个类用于实现窗体
8.     {                                                         
9.      Q_OBJECT                            //Q_OBJECT是在定制信号和槽和必须包含的一条宏语句
10.     public:                                                   
11.         MyMainWindows();                    //类构造函数（用于实现程序的主体部份）
12.     public slots:                              //所有的槽函数都必须申明public slots语句内
13.           void SlotTest();                    //这个槽函数用于显应点击按钮时改变文本框内容
14.           void SlotTest2();                    //新增加槽函数，用于将文本框内容改为SigSig
15.   private:
16.         QPushButton * pb;                    //申请一个按钮QPushButton
17.         QLineEdit * ledit;                      //申请一个文本框ledit
18.         QLabel * label;                        //申请一个文本标签label
19.      Signals:                                //所有信号都需要申明在signals语句内
20.        void SigTest()                        //新增加信号SigTest()。
21.     }; 
22.     #endif /* YOURClASS_H_ */   

    在这个例子中，我们加入了自定义的信号SigTest()。在QT中信号的申请方法是，在类中加入signals(信号)语句。然后在语句后面定义自己的信号函数就可以了。有趣的是信号的定义并不需要具体实现，它就像一系列函数原型一样。你只需要申请就可以了。本例中，我们申请了一个不带有任何参数的信号SigTest()。在下文中我们将用这个信号来实现文本框内容变化。
    在窗体上要绘制文本标签，就必须加入<QLabel>头文件。其次我们在代码中新增加了一个槽SlotTest2()函数和一个信号SigTest()函数，并通过connect()函数连接。
    代码如下所示（yourclass.cpp）：

复制代码

1. #include "yourclass.h"
2. MyMainWindows::MyMainWindows()
3. {
4.   setGeometry(90,90,300,200);
5.   pb = new QPushButton("Modify",this);
6.   pb->setGeometry(10,10,100,20);
7.   ledit = new QLineEdit("what's your name",this);
8.   ledit->setGeometry(10,30,200,150);
9.   label = new QLabel("My MeMe",this);                //实现一个文本标签label，并将其内容初使为：My MeMe
10.   label->setGeometry(115,10,100,20);
11.   connect(pb,SIGNAL(clicked()),this,SLOT(SlotTest())); 
12.   connect(this,SIGNAL(SigTest()),this,SLOT(SlotTest2())); //连接自定义信号SigTest  ()和SlotTest2()槽函数
13. }
14. void MyMainWindows::SlotTest()                      //信号1
15. {
16.   ledit->setText("jingjing");
17.   label->setText("TTT");                          //将文本标签label内容设置为TTT文本
18.   if(label->text() != "My MeMe")
19.     {
20.       emit SigTest();
21.     }
22. }
23. void MyMainWindows::SlotTest2()              //信号2
24. {
25.   ledit->setText("SigSig");  //设置文本框内容为SigSig
26. }

    从上面代码中可以看出，首先我们在MyMainWindows()主窗体类构造函数中加入了
      

复制代码

1. label = new QLabel("My MeMe",this);             
2.        label->setGeometry(115,10,100,20);

    Label文本标签的初使内容为My MeMe。其位置为窗体的(115,10)，大小为(100,20)，我们在上一事例中讲过的槽函数SlotTest()中新加入了对文本标签的检测，来达到对我们自定义信号SigTest()触发。如下所示：

复制代码

1. void MyMainWindows::SlotTest()                      //信号1
2. {
3.   ledit->setText("jingjing");
4.   label->setText("TTT");                          //将文本标签label内容设置为TTT文本
5.   if(label->text() != "My MeMe")
6.     {
7.       emit SigTest();
8.     }
9. }
10. void MyMainWindows::SlotTest2()              //信号2
11. {
12.   ledit->setText("SigSig");  //设置文本框内容为SigSig
13. }

    如代码所示当SlotTest()槽函数被调用时，首先将ledit文本框内容设为jingjing，并把label文本标签内容设为TTT，然后此时我们检测label的内容是不是还为它的初使内容My MeMe，如果不是，则引发我们自定义的SigTest()信号。请注意代码中emit（发射)关键字，做为QT信号与槽机制来说，emit的作用就是将信号发出来的意思。也就是说，当我们类申明文件中定义了一个信号时，如果要使用这个信号，只需在信号语句前面加上emit关键字就可以了。
    而在SlotTest2()槽函数中，我们把文本框ledit的内容设为：SigSig。也就是当SlotTest2()槽函数被调用时就又会把ledit中内容修改为SigSig。在本事例中，我们用SigTest()信号来连接SlotTest2()这个槽，也就是说当SigTest()信号被触发时，就会将文本框的内容修改为：SigSig。代码如下：

复制代码

1. connect(this,SIGNAL(SigTest()),this,SLOT(SlotTest2()));

    现在让我们把上例中的Main.cpp文件放到一起，进行编译
    当第一次点击[Modify]按钮时，程序首先产生一个信号clicked()，而这个信号将导致SlotTest()槽被执行，文本框的内容首先被修改为jingjing,然后label文本标签的内容被修改为TTT，随后在SlotTest()语句发现label的内容不是My MeMe，因此向外发射信号SigTest()。而SigTest()信号与SlotTest2()槽连接，因此导致SlotTest2()槽函数被调用，它又将文本框内容修改为了SigSig。因此当我们点击Modify时，文本框内容最终会变为SigSig文本。