oeditlistbox.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., 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.
*/

#ifndef OEDITLISTBOX_H
#define OEDITLISTBOX_H

#include <qgroupbox.h>
#include <qlistbox.h>

class OLineEdit;
class OComboBox;
class QPushButton;

#if QT_VERSION < 0x030000
    enum StringComparisonMode {
        CaseSensitive   = 0x00001, // 0 0001
        BeginsWith      = 0x00002, // 0 0010
        EndsWith        = 0x00004, // 0 0100
        Contains        = 0x00008, // 0 1000
        ExactMatch      = 0x00010  // 1 0000
    };
#endif

class OEditListBoxPrivate;
class OEditListBox : public QGroupBox
{
   Q_OBJECT

public:
    class CustomEditor
    {
    public:
        CustomEditor()
            : m_representationWidget( 0L ),
              m_lineEdit( 0L ) {}
        CustomEditor( QWidget *repWidget, OLineEdit *edit )
            : m_representationWidget( repWidget ),
              m_lineEdit( edit ) {}
        CustomEditor( OComboBox *combo );

        void setRepresentationWidget( QWidget *repWidget ) {
            m_representationWidget = repWidget;
        }
        void setLineEdit( OLineEdit *edit ) {
            m_lineEdit = edit;
        }

        virtual QWidget   *representationWidget() const {
            return m_representationWidget;
        }
        virtual OLineEdit *lineEdit() const {
            return m_lineEdit;
        }

    protected:
        QWidget *m_representationWidget;
        OLineEdit *m_lineEdit;
    };

   public:

      enum Button { Add = 1, Remove = 2, UpDown = 4, All = Add|Remove|UpDown };

      OEditListBox(QWidget *parent = 0, const char *name = 0,
                   bool checkAtEntering=false, int buttons = All );
      OEditListBox(const QString& title, QWidget *parent = 0,
                   const char *name = 0, bool checkAtEntering=false,
                   int buttons = All );

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

      virtual ~OEditListBox();

      QListBox* listBox() const     { return m_listBox; }
      OLineEdit* lineEdit() const     { return m_lineEdit; }
      QPushButton* addButton() const     { return servNewButton; }
      QPushButton* removeButton() const     { return servRemoveButton; }
      QPushButton* upButton() const     { return servUpButton; }
      QPushButton* downButton() const     { return servDownButton; }

      int count() const   { return int(m_listBox->count()); }
      void insertStringList(const QStringList& list, int index=-1);
      void insertStrList(const QStrList* list, int index=-1);
      void insertStrList(const QStrList& list, int index=-1);
      void insertStrList(const char ** list, int numStrings=-1, int index=-1);
      void insertItem(const QString& text, int index=-1) {m_listBox->insertItem(text,index);}
      void clear();
      QString text(int index) const { return m_listBox->text(index); }
      int currentItem() const;
      QString currentText() const  { return m_listBox->currentText(); }

      QStringList items() const;

   signals:
      void changed();

      void added( const QString & text );

      void removed( const QString & text );

   protected slots:
      //the names should be self-explaining
      void moveItemUp();
      void moveItemDown();
      void addItem();
      void removeItem();
      void enableMoveButtons(int index);
      void typedSomething(const QString& text);

   private:
      QListBox *m_listBox;
      QPushButton *servUpButton, *servDownButton;
      QPushButton *servNewButton, *servRemoveButton;
      OLineEdit *m_lineEdit;

      //this is called in both ctors, to avoid code duplication
      void init( bool checkAtEntering, int buttons,
                 QWidget *representationWidget = 0L );

   protected:
      virtual void virtual_hook( int id, void* data );
   private:
      //our lovely private d-pointer
      OEditListBoxPrivate *d;
};

#endif // OEDITLISTBOX

---