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

The OutgoingFileTransferChannel class represents a Telepathy channel of type FileTransfer for outgoing file transfers. More...

#include <TelepathyQt4/OutgoingFileTransferChannel>

Inherits Tp::FileTransferChannel.

List of all members.

Public Member Functions

Static Public Member Functions

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

Static Public Attributes

Protected Member Functions


Detailed Description

The OutgoingFileTransferChannel class represents a Telepathy channel of type FileTransfer for outgoing file transfers.

For more details, please refer to Telepathy specification.

See Asynchronous Object Model, Shared Pointer Usage


Constructor & Destructor Documentation

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

Class destructor.

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

Construct a new OutgoingFileTransferChannel 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 OutgoingFileTransferChannel::FeatureCore.

Member Function Documentation

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

Create a new OutgoingFileTransferChannel object.

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

Reimplemented from Tp::FileTransferChannel.

PendingOperation * Tp::OutgoingFileTransferChannel::provideFile ( QIODevice input  ) 

Provide the file for an outgoing file transfer which has been offered.

The state will change to FileTransferStateOpen as soon as the transfer starts. The given input device should not be destroyed until the state() changes to FileTransferStateCompleted or FileTransferStateCancelled. If input is a sequential device QIODevice::isSequential(), it should be closed when no more data is available, so that it's known when to stop reading.

Only the primary handler of a file transfer channel may call this method.

This method requires FileTransferChannel::FeatureCore to be ready.

Parameters:
input  A QIODevice object where the data will be read from.
Returns:
A PendingOperation object which will emit PendingOperation::finished when the call has finished.
See also:
stateChanged(), state(), stateReason()

Member Data Documentation

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

This is currently the same as FileTransferChannel::FeatureCore, but may change to include more.

When calling isReady(), becomeReady(), this feature is implicitly added to the requested features.

Reimplemented from Tp::FileTransferChannel.


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