kpageview.h

Go to the documentation of this file.

/*
    This file is part of the KDE Libraries

    Copyright (C) 2006 Tobias Koenig (tokoe@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 KPAGEVIEW_H
#define KPAGEVIEW_H

#include <kdeui_export.h>

#include <QtGui/QWidget>

class KPageModel;

class QAbstractItemDelegate;
class QAbstractItemView;
class QModelIndex;
class KPageViewPrivate;
class QAbstractItemModel;

class KDEUI_EXPORT KPageView : public QWidget
{
  Q_OBJECT
  Q_ENUMS( FaceType )
  Q_PROPERTY( FaceType faceType READ faceType WRITE setFaceType )
    Q_DECLARE_PRIVATE(KPageView)

  public:
    enum FaceType
    {
      Auto,
      Plain,
      List,
      Tree,
      Tabbed
    };

    explicit KPageView( QWidget *parent = 0 );

    virtual ~KPageView();

    void setModel(QAbstractItemModel *model);

    QAbstractItemModel* model() const;

    void setFaceType( FaceType faceType );

    FaceType faceType() const;

    void setCurrentPage( const QModelIndex &index );

    QModelIndex currentPage() const;

    void setItemDelegate( QAbstractItemDelegate *delegate );

    QAbstractItemDelegate* itemDelegate() const;

    void setDefaultWidget( QWidget *widget );

  Q_SIGNALS:
    void currentPageChanged( const QModelIndex &current, const QModelIndex &previous );

  protected:
    virtual QAbstractItemView* createView();

    virtual bool showPageHeader() const;

    virtual Qt::Alignment viewPosition() const;

        KPageView(KPageViewPrivate &dd, QWidget *parent);
        KPageViewPrivate *const d_ptr;

    private:
        Q_PRIVATE_SLOT(d_func(), void _k_rebuildGui())
        Q_PRIVATE_SLOT(d_func(), void _k_modelChanged())
        Q_PRIVATE_SLOT(d_func(), void _k_pageSelected(const QItemSelection &, const QItemSelection &))
        Q_PRIVATE_SLOT(d_func(), void _k_dataChanged(const QModelIndex &, const QModelIndex &))
};

#endif