Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

# qmainwindow.h

This is the verbatim text of the qmainwindow.h include file. It is provided only for illustration; the copyright remains with Trolltech.

    /****************************************************************************
    ** $Id: qt/qmainwindow.h   3.3.3   edited May 27 2003 $
    **
    ** Definition of QMainWindow class
    **
    ** Created : 980316
    **
    ** Copyright (C) 1992-2000 Trolltech AS.  All rights reserved.
    **
    ** This file is part of the widgets module of the Qt GUI Toolkit.
    **
    ** This file may be distributed under the terms of the Q Public License
    ** as defined by Trolltech AS of Norway and appearing in the file
    ** LICENSE.QPL included in the packaging of this file.
    **
    ** This file may be distributed and/or modified under the terms of the
    ** GNU General Public License version 2 as published by the Free Software
    ** Foundation and appearing in the file LICENSE.GPL included in the
    ** packaging of this file.
    **
    ** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
    ** licenses may use this file in accordance with the Qt Commercial License
    ** Agreement provided with the Software.
    **
    ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
    ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
    **
    ** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
    **   information about Qt Commercial License Agreements.
    ** See http://www.trolltech.com/qpl/ for QPL licensing information.
    ** See http://www.trolltech.com/gpl/ for GPL licensing information.
    **
    ** Contact info@trolltech.com if any conditions of this licensing are
    ** not clear to you.
    **
    **********************************************************************/

    #ifndef QMAINWINDOW_H
    #define QMAINWINDOW_H

    #ifndef QT_H
    #include "qwidget.h"
    #include "qtoolbar.h"
    #include "qptrlist.h"
    #include "qtextstream.h"
    #endif // QT_H

    #ifndef QT_NO_MAINWINDOW

    class QMenuBar;
    class QStatusBar;
    class QToolTipGroup;
    class QMainWindowPrivate;
    class QMainWindowLayout;
    class QPopupMenu;

    class Q_EXPORT QMainWindow: public QWidget
    {
        Q_OBJECT
        Q_PROPERTY( bool rightJustification READ rightJustification WRITE setRightJustification DESIGNABLE false )
        Q_PROPERTY( bool usesBigPixmaps READ usesBigPixmaps WRITE setUsesBigPixmaps )
        Q_PROPERTY( bool usesTextLabel READ usesTextLabel WRITE setUsesTextLabel )
        Q_PROPERTY( bool dockWindowsMovable READ dockWindowsMovable WRITE setDockWindowsMovable )
        Q_PROPERTY( bool opaqueMoving READ opaqueMoving WRITE setOpaqueMoving )

    public:
        QMainWindow( QWidget* parent=0, const char* name=0, WFlags f = WType_TopLevel );
        ~QMainWindow();

    #ifndef QT_NO_MENUBAR
        QMenuBar * menuBar() const;
    #endif
        QStatusBar * statusBar() const;
    #ifndef QT_NO_TOOLTIP
        QToolTipGroup * toolTipGroup() const;
    #endif

        virtual void setCentralWidget( QWidget * );
        QWidget * centralWidget() const;

        virtual void setDockEnabled( Dock dock, bool enable );
        bool isDockEnabled( Dock dock ) const;
        bool isDockEnabled( QDockArea *area ) const;
        virtual void setDockEnabled( QDockWindow *tb, Dock dock, bool enable );
        bool isDockEnabled( QDockWindow *tb, Dock dock ) const;
        bool isDockEnabled( QDockWindow *tb, QDockArea *area ) const;

        virtual void addDockWindow( QDockWindow *, Dock = DockTop, bool newLine = FALSE );
        virtual void addDockWindow( QDockWindow *, const QString &label,
    				Dock = DockTop, bool newLine = FALSE );
        virtual void moveDockWindow( QDockWindow *, Dock = DockTop );
        virtual void moveDockWindow( QDockWindow *, Dock, bool nl, int index, int extraOffset = -1 );
        virtual void removeDockWindow( QDockWindow * );

        void show();
        void hide();
        QSize sizeHint() const;
        QSize minimumSizeHint() const;

        bool rightJustification() const;
        bool usesBigPixmaps() const;
        bool usesTextLabel() const;
        bool dockWindowsMovable() const;
        bool opaqueMoving() const;

        bool eventFilter( QObject*, QEvent* );

        bool getLocation( QDockWindow *tb, Dock &dock, int &index, bool &nl, int &extraOffset ) const;

        QPtrList<QDockWindow> dockWindows( Dock dock ) const;
        QPtrList<QDockWindow> dockWindows() const;
        void lineUpDockWindows( bool keepNewLines = FALSE );

        bool isDockMenuEnabled() const;

        // compatibility stuff
        bool hasDockWindow( QDockWindow *dw );
    #ifndef QT_NO_TOOLBAR
        void addToolBar( QDockWindow *, Dock = DockTop, bool newLine = FALSE );
        void addToolBar( QDockWindow *, const QString &label,
    		     Dock = DockTop, bool newLine = FALSE );
        void moveToolBar( QDockWindow *, Dock = DockTop );
        void moveToolBar( QDockWindow *, Dock, bool nl, int index, int extraOffset = -1 );
        void removeToolBar( QDockWindow * );

        bool toolBarsMovable() const;
        QPtrList<QToolBar> toolBars( Dock dock ) const;
        void lineUpToolBars( bool keepNewLines = FALSE );
    #endif

        virtual QDockArea *dockingArea( const QPoint &p );
        QDockArea *leftDock() const;
        QDockArea *rightDock() const;
        QDockArea *topDock() const;
        QDockArea *bottomDock() const;

        virtual bool isCustomizable() const;

        bool appropriate( QDockWindow *dw ) const;

        enum DockWindows { OnlyToolBars, NoToolBars, AllDockWindows };
        QPopupMenu *createDockWindowMenu( DockWindows dockWindows = AllDockWindows ) const;

    public slots:
        virtual void setRightJustification( bool );
        virtual void setUsesBigPixmaps( bool );
        virtual void setUsesTextLabel( bool );
        virtual void setDockWindowsMovable( bool );
        virtual void setOpaqueMoving( bool );
        virtual void setDockMenuEnabled( bool );
        virtual void whatsThis();
        virtual void setAppropriate( QDockWindow *dw, bool a );
        virtual void customize();

        // compatibility stuff
        void setToolBarsMovable( bool );

    signals:
        void pixmapSizeChanged( bool );
        void usesTextLabelChanged( bool );
        void dockWindowPositionChanged( QDockWindow * );

    #ifndef QT_NO_TOOLBAR
        // compatibility stuff
        void toolBarPositionChanged( QToolBar * );
    #endif

    protected slots:
        virtual void setUpLayout();
        virtual bool showDockMenu( const QPoint &globalPos );
        void menuAboutToShow();

    protected:
        void paintEvent( QPaintEvent * );
        void childEvent( QChildEvent * );
        bool event( QEvent * );
        void styleChange( QStyle& );

    private slots:
        void slotPlaceChanged();
        void doLineUp() { lineUpDockWindows( TRUE ); }

    private:
        QMainWindowPrivate * d;
        void triggerLayout( bool deleteLayout = TRUE);
        bool dockMainWindow( QObject *dock );

    #ifndef QT_NO_MENUBAR
        virtual void setMenuBar( QMenuBar * );
    #endif
        virtual void setStatusBar( QStatusBar * );
    #ifndef QT_NO_TOOLTIP
        virtual void setToolTipGroup( QToolTipGroup * );
    #endif

        friend class QDockWindow;
        friend class QMenuBar;
        friend class QHideDock;
        friend class QToolBar;
        friend class QMainWindowLayout;
    private:	// Disabled copy constructor and operator=
    #if defined(Q_DISABLE_COPY)
        QMainWindow( const QMainWindow & );
        QMainWindow& operator=( const QMainWindow & );
    #endif
    };

    #ifndef QT_NO_TOOLBAR
    inline void QMainWindow::addToolBar( QDockWindow *w, ToolBarDock dock, bool newLine )
    {
        addDockWindow( w, dock, newLine );
    }

    inline void QMainWindow::addToolBar( QDockWindow *w, const QString &label,
    			      ToolBarDock dock, bool newLine )
    {
        addDockWindow( w, label, dock, newLine );
    }

    inline void QMainWindow::moveToolBar( QDockWindow *w, ToolBarDock dock )
    {
        moveDockWindow( w, dock );
    }

    inline void QMainWindow::moveToolBar( QDockWindow *w, ToolBarDock dock, bool nl, int index, int extraOffset )
    {
        moveDockWindow( w, dock, nl, index, extraOffset );
    }

    inline void QMainWindow::removeToolBar( QDockWindow *w )
    {
        removeDockWindow( w );
    }

    inline bool QMainWindow::toolBarsMovable() const
    {
        return dockWindowsMovable();
    }

    inline void QMainWindow::lineUpToolBars( bool keepNewLines )
    {
        lineUpDockWindows( keepNewLines );
    }

    inline void QMainWindow::setToolBarsMovable( bool b )
    {
        setDockWindowsMovable( b );
    }
    #endif

    #ifndef QT_NO_TEXTSTREAM
    Q_EXPORT QTextStream &operator<<( QTextStream &, const QMainWindow & );
    Q_EXPORT QTextStream &operator>>( QTextStream &, QMainWindow & );
    #endif

    #endif // QT_NO_MAINWINDOW

    #endif // QMAINWINDOW_H