partmanager.h

/* 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 <tqobject.h>
#include <tqwidget.h>
#include <tqptrlist.h>
 
#include <tdelibs_export.h>
 
class TDEInstance;
 
namespace KParts
{
 
class Part;
 
class PartManagerPrivate;

class TDEPARTS_EXPORT PartManager : public TQObject
{
  TQ_OBJECT
  TQ_ENUMS( SelectionPolicy )
  TQ_PROPERTY( SelectionPolicy selectionPolicy READ selectionPolicy WRITE setSelectionPolicy )
  TQ_PROPERTY( bool allowNestedParts READ allowNestedParts WRITE setAllowNestedParts )
  TQ_PROPERTY( bool ignoreScrollBars READ ignoreScrollBars WRITE setIgnoreScrollBars )
public:
  enum SelectionPolicy { Direct, TriState };

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

  PartManager( TQWidget * parent, const char * name = 0L );
  PartManager( TQWidget * topLevel, TQObject *parent, const char *name = 0 );
  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( TQObject *obj, TQEvent *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, TQWidget *widget = 0L );

  virtual Part *activePart() const;

  virtual TQWidget *activeWidget() const;

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

  virtual Part *selectedPart() const;

  virtual TQWidget *selectedWidget() const;

  const TQPtrList<Part> *parts() const;

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

  int reason() const;
 
signals:
  void partAdded( KParts::Part *part );
  void partRemoved( KParts::Part *part );
  void activePartChanged( KParts::Part *newPart );
 
protected:
  virtual void setActiveInstance( TDEInstance * instance );
 
protected slots:
  void slotObjectDestroyed();

  void slotWidgetDestroyed();

  void slotManagedTopLevelWidgetDestroyed();
private:
  Part * findPartFromWidget( TQWidget * widget, const TQPoint &pos );
  Part * findPartFromWidget( TQWidget * widget );
 
protected:
  virtual void virtual_hook( int id, void* data );
private:
  PartManagerPrivate *d;
};
 
}
 
#endif