class Inti::Connection

Name

class Inti::Connection --  Represents a signal connection

Synopsis

class Inti::Connection is declared in the header inti/connection.h.

Superclasses. none

Subclasses. none

Class members

Important Public Methods.
void disconnect ()
void block ()
void unblock ()

Public Constructors.
Connection ()
Connection (const Connection & src)

Public Destructor.
~Connection ()

Public Methods.
Connection& operator= (const Connection& src)

Description

When you connect a slot to a signal, a Connection object is returned. The Connection can be used to disconnect the slot from the signal, or temporarily "block" the connection (prevent the slot from being invoked).

For example:

Important Public Methods

method Inti::Connection::disconnect

void disconnect ()

Permanently severs the connection; the slot will never be invoked again. Calling disconnect() a second time is safe, but has no effect.

method Inti::Connection::block

void block ()

Blocks the connection, temporarily preventing the connected slot from being invoked. block() may be called multiple times; if so, unblock() must be called the same number of times before the connection becomes unblocked.

method Inti::Connection::unblock

void unblock ()

Unblocks the connection, allowing the connected slot to be invoked. If block() was called more than once, unblock() must be called the same number of times before the connection will be unblocked.

Public Constructors

method Inti::Connection::Connection

Connection ()

This constructor creates an uninitialized connection.

method Inti::Connection::Connection

Connection (const Connection & src)

Copies a Connection. All copies of a Connection manipulate the same connection, that is, it doesn't matter which copy you use to disconnect(), block(), or unblock().

srcConnection to copy

Public Destructor

method Inti::Connection::~Connection

~Connection ()

Destructs a Connection. Has no user-visible side effects.

Public Methods

method Inti::Connection::operator=

Connection& operator= (const Connection& src)

Assigns one connection to another. All copies of a Connection manipulate the same connection, that is, it doesn't matter which copy you use to disconnect(), block(), or unblock().

srcConnection to assign