view.h

Go to the documentation of this file.

/*
 *   Copyright 2007 Aaron Seigo <aseigo@kde.org>
 *
 *   This program 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, or
 *   (at your option) any later version.
 *
 *   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 General Public License for more details
 *
 *   You should have received a copy of the GNU 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 PLASMA_VIEW_H
#define PLASMA_VIEW_H

#include <QtGui/QApplication>
#include <QtGui/QGraphicsView>

#include <kconfiggroup.h>

#include <plasma/plasma_export.h>

namespace Plasma
{

class Containment;
class Corona;
class ViewPrivate;

class PLASMA_EXPORT View : public QGraphicsView
{
    Q_OBJECT

public:
    explicit View(Containment *containment, QWidget *parent = 0);

    View(Containment *containment, int viewId, QWidget *parent = 0);

    ~View();

    void setWallpaperEnabled(bool draw);

    bool isWallpaperEnabled() const;

    void setScreen(int screen, int desktop = -1);

    int screen() const;

    int desktop() const;

    int effectiveDesktop() const;

    Containment *containment() const;

    Containment *swapContainment(Plasma::Containment *existing,
                                 const QString &name,
                                 const QVariantList &args = QVariantList());

    Containment *swapContainment(const QString &name,
                                 const QVariantList &args = QVariantList());

    void setTrackContainmentChanges(bool trackChanges);

    bool trackContainmentChanges();

    static View * topLevelViewAt(const QPoint & pos);

    int id() const;

Q_SIGNALS:
    void sceneRectAboutToChange();

    void sceneRectChanged();

    void lostContainment();

public Q_SLOTS:
    virtual void setContainment(Plasma::Containment *containment);

protected:
    KConfigGroup config() const;


    void configNeedsSaving() const;

private:
    ViewPrivate * const d;

    Q_PRIVATE_SLOT(d, void updateSceneRect())
    Q_PRIVATE_SLOT(d, void containmentDestroyed())
    Q_PRIVATE_SLOT(d, void containmentScreenChanged(int, int, Plasma::Containment *))
    Q_PRIVATE_SLOT(d, void privateInit())

    friend class ViewPrivate;
};

} // namespace Plasma

#endif