MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QBluetoothTransferReply Class Reference

The QBluetoothTransferReply class contains the data and headers for a request sent with QBluetoothTranferManager. More...

 #include <QBluetoothTransferReply>

Inherits: QObject.

This class was introduced in Qt Mobility 1.2.

Public Types

enum TransferError { NoError, UnknownError, FileNotFoundError, HostNotFoundError, UserCanceledTransferError }

Public Functions

~QBluetoothTransferReply ()
QVariant attribute ( QBluetoothTransferRequest::Attribute code ) const
virtual TransferError error () const = 0
virtual QString errorString () const = 0
virtual bool isFinished () const = 0
virtual bool isRunning () const = 0
QBluetoothTransferManager * manager () const
QBluetoothTransferManager::Operation operation () const
  • 29 public functions inherited from QObject

Public Slots

void abort ()
  • 1 public slot inherited from QObject

Signals

void downloadProgress ( qint64 bytesReceived, qint64 bytesTotal )
void finished ( QBluetoothTransferReply * reply )
void uploadProgress ( qint64 bytesSent, qint64 bytesTotal )

Protected Functions

QBluetoothTransferReply ( QObject * parent = 0 )
void setAttribute ( QBluetoothTransferRequest::Attribute code, const QVariant & value )
void setManager ( QBluetoothTransferManager * manager )
void setOperation ( QBluetoothTransferManager::Operation operation )
  • 7 protected functions inherited from QObject

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QBluetoothTransferReply class contains the data and headers for a request sent with QBluetoothTranferManager.

In additional to a copy of the QBluetoothTransferRequest object used to create the request, QBluetoothTransferReply contains the contents of the reply itself.

QBluetoothTransferReply is a sequential-access QIODevice, which means that once data is read from the object, it no longer kept by the device. It is therefore the application's responsibility to keep this data if it needs to. Whenever more data is received and processed, the readyRead() signal is emitted.

The downloadProgress() signal is also emitted when data is received, but the number of bytes contained in it may not represent the actual bytes received, if any transformation is done to the contents (for example, decompressing and removing the protocol overhead).

Even though QBluetoothTransferReply is a QIODevice connected to the contents of the reply, it also emits the uploadProgress() signal, which indicates the progress of the upload for operations that have such content.

Member Type Documentation

enum QBluetoothTransferReply::TransferError

This enum describes the type of error that occurred

Constant Value Description
QBluetoothTransferReply::NoError 0 No error.
QBluetoothTransferReply::UnknownError 1 Unknown error, no better enum available
QBluetoothTransferReply::FileNotFoundError 2 Unable to open the file specified
QBluetoothTransferReply::HostNotFoundError 3 Unable to connect to the target host
QBluetoothTransferReply::UserCanceledTransferError 4 User terminated the transfer

Member Function Documentation

QBluetoothTransferReply::QBluetoothTransferReply ( QObject * parent = 0 ) [protected]

Constructs a new QBluetoothTransferReply with parent parent.

QBluetoothTransferReply::~QBluetoothTransferReply ()

Destroys the QBluetoothTransferReply object.

void QBluetoothTransferReply::abort () [slot]

Aborts this reply.

QVariant QBluetoothTransferReply::attribute ( QBluetoothTransferRequest::Attribute code ) const

Returns the attribute associated with the code code. If the attribute has not been set, it returns an invalid QVariant.

See also setAttribute().

void QBluetoothTransferReply::downloadProgress ( qint64 bytesReceived, qint64 bytesTotal ) [signal]

This signal is emitted whenever data is received. The bytesReceived parameter contains the total number of bytes received so far out of bytesTotal expected for the entire transfer.

TransferError QBluetoothTransferReply::error () const [pure virtual]

QString QBluetoothTransferReply::errorString () const [pure virtual]

String describing the error. Can be displayed to the user.

void QBluetoothTransferReply::finished ( QBluetoothTransferReply * reply ) [signal]

This signal is emitted when the transfer is complete for reply.

bool QBluetoothTransferReply::isFinished () const [pure virtual]

Returns true if this reply has finished; otherwise returns false.

bool QBluetoothTransferReply::isRunning () const [pure virtual]

Returns true if this reply is running; otherwise returns false.

QBluetoothTransferManager * QBluetoothTransferReply::manager () const

Returns the QBluetoothTransferManager that was used to create this QBluetoothTransferReply object.

See also setManager().

QBluetoothTransferManager::Operation QBluetoothTransferReply::operation () const

Returns the type of operation that this reply is for.

See also setOperation().

void QBluetoothTransferReply::setAttribute ( QBluetoothTransferRequest::Attribute code, const QVariant & value ) [protected]

Set the attribute associated with the code code to the value value.

See also attribute().

void QBluetoothTransferReply::setManager ( QBluetoothTransferManager * manager ) [protected]

Set the reply's manager to manager manager.

See also manager().

void QBluetoothTransferReply::setOperation ( QBluetoothTransferManager::Operation operation ) [protected]

Sets the operation of this QBluetoothTransferReply to operation.

See also operation().

void QBluetoothTransferReply::uploadProgress ( qint64 bytesSent, qint64 bytesTotal ) [signal]

This signal is emitted whenever data is sent. The bytesSent parameter contains the total number of bytes sent so far out of bytesTotal.