Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdemultimedia@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 82 insertions, 0 deletions

diff --git a/juk/filehandle.h b/juk/filehandle.h
new file mode 100644
index 00000000..6c12a344
--- /dev/null
+++ b/juk/filehandle.h
@@ -0,0 +1,82 @@
+/***************************************************************************
+    begin                : Sun Feb 29 2004
+    copyright            : (C) 2004 by Scott Wheeler
+    email                : wheeler@kde.org
+***************************************************************************/
+
+/***************************************************************************
+ *                                                                         *
+ *   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.                                   *
+ *                                                                         *
+ ***************************************************************************/
+
+#ifndef JUK_FILEHANDLE_H
+#define JUK_FILEHANDLE_H
+
+#include <qstringlist.h>
+
+class QFileInfo;
+class QDateTime;
+class QDataStream;
+class CoverInfo;
+
+class Tag;
+class CacheDataStream;
+
+/**
+ * An value based, explicitly shared wrapper around file related information
+ * used in JuK's playlists.
+ */
+
+class FileHandle
+{
+public:
+    FileHandle();
+    FileHandle(const FileHandle &f);
+    explicit FileHandle(const QFileInfo &info, const QString &path = QString::null);
+    explicit FileHandle(const QString &path);
+    FileHandle(const QString &path, CacheDataStream &s);
+    ~FileHandle();
+
+    /**
+     * Forces the FileHandle to reread its information from the disk.
+     */
+    void refresh();
+    void setFile(const QString &path);
+
+    Tag *tag() const;
+    CoverInfo *coverInfo() const;
+    QString absFilePath() const;
+    const QFileInfo &fileInfo() const;
+
+    bool isNull() const;
+    bool current() const;
+    const QDateTime &lastModified() const;
+
+    void read(CacheDataStream &s);
+
+    FileHandle &operator=(const FileHandle &f);
+    bool operator==(const FileHandle &f) const;
+    bool operator!=(const FileHandle &f) const;
+
+    static QStringList properties();
+    QString property(const QString &name) const;
+
+    static const FileHandle &null();
+
+private:
+    class FileHandlePrivate;
+    FileHandlePrivate *d;
+
+    void setup(const QFileInfo &info, const QString &path);
+};
+
+typedef QValueList<FileHandle> FileHandleList;
+
+QDataStream &operator<<(QDataStream &s, const FileHandle &f);
+CacheDataStream &operator>>(CacheDataStream &s, FileHandle &f);
+
+#endif