1 files changed, 235 insertions, 0 deletions

diff --git a/libopie2/opieui/olistview.h b/libopie2/opieui/olistview.h
new file mode 100644
index 0000000..bafc67c
--- a/dev/null
+++ b/libopie2/opieui/olistview.h
@@ -0,0 +1,235 @@
+/*
+                             This file is part of the Opie Project
+
+              =.             (C) 2003 Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de>
+            .=l.
+           .>+-=
+ _;:,     .>    :=|.         This program is free software; you can
+.> <`_,   >  .   <=          redistribute it and/or  modify it under
+:`=1 )Y*s>-.--   :           the terms of the GNU Library General Public
+.="- .-=="i,     .._         License as published by the Free Software
+ - .   .-<_>     .<>         Foundation; either version 2 of the License,
+     ._= =}       :          or (at your option) any later version.
+    .%`+i>       _;_.
+    .i_,=:_.      -<s.       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
+..}^=.=       =       ;      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 OLISTVIEW_H
+#define OLISTVIEW_H
+
+#include <qcolor.h>
+#include <qlistview.h>
+#include <qpen.h>
+#include <qdatastream.h>
+
+class OListViewItem;
+
+/**
+ * A @ref QListView variant featuring visual and functional enhancements
+ * like an alternate background for odd rows, an autostretch mode
+ * for the width of the widget ( >= Qt 3 only ) and persistence capabilities.
+ *
+ * @author Michael 'Mickey' Lauer <mickey@tm.informatik.uni-frankfurt.de>
+ * @short OListView list/tree widget.
+ */
+ class OListView: public QListView
+{
+  public:
+   /**
+    * Constructor.
+    *
+    * The parameters @p parent and @p name are handled by
+    * @ref QListView, as usual.
+    */
+    OListView ( QWidget *parent = 0, const char *name = 0 );
+
+   /**
+    * Destructor.
+    */
+    virtual ~OListView();
+
+   /**
+    * Let the last column fit exactly all the available width.
+    */
+    void setFullWidth( bool fullWidth );
+
+   /**
+    * Returns whether the last column is set to fit the available width.
+    */
+    bool fullWidth() const;
+
+   /**
+    * Reimplemented for full width support
+    */
+    virtual int addColumn( const QString& label, int width = -1 );
+
+   /**
+    * Reimplemented for full width support
+    */
+    virtual int addColumn( const QIconSet& iconset, const QString& label, int width = -1 );
+
+   /**
+    * Reimplemented for full width support
+    */
+    virtual void removeColumn(int index);
+
+   /**
+    * sets the alternate background background color.
+    * This only has an effect if the items are OListViewItems
+    *
+    * @param c the color to use for every other item. Set to an invalid
+    *        color to disable alternate colors.
+    */
+    void setAlternateBackground( const QColor &c );
+
+   /**
+    * sets the column separator pen.
+    *
+    * @param p the pen used to draw the column separator.
+    */
+    void setColumnSeparator( const QPen &p );
+
+   /**
+    * @return the alternate background color
+    */
+    const QColor& alternateBackground() const;
+
+   /**
+    * @return the column separator pen
+    */
+    const QPen& columnSeparator() const;
+
+   /**
+    * create a list view item as child of this object
+    * @return the new object
+    */
+    virtual OListViewItem* childFactory();
+
+    #ifndef QT_NO_DATASTREAM
+   /**
+    * serialize this object to a @ref QDataStream
+    * @param s the stream used to serialize this object.
+    */
+    virtual void serializeTo( QDataStream& s ) const;
+
+   /**
+    * serialize this object from a @ref QDataStream
+    * @param s the stream used to serialize this object.
+    */
+    virtual void serializeFrom( QDataStream& s );
+    #endif
+
+  private:
+    QColor m_alternateBackground;
+    bool m_fullWidth;
+    QPen m_columnSeparator;
+};
+
+#ifndef QT_NO_DATASTREAM
+/**
+  * \relates QListView
+  * Writes a listview to the stream and returns a reference to the stream.
+  */
+QDataStream& operator<<( QDataStream& s, const OListView& lv );
+/**
+  * \relates QListView
+  * Reads a listview from the stream and returns a reference to the stream.
+  */
+QDataStream& operator>>( QDataStream& s, OListView& lv );
+#endif // QT_NO_DATASTREAM
+
+//****************************** OListViewItem ******************************************************************
+
+class OListViewItem: public QListViewItem
+{
+  public:
+    OListViewItem( QListView * parent );
+    OListViewItem( QListViewItem * parent );
+    OListViewItem( QListView * parent, QListViewItem * after );
+    OListViewItem( QListViewItem * parent, QListViewItem * after );
+
+    OListViewItem( QListView * parent,
+        QString,     QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null );
+
+    OListViewItem( QListViewItem * parent,
+        QString,     QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null );
+
+    OListViewItem( QListView * parent, QListViewItem * after,
+        QString,     QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null );
+
+    OListViewItem( QListViewItem * parent, QListViewItem * after,
+        QString,     QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null,
+        QString = QString::null, QString = QString::null );
+
+    virtual ~OListViewItem();
+
+    const QColor& backgroundColor();
+    bool isAlternate();
+    void paintCell( QPainter *p, const QColorGroup &cg, int column, int width, int alignment );
+    void init();
+
+   /**
+    * create a list view item as child of this object
+    * @return the new object
+    */
+    virtual OListViewItem* childFactory();
+
+    #ifndef QT_NO_DATASTREAM
+   /**
+    * serialize this object to or from a @ref QDataStream
+    * @param s the stream used to serialize this object.
+    */
+    virtual void serializeTo( QDataStream& s ) const;
+
+   /**
+    * serialize this object to or from a @ref QDataStream
+    * @param s the stream used to serialize this object.
+    */
+    virtual void serializeFrom( QDataStream& s );
+    #endif
+
+  private:
+    bool m_known;
+    bool m_odd;
+};
+
+#ifndef QT_NO_DATASTREAM
+/**
+  * \relates QListViewItem
+  * Writes a listview item and all subitems recursively to the stream
+  * and returns a reference to the stream.
+  */
+QDataStream& operator<<( QDataStream &s, const OListViewItem& lvi );
+/**
+  * \relates QListViewItem
+  * Reads a listview item from the stream and returns a reference to the stream.
+  */
+QDataStream& operator>>( QDataStream &s, OListViewItem& lvi );
+#endif // QT_NO_DATASTREAM
+
+#endif // OLISTVIEW_H