Qt 5.6 | Qt Bluetooth | C++ Classes | QBluetoothTransferReply

Qt 5.6.2 Reference Documentation

# QBluetoothTransferReply Class

The QBluetoothTransferReply class stores the response for a data transfer request. More...

Header: | #include <QBluetoothTransferReply>
qmake: | QT += bluetooth
Since: | Qt 5.2
Inherits: | QObject

- List of all members, including inherited members

## Public Types

enum | TransferError { NoError, UnknownError, FileNotFoundError, HostNotFoundError, ..., SessionError }

## Public Functions

| ~QBluetoothTransferReply()
virtual TransferError | error() const = 0
virtual QString | errorString() const = 0
virtual bool | isFinished() const = 0
virtual bool | isRunning() const = 0
QBluetoothTransferManager * | manager() const
QBluetoothTransferRequest | request() const

- 31 public functions inherited from QObject

## Public Slots

void | abort()

- 1 public slot inherited from QObject

## Signals

void | error(QBluetoothTransferReply::TransferError errorType)
void | finished(QBluetoothTransferReply *reply)
void | transferProgress(qint64 bytesTransferred, qint64 bytesTotal)

- 2 signals inherited from QObject

## Protected Functions

| QBluetoothTransferReply(QObject *parent = Q_NULLPTR)
void | setManager(QBluetoothTransferManager *manager)
void | setRequest(const QBluetoothTransferRequest &request)

- 9 protected functions inherited from QObject

### Additional Inherited Members

- 1 property inherited from QObject
- 1 public variable inherited from QObject
- 10 static public members inherited from QObject
- 2 protected variables inherited from QObject

## Detailed Description

The QBluetoothTransferReply class stores the response for a data transfer request.

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

After the file transfer has started, QBluetoothTransferReply emits the transferProgress() signal, which indicates the progress of the file transfer.

## 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.
`QBluetoothTransferReply::IODeviceNotReadableError` | `5` | File was not open before initiating the sending command.
`QBluetoothTransferReply::ResourceBusyError` | `6` | Unable to access the resource..
`QBluetoothTransferReply::SessionError` | `7` | An error occurred during the handling of the session. This enum was introduced by Qt 5.4.

## Member Function Documentation

### `[protected]` QBluetoothTransferReply::QBluetoothTransferReply(QObject *parent = Q_NULLPTR)

Constructs a new QBluetoothTransferReply with parent.

### QBluetoothTransferReply::~QBluetoothTransferReply()

Destroys the QBluetoothTransferReply object.

### `[slot]` void QBluetoothTransferReply::abort()

Aborts this reply.

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

The error code of the error that occurred.

See also errorString().

### `[signal]` void QBluetoothTransferReply::error(QBluetoothTransferReply::TransferError errorType)

This signal is emitted whenever an error has occurred. The errorType parameter indicates the type of error.

To avoid the loss of signal emissions it is recommend to immidiately connect to this signal once a QBluetoothTransferReply instance has been created.

Note: Signal error is overloaded in this class. To connect to this one using the function pointer syntax, you must specify the signal type in a static cast, as shown in this example:

      connect(bluetoothTransferReply, static_cast<void(QBluetoothTransferReply::*)(QBluetoothTransferReply::TransferError)>(&QBluetoothTransferReply::error),
          [=](QBluetoothTransferReply::TransferError errorType){ /* ... */ });

This function was introduced in Qt 5.4.

See also error() and errorString().

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

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

See also error().

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

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

To avoid the loss of signal emissions it is recommend to immidiately connect to this signal once a `QBluetoothTransferReply` instance has been created.

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

Returns true if this reply has finished, otherwise false.

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

Returns true if this reply is running, otherwise false.

### QBluetoothTransferManager *QBluetoothTransferReply::manager() const

Returns the QBluetoothTransferManager that was used to create this QBluetoothTransferReply object. Initially, it is also the parent object.

See also setManager().

### QBluetoothTransferRequest QBluetoothTransferReply::request() const

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

See also setRequest().

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

Set the reply's manager to the manager.

See also manager().

### `[protected]` void QBluetoothTransferReply::setRequest(const QBluetoothTransferRequest &request)

Set the reply's request to request.

See also request().

### `[signal]` void QBluetoothTransferReply::transferProgress(qint64 bytesTransferred, qint64 bytesTotal)

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

To avoid the loss of signal emissions it is recommend to immidiately connect to this signal once a QBluetoothTransferReply instance has been created.