StandardActionTreeModel.h

Go to the documentation of this file.

/*
 *   Copyright (C) 2007, 2008, 2009, 2010 Ivan Cukic <ivan.cukic(at)kde.org>
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU Lesser/Library General Public License version 2,
 *   or (at your option) any later version, as published by the Free
 *   Software Foundation
 *
 *   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 Lesser/Library General Public License for more details
 *
 *   You should have received a copy of the GNU Lesser/Library General Public
 *   License along with this program; if not, write to the
 *   Free Software Foundation, Inc.,
 *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 */

#ifndef LANCELOT_STANDARD_ACTION_TREE_MODEL_H
#define LANCELOT_STANDARD_ACTION_TREE_MODEL_H

#include "ActionTreeModel.h"

#include <lancelot/lancelot_export.h>

namespace Lancelot
{

class LANCELOT_EXPORT StandardActionTreeModel: public ActionTreeModel {
protected:
    class LANCELOT_EXPORT Item { //krazy:exclude=dpointer
    public:
        explicit Item(QString itemTitle = QString(),
             QString itemDescription = QString(),
             QIcon itemIcon = QIcon(),
             QVariant itemData = QVariant());

        ~Item();

        QString title;
        QString description;
        QIcon icon;
        QVariant data;

        QList < Item * > children;
    };

    StandardActionTreeModel(Item * root);

    Item * root() const;
    virtual StandardActionTreeModel * createChild(int index) = 0;


public:
    StandardActionTreeModel();

    virtual ~StandardActionTreeModel();

    // ActionTreeModel
    L_Override ActionTreeModel * child(int index);
    L_Override QString selfTitle() const;
    L_Override QIcon selfIcon()  const;

    // ActionListModel
    L_Override QString title(int index) const;
    L_Override QString description(int index) const;
    L_Override QIcon icon(int index) const;
    L_Override bool isCategory(int index) const;

    L_Override int size() const;

    QVariant data(int index) const;

    void add(Item * item, Item * parent = NULL);

    void add(const QString & title, const QString & description,
            QIcon icon, const QVariant & data, Item * parent = NULL);

    void set(int index, Item * item, Item * parent = NULL);

    void set(int index, const QString & title, const QString & description,
            QIcon icon, const QVariant & data, Item * parent = NULL);

    void removeAt(int index, Item * parent = NULL);

    Item * itemAt(int index, Item * parent = NULL);

    void clear(Item * parent = NULL);

private:
    class Private;
    Private * const d;

};

} // namespace Lancelot

#endif /* LANCELOT_STANDARD_ACTION_TREE_MODEL_H */