kcategorizedview.h

Go to the documentation of this file.

#ifndef KCATEGORIZEDVIEW_H
#define KCATEGORIZEDVIEW_H

#include <QtGui/QListView>

#include <kdeui_export.h>

class KCategoryDrawer;
class KCategoryDrawerV2;

class KDEUI_EXPORT KCategorizedView
    : public QListView
{
    Q_OBJECT
    Q_PROPERTY(int categorySpacing READ categorySpacing WRITE setCategorySpacing)
    Q_PROPERTY(bool alternatingBlockColors READ alternatingBlockColors WRITE setAlternatingBlockColors)
    Q_PROPERTY(bool collapsibleBlocks READ collapsibleBlocks WRITE setCollapsibleBlocks)

public:
    KCategorizedView(QWidget *parent = 0);

    ~KCategorizedView();

    virtual void setModel(QAbstractItemModel *model);

    void setGridSize(const QSize &size);

    void setGridSizeOwn(const QSize &size);

    virtual QRect visualRect(const QModelIndex &index) const;

    KCategoryDrawer *categoryDrawer() const;

    void setCategoryDrawer(KCategoryDrawer *categoryDrawer);

    int categorySpacing() const;

    void setCategorySpacing(int categorySpacing);

    bool alternatingBlockColors() const;

    void setAlternatingBlockColors(bool enable);

    bool collapsibleBlocks() const;

    void setCollapsibleBlocks(bool enable);

    QModelIndexList block(const QString &category);

    QModelIndexList block(const QModelIndex &representative);

    virtual QModelIndex indexAt(const QPoint &point) const;

    virtual void reset();

protected:
    virtual void paintEvent(QPaintEvent *event);

    virtual void resizeEvent(QResizeEvent *event);

    virtual void setSelection(const QRect &rect,
                              QItemSelectionModel::SelectionFlags flags);

    virtual void mouseMoveEvent(QMouseEvent *event);

    virtual void mousePressEvent(QMouseEvent *event);

    virtual void mouseReleaseEvent(QMouseEvent *event);

    virtual void leaveEvent(QEvent *event);

    virtual void startDrag(Qt::DropActions supportedActions);

    virtual void dragMoveEvent(QDragMoveEvent *event);

    virtual void dragEnterEvent(QDragEnterEvent *event);

    virtual void dragLeaveEvent(QDragLeaveEvent *event);

    virtual void dropEvent(QDropEvent *event);

    virtual QModelIndex moveCursor(CursorAction cursorAction,
                                   Qt::KeyboardModifiers modifiers);

    virtual void rowsAboutToBeRemoved(const QModelIndex &parent,
                                      int start,
                                      int end);

    virtual void updateGeometries();

    virtual void currentChanged(const QModelIndex &current,
                                const QModelIndex &previous);

    virtual void dataChanged(const QModelIndex &topLeft,
                             const QModelIndex &bottomRight);

    virtual void rowsInserted(const QModelIndex &parent,
                              int start,
                              int end);

protected Q_SLOTS:
#ifndef KDE_NO_DEPRECATED
    virtual KDE_DEPRECATED void rowsInsertedArtifficial(const QModelIndex &parent,
                                                        int start,
                                                        int end);
#endif

#ifndef KDE_NO_DEPRECATED
    virtual KDE_DEPRECATED void rowsRemoved(const QModelIndex &parent,
                                            int start,
                                            int end);
#endif

    virtual void slotLayoutChanged();

private:
    class Private;
    Private *const d;

    Q_PRIVATE_SLOT(d, void _k_slotCollapseOrExpandClicked(QModelIndex))
};

#endif // KCATEGORIZEDVIEW_H