qt5中的连接
有下列几种方式可以连接到信号上
旧语法
qt5将继续支持旧的语法去连接,在QObject对象上定义信号和槽函数,及任何继承QObjec的对象(包含QWidget)。
connect(sender, SIGNAL (valueChanged(QString,QString)),receiver, SLOT (updateValue(QString)) );
新语法:连接到QObject成员
下面是一种新的方式来连接两个QObjects:
connect(sender, &Sender::valueChanged,receiver, &Receiver::updateValue );
它支持:
- 编译期间检查信号和槽是否存在,它们的类型,及Q_OBJECT是否丢失
- 参数能被typedef或不同命名空间指定。
- 如果有隐式转换的参数,会自动转换类型。比如QString到QVariant
- 它可以连接QObject的任何成员方法,不仅仅是定义的槽。
它不支持:
- 更复杂的语法?你需要指定你的对象类型、
- 非常复杂的语法,比如重载,参见后面。
- 在槽的中默认参数不在被支持。
新语法:连接到简单的函数
新语法甚至能连接到函数,不仅仅是QObjects:
connect(sender, &Sender::valueChanged, someFunction);
支持:
能和tr1::bind一起使用:
connect(sender, &Sender::valueChanged, tr1::bind(receiver, &Receiver::updateValue, "senderValue", tr1::placeholder::_1));
能和c++ 11 lambda表达式一起使用:
connect(sender, &Sender::valueChanged, [=](const QString &newValue) { receiver->updateValue("senderValue", newValue); });
不支持:
当receiver被销毁时,新语法不能自动断开信号和槽的连接。 因为它是没有跟QObject一起的伪函数。不管怎样,从5.2版本开始有一个重载函数,它添加一个上下文对象,当对象摧毁时,这个连接会破坏。这个上下文也被使用在线程关联性上: 这个lambda方法将会被调用在对象事件循环的线程中。
qt5中断开连接
如你可能预期的那样,在qt5中如何终止连接也会有一些新变化。
旧方式
你仍可以旧方式断开连接(使用SIGNAL, SLOT方式)。但仅限是
- 你使用旧方式连接,或者
- 如果你想使用通配符,从指定的信号中断开所有的槽
对称的函数指针
disconnect(sender, &Sender::valueChanged,
receiver, &Receiver::updateValue );
这只可以用在你使用同样方式的连接上,或者你也可以使用0作为通配。 在实际中,它也不适用于静态函数,仿函数,或lambda函数。
使用QMetaObject::Connection的新方式
QMetaObject::Connection m_connection;
//…
m_connection = QObject::connect(…);
//…
QObject::disconnect(m_connection);
这适用于所有场景下,包括lambda函数和伪函数。
更简单的异步
随着C++ 11,它可以保持代码内联
void doYourStuff(const QByteArray &page)
{
QTcpSocket *socket = new QTcpSocket;
socket->connectToHost("qt.io", 80);
QObject::connect(socket, &QTcpSocket::connected, [socket, page] () {
socket->write(QByteArray("GET " + page + ""));
});
QObject::connect(socket, &QTcpSocket::readyRead, [socket] () {
qDebug()<< "GOT DATA "<< socket->readAll();
});
QObject::connect(socket, &QTcpSocket::disconnected, [socket] () {
qDebug()<< "DISCONNECTED ";
socket->deleteLater();
});
QObject::connect(socket, static_cast
(&QAbstractSocket::error), [socket](QAbstractSocket::SocketError) {
qDebug()<< "ERROR " << socket->errorString();
socket->deleteLater();
});
}
下面是一个不用重新进入事件循环的QDialog,保持代码属于:
void Doc::saveDocument() {
QFileDialog *dlg = new QFileDialog();
dlg->open();
QObject::connect(dlg, &QDialog::finished, [dlg, this](int result) {
if (result) {
QFile file(dlg->selectedFiles().first());
// …
}
dlg->deleteLater();
});
}
使用QHttpServer的另外例子。
错误报告
用GCC测试的、
幸运的是,IDE能简化函数的命名,比如Qt Creator。
忘记Q_OBJECT
#include
class Goo : public QObject {
Goo() {
connect(this, &Goo::someSignal, this, &QObject::deleteLater);
}
signals:
void someSignal();
};
qobject.h: In member function 'void QObject::qt_check_for_QOBJECT_macro(const T&&) const [with T = Goo]':
qobject.h:535:9: instantiated from 'static typename QtPrivate::QEnableIf<((int)
(QtPrivate::FunctionPointer::ArgumentCount) >= (int)
(QtPrivate::FunctionPointer::ArgumentCount)), void*>::Type QObject::connect(const typename
QtPrivate::FunctionPointer::Object*, Func1, const typename QtPrivate::FunctionPointer::Object*,
Func2, Qt::ConnectionType) [with Func1 = void (Goo::*)(), Func2 = void (QObject::*)(), typename
QtPrivate::QEnableIf<((int)(QtPrivate::FunctionPointer::ArgumentCount) >= (int)
(QtPrivate::FunctionPointer::ArgumentCount)), void*>::Type = void*, typename
QtPrivate::FunctionPointer::Object = Goo, typename QtPrivate::FunctionPointer::Object = QObject]'
main.cc:4:68: instantiated from here
qobject.h:353:5: error: void value not ignored as it ought to be
make: '''* [main.o] Error 1
拼写错误
#include
class Goo : public QObject {
Q_OBJECT
public:
Goo() {
connect(this, &Goo::someSignal, this, &Goo::someSlot1); //error
connect(this, &Goo::someSignal, this, &Goo::someSlot2); //works
}
signals:
void someSignal(QString);
public:
void someSlot1(int);
void someSlot2(QVariant);
};
qobject.h: In static member function 'static typename QtPrivate::QEnableIf<((int)
(QtPrivate::FunctionPointer::ArgumentCount) >= (int)
(QtPrivate::FunctionPointer::ArgumentCount)), void*>::Type QObject::connect(const typename
QtPrivate::FunctionPointer::Object*, Func1, const typename QtPrivate::FunctionPointer::Object*,
Func2, Qt::ConnectionType) [with Func1 = void (Goo::*)(QString), Func2 = void (Goo::*)(int), typename
QtPrivate::QEnableIf<((int)(QtPrivate::FunctionPointer::ArgumentCount) >= (int)
(QtPrivate::FunctionPointer::ArgumentCount)), void*>::Type = void*, typename
QtPrivate::FunctionPointer::Object = Goo, typename QtPrivate::FunctionPointer::Object = Goo]':
main.cc:6:62: instantiated from here
qobject.h:538:163: error: no type named 'IncompatibleSignalSlotArguments' in 'struct
QtPrivate::CheckCompatibleArguments, QtPrivate::List, true>'
qobject.h: In static member function 'static void QtPrivate::FunctionPointer::call
(QtPrivate::FunctionPointer::Function, Obj*, void*) [with Args = QtPrivate::List,
Obj = Goo, Ret = void, Arg1 = int, QtPrivate::FunctionPointer::Function = void (Goo::*)(int)]':
qobject.h:501:13: instantiated from 'void QObject::QSlotObject::call(QObject*, void**) [with Func =
void (Goo::*)(int), Args = QtPrivate::List, QObject = QObject]'
main.cc:14:2: instantiated from here
qobject.h:109:13: error: cannot conver
开放式问题
槽中的默认参数
如果你有类似下面的代码:
class A : public QObject { Q_OBJECT
public slots:
void someSlot(int foo = 0);
};
旧的连接方式允许你连接这个槽到信号上,不用带参数。 但是我不能从模板代码中知道一个函数是否带有默认参数。因此这个功能是被禁用的。 这里有个实现方法是,如果槽函数中参数数量多于信号函数中的参数数量时,退回到旧方式去连接。 不管怎样,这是相当不一致的,因此旧语法不再执行类型类型检查和类型转换。 它已经从分支中移除,并被合并。
重载
如你在上面例子中看到的那样,连接到QAbstractSocket::error,它不是真正完美的方式,因为error有一个重载。取得一个重载函数的地址需要隐式转换。比如一个连接如下所示:
connect(mySpinBox, SIGNAL(valueChanged(int)), mySlider, SLOT(setValue(int));
它不能简单的转换到:
connect(mySpinBox, &QSpinBox::valueChanged, mySlider, &QSlider::setValue);
因为 QSpinBox有2个信号,名字都叫valueChanged()带有不同的参数。 新方式要用下列代码替代:
connect(mySpinBox, static_cast(&QSpinBox::valueChanged), mySlider, &QSlider::setValue);
最好的方式是尽量不要重载信号和槽。
但是我们已经在过去的release版本中添加重载了,因为取得函数的地址不是我们支持的使用方式。 但是现在不破坏代码兼用性已经是不可能的。
断开连接
是否QMetaObject::Connection应该有一个disconnect()函数?
其他的难题是,如果我们使用新语法,在一些对象关闭时,不能自动断开连接。一个方式是在断开连接中添加对象的集合,或者一个新函数例如QMetaObject::Connection::require
auto c = connect(sender, &Sender::valueChanged, [=](const QString &newValue) {
receiver->updateValue("senderValue", newValue);
} , QList { receiver } ); // solution 1
c.require(receiver); // solution 2
方案2是否有效? 没有什么比得上QMetaObject::Connection::require()
回调
函数例如QHostInfo::lookupHost或QTimer::singleShot或QFileDialog::open 带有一个QObject接收者和 char* 的slot。 这在新方式中是不能用的。 如果你想用c++方式的回调,应该使用 std::function (or tr1)。但我们不能在我们的API中,使用STL类型,因此一个qt函数应该被完成当复制一个std::function时。 无论如何,这是和QObject连接是不相关的。
译自:https://wiki.qt.io/New_Signal_Slot_Syntax