smf/smfservermodule/smfcommon/smfartists.h
changeset 25 a180113055cb
parent 18 013a02bf2bb0
equal deleted inserted replaced
24:1cee9f1b95e0 25:a180113055cb
    64 	 */
    64 	 */
    65 	QStringList names( ) const;
    65 	QStringList names( ) const;
    66 	
    66 	
    67 	/**
    67 	/**
    68 	 * Method to get the image of the artists
    68 	 * Method to get the image of the artists
    69 	 * @return The image of te artists
    69 	 * @return The image of the artists if available, always small size is fetched
    70 	 */
    70 	 */
    71 	QImage image( ) const;
    71 	QImage image( ) const;
    72 	
    72 	
    73 	/**
    73 	/**
    74 	 * Method to get the url of the artists
    74 	 * Method to get the url of the artists
    75 	 * @return The url of the artists
    75 	 * @return The url of the artists, NULL if not present
    76 	 */
    76 	 */
    77 	QUrl url( ) const;
    77 	QUrl url( ) const;
       
    78 
       
    79 	/**
       
    80 	 * Method to get the tags applied for artist(s) 
       
    81 	 * @return list of tags, NULL if not supported
       
    82 	 */
       
    83 	QStringList tags( ) const;
    78 	
    84 	
       
    85 	/**
       
    86 	 * Service specific Id for this artist(s), e.g. could be musicbrainz id for this artist 
       
    87 	 * @return service specific id of the artists, NULL if not supported
       
    88 	 */
       
    89 	QString id( ) const;
       
    90 
    79 	/**
    91 	/**
    80 	 * Method to set the artists names
    92 	 * Method to set the artists names
    81 	 * @param aList The list of artists names
    93 	 * @param aList The list of artists names
    82 	 */
    94 	 */
    83 	void setNames( const QStringList &aList );
    95 	void setNames( const QStringList &aList );
    91 	/**
   103 	/**
    92 	 * Method to set the url of the artists
   104 	 * Method to set the url of the artists
    93 	 * @param aUrl The url of the artists
   105 	 * @param aUrl The url of the artists
    94 	 */
   106 	 */
    95 	void setUrl( const QUrl &aUrl );
   107 	void setUrl( const QUrl &aUrl );
       
   108 	
       
   109 	/**
       
   110 	 * Method to set tags of the artists
       
   111 	 * @param aTags tags for the artists
       
   112 	 */
       
   113 	void setTags( const QStringList &aTags );
       
   114 
       
   115 	/**
       
   116 	 * Method to set the service specific ID of the artists
       
   117 	 * @param aId The id of the artists
       
   118 	 */
       
   119 	void setId( const QString &aId );
    96 		
   120 		
    97 private:
   121 private:
    98 	QSharedDataPointer<SmfArtistsPrivate> d;
   122 	QSharedDataPointer<SmfArtistsPrivate> d;
    99 	
   123 	
   100 	friend QDataStream &operator<<( QDataStream &aDataStream, 
   124 	friend QDataStream &operator<<( QDataStream &aDataStream, 
   124  * @return reference to the stream
   148  * @return reference to the stream
   125  */
   149  */
   126 SMFCOMMON_EXPORT QDataStream &operator>>( QDataStream &aDataStream, 
   150 SMFCOMMON_EXPORT QDataStream &operator>>( QDataStream &aDataStream, 
   127 		SmfArtists &aArtists);
   151 		SmfArtists &aArtists);
   128 
   152 
       
   153 typedef QList<SmfArtists> SmfArtistsList;
       
   154 
   129 // Make the class SmfArtists known to QMetaType, so that as to register it.
   155 // Make the class SmfArtists known to QMetaType, so that as to register it.
   130 Q_DECLARE_METATYPE(SmfArtists)
   156 Q_DECLARE_METATYPE(SmfArtists)
   131 Q_DECLARE_METATYPE(QList<SmfArtists>)
   157 Q_DECLARE_METATYPE(QList<SmfArtists>)
   132 
   158 
   133 #endif /* SMFARTISTS_H_ */
   159 #endif /* SMFARTISTS_H_ */