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.
tdebase/klipper/historyitem.h

96 lines
2.6 KiB

// -*- 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 <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 QClipboard::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