QMetaObject::Connection Class | Qt Core | Qt 6.11.0

- Qt 6.11
- Qt Core
- C++ Classes
- Connection
- Qt 6.11.0 Reference Documentation

# QMetaObject::Connection Class

class QMetaObject::Connection

- List of all members, including inherited members

## Public Functions

| Connection()
| Connection(const QMetaObject::Connection &other)
| Connection(QMetaObject::Connection &&o)
| ~Connection()
void | swap(QMetaObject::Connection &other)
| operator bool() const
QMetaObject::Connection & | operator=(QMetaObject::Connection &&other)
QMetaObject::Connection & | operator=(const 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.

### 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.

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

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

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

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