QSoundCloud
A Qt/C++ library and QML module to access the SoundCloud Data API.
 All Classes Functions Enumerations Properties Groups Pages
Public Types | Public Slots | Signals | Public Member Functions | Properties | List of all members
QSoundCloud::StreamsModel Class Reference

A list model for displaying list of streams for a SoundCloud track. More...

Inheritance diagram for QSoundCloud::StreamsModel:
QSoundCloud::Model

Public Types

enum  Roles
 The data roles available for accessing the model data. More...

Public Slots

void get (const QString &id)
 Retrieves a list of streams for a SoundCloud track.
void cancel ()
 Cancels the current request.
void reload ()
 Clears any existing data and retreives a new list of streams using the existing parameters.
- Public Slots inherited from QSoundCloud::Model
void clear ()
 Removes all items.

Signals

void statusChanged (QSoundCloud::StreamsRequest::Status s)
 Emitted when the status changes.
- Signals inherited from QSoundCloud::Model
void countChanged (int c)
 Emitted when items are added/removed.

Public Member Functions

void setNetworkAccessManager (QNetworkAccessManager *manager)
 Sets the QNetworkAccessManager instance to be used when making requests.
- Public Member Functions inherited from QSoundCloud::Model
int rowCount (const QModelIndex &parent=QModelIndex()) const
 Returns the number of items in the model.
QVariant data (const QModelIndex &index, int role) const
 Re-implemented from QAbstractListModel::data()
QMap< int, QVariant > itemData (const QModelIndex &index) const
 Re-implemented from QAbstractListModel::itemData()
bool setData (const QModelIndex &index, const QVariant &value, int role)
 Re-implemented from QAbstractListModel::setData()
bool setItemData (const QModelIndex &index, const QMap< int, QVariant > &roles)
 Re-implemented from QAbstractListModel::setItemData()
void append (const QMap< int, QVariant > &roles)
 Appends an item using the data in roles.
void insert (const QModelIndex &index, const QMap< int, QVariant > &roles)
 Inserts an item before index using the data in roles.
bool remove (const QModelIndex &index)
 Removes the item at index.
Q_INVOKABLE QVariantMap get (int row) const
 Returns the item at row.
Q_INVOKABLE bool setProperty (int row, const QString &property, const QVariant &value)
 Sets the property of the item at row to value.
Q_INVOKABLE bool set (int row, const QVariantMap &properties)
 Sets the properties of the item at row to properties.
Q_INVOKABLE void append (const QVariantMap &properties)
 Appends an item to the model using properties.
Q_INVOKABLE void insert (int row, const QVariantMap &properties)
 Inserts an item before row to the model using properties.
Q_INVOKABLE bool remove (int row)
 Removes the item at row.

Properties

QSoundCloud::StreamsRequest::Status status
 The current status of the model.
QVariant result
 The current result of the model.
QSoundCloud::StreamsRequest::Error error
 The error type of the model.
QString errorString
 A description of the error of the model.
- Properties inherited from QSoundCloud::Model
int count
 The number of items in the model.

Detailed Description

A list model for displaying list of streams for a SoundCloud track.

The StreamsModel is a list model used for displaying SoundCloud track streams in a list view. StreamsModel provides the same methods that are available in StreamsRequest, so it is better to simply use that class if you do not need the additional features provided by a data model.

StreamsModel provides the following roles and role names:

Role Role name
IdRole id
DescriptionRole description
ExtensionRole ext
UrlRole url

Example usage:

C++

using namespace QSoundCloud;
...
QListView *view = new QListView(this);
StreamsModel *model = new StreamsModel(this);
view->setModel(model);
model->get(TRACK_ID);

QML

import QtQuick 1.0
import QSoundCloud 1.0
ListView {
id: view
width: 800
height: 480
model: StreamsModel {
id: streamsModel
}
delegate: Text {
width: view.width
height: 50
horizontalAlignment: Text.AlignHCenter
verticalAlignment: Text.AlignVCenter
elide: Text.ElideRight
text: description
}
Component.onCompleted: streamsModel.list(TRACK_ID)
}
See Also
StreamsRequest

Member Enumeration Documentation

The data roles available for accessing the model data.

See the detailed description for the list of available roles.

Member Function Documentation

void QSoundCloud::StreamsModel::cancel ( )
slot

Cancels the current request.

See Also
StreamsRequest::cancel()
void QSoundCloud::StreamsModel::get ( const QString &  id)
slot

Retrieves a list of streams for a SoundCloud track.

See Also
StreamsRequest::get()
void QSoundCloud::StreamsModel::setNetworkAccessManager ( QNetworkAccessManager *  manager)

Sets the QNetworkAccessManager instance to be used when making requests.

StreamsModel does not take ownership of manager.

If no QNetworkAccessManager is set, one will be created when required.

See Also
StreamsRequest::setNetworkAccessManager()

Property Documentation

StreamsRequest::Error QSoundCloud::StreamsModel::error
read

The error type of the model.

See Also
StreamsRequest::error
QString QSoundCloud::StreamsModel::errorString
read

A description of the error of the model.

See Also
StreamsRequest::status
QVariant QSoundCloud::StreamsModel::result
read

The current result of the model.

See Also
StreamsRequest::result
StreamsRequest::Status QSoundCloud::StreamsModel::status
read

The current status of the model.

See Also
StreamsRequest::status