keditlistbox.h

Go to the documentation of this file.

/* This file is part of the KDE libraries
    Copyright (C) 2000 David Faure <faure@kde.org>, Alexander Neundorf <neundorf@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 KEDITLISTBOX_H
#define KEDITLISTBOX_H

#include <kdeui_export.h>

#include <QtGui/QGroupBox>
#include <QtGui/QStringListModel>

class KLineEdit;
class KComboBox;
class QListView;
class QPushButton;

class KEditListBoxPrivate;
class KDEUI_EXPORT KEditListBox : public QGroupBox
{
   Q_OBJECT

   Q_FLAGS( Buttons )
   Q_PROPERTY( Buttons buttons READ buttons WRITE setButtons )
   Q_PROPERTY( QStringList items READ items WRITE setItems NOTIFY changed USER true )

public:
    class CustomEditorPrivate;

    class KDEUI_EXPORT CustomEditor
    {
    public:
        CustomEditor();
        CustomEditor( QWidget *repWidget, KLineEdit *edit );
        CustomEditor( KComboBox *combo );
        virtual ~CustomEditor();

        void setRepresentationWidget( QWidget *repWidget );
        void setLineEdit( KLineEdit *edit );

        virtual QWidget *representationWidget() const;
        virtual KLineEdit *lineEdit() const;

    private:
        friend class CustomEditorPrivate;
        CustomEditorPrivate *const d;

        Q_DISABLE_COPY(CustomEditor)
    };

   public:

      enum Button {
        Add = 0x0001,
        Remove = 0x0002,
        UpDown = 0x0004,
        All = Add | Remove | UpDown
      };

      Q_DECLARE_FLAGS( Buttons, Button )

      
      explicit KEditListBox(QWidget *parent = 0);

      explicit KEditListBox(const QString& title, QWidget *parent = 0);

// ### KDE5: remove name arguments and simplify (merge?!) constructors

      explicit KDE_DEPRECATED KEditListBox(QWidget *parent, const char *name,
                            bool checkAtEntering = false, Buttons buttons = All );
      explicit KDE_DEPRECATED KEditListBox(const QString& title, QWidget *parent,
                            const char *name, bool checkAtEntering = false,
                            Buttons buttons = All );

      KEditListBox( const QString& title,
                    const CustomEditor &customEditor,
                    QWidget *parent = 0, const char *name = 0,
                    bool checkAtEntering = false, Buttons buttons = All );

      virtual ~KEditListBox();

      QListView* listView() const;
      KLineEdit* lineEdit() const;
      QPushButton* addButton() const;
      QPushButton* removeButton() const;
      QPushButton* upButton() const;
      QPushButton* downButton() const;

      int count() const;
      void insertStringList(const QStringList& list, int index=-1);
      void insertItem(const QString& text, int index=-1);
      void clear();
      QString text(int index) const;
      int currentItem() const;
      QString currentText() const;

      QStringList items() const;

      void setItems(const QStringList& items);

      Buttons buttons() const;

      void setButtons( Buttons buttons );

      void setCheckAtEntering(bool check);

      bool checkAtEntering();

      void setCustomEditor( const CustomEditor& editor );

      bool eventFilter( QObject* o, QEvent* e );

   Q_SIGNALS:
      void changed();

      void added( const QString & text );

      void removed( const QString & text );

   protected Q_SLOTS: // KDE5: make private?
      void moveItemUp();
      void moveItemDown();
      void addItem();
      void removeItem();
      void enableMoveButtons(const QModelIndex&, const QModelIndex&);
      void typedSomething(const QString& text);

   private Q_SLOTS:
      void slotSelectionChanged( const QItemSelection& selected, const QItemSelection& deselected );

   private:
      friend class KEditListBoxPrivate;
      KEditListBoxPrivate* const d;

      Q_DISABLE_COPY(KEditListBox)
};

Q_DECLARE_OPERATORS_FOR_FLAGS(KEditListBox::Buttons)

#endif