MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9
   Home · All Classes · All Namespaces · Modules · Functions · Files

The TubeChannel class is a base class for all tube types. More...

#include <TelepathyQt4/TubeChannel>

Inherits Tp::Channel.

Inherited by Tp::StreamTubeChannel.

List of all members.

Signals

Public Member Functions

Static Public Member Functions

  • static TubeChannelPtr create (const ConnectionPtr &connection, const QString &objectPath, const QVariantMap &immutableProperties)

Static Public Attributes

Protected Member Functions


Detailed Description

The TubeChannel class is a base class for all tube types.

A tube is a mechanism for arbitrary data transfer between two or more IM users, used to allow applications on the users' systems to communicate without having to establish network connections themselves.

Note that TubeChannel should never be instantiated directly, instead one of its subclasses (e.g. IncomingStreamTubeChannel or OutgoingStreamTubeChannel) should be used.

See Asynchronous Object Model, Shared Pointer Usage


Constructor & Destructor Documentation

Tp::TubeChannel::~TubeChannel (  )  [virtual]

Class destructor.

Tp::TubeChannel::TubeChannel ( const ConnectionPtr &  connection,
const QString objectPath,
const QVariantMap &  immutableProperties,
const Feature coreFeature = TubeChannel::FeatureCore  
) [protected]

Construct a new TubeChannel object.

Parameters:
connection  Connection owning this channel, and specifying the service.
objectPath  The channel object path.
immutableProperties  The channel immutable properties.
coreFeature  The core feature of the channel type, if any. The corresponding introspectable should depend on TubeChannel::FeatureCore.

Member Function Documentation

TubeChannelPtr Tp::TubeChannel::create ( const ConnectionPtr &  connection,
const QString objectPath,
const QVariantMap &  immutableProperties  
) [static]

Create a new TubeChannel channel.

Parameters:
connection  Connection owning this channel, and specifying the service.
objectPath  The channel object path.
immutableProperties  The channel immutable properties.
Returns:
A TubeChannelPtr object pointing to the newly created TubeChannel object.

Reimplemented from Tp::Channel.

Reimplemented in Tp::IncomingStreamTubeChannel, Tp::OutgoingStreamTubeChannel, and Tp::StreamTubeChannel.

TubeChannelState Tp::TubeChannel::state (  )  const

Return the state of this tube.

Change notification is via the stateChanged() signal.

This method requires TubeChannel::FeatureCore to be ready.

Returns:
The state as TubeChannelState.
See also:
stateChanged()
TubeChannelState Tp::TubeChannel::tubeState (  )  const
Deprecated:
Use state() instead.
QVariantMap Tp::TubeChannel::parameters (  )  const

Return the parameters associated with this tube, if any.

The parameters are populated when an outgoing tube is offered, but they are most useful in the receiving end, where the parameters passed to the offer can be extracted for the tube's entire lifetime to bootstrap legacy protocols. All parameters are passed unchanged.

This method requires TubeChannel::FeatureCore to be ready.

Returns:
The parameters as QVariantMap.
void Tp::TubeChannel::stateChanged ( Tp::TubeChannelState  state  )  [signal]

Emitted when the value of state() changes.

See also:
state The new state of this tube.
void Tp::TubeChannel::tubeStateChanged ( Tp::TubeChannelState  state  )  [signal]
void Tp::TubeChannel::setParameters ( const QVariantMap &  parameters  )  [protected]
void Tp::TubeChannel::connectNotify ( const char *  signalName  )  [protected]

Member Data Documentation

Feature representing the core that needs to become ready to make the TubeChannel object usable.

Note that this feature must be enabled in order to use most TubeChannel methods. See specific methods documentation for more details.

Reimplemented from Tp::Channel.

Reimplemented in Tp::IncomingStreamTubeChannel, Tp::OutgoingStreamTubeChannel, and Tp::StreamTubeChannel.


Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation
Telepathy-Qt4 0.6.5