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.
95 lines
2.5 KiB
95 lines
2.5 KiB
/* 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 <tqpixmap.h>
|
|
|
|
class TQString;
|
|
class TQMimeSource;
|
|
class TQDataStream;
|
|
|
|
/**
|
|
* 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 TQString 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 TQPixmap& image() const;
|
|
|
|
/**
|
|
* Returns TQMimeSource suitable for TQClipboard::setData().
|
|
*/
|
|
virtual TQMimeSource* mimeSource() const = 0;
|
|
|
|
/**
|
|
* Write object on datastream
|
|
*/
|
|
virtual void write( TQDataStream& 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 TQMimeSource& 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( TQDataStream& aSource );
|
|
};
|
|
|
|
inline
|
|
const TQPixmap& HistoryItem::image() const {
|
|
static TQPixmap nullPixmap;
|
|
return nullPixmap;
|
|
}
|
|
|
|
inline
|
|
TQDataStream& operator<<( TQDataStream& lhs, HistoryItem const * const rhs ) {
|
|
if ( rhs ) {
|
|
rhs->write( lhs );
|
|
}
|
|
return lhs;
|
|
|
|
}
|
|
|
|
#endif
|