/usr/include/kparts/historyprovider.h is in kdelibs5-dev 4:4.14.16-0ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 | /* This file is part of the KDE project
Copyright (C) 2001 Carsten Pfeiffer <pfeiffer@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library 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
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef KHISTORYPROVIDER_H
#define KHISTORYPROVIDER_H
#include <QtCore/QObject>
#include <kparts/kparts_export.h>
namespace KParts {
class HistoryProviderPrivate;
/**
* Basic class to manage a history of "items". This class is only meant
* for fast lookup, if an item is in the history or not.
*
* May be subclassed to implement a persistent history for example.
* For usage with khtml, just create your provider and call the
* HistoryProvider constructor _before_ you do any khtml stuff. That way,
* khtml, using the self()-method, will use your subclassed provider.
*
* @author Carsten Pfeiffer <pfeiffer@kde.org>
*/
class KPARTS_EXPORT HistoryProvider : public QObject
{
Q_OBJECT
friend class ::KParts::HistoryProviderPrivate;
public:
static HistoryProvider * self();
/**
* @returns true if a provider has already been created.
* @since 4.4
*/
static bool exists();
/**
* @returns true if @p item is present in the history.
*/
virtual bool contains( const QString& item ) const;
/**
* Inserts @p item into the history.
*/
virtual void insert( const QString& item );
/**
* Removes @p item from the history.
*/
virtual void remove( const QString& item );
/**
* Clears the history. The cleared() signal is emitted after clearing.
*/
virtual void clear();
Q_SIGNALS:
/**
* Emitted after the history has been cleared.
*/
void cleared();
/**
* This signal is never emitted from this class, it is only meant as an
* interface for subclasses. Emit this signal to notify others that the
* history has changed. Put those items that were added or removed from the
* history into @p items.
*/
void updated( const QStringList& items );
/**
* Emitted after the item has been inserted
*/
void inserted( const QString& item );
protected:
/**
* Creates a KHistoryProvider with an optional parent and name
*/
HistoryProvider(QObject *parent = 0);
/**
* Destroys the provider.
*/
virtual ~HistoryProvider();
private:
HistoryProviderPrivate* const d;
};
}
#endif // KHISTORYPROVIDER_H
|