partmanager.h

Go to the documentation of this file.

/* This file is part of the KDE project
   Copyright (C) 1999 Simon Hausmann <hausmann@kde.org>
             (C) 1999 David Faure <faure@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 __kpartmanager_h__
#define __kpartmanager_h__

#include <QtGui/QWidget>

#include <kparts/kparts_export.h>

class KComponentData;

namespace KParts
{

class Part;

class PartManagerPrivate;

class KPARTS_EXPORT PartManager : public QObject
{
    Q_OBJECT
    Q_ENUMS( SelectionPolicy )
    Q_PROPERTY( SelectionPolicy selectionPolicy READ selectionPolicy WRITE setSelectionPolicy )
    Q_PROPERTY( bool allowNestedParts READ allowNestedParts WRITE setAllowNestedParts )
    Q_PROPERTY( bool ignoreScrollBars READ ignoreScrollBars WRITE setIgnoreScrollBars )
public:
    enum SelectionPolicy { Direct, TriState };

    enum Reason { ReasonLeftClick = 100, ReasonMidClick, ReasonRightClick, NoReason };

    PartManager( QWidget * parent );
    PartManager( QWidget * topLevel, QObject *parent );
    virtual ~PartManager();

    void setSelectionPolicy( SelectionPolicy policy );
    SelectionPolicy selectionPolicy() const;

    void setAllowNestedParts( bool allow );
    bool allowNestedParts() const;

    void setIgnoreScrollBars( bool ignore );
    bool ignoreScrollBars() const;

    void setActivationButtonMask( short int buttonMask );
    short int activationButtonMask() const;

    virtual bool eventFilter( QObject *obj, QEvent *ev );

    virtual void addPart( Part *part, bool setActive = true );

    virtual void removePart( Part *part );

    virtual void replacePart( Part * oldPart, Part * newPart, bool setActive = true );

    virtual void setActivePart( Part *part, QWidget *widget = 0 );

    virtual Part *activePart() const;

    virtual QWidget *activeWidget() const;

    virtual void setSelectedPart( Part *part, QWidget *widget = 0 );

    virtual Part *selectedPart() const;

    virtual QWidget *selectedWidget() const;

    const QList<Part *> parts() const;

    void addManagedTopLevelWidget( const QWidget *topLevel );
    void removeManagedTopLevelWidget( const QWidget *topLevel );

    int reason() const;

Q_SIGNALS:
    void partAdded( KParts::Part *part );
    void partRemoved( KParts::Part *part );
    void activePartChanged( KParts::Part *newPart );

protected:
    virtual void setActiveComponent(const KComponentData &instance);

    void setIgnoreExplictFocusRequests(bool);

protected Q_SLOTS:
    void slotObjectDestroyed();

    void slotWidgetDestroyed();

    void slotManagedTopLevelWidgetDestroyed();
private:
    Part * findPartFromWidget( QWidget * widget, const QPoint &pos );
    Part * findPartFromWidget( QWidget * widget );

private:
    PartManagerPrivate* const d;
};

}

#endif