/*************************************************************************** * Copyright (C) 2013-2018 by Ilya Kotov * * forkotov02@ya.ru * * * * This program is free software; you can redistribute it and/or modify * * it under the terms of the GNU General Public License as published by * * the Free Software Foundation; either version 2 of the License, or * * (at your option) any later version. * * * * This program is distributed in the hope that it will be useful, * * but WITHOUT ANY WARRANTY; without even the implied warranty of * * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * * GNU General Public License for more details. * * * * You should have received a copy of the GNU General Public License * * along with this program; if not, write to the * * Free Software Foundation, Inc., * * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * ***************************************************************************/ #ifndef PLAYLISTTRACK_H #define PLAYLISTTRACK_H #include #include #include #include "playlistitem.h" #include "qmmpui_export.h" class QmmpUiSettings; class PlayListHeaderModel; class MetaDataHelper; /** @brief The PlayListTrack class provides a track for use with the PlayListModel class. * @author Ilya Kotov */ class QMMPUI_EXPORT PlayListTrack : public TrackInfo, public PlayListItem { public: /*! * Constructs an empty plalist item. */ PlayListTrack(); /*! * Constructs a new PlayListTrack that is a copy of the given track \b other */ PlayListTrack(const PlayListTrack &other); /*! * Constructs plalist item with given metadata. * @param info Media file information. */ PlayListTrack(TrackInfo *info); /*! * Object destructor. */ virtual ~PlayListTrack(); /*! * Assigns \b other to this track and returns a reference to this track. */ PlayListTrack &operator=(const PlayListTrack &other); /*! * Returns formatted title of the item. * @param column Number of column. */ const QString formattedTitle(int column); /*! * Returns the list of the formatted titles for all columns. */ const QStringList formattedTitles(); /*! * Returns formatted length of the item. */ const QString formattedLength(); /*! * Updates current metadata. * @param info Track information. */ void updateMetaData(const TrackInfo *info); /*! * Gets new metadata from file (works for local files only). */ void updateMetaData(); /*! * Returns name of the parent group. */ const QString groupName(); /*! * Returns \b false. */ bool isGroup() const; /*! * Sets the index of the track. */ void setTrackIndex(int track_index); /*! * Returns the index of the track. * Default implementation returns -1. */ int trackIndex() const; /*! * Prepares for usage. * Increases reference counter. */ void beginUsage(); /*! * End of usage. * Decreases reference counter. */ void endUsage(); /*! * Shedules track object for deletion. */ void deleteLater(); /*! * Returns \b true if the track object is sheduled for deletion. */ bool isSheduledForDeletion() const; /*! * Indicates that instance is currently busy in some kind of operation (tags editing etc.) * and can't be deleted at the moment. Call \b deleteLater() instead of delete operator call. */ bool isUsed() const; private: void formatTitle(int column); void formatGroup(); QStringList m_formattedTitles; QString m_formattedLength; QString m_group; QStringList m_titleFormats; QString m_groupFormat; QmmpUiSettings *m_settings; int m_refCount; int m_track_index; bool m_sheduledForDeletion; MetaDataHelper *m_helper; }; #endif