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

A list model for displaying Vimeo resources. More...

Inheritance diagram for QVimeo::ResourcesModel:
QVimeo::Model

Public Slots

void list (const QString &resourcePath, const QVariantMap &filters=QVariantMap())
 Retrieves a list of Vimeo resources belonging to resourcePath.
void insert (const QVariantMap &resource)
 Inserts a new Vimeo resource into the current resourcePath.
void insert (int row, const QString &resourcePath)
 Inserts the Vimeo resource at row into resourcePath.
void update (int row, const QVariantMap &resource)
 Updates the Vimeo resource at row with resource.
void del (int row)
 Deletes the Vimeo resource at row from the current resourcePath.
void del (int row, const QString &resourcePath)
 Deletes the Vimeo resource at row from resourcePath.
void cancel ()
 Cancels the current request.
void reload ()
 Clears any existing data and retreives a new list of Vimeo resources using the existing parameters.
- Public Slots inherited from QVimeo::Model
void clear ()
 Removes all items.

Signals

void clientIdChanged ()
 Emitted when the clientId changes.
void clientSecretChanged ()
 Emitted when the clientSecret changes.
void accessTokenChanged (const QString &token)
 Emitted when the accessToken changes.
void statusChanged (QVimeo::ResourcesRequest::Status s)
 Emitted when the status changes.
- Signals inherited from QVimeo::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 to the Vimeo Data API.
- Public Member Functions inherited from QVimeo::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

QString clientId
 The client id to be used when making requests to the Vimeo Data API.
QString clientSecret
 The client secret to be used when making requests to the Vimeo Data API.
QString accessToken
 The access token to be used when making requests to the Vimeo Data API.
QVimeo::ResourcesRequest::Status status
 The current status of the model.
QVariant result
 The current result of the model.
QVimeo::ResourcesRequest::Error error
 The error type of the model.
QString errorString
 A description of the error of the model.
- Properties inherited from QVimeo::Model
int count
 The number of items in the model.

Detailed Description

A list model for displaying Vimeo resources.

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

Roles

The roles and role names of ResourcesModel are created dynamically when the model is populated with data. The roles are created by iterating through the keys of the first item in alphabetical order, starting at Qt::UserRole + 1. The role names are the keys themselves.

Example usage:

C++

using namespace QVimeo;
...
QListView *view = new QListView(this);
ResourcesModel *model = new ResourcesModel(this);
view->setModel(new ResourcesModel(this));
QVariantMap filters;
filters["per_page"] = 10;
filters["sort"] = "date";
filters["query"] = "Qt";
model->list("/videos", filters);

QML

import QtQuick 1.0
import QVimeo 1.0
ListView {
id: view
width: 800
height: 480
model: ResourcesModel {
id: resourcesModel
}
delegate: Text {
width: view.width
height: 50
horizontalAlignment: Text.AlignHCenter
verticalAlignment: Text.AlignVCenter
elide: Text.ElideRight
text: name
}
Component.onCompleted: resourcesModel.list("/videos", {per_page: 10, sort: "date", query: "Qt"})
}
See Also
ResourcesRequest

Member Function Documentation

void QVimeo::ResourcesModel::cancel ( )
slot

Cancels the current request.

See Also
ResourcesRequest::cancel()
void QVimeo::ResourcesModel::insert ( const QVariantMap &  resource)
slot

Inserts a new Vimeo resource into the current resourcePath.

See Also
ResourcesRequest::insert()
void QVimeo::ResourcesModel::insert ( int  row,
const QString &  resourcePath 
)
slot

Inserts the Vimeo resource at row into resourcePath.

See Also
ResourcesRequest::insert()
void QVimeo::ResourcesModel::list ( const QString &  resourcePath,
const QVariantMap &  filters = QVariantMap() 
)
slot

Retrieves a list of Vimeo resources belonging to resourcePath.

See Also
ResourcesRequest::list()
void QVimeo::ResourcesModel::setNetworkAccessManager ( QNetworkAccessManager *  manager)

Sets the QNetworkAccessManager instance to be used when making requests to the Vimeo Data API.

ResourcesModel does not take ownership of manager.

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

See Also
ResourcesRequest::setNetworkAccessManager()

Property Documentation

QString QVimeo::ResourcesModel::accessToken
readwrite

The access token to be used when making requests to the Vimeo Data API.

The access token is required when accessing a resource's protected resources.

See Also
ResourcesRequest::accessToken
QString QVimeo::ResourcesModel::clientId
readwrite

The client id to be used when making requests to the Vimeo Data API.

The client id is used only when the access token needs to be refreshed.

See Also
ResourcesRequest::clientId
QString QVimeo::ResourcesModel::clientSecret
readwrite

The client secret to be used when making requests to the Vimeo Data API.

The client secret is used only when the access token needs to be refreshed.

See Also
ResourcesRequest::clientSecret
ResourcesRequest::Error QVimeo::ResourcesModel::error
read

The error type of the model.

See Also
ResourcesRequest::error
QString QVimeo::ResourcesModel::errorString
read

A description of the error of the model.

See Also
ResourcesRequest::status
QVariant QVimeo::ResourcesModel::result
read

The current result of the model.

See Also
ResourcesRequest::result
ResourcesRequest::Status QVimeo::ResourcesModel::status
read

The current status of the model.

See Also
ResourcesRequest::status