khistorycombobox.h

Go to the documentation of this file.

/* This file is part of the KDE libraries

   Copyright (c) 2000,2001 Dawit Alemayehu <adawit@kde.org>
   Copyright (c) 2000,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 Lesser General Public
   License (LGPL) 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
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser 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 KHistoryComboBoxBOX_H
#define KHistoryComboBoxBOX_H

#include <kcombobox.h>

class KPixmapProvider;

class KDEUI_EXPORT KHistoryComboBox : public KComboBox
{
    Q_OBJECT
    Q_PROPERTY( QStringList historyItems READ historyItems WRITE setHistoryItems )

public:
    explicit KHistoryComboBox( QWidget *parent = 0 );

    explicit KHistoryComboBox( bool useCompletion, QWidget *parent = 0 );

    ~KHistoryComboBox();

    void setHistoryItems( const QStringList &items );

    void setHistoryItems( const QStringList &items, bool setCompletionList );

    QStringList historyItems() const;

    bool removeFromHistory( const QString& item );

    void setPixmapProvider( KPixmapProvider *prov );

    KPixmapProvider * pixmapProvider() const;

    void reset();

    using QComboBox::insertItems;

public Q_SLOTS:
    void addToHistory( const QString& item );

    void clearHistory();

Q_SIGNALS:
    void cleared();

protected:
    virtual void keyPressEvent( QKeyEvent * );

    virtual void wheelEvent( QWheelEvent *ev );

    void insertItems( const QStringList& items );

    bool useCompletion() const;

private Q_SLOTS:
    void slotReset();

    void slotClear();

    void addContextMenuItems( QMenu* );

    void slotSimulateActivated( const QString& );

private:
    void init( bool useCompletion );
    void rotateUp();
    void rotateDown();

private:
    class Private;
    friend class Private;
    Private* const d;

    Q_DISABLE_COPY(KHistoryComboBox)
};


#endif