LeechCraft  0.6.70-3565-g2d86529
Modular cross-platform feature rich live environment.
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Media::IPendingDisco Class Referenceabstract

Pending discography request handle. More...

#include "idiscographyprovider.h"

Public Member Functions

virtual ~IPendingDisco ()
 
virtual QObject * GetQObject ()=0
 Returns this object as a QObject. More...
 
virtual QList< ReleaseInfoGetReleases () const =0
 Returns the list of found releases. More...
 

Protected Member Functions

virtual void ready ()=0
 Emitted when the biography is ready and fetched. More...
 
virtual void error (const QString &reason)=0
 Emitted when there is an error fetching the biography. More...
 

Detailed Description

Pending discography request handle.

Interface to a pending discography search in a IDiscographyProvider. A descendant of this class is returned from IDiscographyProvider::GetDiscography() or IDiscographyProvider::GetReleaseInfo(). In the former case GetReleases() contains all releases of the given artist, while in the latter — only those matching the requested release.

This class has some signals (ready() and error()), and one can use the GetQObject() method to get an object of this class as a QObject and connect to those signals.

Note
The object of this class should schedule its deletion (via QObject::deleteLater(), for example) after ready() or error() signal is emitted. Thus the calling code should never delete it explicitly, neither it should use this object after ready() or error() signals or connect to this signals via Qt::QueuedConnection.
See Also
IDiscographyProvider

Definition at line 137 of file idiscographyprovider.h.

Constructor & Destructor Documentation

virtual Media::IPendingDisco::~IPendingDisco ( )
inlinevirtual

Definition at line 140 of file idiscographyprovider.h.

Member Function Documentation

virtual void Media::IPendingDisco::error ( const QString &  reason)
protectedpure virtual

Emitted when there is an error fetching the biography.

The object will be invalid after this signal is emitted and the event loop is run.

Parameters
[out]reasonThe human-readable string describing the error.
virtual QObject* Media::IPendingDisco::GetQObject ( )
pure virtual

Returns this object as a QObject.

This function can be used to connect to the signals of this class.

Returns
This object as a QObject.
virtual QList<ReleaseInfo> Media::IPendingDisco::GetReleases ( ) const
pure virtual

Returns the list of found releases.

This function returns the found releases, or an empty list if no releases are found, an error has occurred or search isn't completed yet.

Returns
The fetched artist biography.
virtual void Media::IPendingDisco::ready ( )
protectedpure virtual

Emitted when the biography is ready and fetched.

The object will be invalid after this signal is emitted and the event loop is run.


The documentation for this class was generated from the following file: