diff options
Diffstat (limited to 'src/kernel/qlayout.h')
| -rw-r--r-- | src/kernel/qlayout.h | 473 |
1 files changed, 473 insertions, 0 deletions
diff --git a/src/kernel/qlayout.h b/src/kernel/qlayout.h new file mode 100644 index 0000000..7e96eda --- /dev/null +++ b/src/kernel/qlayout.h @@ -0,0 +1,473 @@ +/**************************************************************************** +** +** Definition of layout classes +** +** Created : 960416 +** +** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved. +** +** This file is part of the kernel module of the Qt GUI Toolkit. +** +** This file may be used under the terms of the GNU General +** Public License versions 2.0 or 3.0 as published by the Free +** Software Foundation and appearing in the files LICENSE.GPL2 +** and LICENSE.GPL3 included in the packaging of this file. +** Alternatively you may (at your option) use any later version +** of the GNU General Public License if such license has been +** publicly approved by Trolltech ASA (or its successors, if any) +** and the KDE Free Qt Foundation. +** +** Please review the following information to ensure GNU General +** Public Licensing requirements will be met: +** http://trolltech.com/products/qt/licenses/licensing/opensource/. +** If you are unsure which license is appropriate for your use, please +** review the following information: +** http://trolltech.com/products/qt/licenses/licensing/licensingoverview +** or contact the sales department at sales@trolltech.com. +** +** This file may be used under the terms of the Q Public License as +** defined by Trolltech ASA and appearing in the file LICENSE.QPL +** included in the packaging of this file. Licensees holding valid Qt +** Commercial 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 WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted +** herein. +** +**********************************************************************/ + +#ifndef QLAYOUT_H +#define QLAYOUT_H + +#ifndef QT_H +#include "qobject.h" +#include "qsizepolicy.h" +#include "qwidget.h" +#endif // QT_H + +#include <limits.h> + +#ifndef QT_NO_LAYOUT + +#if 0 +Q_OBJECT +#endif + +static const int QLAYOUTSIZE_MAX = INT_MAX/256/16; + +class QGridLayoutBox; +class QGridLayoutData; +class QLayout; +class QLayoutItem; +struct QLayoutData; +class QMenuBar; +class QSpacerItem; +class QWidget; + +class Q_EXPORT QGLayoutIterator : public QShared +{ +public: + virtual ~QGLayoutIterator(); + virtual QLayoutItem *next() = 0; + virtual QLayoutItem *current() = 0; + virtual QLayoutItem *takeCurrent() = 0; +}; + +class Q_EXPORT QLayoutIterator +{ +public: + QLayoutIterator( QGLayoutIterator *i ) : it( i ) { } + QLayoutIterator( const QLayoutIterator &i ) : it( i.it ) { + if ( it ) + it->ref(); + } + ~QLayoutIterator() { if ( it && it->deref() ) delete it; } + QLayoutIterator &operator=( const QLayoutIterator &i ) { + if ( i.it ) + i.it->ref(); + if ( it && it->deref() ) + delete it; + it = i.it; + return *this; + } + QLayoutItem *operator++() { return it ? it->next() : 0; } + QLayoutItem *current() { return it ? it->current() : 0; } + QLayoutItem *takeCurrent() { return it ? it->takeCurrent() : 0; } + void deleteCurrent(); + +private: + QGLayoutIterator *it; +}; + +class Q_EXPORT QLayoutItem +{ +public: + QLayoutItem( int alignment = 0 ) : align( alignment ) { } + virtual ~QLayoutItem(); + virtual QSize sizeHint() const = 0; + virtual QSize minimumSize() const = 0; + virtual QSize maximumSize() const = 0; + virtual QSizePolicy::ExpandData expanding() const = 0; + virtual void setGeometry( const QRect& ) = 0; + virtual QRect geometry() const = 0; + virtual bool isEmpty() const = 0; + virtual bool hasHeightForWidth() const; + virtual int heightForWidth( int ) const; + // ### add minimumHeightForWidth( int ) in Qt 4.0 + virtual void invalidate(); + + virtual QWidget *widget(); + virtual QLayoutIterator iterator(); + virtual QLayout *layout(); + virtual QSpacerItem *spacerItem(); + + int alignment() const { return align; } + virtual void setAlignment( int a ); + +protected: + int align; +}; + +class Q_EXPORT QSpacerItem : public QLayoutItem +{ +public: + QSpacerItem( int w, int h, + QSizePolicy::SizeType hData = QSizePolicy::Minimum, + QSizePolicy::SizeType vData = QSizePolicy::Minimum ) + : width( w ), height( h ), sizeP( hData, vData ) { } + void changeSize( int w, int h, + QSizePolicy::SizeType hData = QSizePolicy::Minimum, + QSizePolicy::SizeType vData = QSizePolicy::Minimum ); + QSize sizeHint() const; + QSize minimumSize() const; + QSize maximumSize() const; + QSizePolicy::ExpandData expanding() const; + bool isEmpty() const; + void setGeometry( const QRect& ); + QRect geometry() const; + QSpacerItem *spacerItem(); + +private: + int width; + int height; + QSizePolicy sizeP; + QRect rect; +}; + +class Q_EXPORT QWidgetItem : public QLayoutItem +{ +public: + QWidgetItem( QWidget *w ) : wid( w ) { } + QSize sizeHint() const; + QSize minimumSize() const; + QSize maximumSize() const; + QSizePolicy::ExpandData expanding() const; + bool isEmpty() const; + void setGeometry( const QRect& ); + QRect geometry() const; + virtual QWidget *widget(); + + bool hasHeightForWidth() const; + int heightForWidth( int ) const; + +private: + QWidget *wid; +}; + +class Q_EXPORT QLayout : public QObject, public QLayoutItem +{ + Q_OBJECT + Q_ENUMS( ResizeMode ) + Q_PROPERTY( int margin READ margin WRITE setMargin ) + Q_PROPERTY( int spacing READ spacing WRITE setSpacing ) + Q_PROPERTY( ResizeMode resizeMode READ resizeMode WRITE setResizeMode ) + +public: + // ### Qt 4.0: put 'Auto' first in enum + enum ResizeMode { FreeResize, Minimum, Fixed, Auto }; + + QLayout( QWidget *parent, int margin = 0, int spacing = -1, + const char *name = 0 ); + QLayout( QLayout *parentLayout, int spacing = -1, const char *name = 0 ); + QLayout( int spacing = -1, const char *name = 0 ); + ~QLayout(); + + int margin() const { return outsideBorder; } + int spacing() const { return insideSpacing; } + + virtual void setMargin( int ); + virtual void setSpacing( int ); + + int defaultBorder() const { return insideSpacing; } + void freeze( int w, int h ); + void freeze() { setResizeMode( Fixed ); } + + void setResizeMode( ResizeMode ); + ResizeMode resizeMode() const; + +#ifndef QT_NO_MENUBAR + virtual void setMenuBar( QMenuBar *w ); + QMenuBar *menuBar() const { return menubar; } +#endif + + QWidget *mainWidget(); + bool isTopLevel() const { return topLevel; } + + virtual void setAutoAdd( bool ); + bool autoAdd() const { return autoNewChild; } + + void invalidate(); + QRect geometry() const; + bool activate(); + + void add( QWidget *w ) { addItem( new QWidgetItem(w) ); } + virtual void addItem( QLayoutItem * ) = 0; + + void remove( QWidget *w ); + void removeItem( QLayoutItem * ); + + QSizePolicy::ExpandData expanding() const; + QSize minimumSize() const; + QSize maximumSize() const; + void setGeometry( const QRect& ) = 0; + QLayoutIterator iterator() = 0; + bool isEmpty() const; + + int totalHeightForWidth( int w ) const; + QSize totalMinimumSize() const; + QSize totalMaximumSize() const; + QSize totalSizeHint() const; + QLayout *layout(); + + bool supportsMargin() const { return marginImpl; } + + void setEnabled( bool ); + bool isEnabled() const; + +protected: + bool eventFilter( QObject *, QEvent * ); + void childEvent( QChildEvent *e ); + void addChildLayout( QLayout *l ); + void deleteAllItems(); + + void setSupportsMargin( bool ); + QRect alignmentRect( const QRect& ) const; + +private: + void setWidgetLayout( QWidget *, QLayout * ); + void init(); + int insideSpacing; + int outsideBorder; + uint topLevel : 1; + uint enabled : 1; + uint autoNewChild : 1; + uint frozen : 1; + uint activated : 1; + uint marginImpl : 1; + uint autoMinimum : 1; + uint autoResizeMode : 1; + QRect rect; + QLayoutData *extraData; +#ifndef QT_NO_MENUBAR + QMenuBar *menubar; +#endif + +private: +#if defined(Q_DISABLE_COPY) + QLayout( const QLayout & ); + QLayout &operator=( const QLayout & ); +#endif + + static void propagateSpacing( QLayout *layout ); +}; + +inline void QLayoutIterator::deleteCurrent() +{ + delete takeCurrent(); +} + +class Q_EXPORT QGridLayout : public QLayout +{ + Q_OBJECT +public: + QGridLayout( QWidget *parent, int nRows = 1, int nCols = 1, int border = 0, + int spacing = -1, const char *name = 0 ); + QGridLayout( int nRows = 1, int nCols = 1, int spacing = -1, + const char *name = 0 ); + QGridLayout( QLayout *parentLayout, int nRows = 1, int nCols = 1, + int spacing = -1, const char *name = 0 ); + ~QGridLayout(); + + QSize sizeHint() const; + QSize minimumSize() const; + QSize maximumSize() const; + + // ### remove 'virtual' in 4.0 (or add 'virtual' to set{Row,Col}Spacing()) + virtual void setRowStretch( int row, int stretch ); + virtual void setColStretch( int col, int stretch ); + int rowStretch( int row ) const; + int colStretch( int col ) const; + + void setRowSpacing( int row, int minSize ); + void setColSpacing( int col, int minSize ); + int rowSpacing( int row ) const; + int colSpacing( int col ) const; + + int numRows() const; + int numCols() const; + QRect cellGeometry( int row, int col ) const; + + bool hasHeightForWidth() const; + int heightForWidth( int ) const; + int minimumHeightForWidth( int ) const; + + QSizePolicy::ExpandData expanding() const; + void invalidate(); + + void addItem( QLayoutItem * ); + void addItem( QLayoutItem *item, int row, int col ); + void addMultiCell( QLayoutItem *, int fromRow, int toRow, + int fromCol, int toCol, int align = 0 ); + + void addWidget( QWidget *, int row, int col, int align = 0 ); + void addMultiCellWidget( QWidget *, int fromRow, int toRow, + int fromCol, int toCol, int align = 0 ); + void addLayout( QLayout *layout, int row, int col); + void addMultiCellLayout( QLayout *layout, int fromRow, int toRow, + int fromCol, int toCol, int align = 0 ); + void addRowSpacing( int row, int minsize ); + void addColSpacing( int col, int minsize ); + + void expand( int rows, int cols ); + + enum Corner { TopLeft, TopRight, BottomLeft, BottomRight }; + void setOrigin( Corner ); + Corner origin() const; + QLayoutIterator iterator(); + void setGeometry( const QRect& ); + +protected: + bool findWidget( QWidget* w, int *r, int *c ); + void add( QLayoutItem*, int row, int col ); + +private: +#if defined(Q_DISABLE_COPY) + QGridLayout( const QGridLayout & ); + QGridLayout &operator=( const QGridLayout & ); +#endif + + void init( int rows, int cols ); + QGridLayoutData *data; +}; + +class QBoxLayoutData; +class QDockWindow; + +class Q_EXPORT QBoxLayout : public QLayout +{ + Q_OBJECT +public: + enum Direction { LeftToRight, RightToLeft, TopToBottom, BottomToTop, + Down = TopToBottom, Up = BottomToTop }; + + QBoxLayout( QWidget *parent, Direction, int border = 0, int spacing = -1, + const char *name = 0 ); + QBoxLayout( QLayout *parentLayout, Direction, int spacing = -1, + const char *name = 0 ); + QBoxLayout( Direction, int spacing = -1, const char *name = 0 ); + ~QBoxLayout(); + + void addItem( QLayoutItem * ); + + Direction direction() const { return dir; } + void setDirection( Direction ); + + void addSpacing( int size ); + void addStretch( int stretch = 0 ); + void addWidget( QWidget *, int stretch = 0, int alignment = 0 ); + void addLayout( QLayout *layout, int stretch = 0 ); + void addStrut( int ); + + void insertSpacing( int index, int size ); + void insertStretch( int index, int stretch = 0 ); + void insertWidget( int index, QWidget *widget, int stretch = 0, + int alignment = 0 ); + void insertLayout( int index, QLayout *layout, int stretch = 0 ); + + bool setStretchFactor( QWidget*, int stretch ); + bool setStretchFactor( QLayout *l, int stretch ); + + QSize sizeHint() const; + QSize minimumSize() const; + QSize maximumSize() const; + + bool hasHeightForWidth() const; + int heightForWidth( int ) const; + int minimumHeightForWidth( int ) const; + + QSizePolicy::ExpandData expanding() const; + void invalidate(); + QLayoutIterator iterator(); + void setGeometry( const QRect& ); + + int findWidget( QWidget* w ); + +protected: + void insertItem( int index, QLayoutItem * ); + +private: + friend class QDockWindow; +#if defined(Q_DISABLE_COPY) + QBoxLayout( const QBoxLayout & ); + QBoxLayout &operator=( const QBoxLayout & ); +#endif + + void setupGeom(); + void calcHfw( int ); + QBoxLayoutData *data; + Direction dir; + QBoxLayout *createTmpCopy(); +}; + +class Q_EXPORT QHBoxLayout : public QBoxLayout +{ + Q_OBJECT +public: + QHBoxLayout( QWidget *parent, int border = 0, + int spacing = -1, const char *name = 0 ); + QHBoxLayout( QLayout *parentLayout, + int spacing = -1, const char *name = 0 ); + QHBoxLayout( int spacing = -1, const char *name = 0 ); + + ~QHBoxLayout(); + +private: // Disabled copy constructor and operator= +#if defined(Q_DISABLE_COPY) + QHBoxLayout( const QHBoxLayout & ); + QHBoxLayout &operator=( const QHBoxLayout & ); +#endif +}; + +class Q_EXPORT QVBoxLayout : public QBoxLayout +{ + Q_OBJECT +public: + QVBoxLayout( QWidget *parent, int border = 0, + int spacing = -1, const char *name = 0 ); + QVBoxLayout( QLayout *parentLayout, + int spacing = -1, const char *name = 0 ); + QVBoxLayout( int spacing = -1, const char *name = 0 ); + + ~QVBoxLayout(); + +private: // Disabled copy constructor and operator= +#if defined(Q_DISABLE_COPY) + QVBoxLayout( const QVBoxLayout & ); + QVBoxLayout &operator=( const QVBoxLayout & ); +#endif +}; + +#endif // QT_NO_LAYOUT +#endif // QLAYOUT_H |