tdemdimainfrm.h

//----------------------------------------------------------------------------
//    filename             : tdemdimainfrm.h
//----------------------------------------------------------------------------
//    Project              : KDE MDI extension
//
//    begin                : 07/1999       by Szymon Stefanek as part of kvirc
//                                         (an IRC application)
//    changes              : 09/1999       by Falk Brettschneider to create an
//                           - 06/2000     stand-alone Qt extension set of
//                                         classes and a Qt-based library
//                         : 02/2000       by Massimo Morin (mmorin@schedsys.com)
//                           2000-2003     maintained by the KDevelop project
//    patches              : */2000        by Lars Beikirch (Lars.Beikirch@gmx.net)
//                         : 01/2003       by Jens Zurheide (jens.zurheide@gmx.de)
//
//    copyright            : (C) 1999-2003 by Falk Brettschneider
//                                         and
//                                         Szymon Stefanek (stefanek@tin.it)
//    email                :  falkbr@kdevelop.org (Falk Brettschneider)
//----------------------------------------------------------------------------
//
//----------------------------------------------------------------------------
//
//    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 of the
//    License, or (at your option) any later version.
//
//----------------------------------------------------------------------------
 
#ifndef _TDEMDIMAINFRM_H_
#define _TDEMDIMAINFRM_H_
 
#include <tdeparts/dockmainwindow.h>
#include <tdemenubar.h>
#include <tdepopupmenu.h>
 
#include <tqptrlist.h>
#include <tqrect.h>
#include <tqapplication.h>
#include <tqdom.h>
#include <tqguardedptr.h>
 
#include "tdemditaskbar.h"
#include "tdemdichildarea.h"
#include "tdemdichildview.h"
#include "tdemdiiterator.h"
#include "tdemdilistiterator.h"
#include "tdemdinulliterator.h"
#include "tdemditoolviewaccessor.h"
 
class TQTimer;
class TQPopupMenu;
class TQMenuBar;
 
 
class TQToolButton;
 
namespace KMDIPrivate
{
class KMDIGUIClient;
}
 
class KMdiDockContainer;
class KMdiMainFrmPrivate;
 
class KMDI_EXPORT KMdiViewCloseEvent : public TQCustomEvent
{
public:
    KMdiViewCloseEvent( KMdiChildView* pWnd ) : TQCustomEvent( TQEvent::User, pWnd ) {}
};
 
class KMDI_EXPORT KMdiMainFrm : public KParts::DockMainWindow
{
    friend class KMdiChildView;
    friend class KMdiTaskBar;
    TQ_OBJECT
 
    friend class KMdiToolViewAccessor;
    // attributes
protected:
    KMdi::MdiMode m_mdiMode;
    KMdiChildArea *m_pMdi;
    KMdiTaskBar *m_pTaskBar;
    TQPtrList<KMdiChildView> *m_pDocumentViews;
    TQMap<TQWidget*, KMdiToolViewAccessor*> *m_pToolViews;
    KMdiChildView *m_pCurrentWindow;
    TQPopupMenu *m_pWindowPopup;
    TQPopupMenu *m_pTaskBarPopup;
    TQPopupMenu *m_pWindowMenu;
    TQPopupMenu *m_pDockMenu;
    TQPopupMenu *m_pMdiModeMenu;
    TQPopupMenu *m_pPlacingMenu;
    KMenuBar *m_pMainMenuBar;
 
    TQPixmap *m_pUndockButtonPixmap;
    TQPixmap *m_pMinButtonPixmap;
    TQPixmap *m_pRestoreButtonPixmap;
    TQPixmap *m_pCloseButtonPixmap;
 
    TQToolButton *m_pUndock;
    TQToolButton *m_pMinimize;
    TQToolButton *m_pRestore;
    TQToolButton *m_pClose;
    TQPoint m_undockPositioningOffset;
    bool m_bMaximizedChildFrmMode;
    int m_oldMainFrmHeight;
    int m_oldMainFrmMinHeight;
    int m_oldMainFrmMaxHeight;
    static KMdi::FrameDecor m_frameDecoration;
    bool m_bSDIApplication;
    KDockWidget* m_pDockbaseAreaOfDocumentViews;
    TQDomDocument* m_pTempDockSession;
    bool m_bClearingOfWindowMenuBlocked;
 
    TQTimer* m_pDragEndTimer;
 
    bool m_bSwitching;
 
    KDockWidget* m_leftContainer;
    KDockWidget* m_rightContainer;
    KDockWidget* m_topContainer;
    KDockWidget* m_bottomContainer;
 
 
private:
    KMdiMainFrmPrivate* d;
    KMDIPrivate::KMDIGUIClient* m_mdiGUIClient;
    bool m_managedDockPositionMode;
 
    // methods
public:
#ifdef qdoc
    KMdiMainFrm( TQWidget* parentWidget, const char* name = "", KMdi::MdiMode mdiMode = KMdi::ChildframeMode, WFlags flags = WType_TopLevel | WDestructiveClose );
#else
    KMdiMainFrm( TQWidget* parentWidget, const char* name = "", KMdi::MdiMode mdiMode = KMdi::ChildframeMode, WFlags flags = (WFlags)(WType_TopLevel | WDestructiveClose) );
#endif
    virtual ~KMdiMainFrm();
 
    void setStandardMDIMenuEnabled( bool showModeMenu = true );
 
    void setManagedDockPositionModeEnabled( bool enabled );
 
    bool isInMaximizedChildFrmMode() { return m_bMaximizedChildFrmMode; }
 
    KMdi::MdiMode mdiMode() { return m_mdiMode; }
 
    KMdiChildView* activeWindow();
 
    virtual TQPopupMenu * taskBarPopup( KMdiChildView *pWnd, bool bIncludeWindowPopup = false );
 
    virtual TQPopupMenu * windowPopup( KMdiChildView *pWnd, bool bIncludeTaskbarPopup = true );
 
    virtual void applyOptions();
 
    KMdiChildView * findWindow( const TQString& caption );
 
    enum ExistsAs {DocumentView, ToolView, AnyView};
    bool windowExists( KMdiChildView *pWnd, ExistsAs as );
 
    virtual bool event( TQEvent* e );
 
    virtual void setSysButtonsAtMenuPosition();
 
    virtual int taskBarHeight() { return m_pTaskBar ? m_pTaskBar->height() : 0; }
 
    virtual void setUndockPositioningOffset( TQPoint offset ) { m_undockPositioningOffset = offset; }
 
    // FIXME And what exactly are we supposed to fix? -mattr
    KMdiIterator<KMdiChildView*>* createIterator()
    {
        if ( m_pDocumentViews == 0L )
        {
            return new KMdiNullIterator<KMdiChildView*>();
        }
        else
        {
            return new KMdiListIterator<KMdiChildView>( *m_pDocumentViews );
        }
    }
 
    void deleteIterator( KMdiIterator<KMdiChildView*>* pIt )
    {
        delete pIt;
    }
 
    TQPopupMenu* windowMenu() const  { return m_pWindowMenu; };
 
    virtual void setBackgroundColor( const TQColor &c ) { m_pMdi->setBackgroundColor( c ); }
 
    virtual void setBackgroundPixmap( const TQPixmap &pm ) { m_pMdi->setBackgroundPixmap( pm ); }
 
    void setDefaultChildFrmSize( const TQSize& sz ) { m_pMdi->m_defaultChildFrmSize = sz; }
 
    TQSize defaultChildFrmSize() { return m_pMdi->m_defaultChildFrmSize; }
 
    virtual void setMinimumSize( int minw, int minh );
 
    int childFrameModeHeight() { return m_oldMainFrmHeight; };
    virtual void setMenuForSDIModeSysButtons( KMenuBar* menuBar = 0 );
 
    static int frameDecorOfAttachedViews() { return m_frameDecoration; }
 
    void fakeSDIApplication();
 
    bool isFakingSDIApplication() const { return m_bSDIApplication; }
 
    virtual bool eventFilter( TQObject *obj, TQEvent *e );
    void findRootDockWidgets( TQPtrList<KDockWidget>* pRootDockWidgetList, TQValueList<TQRect>* pPositionList );
 
    void setSwitching( const bool switching ) { m_bSwitching = switching; }
    bool switching( void ) const { return m_bSwitching; }
 
public slots:
    KMdiChildView* createWrapper( TQWidget *view, const TQString& name, const TQString& shortName );
 
    virtual void addWindow( KMdiChildView* pWnd, int flags = KMdi::StandardAdd );
 
    //KDE4: merge the two methods
    void addWindow( KMdiChildView* pWnd, int flags, int index );
 
    virtual void addWindow( KMdiChildView* pWnd, TQPoint pos, int flags = KMdi::StandardAdd );
 
    virtual void addWindow( KMdiChildView* pWnd, TQRect rectNormal, int flags = KMdi::StandardAdd );
 
    virtual KMdiToolViewAccessor *addToolWindow( TQWidget* pWnd, KDockWidget::DockPosition pos = KDockWidget::DockNone,
                                                 TQWidget* pTargetWnd = 0L, int percent = 50, const TQString& tabToolTip = 0,
                                                 const TQString& tabCaption = 0 );
 
    virtual void deleteToolWindow( TQWidget* pWnd );
    virtual void deleteToolWindow( KMdiToolViewAccessor *accessor );
 
    KMdiToolViewAccessor *createToolWindow();
 
    virtual void removeWindowFromMdi( KMdiChildView *pWnd );
 
    virtual void closeWindow( KMdiChildView *pWnd, bool layoutTaskBar = true );
 
    virtual void slot_toggleTaskBar();
 
    virtual void attachWindow( KMdiChildView *pWnd, bool bShow = true, bool bAutomaticResize = false );
 
    virtual void detachWindow( KMdiChildView *pWnd, bool bShow = true );
 
    virtual void childWindowCloseRequest( KMdiChildView *pWnd );
 
    virtual void closeAllViews();
 
    virtual void iconifyAllViews();
 
    virtual void closeActiveView();
 
    virtual void switchToToplevelMode();
    virtual void finishToplevelMode();
 
    virtual void switchToChildframeMode();
    virtual void finishChildframeMode();
 
    virtual void switchToTabPageMode();
    virtual void finishTabPageMode();
 
    virtual void switchToIDEAlMode();
    virtual void finishIDEAlMode( bool full = true );
 
    void setIDEAlModeStyle( int flags ) TDE_DEPRECATED;
    //KDE4: Get rid of the above.
    void setToolviewStyle( int flags );
    bool isViewTaskBarOn();
 
    virtual void showViewTaskBar();
 
    virtual void hideViewTaskBar();
 
    virtual void fillWindowMenu();
 
    virtual void cascadeWindows() { m_pMdi->cascadeWindows(); }
 
    virtual void cascadeMaximized() { m_pMdi->cascadeMaximized(); }
 
    virtual void expandVertical() { m_pMdi->expandVertical(); }
 
    virtual void expandHorizontal() { m_pMdi->expandHorizontal(); }
 
    virtual void tilePragma() { m_pMdi->tilePragma(); }
 
    virtual void tileAnodine() { m_pMdi->tileAnodine(); }
 
    virtual void tileVertically() { m_pMdi->tileVertically(); }
 
    virtual void setFrameDecorOfAttachedViews( int frameDecor );
 
    virtual void setEnableMaximizedChildFrmMode( bool bEnable );
 
    virtual void activateNextWin();
 
    virtual void activatePrevWin();
 
    virtual void activateFirstWin();
 
    virtual void activateLastWin();
 
    virtual void activateView( int index );
 
private:
    void setupToolViewsForIDEALMode();
    void setupTabbedDocumentViewSpace();
    class KMdiDocumentViewTabWidget * m_documentTabWidget;
 
protected:
 
    virtual void resizeEvent( TQResizeEvent * );
 
    virtual void createTaskBar();
 
    virtual void createMdiManager();
 
    void blockClearingOfWindowMenu( bool bBlocked ) { m_bClearingOfWindowMenuBlocked = bBlocked; }
 
    void findToolViewsDockedToMain( TQPtrList<KDockWidget>* list, KDockWidget::DockPosition dprtmw );
    void dockToolViewsIntoContainers( TQPtrList<KDockWidget>& widgetsToReparent, KDockWidget *container );
    TQStringList prepareIdealToTabs( KDockWidget* container );
    void idealToolViewsToStandardTabs( TQStringList widgetNames, KDockWidget::DockPosition pos, int sizee );
 
    KMdi::TabWidgetVisibility tabWidgetVisibility();
 
    void setTabWidgetVisibility( KMdi::TabWidgetVisibility );
 
    class KTabWidget * tabWidget() const;
 
 
protected slots:  // Protected slots
    virtual void activateView( KMdiChildView *pWnd );
 
    virtual void taskbarButtonRightClicked( KMdiChildView *pWnd );
 
    void switchOffMaximizeModeForMenu( KMdiChildFrm* oldChild );
 
    void updateSysButtonConnections( KMdiChildFrm* oldChild, KMdiChildFrm* newChild );
 
    void windowMenuItemActivated( int id );
 
    void dockMenuItemActivated( int id );
 
    void popupWindowMenu( TQPoint p );
 
    void dragEndTimeOut();
 
    void closeViewButtonPressed();
 
signals:
    void lastChildFrmClosed();
 
    void lastChildViewClosed();
 
    void leftTopLevelMode();
 
    void childViewIsDetachedNow( TQWidget* );
 
    void collapseOverlapContainers();
 
    void mdiModeHasBeenChangedTo( KMdi::MdiMode );
 
    void viewActivated( KMdiChildView* );
    void viewDeactivated( KMdiChildView* );
 
public slots:
    void prevToolViewInDock();
    void nextToolViewInDock();
 
private slots:
    void setActiveToolDock( KMdiDockContainer* );
    void removeFromActiveDockList( KMdiDockContainer* );
    void slotDocCurrentChanged( TQWidget* );
    void verifyToplevelHeight();
#define protected public
signals:
#undef protected
 
    void toggleTop();
    void toggleLeft();
    void toggleRight();
    void toggleBottom();
};
 
#endif //_TDEMDIMAINFRM_H_