You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
96 lines
2.6 KiB
96 lines
2.6 KiB
15 years ago
|
// -*- 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
|