tdemdichildview.h

//----------------------------------------------------------------------------
//    filename             : tdemdichildview.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
//                           2000-2003     maintained by the KDevelop project
//    patches              : 02/2000       by Massimo Morin (mmorin@schedsys.com)
//                           */2000        by Lars Beikirch (Lars.Beikirch@gmx.net)
//                           02/2001       by Eva Brucherseifer (eva@rt.e-technik.tu-darmstadt.de)
//                           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 _TDEMDI_CHILD_VIEW_H_
#define _TDEMDI_CHILD_VIEW_H_
 
#include <tqwidget.h>
#include <tqpixmap.h>
#include <tqrect.h>
#include <tqapplication.h>
#include <tqdatetime.h>
 
#include "tdemdichildfrm.h"
 
class KMdiChildViewPrivate;
 
class KMDI_EXPORT KMdiChildView : public TQWidget
{
    friend class KMdiMainFrm;
    friend class KMdiChildFrm;
    TQ_OBJECT
 
    // attributes
protected:
    TQString m_szCaption;
    
    TQString m_sTabCaption;
    
    TQWidget* m_focusedChildWidget;
    
    TQWidget* m_firstFocusableChildWidget;
    
    TQWidget* m_lastFocusableChildWidget;
    
    int m_windowMenuID;
    
    bool m_stateChanged;
 
    TQDateTime m_time;
 
private:
    bool m_bToolView;
    
    bool m_bInterruptActivation;
    
    bool m_bMainframesActivateViewIsPending;
    
    bool m_bFocusInEventIsPending;
 
    // methods
public:
    KMdiChildView( const TQString& caption, TQWidget* parentWidget = 0L, const char* name = 0L, WFlags f = 0 );
    
    KMdiChildView( TQWidget* parentWidget = 0L, const char* name = 0L, WFlags f = 0 );
    
    ~KMdiChildView();
    
    void activate();
    
    void setFirstFocusableChildWidget( TQWidget* );
    
    void setLastFocusableChildWidget( TQWidget* );
    
    TQWidget* focusedChildWidget();
    
    bool isAttached() const { return ( mdiParent() != 0L ); }
    
    const TQString& caption() const { return m_szCaption; }
    
    const TQString& tabCaption() const { return m_sTabCaption; }
    
    virtual void setCaption( const TQString& szCaption );
    
    virtual void setTabCaption( const TQString& caption );
    
    virtual void setMDICaption( const TQString &caption );
    
    KMdiChildFrm *mdiParent() const;
    
    bool isMinimized() const;
    
    bool isMaximized() const;
    
    TQRect internalGeometry() const;
    
    void setInternalGeometry( const TQRect& newGeomety );
    
    TQRect externalGeometry() const;
    
    void setExternalGeometry( const TQRect& newGeomety );
    
    virtual TQPixmap* myIconPtr();
    
    virtual void minimize( bool bAnimate );
    
    virtual void maximize( bool bAnimate );
    
    TQRect restoreGeometry();
    
    void setRestoreGeometry( const TQRect& newRestGeo );
    
    void removeEventFilterForAllChildren();
    
    void setWindowMenuID( int id );
    
    virtual void setMinimumSize ( int minw, int minh );
    
    virtual void setMaximumSize ( int maxw, int maxh );
    
    inline bool isToolView() const { return m_bToolView; }
    
    inline void updateTimeStamp()
    {
        m_time.setDate( TQDate::currentDate() );
        m_time.setTime( TQTime::currentTime() );
    }
    
    inline const TQDateTime& getTimeStamp() const { return m_time; }
 
public slots:
    virtual void attach();
    
    virtual void detach();
    
    virtual void minimize();
    
    virtual void maximize();
    
    virtual void restore();
    
    virtual void youAreAttached( KMdiChildFrm *lpC );
    
    virtual void youAreDetached();
    
    virtual void slot_clickedInWindowMenu();
    
    virtual void slot_clickedInDockMenu();
    
    virtual void show();
    
    virtual void hide();
    
    virtual void raise();
    
    virtual void showMinimized();
    
    virtual void showMaximized();
    
    virtual void showNormal();
    
 
protected:
    virtual void closeEvent( TQCloseEvent *e );
    
    virtual bool eventFilter( TQObject *obj, TQEvent *e );
    
    virtual void focusInEvent( TQFocusEvent *e );
    
    virtual void focusOutEvent( TQFocusEvent *e );
    
    virtual void resizeEvent( TQResizeEvent *e );
 
    void trackIconAndCaptionChanges( TQWidget *view );
 
protected slots:
    void slot_childDestroyed();
 
signals:
    void attachWindow( KMdiChildView*, bool );
    
    void detachWindow( KMdiChildView*, bool );
    
    void focusInEventOccurs( KMdiChildView* );
    
    void gotFocus( KMdiChildView* );
    
    void activated( KMdiChildView* );
    
    void lostFocus( KMdiChildView* );
    
    void deactivated( KMdiChildView* );
    
    void childWindowCloseRequest( KMdiChildView* );
    
    void windowCaptionChanged( const TQString& );
    
    void tabCaptionChanged( const TQString& );
    
    void mdiParentNowMaximized( bool );
    
    void clickedInWindowMenu( int );
    
    void clickedInDockMenu( int );
    
    void isMaximizedNow();
    
    void isMinimizedNow();
    
    void isRestoredNow();
    
    void isAttachedNow();
    
    void isDetachedNow();
 
    void iconUpdated( TQWidget*, TQPixmap );
    void captionUpdated( TQWidget*, const TQString& );
 
 
private:
    KMdiChildViewPrivate *d;
    TQWidget *m_trackChanges;
};
 
inline KMdiChildFrm *KMdiChildView::mdiParent() const
{
    TQWidget * pw = parentWidget();
    if ( pw != 0L )
        if ( pw->inherits( "KMdiChildFrm" ) )
            return ( KMdiChildFrm * ) pw;
    return 0L;
}
 
#endif //_TDEMDI_CHILD_VIEW_H_