Home · All Classes · All Namespaces · Modules · Functions · Files |
The OutgoingDBusTubeChannel class represents an outgoing Telepathy channel of type DBusTube. More...
#include <TelepathyQt/OutgoingDBusTubeChannel>
Inherits Tp::DBusTubeChannel.
The OutgoingDBusTubeChannel class represents an outgoing Telepathy channel of type DBusTube.
Outgoing (locally initiated/requested) tubes are initially in the TubeChannelStateNotOffered state. When offerTube is called, the connection manager takes care of instantiating a new DBus server, at which point the tube state becomes TubeChannelStateRemotePending.
If the target accepts the connection request, the state goes TubeChannelStateOpen and both sides can start using the new private bus, the address of which can be retrieved from the completed PendingDBusTubeConnection or from this class.
For more details, please refer to Telepathy specification.
Tp::OutgoingDBusTubeChannel::~OutgoingDBusTubeChannel | ( | ) | [virtual] |
Class destructor.
Tp::OutgoingDBusTubeChannel::OutgoingDBusTubeChannel | ( | const ConnectionPtr & | connection, |
const QString & | objectPath, | ||
const QVariantMap & | immutableProperties | ||
) | [protected] |
Construct a new OutgoingDBusTubeChannel object.
connection | Connection owning this channel, and specifying the service. |
objectPath | The object path of this channel. |
immutableProperties | The immutable properties of this channel. |
OutgoingDBusTubeChannelPtr Tp::OutgoingDBusTubeChannel::create | ( | const ConnectionPtr & | connection, |
const QString & | objectPath, | ||
const QVariantMap & | immutableProperties | ||
) | [static] |
Create a new OutgoingDBusTubeChannel channel.
connection | Connection owning this channel, and specifying the service. |
objectPath | The object path of this channel. |
immutableProperties | The immutable properties of this channel. |
Reimplemented from Tp::DBusTubeChannel.
PendingDBusTubeConnection * Tp::OutgoingDBusTubeChannel::offerTube | ( | const QVariantMap & | parameters, |
bool | allowOtherUsers = false |
||
) |
Offer the tube
This method sets up a private DBus connection to the channel target(s), and offers it through the tube.
The PendingDBusTubeConnection returned by this method will be completed as soon as the tube is opened and ready to be used.
This method requires DBusTubeChannel::FeatureCore to be enabled.
parameters | A dictionary of arbitrary Parameters to send with the tube offer. The other end will receive this QVariantMap in the parameters() method of the corresponding IncomingDBusTubeChannel. |
allowOtherUsers | Whether the server should allow other users to connect to this tube more than just the current one. If your application has no specific needs, it is advisable not to modify the default value of this argument. |
Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation | Telepathy-Qt 0.9.3 |