微型技术博客——connect函数

一、简介

信号和槽是一种高级接口，应用于对象之间的通信。所有从 QObject 或其子类 ( 例如 Qwidget) 派生的类都能够包含信号和槽，当对象改变其状态时，信号就由该对象发射 (emit) 出去，这就是对象所要做的全部事情，它不知道另一端是谁在接收这个信号。槽用于接收信号，但它们是普通的对象成员函数。一个槽并不知道是否有任何信号与自己相连接。而且，对象并不了解具体的通信机制。

你可以将很多信号与单个的槽进行连接，也可以将单个的信号与很多的槽进行连接，甚至于将一个信号与另外一个信号相连接也是可能的，这时无论第一个信号什么时候发射系统都将立刻发射第二个信号。总之，信号与槽构造了一个强大的部件编程机制。

二、信号

当某个信号对其客户或所有者发生的内部状态发生改变，信号被一个对象发射。只有定义过这个信号的类及其派生类能够发射这个信号。当一个信号被发射时，与其相关联的槽将被立刻执行，就象一个正常的函数调用一样。信号 - 槽机制完全独立于任何 GUI 事件循环。只有当所有的槽返回以后发射函数（emit）才返回。 如果存在多个槽与某个信号相关联，那么，当这个信号被发射时，这些槽将会一个接一个地执行，但是它们执行的顺序将会是随机的、不确定的，我们不能人为地指定哪个先执行、哪个后执行。

信号的声明是在头文件中进行的，QT 的 signals 关键字指出进入了信号声明区，随后即可声明自己的信号。

signals: 
		 void mySignal(); 
		 void mySignal(int x); 
		 void mySignalParam(int x,int y);

在上面的定义中，signals 是 QT 的关键字，而非 C/C++ 的。接下来的一行 void mySignal() 定义了信号 mySignal，这个信号没有携带参数；接下来的一行 void mySignal(int x) 定义了重名信号 mySignal，但是它携带一个整形参数，这有点类似于 C++ 中的虚函数。从形式上讲信号的声明与普通的 C++ 函数是一样的，但是信号却没有函数体定义，另外，信号的返回类型都是 void。

三、槽

槽是普通的 C++ 成员函数，可以被正常调用，它们唯一的特殊性就是很多信号可以与其相关联。当与其关联的信号被发射时，这个槽就会被调用。槽可以有参数，但槽的参数不能有缺省值。

既然槽是普通的成员函数，因此与其它的函数一样，它们也有存取权限。槽的存取权限决定了谁能够与其相关联。同普通的 C++ 成员函数一样，槽函数也分为三种类型，即 public slots、private slots 和 protected slots。

• public slots：在这个区内声明的槽意味着任何对象都可将信号与之相连接。
• protected slots：在这个区内声明的槽意味着当前类及其子类可以将信号与之相连接。这适用于那些槽，它们是类实现的一部分，但是其界面接口却面向外部。
• private slots：在这个区内声明的槽意味着只有类自己可以将信号与之相连接。

槽也能够声明为虚函数，槽的声明也是在头文件中进行的。例如，下面声明了三个槽：

public slots: 
		 void mySlot(); 
		 void mySlot(int x); 
		 void mySignalParam(int x,int y);

三、信号与槽的关联

通过调用 QObject 对象的 connect 函数来将某个对象的信号与另外一个对象的槽函数相关联，这样当发射者发射信号时，接收者的槽函数将被调用。该函数的定义如下：

bool QObject::connect ( const QObject * sender, const char * signal, 
		 const QObject * receiver, const char * member ) [static]

这个函数的作用就是将发射者 sender 对象中的信号 signal 与接收者 receiver 中的 member 槽函数联系起来。当指定信号 signal 时必须使用 QT 的宏 SIGNAL()，当指定槽函数时必须使用宏 SLOT()。如果发射者与接收者属于同一个对象的话，那么在 connect 调用中接收者参数可以省略。

例如，下面定义了两个对象：标签对象 label 和滚动条对象 scroll，并将 valueChanged() 信号与标签对象的 setNum() 相关联，另外信号还携带了一个整形参数，这样标签总是显示滚动条所处位置的值。

QLabel     *label  = new QLabel; 
    QScrollBar *scroll = new QScrollBar; 
    QObject::connect( scroll, SIGNAL(valueChanged(int)), 
                      label,  SLOT(setNum(int)) );

四、一个例子

//tsignal.h 
 ... 
 class TsignalApp:public QMainWindow 
 { 
	 Q_OBJECT 
	 ... 
	 // 信号声明区
	 signals: 
		 // 声明信号 mySignal() 
		 void mySignal(); 
		 // 声明信号 mySignal(int) 
		 void mySignal(int x); 
		 // 声明信号 mySignalParam(int,int) 
		 void mySignalParam(int x,int y); 
	 // 槽声明区
	 public slots: 
		 // 声明槽函数 mySlot() 
		 void mySlot(); 
		 // 声明槽函数 mySlot(int) 
		 void mySlot(int x); 
		 // 声明槽函数 mySignalParam (int，int) 
		 void mySignalParam(int x,int y); 
 } 
 ... 
 //tsignal.cpp 
 ... 
 TsignalApp::TsignalApp() 
 { 
	 ... 
	 // 将信号 mySignal() 与槽 mySlot() 相关联
	 connect(this,SIGNAL(mySignal()),SLOT(mySlot())); 
	 // 将信号 mySignal(int) 与槽 mySlot(int) 相关联
	 connect(this,SIGNAL(mySignal(int)),SLOT(mySlot(int))); 
	 // 将信号 mySignalParam(int,int) 与槽 mySlotParam(int,int) 相关联
	 connect(this,SIGNAL(mySignalParam(int,int)),SLOT(mySlotParam(int,int))); 
 } 
 // 定义槽函数 mySlot() 
 void TsignalApp::mySlot() 
 { 
	 QMessageBox::about(this,"Tsignal", "This is a signal/slot sample without 
 parameter."); 
 } 
 // 定义槽函数 mySlot(int) 
 void TsignalApp::mySlot(int x) 
 { 
	 QMessageBox::about(this,"Tsignal", "This is a signal/slot sample with one 
 parameter."); 
 } 
 // 定义槽函数 mySlotParam(int,int) 
 void TsignalApp::mySlotParam(int x,int y) 
 { 
	 char s[256]; 
	 sprintf(s,"x:%d y:%d",x,y); 
	 QMessageBox::about(this,"Tsignal", s); 
 } 
 void TsignalApp::slotFileNew() 
 { 
	 // 发射信号 mySignal() 
	 emit mySignal(); 
	 // 发射信号 mySignal(int) 
	 emit mySignal(5); 
	 // 发射信号 mySignalParam(5，100) 
	 emit mySignalParam(5,100); 
 }

五、要注意的问题

1.信号与槽机制与普通函数的调用一样，如果使用不当的话，在程序执行时也有可能产生死循环。因此，在定义槽函数时一定要注意避免间接形成无限循环，即在槽中再次发射所接收到的同样信号。例如 , 在前面给出的例子中如果在 mySlot() 槽函数中加上语句 emit mySignal() 即可形成死循环。

2.如果一个信号与多个槽相联系的话，那么，当这个信号被发射时，与之相关的槽被激活的顺序将是随机的。

3.宏定义不能用在 signal 和 slot 的参数中。

4.构造函数不能用在 signals 或者 slots 声明区域内。

class SomeClass : public QObject 
    { 
        Q_OBJECT 
    public slots: 
        SomeClass( QObject *parent, const char *name ) 
            : QObject( parent, name ) {}  // 在槽声明区内声明构造函数不合语法
    [...] 
    };

5.函数指针不能作为信号或槽的参数。

class someClass : public QObject 
    { 
        Q_OBJECT 
    [...] 
    public slots: 
        void apply(void (*applyFunction)(QList*, void*), char*); // 不合语法
    };

6.信号与槽不能有缺省参数。

 class SomeClass : public QObject 
    { 
        Q_OBJECT 
    public slots: 
        void someSlot(int x=100); // 将 x 的缺省值定义成 100，在槽函数声明中使用是错误的
    };

7. 嵌套的类不能位于信号或槽区域内，也不能有信号或者槽。

class A 
    { 
        Q_OBJECT 
    public: 
        class B 
    { 
        public slots:   // 在嵌套类中声明槽不合语法
            void b(); 
        [....] 
        }; 
    signals: 
        class B 
    { 
        // 在信号区内声明嵌套类不合语法
        void b(); 
        [....] 
        }: 
    };