Connection Class

class QMetaObject::Connection

Public Functions

Connection()
Connection(const QMetaObject::Connection &other)
Connection(QMetaObject::Connection &&o)
~Connection()
void swap(QMetaObject::Connection &other)
bool operator bool() const
QMetaObject::Connection &operator=(const QMetaObject::Connection &other)
QMetaObject::Connection &operator=(QMetaObject::Connection &&other)

Detailed Description

Represents a handle to a signal-slot (or signal-functor) connection.

It can be used to check if the connection is valid and to disconnect it using QObject::disconnect(). For a signal-functor connection without a context object, it is the only way to selectively disconnect that connection.

As Connection is just a handle, the underlying signal-slot connection is unaffected when Connection is destroyed or reassigned.

Member Function Documentation

Connection::Connection()

Creates a Connection instance.

Connection::Connection(const QMetaObject::Connection &other)

Create a copy of the handle to the other connection

[noexcept] Connection::Connection(QMetaObject::Connection &&o)

Move-constructs a Connection instance, making it point to the same object that o was pointing to.

[noexcept] Connection::~Connection()

Destructor for QMetaObject::Connection.

[noexcept] void Connection::swap(QMetaObject::Connection &other)

Swaps this Connection instance with other. This operation is very fast and never fails.

bool Connection::operator bool() const

Returns true if the connection is valid.

The connection is valid if the call to QObject::connect succeeded. The connection is invalid if QObject::connect was not able to find the signal or the slot, or if the arguments do not match.

QMetaObject::Connection &Connection::operator=(const QMetaObject::Connection &other)

Assigns other to this connection and returns a reference to this connection.

[noexcept] QMetaObject::Connection &Connection::operator=(QMetaObject::Connection &&other)

Move-assigns other to this object, and returns a reference.