1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
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 <[email protected]>
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
|
