kjanuswidget.h

/*  This file is part of the KDE Libraries
 *  Copyright (C) 1999-2000 Espen Sand (espen@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 _KJANUS_WIDGET_H_
#define _KJANUS_WIDGET_H_
 
#include <tqptrlist.h>
#include <tqpixmap.h>
#include <tqsplitter.h>
 
#include <tdelistbox.h>
#include <tqstringlist.h>
#include <tqmap.h>
 
class TDEListView;
 
class TQGrid;
class TQHBox;
class TQLabel;
class TQTabWidget;
class TQVBox;
class TQWidgetStack;
class KSeparator;
class TQListViewItem;
class KGuiItem;
 
class TDEUI_EXPORT KJanusWidget : public TQWidget
{
  TQ_OBJECT
 
  private:
    class IconListBox : public TDEListBox
    {
      friend class KJanusWidget;
 
      public:
        IconListBox( TQWidget *parent=0, const char *name=0, WFlags f=0 );
    void updateMinimumHeight();
    void updateWidth();
    void invalidateHeight();
    void invalidateWidth();
    void setShowAll( bool showAll );
 
      protected:
        void slotOnItem( TQListBoxItem *item );
    virtual void leaveEvent( TQEvent * );
    
      private:
    bool mShowAll;
    bool mHeightValid;
    bool mWidthValid;
    TQListBoxItem *mOldItem;    
    };
 
  public:
    enum Face
    {
      TreeList = 0,
      Tabbed,
      Plain,
      Swallow,
      IconList
    };
 
  public:
 
    KJanusWidget( TQWidget *parent=0, const char *name=0, int face=Plain );
 
    ~KJanusWidget();
 
    virtual bool showPage( int index );
 
    virtual int  activePageIndex() const;
 
    virtual bool isValid() const;
 
    virtual int face() const;
 
    virtual TQSize minimumSizeHint() const;
 
    virtual TQSize sizeHint() const;
 
    virtual TQFrame *plainPage();
 
    virtual TQFrame *addPage(const TQString &item,const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
     virtual TQFrame *addPage(const TQStringList &items, const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
    virtual TQVBox *addVBoxPage( const TQString &item,
            const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
    virtual TQVBox *addVBoxPage( const TQStringList &items,
            const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
    virtual TQHBox *addHBoxPage( const TQString &itemName,
            const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
    virtual TQHBox *addHBoxPage( const TQStringList &items,
            const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
    virtual TQGrid *addGridPage( int n, Orientation dir,
            const TQString &itemName,
            const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
    virtual TQGrid *addGridPage( int n, Orientation dir,
            const TQStringList &items,
            const TQString &header=TQString::null,
            const TQPixmap &pixmap=TQPixmap() );
 
    void removePage( TQWidget *page );
 
 
    virtual int pageIndex( TQWidget *widget ) const;
 
    virtual bool setSwallowedWidget( TQWidget *widget );
 
    virtual void setTreeListAutoResize( bool state );
 
    virtual void setShowIconsInTreeList(bool state);
 
    virtual void setRootIsDecorated( bool state );
 
    /*virtual*/ void unfoldTreeList( bool persist = false ); //### KDE4 BIC add virtual
 
    /*virtual*/ void addWidgetBelowList( TQWidget * widget ); // ### KDE4
 
    /*virtual*/ void addButtonBelowList( const TQString & text, TQObject * recv,
                    const char * slot ); //### KDE4
 
    /*virtual*/ void addButtonBelowList( const KGuiItem & guiitem, TQObject *
                    recv, const char * slot ); //### KDE4
 
    virtual void setIconListAllVisible( bool state );
 
    virtual void setFolderIcon(const TQStringList &path, const TQPixmap &pixmap);
    /*virtual*/ TQString pageTitle(int index) const;
    /*virtual*/ TQWidget *pageWidget(int index) const;
 
  signals:
    void aboutToShowPage(TQWidget *page);
 
  public slots:
    virtual void setFocus();
 
  protected:
    virtual void showEvent( TQShowEvent * );
 
    virtual bool eventFilter( TQObject *o, TQEvent *e );
 
  private slots:
    bool slotShowPage();
    void slotFontChanged();
 
    void slotOnItem(TQListBoxItem *item);
    void slotItemClicked(TQListViewItem *it);
    void pageGone(TQObject *obj); // signal from the added page's "destroyed" signal
    void slotReopen(TQListViewItem *item);
 
  protected:
    bool showPage( TQWidget *w );
    void addPageWidget( TQFrame *page, const TQStringList &items,
            const TQString &header, const TQPixmap &pixmap );
    void InsertTreeListItem(const TQStringList &items, const TQPixmap &pixmap, TQFrame *page);
    TQWidget *FindParent();
 
  private:
    bool mValid;
 
    // Obsolete members. Remove in KDE 4.
    TQPtrList<TQWidget> *mPageList;
    TQStringList *mTitleList;
 
    int          mFace;
    TDEListView    *mTreeList;
    IconListBox  *mIconList;
    TQWidgetStack *mPageStack;
    TQLabel       *mTitleLabel;
    TQTabWidget   *mTabControl;
    TQFrame       *mPlainPage;
    TQWidget      *mSwallowPage;
    TQWidget      *mActivePageWidget;
    KSeparator   *mTitleSep;
    TQSplitter::ResizeMode mTreeListResizeMode;
    bool         mShowIconsInTreeList;
    TQMap<TQListViewItem *, TQWidget *> mTreeListToPageStack;
    TQMap<TQListBoxItem *, TQWidget *> mIconListToPageStack;
    TQMap<TQString, TQPixmap> mFolderIconMap;
    TQMap<TQString, TQStringList> mChildrenNames;
    TQMap<TQString, TQWidget *> mChildPages;
 
  public:
    class IconListItem;
  protected:
    virtual void virtual_hook( int id, void* data );
  private:
    class KJanusWidgetPrivate;
    KJanusWidgetPrivate *d;
};
 
#endif