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/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 95 insertions, 0 deletions

diff --git a/klipper/historyitem.h b/klipper/historyitem.h
new file mode 100644
index 000000000..04ab542ed
--- /dev/null
+++ b/klipper/historyitem.h
@@ -0,0 +1,95 @@
+// -*- Mode: C++; c-basic-offset: 4; indent-tabs-mode: nil; tab-width: 8; -*-
+/* This file is part of the KDE project
+   Copyright (C) 2004  Esben Mose Hansen <kde@mosehansen.dk>
+
+   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; see the file COPYING.  If not, write to
+   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+   Boston, MA 02110-1301, USA.
+*/
+#ifndef _HISTORYITEM_H_
+#define _HISTORYITEM_H_
+#include <qpixmap.h>
+
+class QString;
+class QMimeSource;
+class QDataStream;
+
+/**
+ * An entry in the clipboard history.
+ */
+class HistoryItem
+{
+public:
+    HistoryItem( );
+    virtual ~HistoryItem();
+
+    /**
+     * Return the current item as text
+     * An image would be returned as a descriptive
+     * text, such as 32x43 image.
+     */
+    virtual QString text() const = 0;
+
+    /**
+     * Return the current item as text
+     * A text would be returned as a null pixmap,
+     * which is also the default implementation
+     */
+    inline virtual const QPixmap& image() const;
+
+    /**
+     * Returns QMimeSource suitable for QClipboard::setData().
+     */
+    virtual QMimeSource* mimeSource() const = 0;
+
+    /**
+     * Write object on datastream
+     */
+    virtual void write( QDataStream& stream ) const = 0;
+
+    /**
+     * Equality.
+     */
+    virtual bool operator==(const HistoryItem& rhs) const = 0;
+
+    /**
+     * Create an HistoryItem from MimeSources (i.e., clipboard data)
+     * returns null if create fails (e.g, unsupported mimetype)
+     */
+    static HistoryItem* create( const QMimeSource& aSource );
+
+    /**
+     * Create an HistoryItem from MimeSources (i.e., clipboard data)
+     * returns null if creation fails. In this case, the datastream
+     * is left in an undefined state.
+     */
+    static HistoryItem* create( QDataStream& aSource );
+};
+
+inline
+const QPixmap& HistoryItem::image() const {
+    static QPixmap nullPixmap;
+    return nullPixmap;
+}
+
+inline
+QDataStream& operator<<( QDataStream& lhs, HistoryItem const * const rhs ) {
+    if ( rhs ) {
+        rhs->write( lhs );
+    }
+    return lhs;
+
+}
+
+#endif