diff options
Diffstat (limited to 'src/kernel/qabstractlayout.cpp')
| -rw-r--r-- | src/kernel/qabstractlayout.cpp | 1945 |
1 files changed, 1945 insertions, 0 deletions
diff --git a/src/kernel/qabstractlayout.cpp b/src/kernel/qabstractlayout.cpp new file mode 100644 index 000000000..a0b4b8b51 --- /dev/null +++ b/src/kernel/qabstractlayout.cpp @@ -0,0 +1,1945 @@ +/**************************************************************************** +** +** Implementation of the abstract layout base class +** +** Created : 960416 +** +** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved. +** +** This file is part of the kernel module of the TQt 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 TQt Foundation. +** +** Please review the following information to ensure GNU General +** Public Licensing retquirements 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.TQPL +** included in the packaging of this file. Licensees holding valid TQt +** Commercial licenses may use this file in accordance with the TQt +** 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. +** +**********************************************************************/ + +#include "qlayout.h" + +#ifndef QT_NO_LAYOUT +#include "qapplication.h" +#include "qlayoutengine_p.h" +#include "qmenubar.h" +#include "qtoolbar.h" + +static int menuBarHeightForWidth( TQMenuBar *menubar, int w ) +{ +#ifndef QT_NO_MENUBAR + if ( menubar && !menubar->isHidden() && !menubar->isTopLevel() ) + return menubar->heightForWidth( TQMAX(w, menubar->minimumWidth()) ); + else +#endif + return 0; +} + +/*! + \class TQLayoutItem + \ingroup appearance + \ingroup geomanagement + \brief The TQLayoutItem class provides an abstract item that a + TQLayout manipulates. + + This is used by custom layouts. + + Pure virtual functions are provided to return information about + the layout, including, sizeHint(), minimumSize(), maximumSize() + and expanding(). + + The layout's geometry can be set and retrieved with setGeometry() + and geometry(), and its alignment with setAlignment() and + alignment(). + + isEmpty() returns whether the layout is empty. iterator() returns + an iterator for the layout's children. If the concrete item is a + TQWidget, it can be retrieved using widget(). Similarly for + layout() and spacerItem(). + + \sa TQLayout +*/ + +/*! + \class TQSpacerItem + \ingroup appearance + \ingroup geomanagement + \brief The TQSpacerItem class provides blank space in a layout. + + This class is used by custom layouts. + + \sa TQLayout TQLayout::spacerItem() +*/ + +/*! + \class TQWidgetItem + \ingroup appearance + \ingroup geomanagement + \brief The TQWidgetItem class is a layout item that represents a widget. + + This is used by custom layouts. + + \sa TQLayout TQLayout::widget() +*/ + +/*! + \fn TQLayoutItem::TQLayoutItem( int alignment ) + + Constructs a layout item with an \a alignment that is a bitwise OR + of the \l{TQt::AlignmentFlags}. Not all subclasses support + alignment. +*/ + +/*! + \fn int TQLayoutItem::alignment() const + + Returns the alignment of this item. +*/ + +/*! + Sets the alignment of this item to \a a, which is a bitwise OR of + the \l{TQt::AlignmentFlags}. Not all subclasses support alignment. +*/ +void TQLayoutItem::setAlignment( int a ) +{ + align = a; +} + +/*! + \fn TQSize TQLayoutItem::maximumSize() const + + Implemented in subclasses to return the maximum size of this item. +*/ + +/*! + \fn TQSize TQLayoutItem::minimumSize() const + + Implemented in subclasses to return the minimum size of this item. +*/ + +/*! + \fn TQSize TQLayoutItem::sizeHint() const + + Implemented in subclasses to return the preferred size of this item. +*/ + +/*! + \fn TQSizePolicy::ExpandData TQLayoutItem::expanding() const + + Implemented in subclasses to return the direction(s) this item + "wants" to expand in (if any). +*/ + +/*! + \fn void TQLayoutItem::setGeometry( const TQRect &r ) + + Implemented in subclasses to set this item's geometry to \a r. +*/ + +/*! + \fn TQRect TQLayoutItem::geometry() const + + Returns the rectangle covered by this layout item. +*/ + +/*! + \fn virtual bool TQLayoutItem::isEmpty() const + + Implemented in subclasses to return whether this item is empty, + i.e. whether it contains any widgets. +*/ + +/*! + \fn TQSpacerItem::TQSpacerItem( int w, int h, TQSizePolicy::SizeType hData, TQSizePolicy::SizeType vData ) + + Constructs a spacer item with preferred width \a w, preferred + height \a h, horizontal size policy \a hData and vertical size + policy \a vData. + + The default values provide a gap that is able to stretch if + nothing else wants the space. +*/ + +/*! + Changes this spacer item to have preferred width \a w, preferred + height \a h, horizontal size policy \a hData and vertical size + policy \a vData. + + The default values provide a gap that is able to stretch if + nothing else wants the space. +*/ +void TQSpacerItem::changeSize( int w, int h, TQSizePolicy::SizeType hData, + TQSizePolicy::SizeType vData ) +{ + width = w; + height = h; + sizeP = TQSizePolicy( hData, vData ); +} + +/*! + \fn TQWidgetItem::TQWidgetItem (TQWidget * w) + + Creates an item containing widget \a w. +*/ + +/*! + Destroys the TQLayoutItem. +*/ +TQLayoutItem::~TQLayoutItem() +{ +} + +/*! + Invalidates any cached information in this layout item. +*/ +void TQLayoutItem::invalidate() +{ +} + +/*! + If this item is a TQLayout, it is returned as a TQLayout; otherwise + 0 is returned. This function provides type-safe casting. +*/ +TQLayout * TQLayoutItem::layout() +{ + return 0; +} + +/*! + If this item is a TQSpacerItem, it is returned as a TQSpacerItem; + otherwise 0 is returned. This function provides type-safe casting. +*/ +TQSpacerItem * TQLayoutItem::spacerItem() +{ + return 0; +} + +/*! + \reimp +*/ +TQLayout * TQLayout::layout() +{ + return this; +} + +/*! + \reimp +*/ +TQSpacerItem * TQSpacerItem::spacerItem() +{ + return this; +} + +/*! + If this item is a TQWidget, it is returned as a TQWidget; otherwise + 0 is returned. This function provides type-safe casting. +*/ +TQWidget * TQLayoutItem::widget() +{ + return 0; +} + +/*! + Returns the widget managed by this item. +*/ +TQWidget * TQWidgetItem::widget() +{ + return wid; +} + +/*! + Returns TRUE if this layout's preferred height depends on its + width; otherwise returns FALSE. The default implementation returns + FALSE. + + Reimplement this function in layout managers that support height + for width. + + \sa heightForWidth(), TQWidget::heightForWidth() +*/ +bool TQLayoutItem::hasHeightForWidth() const +{ + return FALSE; +} + +/*! + Returns an iterator over this item's TQLayoutItem children. The + default implementation returns an empty iterator. + + Reimplement this function in subclasses that can have children. +*/ +TQLayoutIterator TQLayoutItem::iterator() +{ + return TQLayoutIterator( 0 ); +} + +/*! + Returns the preferred height for this layout item, given the width + \a w. + + The default implementation returns -1, indicating that the + preferred height is independent of the width of the item. Using + the function hasHeightForWidth() will typically be much faster + than calling this function and testing for -1. + + Reimplement this function in layout managers that support height + for width. A typical implementation will look like this: + \code + int MyLayout::heightForWidth( int w ) const + { + if ( cache_dirty || cached_width != w ) { + // not all C++ compilers support "mutable" + MyLayout *that = (MyLayout*)this; + int h = calculateHeightForWidth( w ); + that->cached_hfw = h; + return h; + } + return cached_hfw; + } + \endcode + + Caching is strongly recommended; without it layout will take + exponential time. + + \sa hasHeightForWidth() +*/ +int TQLayoutItem::heightForWidth( int /* w */ ) const +{ + return -1; +} + +/*! + Stores the spacer item's rect \a r so that it can be returned by + geometry(). +*/ +void TQSpacerItem::setGeometry( const TQRect &r ) +{ + rect = r; +} + +/*! + Sets the geometry of this item's widget to be contained within + rect \a r, taking alignment and maximum size into account. +*/ +void TQWidgetItem::setGeometry( const TQRect &r ) +{ + TQSize s = r.size().boundedTo( qSmartMaxSize( this ) ); + int x = r.x(); + int y = r.y(); + if ( align & (TQt::AlignHorizontal_Mask | TQt::AlignVertical_Mask) ) { + TQSize pref = wid->sizeHint().expandedTo( wid->minimumSize() ); //### + if ( align & TQt::AlignHorizontal_Mask ) + s.setWidth( TQMIN( s.width(), pref.width() ) ); + if ( align & TQt::AlignVertical_Mask ) { + if ( hasHeightForWidth() ) + s.setHeight( TQMIN( s.height(), heightForWidth(s.width()) ) ); + else + s.setHeight( TQMIN( s.height(), pref.height() ) ); + } + } + int alignHoriz = TQApplication::horizontalAlignment( align ); + if ( alignHoriz & TQt::AlignRight ) + x = x + ( r.width() - s.width() ); + else if ( !(alignHoriz & TQt::AlignLeft) ) + x = x + ( r.width() - s.width() ) / 2; + + if ( align & TQt::AlignBottom ) + y = y + ( r.height() - s.height() ); + else if ( !(align & TQt::AlignTop) ) + y = y + ( r.height() - s.height() ) / 2; + + if ( !isEmpty() ) + wid->setGeometry( x, y, s.width(), s.height() ); +} + +/*! + \reimp +*/ +TQRect TQSpacerItem::geometry() const +{ + return rect; +} + +/*! + \reimp +*/ +TQRect TQWidgetItem::geometry() const +{ + return wid->geometry(); +} + +/*! + \reimp +*/ +TQRect TQLayout::geometry() const +{ + return rect; +} + +/*! + \reimp +*/ +bool TQWidgetItem::hasHeightForWidth() const +{ + if ( isEmpty() ) + return FALSE; + if ( wid->layout() ) + return wid->layout()->hasHeightForWidth(); + return wid->sizePolicy().hasHeightForWidth(); +} + +/*! + \reimp +*/ +int TQWidgetItem::heightForWidth( int w ) const +{ + if ( isEmpty() ) + return -1; + int hfw; + if ( wid->layout() ) + hfw = wid->layout()->totalHeightForWidth( w ); + else + hfw = wid->heightForWidth( w ); + + if ( hfw > wid->maximumHeight() ) + hfw = wid->maximumHeight(); + if ( hfw < wid->minimumHeight() ) + hfw = wid->minimumHeight(); + if ( hfw < 1 ) + hfw = 1; + return hfw; +} + +/*! + Returns the direction in which this spacer item will expand. + + \sa TQSizePolicy::ExpandData +*/ +TQSizePolicy::ExpandData TQSpacerItem::expanding() const +{ + return sizeP.expanding(); +} + +/*! + Returns whether this item's widget can make use of more space than + sizeHint(). A value of \c Vertical or \c Horizontal means that it wants + to grow in only one dimension, whereas \c BothDirections means that + it wants to grow in both dimensions and \c NoDirection means that + it doesn't want to grow at all. +*/ +TQSizePolicy::ExpandData TQWidgetItem::expanding() const +{ + if ( isEmpty() ) + return TQSizePolicy::NoDirection; + + int e = wid->sizePolicy().expanding(); + /* + If the layout is expanding, we make the widget expanding, even if + its own size policy isn't expanding. This behavior should be + reconsidered in TQt 4.0. (###) + */ + if ( wid->layout() ) { + if ( wid->sizePolicy().mayGrowHorizontally() + && (wid->layout()->expanding() & TQSizePolicy::Horizontally) ) + e |= TQSizePolicy::Horizontally; + if ( wid->sizePolicy().mayGrowVertically() + && (wid->layout()->expanding() & TQSizePolicy::Vertically) ) + e |= TQSizePolicy::Vertically; + } + + if ( align & TQt::AlignHorizontal_Mask ) + e &= ~TQSizePolicy::Horizontally; + if ( align & TQt::AlignVertical_Mask) + e &= ~TQSizePolicy::Vertically; + return (TQSizePolicy::ExpandData)e; +} + +/*! + Returns the minimum size of this spacer item. +*/ +TQSize TQSpacerItem::minimumSize() const +{ + return TQSize( sizeP.mayShrinkHorizontally() ? 0 : width, + sizeP.mayShrinkVertically() ? 0 : height ); +} + +/*! + Returns the minimum size of this item. +*/ +TQSize TQWidgetItem::minimumSize() const +{ + if ( isEmpty() ) + return TQSize( 0, 0 ); + return qSmartMinSize( this ); +} + +/*! + Returns the maximum size of this spacer item. +*/ +TQSize TQSpacerItem::maximumSize() const +{ + return TQSize( sizeP.mayGrowHorizontally() ? TQLAYOUTSIZE_MAX : width, + sizeP.mayGrowVertically() ? TQLAYOUTSIZE_MAX : height ); +} + +/*! + Returns the maximum size of this item. +*/ +TQSize TQWidgetItem::maximumSize() const +{ + if ( isEmpty() ) { + return TQSize( 0, 0 ); + } else { + return qSmartMaxSize( this, align ); + } +} + +/*! + Returns the preferred size of this spacer item. +*/ +TQSize TQSpacerItem::sizeHint() const +{ + return TQSize( width, height ); +} + +/*! + Returns the preferred size of this item. +*/ +TQSize TQWidgetItem::sizeHint() const +{ + TQSize s; + if ( isEmpty() ) { + s = TQSize( 0, 0 ); + } else { + s = wid->sizeHint(); + if ( wid->sizePolicy().horData() == TQSizePolicy::Ignored ) + s.setWidth( 1 ); + if ( wid->sizePolicy().verData() == TQSizePolicy::Ignored ) + s.setHeight( 1 ); + s = s.boundedTo( wid->maximumSize() ) + .expandedTo( wid->minimumSize() ).expandedTo( TQSize(1, 1) ); + } + return s; +} + +/*! + Returns TRUE because a spacer item never contains widgets. +*/ +bool TQSpacerItem::isEmpty() const +{ + return TRUE; +} + +/*! + Returns TRUE if the widget has been hidden; otherwise returns + FALSE. +*/ +bool TQWidgetItem::isEmpty() const +{ + return wid->isHidden() || wid->isTopLevel(); +} + +/*! + \class TQLayout + \brief The TQLayout class is the base class of geometry managers. + + \ingroup appearance + \ingroup geomanagement + + This is an abstract base class inherited by the concrete classes, + TQBoxLayout and TQGridLayout. + + For users of TQLayout subclasses or of TQMainWindow there is seldom + any need to use the basic functions provided by TQLayout, such as + \l setResizeMode() or setMenuBar(). See the \link layout.html layout + overview page \endlink for more information. + + To make your own layout manager, subclass TQGLayoutIterator and + implement the functions addItem(), sizeHint(), setGeometry(), and + iterator(). You should also implement minimumSize() to ensure your + layout isn't resized to zero size if there is too little space. To + support children whose heights depend on their widths, implement + hasHeightForWidth() and heightForWidth(). See the \link + customlayout.html custom layout page \endlink for an in-depth + description. + + Geometry management stops when the layout manager is deleted. +*/ + +/*! + Constructs a new top-level TQLayout called \a name, with main + widget \a parent. \a parent may not be 0. + + The \a margin is the number of pixels between the edge of the + widget and the managed children. The \a spacing sets the value of + spacing(), which gives the spacing between the managed widgets. If + \a spacing is -1 (the default), spacing is set to the value of \a + margin. + + There can be only one top-level layout for a widget. It is + returned by TQWidget::layout() +*/ +TQLayout::TQLayout( TQWidget *parent, int margin, int spacing, const char *name ) + : TQObject( parent, name ) +{ + init(); + if ( parent ) { + if ( parent->layout() ) { + qWarning( "TQLayout \"%s\" added to %s \"%s\", which already has a" + " layout", TQObject::name(), parent->className(), + parent->name() ); + parent->removeChild( this ); + } else { + topLevel = TRUE; + parent->installEventFilter( this ); + setWidgetLayout( parent, this ); + } + } + outsideBorder = margin; + if ( spacing < 0 ) + insideSpacing = margin; + else + insideSpacing = spacing; +} + +void TQLayout::init() +{ + insideSpacing = 0; + outsideBorder = 0; + topLevel = FALSE; + enabled = TRUE; + autoNewChild = FALSE; + frozen = FALSE; + activated = FALSE; + marginImpl = FALSE; + autoMinimum = FALSE; + autoResizeMode = TRUE; + extraData = 0; +#ifndef QT_NO_MENUBAR + menubar = 0; +#endif +} + +/*! + Constructs a new child TQLayout called \a name, and places it + inside \a parentLayout by using the default placement defined by + addItem(). + + If \a spacing is -1, this TQLayout inherits \a parentLayout's + spacing(), otherwise the value of \a spacing is used. +*/ +TQLayout::TQLayout( TQLayout *parentLayout, int spacing, const char *name ) + : TQObject( parentLayout, name ) + +{ + init(); + insideSpacing = spacing < 0 ? parentLayout->insideSpacing : spacing; + parentLayout->addItem( this ); +} + +/*! + Constructs a new child TQLayout called \a name. If \a spacing is + -1, this TQLayout inherits its parent's spacing(); otherwise the + value of \a spacing is used. + + This layout has to be inserted into another layout before geometry + management will work. +*/ +TQLayout::TQLayout( int spacing, const char *name ) + : TQObject( 0, name ) +{ + init(); + insideSpacing = spacing; +} + +/*! + \fn void TQLayout::addItem( TQLayoutItem *item ) + + Implemented in subclasses to add an \a item. How it is added is + specific to each subclass. + + The ownership of \a item is transferred to the layout, and it's + the layout's responsibility to delete it. +*/ + +/*! + \fn TQLayoutIterator TQLayout::iterator() + + Implemented in subclasses to return an iterator that iterates over + this layout's children. + + A typical implementation will be: + \code + TQLayoutIterator MyLayout::iterator() + { + TQGLayoutIterator *i = new MyLayoutIterator( internal_data ); + return TQLayoutIterator( i ); + } + \endcode + where MyLayoutIterator is a subclass of TQGLayoutIterator. +*/ + +/*! + \fn void TQLayout::add( TQWidget *w ) + + Adds widget \a w to this layout in a manner specific to the + layout. This function uses addItem(). +*/ + +/*! + \fn TQMenuBar* TQLayout::menuBar () const + + Returns the menu bar set for this layout, or 0 if no menu bar is + set. +*/ + +/*! + \fn bool TQLayout::isTopLevel () const + + Returns TRUE if this layout is a top-level layout, i.e. not a + child of another layout; otherwise returns FALSE. +*/ + +/*! + \property TQLayout::margin + \brief the width of the outside border of the layout + + For some layout classes this property has an effect only on + top-level layouts; TQBoxLayout and TQGridLayout support margins for + child layouts. The default value is 0. + + \sa spacing +*/ + +/*! + \property TQLayout::spacing + \brief the spacing between widgets inside the layout + + The default value is -1, which signifies that the layout's spacing + should not override the widget's spacing. + + \sa margin +*/ +void TQLayout::setMargin( int margin ) +{ + outsideBorder = margin; + invalidate(); + if ( mainWidget() ) { + TQEvent *lh = new TQEvent( TQEvent::LayoutHint ); + TQApplication::postEvent( mainWidget(), lh ); + } +} + +void TQLayout::setSpacing( int spacing ) +{ + insideSpacing = spacing; + if ( spacing >= 0 ) + propagateSpacing( this ); + invalidate(); + if ( mainWidget() ) { + TQEvent *lh = new TQEvent( TQEvent::LayoutHint ); + TQApplication::postEvent( mainWidget(), lh ); + } +} + +/*! + Returns the main widget (parent widget) of this layout, or 0 if + this layout is a sub-layout that is not yet inserted. +*/ +TQWidget *TQLayout::mainWidget() +{ + if ( !topLevel ) { + if ( parent() ) { + TQLayout *parentLayout = ::qt_cast<TQLayout*>(parent()); + Q_ASSERT(parentLayout); + return parentLayout->mainWidget(); + } else { + return 0; + } + } else { + Q_ASSERT(parent() && parent()->isWidgetType()); + return (TQWidget*)parent(); + } +} + +/*! + Returns TRUE if this layout is empty. The default implementation + returns FALSE. +*/ +bool TQLayout::isEmpty() const +{ + return FALSE; //### should check +} + +/*! + Sets widget \a w's layout to layout \a l. +*/ +void TQLayout::setWidgetLayout( TQWidget *w, TQLayout *l ) +{ + w->setLayout( l ); +} + +/*! + This function is reimplemented in subclasses to perform layout. + + The default implementation maintains the geometry() information + given by rect \a r. Reimplementors must call this function. +*/ +void TQLayout::setGeometry( const TQRect &r ) +{ + rect = r; +} + +/*! + Invalidates cached information. Reimplementations must call this. +*/ +void TQLayout::invalidate() +{ + rect = TQRect(); +} + +static bool removeWidgetRecursively( TQLayoutItem *lay, TQWidget *w ) +{ + bool didSomething = FALSE; + TQLayoutIterator it = lay->iterator(); + TQLayoutItem *child; + while ( (child = it.current()) != 0 ) { + if ( child->widget() == w ) { + it.deleteCurrent(); + lay->invalidate(); // maybe redundant + didSomething = TRUE; + } else if ( removeWidgetRecursively(child, w) ) { + lay->invalidate(); // maybe redundant + didSomething = TRUE; + } else { + ++it; + } + } + return didSomething; +} + +/*! + \reimp + Performs child widget layout when the parent widget is resized. + Also handles removal of widgets and child layouts. \a e is the + event the occurred on object \a o. +*/ +bool TQLayout::eventFilter( TQObject *o, TQEvent *e ) +{ + if ( !enabled ) + return FALSE; + + if ( !o->isWidgetType() ) + return FALSE; + + switch ( e->type() ) { + case TQEvent::Resize: + if ( activated ) { + TQResizeEvent *r = (TQResizeEvent *)e; + int mbh = 0; +#ifndef QT_NO_MENUBAR + mbh = menuBarHeightForWidth( menubar, r->size().width() ); +#endif + int b = marginImpl ? 0 : outsideBorder; + setGeometry( TQRect( b, mbh + b, r->size().width() - 2 * b, + r->size().height() - mbh - 2 * b ) ); + } else { + activate(); + } + break; + case TQEvent::ChildRemoved: + { + TQChildEvent *c = (TQChildEvent *)e; + if ( c->child()->isWidgetType() ) { + TQWidget *w = (TQWidget *)c->child(); +#ifndef QT_NO_MENUBAR + if ( w == menubar ) + menubar = 0; +#endif + if ( removeWidgetRecursively( this, w ) ) { + TQEvent *lh = new TQEvent( TQEvent::LayoutHint ); + TQApplication::postEvent( o, lh ); + } + } + } + break; + case TQEvent::ChildInserted: + if ( topLevel && autoNewChild ) { + TQChildEvent *c = (TQChildEvent *)e; + if ( c->child()->isWidgetType() ) { + TQWidget *w = (TQWidget *)c->child(); + if ( !w->isTopLevel() ) { +#if !defined(QT_NO_MENUBAR) && !defined(QT_NO_TOOLBAR) + if ( ::qt_cast<TQMenuBar*>(w) && !::qt_cast<TQToolBar*>(w->parentWidget()) ) + menubar = (TQMenuBar *)w; + else +#endif + addItem( new TQWidgetItem( w ) ); + TQEvent *lh = new TQEvent( TQEvent::LayoutHint ); + TQApplication::postEvent( o, lh ); + } + } + } + break; + case TQEvent::LayoutHint: + activate(); + break; + default: + break; + } + return TQObject::eventFilter( o, e ); +} + +/*! + \reimp +*/ +void TQLayout::childEvent( TQChildEvent *e ) +{ + if ( !enabled ) + return; + + if ( e->type() == TQEvent::ChildRemoved ) { + TQChildEvent *c = (TQChildEvent*)e; + TQLayoutIterator it = iterator(); + TQLayoutItem *item; + while ( (item = it.current() ) ) { + if ( item == (TQLayout*)c->child() ) { + it.takeCurrent(); + invalidate(); + break; + } else { + ++it; + } + } + } +} + +/*! + \internal + Also takes margin() and menu bar into account. +*/ +int TQLayout::totalHeightForWidth( int w ) const +{ + if ( topLevel ) { + TQWidget *mw = (TQWidget*)parent(); + if ( mw && !mw->testWState(WState_Polished) ) { + mw->polish(); + } + } + int b = ( topLevel && !marginImpl ) ? 2 * outsideBorder : 0; + int h = heightForWidth( w - b ) + b; +#ifndef QT_NO_MENUBAR + h += menuBarHeightForWidth( menubar, w ); +#endif + return h; +} + +/*! + \internal + Also takes margin() and menu bar into account. +*/ +TQSize TQLayout::totalMinimumSize() const +{ + if ( topLevel ) { + TQWidget *mw = (TQWidget*)parent(); + if ( mw && !mw->testWState(WState_Polished) ) + mw->polish(); + } + int b = ( topLevel && !marginImpl ) ? 2 * outsideBorder : 0; + + TQSize s = minimumSize(); + int h = b; +#ifndef QT_NO_MENUBAR + h += menuBarHeightForWidth( menubar, s.width() ); +#endif + return s + TQSize( b, h ); +} + +/*! + \internal + Also takes margin() and menu bar into account. +*/ +TQSize TQLayout::totalSizeHint() const +{ + if ( topLevel ) { + TQWidget *mw = (TQWidget*)parent(); + if ( mw && !mw->testWState(WState_Polished) ) + mw->polish(); + } + int b = ( topLevel && !marginImpl ) ? 2 * outsideBorder : 0; + + TQSize s = sizeHint(); + if ( hasHeightForWidth() ) + s.setHeight( heightForWidth(s.width()) ); + int h = b; +#ifndef QT_NO_MENUBAR + h += menuBarHeightForWidth( menubar, s.width() ); +#endif + return s + TQSize( b, h ); +} + +/*! + \internal + Also takes margin() and menu bar into account. +*/ +TQSize TQLayout::totalMaximumSize() const +{ + if ( topLevel ) { + TQWidget *mw = (TQWidget*)parent(); + if ( mw && !mw->testWState(WState_Polished) ) { + mw->polish(); + } + } + int b = ( topLevel && !marginImpl ) ? 2 * outsideBorder : 0; + + TQSize s = maximumSize(); + int h = b; +#ifndef QT_NO_MENUBAR + h += menuBarHeightForWidth( menubar, s.width() ); +#endif + + if ( isTopLevel() ) + s = TQSize( TQMIN( s.width() + b, TQLAYOUTSIZE_MAX ), + TQMIN( s.height() + h, TQLAYOUTSIZE_MAX ) ); + return s; +} + +/*! + \internal + Destroys the layout, deleting all child layouts. + Geometry management stops when a top-level layout is deleted. + + The layout classes will probably be fatally confused if you delete + a sublayout. +*/ +TQLayout::~TQLayout() +{ + /* + This function may be called during the TQObject destructor, + when the parent no longer is a TQWidget. + */ + if ( isTopLevel() && parent() && parent()->isWidgetType() && + ((TQWidget*)parent())->layout() == this ) + setWidgetLayout( (TQWidget*)parent(), 0 ); +} + +/*! + Removes and deletes all items in this layout. +*/ +void TQLayout::deleteAllItems() +{ + TQLayoutIterator it = iterator(); + TQLayoutItem *l; + while ( (l = it.takeCurrent()) ) + delete l; +} + +/*! + This function is called from addLayout() functions in subclasses + to add layout \a l as a sub-layout. +*/ +void TQLayout::addChildLayout( TQLayout *l ) +{ + if ( l->parent() ) { +#if defined(QT_CHECK_NULL) + qWarning( "TQLayout::addChildLayout: layout already has a parent" ); +#endif + return; + } + insertChild( l ); + if ( l->insideSpacing < 0 ) { + l->insideSpacing = insideSpacing; + propagateSpacing( l ); + } +} + +/*! \fn int TQLayout::defaultBorder() const + + \internal +*/ + +/*! \fn void TQLayout::freeze() + + \internal +*/ + +/*! + \internal + Fixes the size of the main widget and distributes the available + space to the child widgets. For widgets which should not be + resizable, but where a TQLayout subclass is used to set up the initial + geometry. + + As a special case, freeze(0, 0) is equivalent to setResizeMode(Fixed). +*/ +void TQLayout::freeze( int w, int h ) +{ + if ( w <= 0 || h <= 0 ) { + setResizeMode( Fixed ); + } else { + setResizeMode( FreeResize ); // layout will not change min/max size + mainWidget()->setFixedSize( w, h ); + } +} + +#ifndef QT_NO_MENUBAR + +/*! + Makes the geometry manager take account of the menu bar \a w. All + child widgets are placed below the bottom edge of the menu bar. + + A menu bar does its own geometry management: never do addWidget() + on a TQMenuBar. +*/ +void TQLayout::setMenuBar( TQMenuBar *w ) +{ + menubar = w; +} + +#endif + +/*! + Returns the minimum size of this layout. This is the smallest size + that the layout can have while still respecting the + specifications. Does not include what's needed by margin() or + menuBar(). + + The default implementation allows unlimited resizing. +*/ +TQSize TQLayout::minimumSize() const +{ + return TQSize( 0, 0 ); +} + +/*! + Returns the maximum size of this layout. This is the largest size + that the layout can have while still respecting the + specifications. Does not include what's needed by margin() or + menuBar(). + + The default implementation allows unlimited resizing. +*/ +TQSize TQLayout::maximumSize() const +{ + return TQSize( TQLAYOUTSIZE_MAX, TQLAYOUTSIZE_MAX ); +} + +/*! + Returns whether this layout can make use of more space than + sizeHint(). A value of \c Vertical or \c Horizontal means that it wants + to grow in only one dimension, whereas \c BothDirections means that + it wants to grow in both dimensions. + + The default implementation returns \c BothDirections. +*/ +TQSizePolicy::ExpandData TQLayout::expanding() const +{ + return TQSizePolicy::BothDirections; +} + +static void invalidateRecursive( TQLayoutItem *lay ) +{ + lay->invalidate(); + TQLayoutIterator it = lay->iterator(); + TQLayoutItem *child; + while ( (child = it.current()) != 0 ) { + invalidateRecursive( child ); + ++it; + } +} + +/*! + Redoes the layout for mainWidget(). You should generally not need + to call this because it is automatically called at the most + appropriate times. + + However, if you set up a TQLayout for a visible widget without + resizing that widget, you will need to call this function in order + to lay it out. + + \sa TQWidget::updateGeometry() +*/ +bool TQLayout::activate() +{ + invalidateRecursive( this ); + if ( !topLevel ) + return FALSE; + + TQWidget *mw = mainWidget(); + if (!mw) { +#if defined( QT_CHECK_NULL ) + qWarning( "TQLayout::activate: %s \"%s\" does not have a main widget", + TQObject::className(), TQObject::name() ); +#endif + return FALSE; + } + activated = TRUE; + TQSize s = mw->size(); + TQSize ms; + int mbh = 0; +#ifndef QT_NO_MENUBAR + mbh = menuBarHeightForWidth( menubar, s.width() ); +#endif + int b = marginImpl ? 0 : outsideBorder; + setGeometry(TQRect(b, mbh + b, s.width() - 2 * b, s.height() - mbh - 2 * b)); + if ( frozen ) { + // will trigger resize + mw->setFixedSize( totalSizeHint() ); + } else if ( autoMinimum ) { + ms = totalMinimumSize(); + } else if ( autoResizeMode && topLevel && mw->isTopLevel() ) { + ms = totalMinimumSize(); + if ( hasHeightForWidth() ) { + int h; + int mmbh = menuBarHeightForWidth( menubar, ms.width() ); + // ### 4.0: remove this 'if' when minimumHeightForWidth() is virtual + if ( inherits("TQBoxLayout") ) { + h = ((TQBoxLayout *) this)->minimumHeightForWidth( ms.width() ); + } else if ( inherits("TQGridLayout") ) { + h = ((TQGridLayout *) this)->minimumHeightForWidth( ms.width() ); + } else { + h = heightForWidth( ms.width() ); + } + if ( h + mmbh > ms.height() ) +#if 1 + //old behaviour: + ms = TQSize( 0, 0 ); +#else + //better, but too big a change for a patch release in a stable branch: + ms.setHeight( 0 ); +#endif + } + } + + if (ms.isValid()) + mw->setMinimumSize( ms ); + + // ideally only if sizeHint() or sizePolicy() has changed + mw->updateGeometry(); + return TRUE; +} + +/*! + \class TQSizePolicy + \brief The TQSizePolicy class is a layout attribute describing horizontal + and vertical resizing policy. + + \ingroup appearance + \ingroup geomanagement + + The size policy of a widget is an expression of its willingness to + be resized in various ways. + + Widgets that reimplement TQWidget::sizePolicy() return a TQSizePolicy + that describes the horizontal and vertical resizing policy they + prefer when being laid out. Only \link #interesting one of the + constructors\endlink is of interest in most applications. + + TQSizePolicy contains two independent SizeType objects; one describes + the widgets's horizontal size policy, and the other describes its + vertical size policy. It also contains a flag to indicate whether the + height and width of its preferred size are related. + + The horizontal and vertical \l{SizeType}s are set in the usual constructor + and can be queried using a variety of functions. + + The hasHeightForWidth() flag indicates whether the widget's sizeHint() + is width-dependent (such as a word-wrapping label) or not. + + \sa TQSizePolicy::SizeType +*/ + +/*! + \enum TQSizePolicy::SizeType + + The per-dimension sizing types used when constructing a + TQSizePolicy are: + + \value Fixed The TQWidget::sizeHint() is the only acceptable + alternative, so the widget can never grow or shrink (e.g. the + vertical direction of a push button). + + \value Minimum The sizeHint() is minimal, and sufficient. The + widget can be expanded, but there is no advantage to it being + larger (e.g. the horizontal direction of a push button). + It cannot be smaller than the size provided by sizeHint(). + + \value Maximum The sizeHint() is a maximum. The widget can be + shrunk any amount without detriment if other widgets need the + space (e.g. a separator line). + It cannot be larger than the size provided by sizeHint(). + + \value Preferred The sizeHint() is best, but the widget can be + shrunk and still be useful. The widget can be expanded, but there + is no advantage to it being larger than sizeHint() (the default + TQWidget policy). + + \value Expanding The sizeHint() is a sensible size, but the + widget can be shrunk and still be useful. The widget can make use + of extra space, so it should get as much space as possible (e.g. + the horizontal direction of a slider). + + \value MinimumExpanding The sizeHint() is minimal, and sufficient. + The widget can make use of extra space, so it should get as much + space as possible (e.g. the horizontal direction of a slider). + + \value Ignored the sizeHint() is ignored. The widget will get as + much space as possible. +*/ + +/*! + \enum TQSizePolicy::ExpandData + + This enum type describes in which directions a widget can make use + of extra space. There are four possible values: + + \value NoDirection the widget cannot make use of extra space in + any direction. + + \value Horizontally the widget can usefully be wider than the + sizeHint(). + + \value Vertically the widget can usefully be taller than the + sizeHint(). + + \value BothDirections the widget can usefully be both wider and + taller than the sizeHint(). +*/ + +/*! + \fn TQSizePolicy::TQSizePolicy() + + Constructs a minimally initialized TQSizePolicy. +*/ + +/*! + \fn TQSizePolicy::TQSizePolicy( SizeType hor, SizeType ver, bool hfw ) + + \target interesting + This is the constructor normally used to return a value in the + overridden \l TQWidget::sizePolicy() function of a TQWidget + subclass. + + It constructs a TQSizePolicy with independent horizontal and + vertical sizing types, \a hor and \a ver respectively. These \link + TQSizePolicy::SizeType sizing types\endlink affect how the widget + is treated by the \link TQLayout layout engine\endlink. + + If \a hfw is TRUE, the preferred height of the widget is dependent + on the width of the widget (for example, a TQLabel with line + wrapping). + + \sa horData() verData() hasHeightForWidth() +*/ + +/*! + \fn TQSizePolicy::TQSizePolicy( SizeType hor, SizeType ver, uchar horStretch, uchar verStretch, bool hfw ) + + Constructs a TQSizePolicy with independent horizontal and vertical + sizing types \a hor and \a ver, and stretch factors \a horStretch + and \a verStretch. + + If \a hfw is TRUE, the preferred height of the widget is dependent on the + width of the widget. + + \sa horStretch() verStretch() +*/ + +/*! + \fn TQSizePolicy::SizeType TQSizePolicy::horData() const + + Returns the horizontal component of the size policy. + + \sa setHorData() verData() horStretch() +*/ + +/*! + \fn TQSizePolicy::SizeType TQSizePolicy::verData() const + + Returns the vertical component of the size policy. + + \sa setVerData() horData() verStretch() +*/ + +/*! + \fn bool TQSizePolicy::mayShrinkHorizontally() const + + Returns TRUE if the widget can sensibly be narrower than its + sizeHint(); otherwise returns FALSE. + + \sa mayShrinkVertically() mayGrowHorizontally() +*/ + +/*! + \fn bool TQSizePolicy::mayShrinkVertically() const + + Returns TRUE if the widget can sensibly be shorter than its + sizeHint(); otherwise returns FALSE. + + \sa mayShrinkHorizontally() mayGrowVertically() +*/ + +/*! + \fn bool TQSizePolicy::mayGrowHorizontally() const + + Returns TRUE if the widget can sensibly be wider than its + sizeHint(); otherwise returns FALSE. + + \sa mayGrowVertically() mayShrinkHorizontally() +*/ + +/*! + \fn bool TQSizePolicy::mayGrowVertically() const + + Returns TRUE if the widget can sensibly be taller than its + sizeHint(); otherwise returns FALSE. + + \sa mayGrowHorizontally() mayShrinkVertically() +*/ + +/*! + \fn TQSizePolicy::ExpandData TQSizePolicy::expanding() const + + Returns whether this layout can make use of more space than + sizeHint(). A value of \c Vertical or \c Horizontal means that it wants + to grow in only one dimension, whereas \c BothDirections means that + it wants to grow in both dimensions. + + \sa mayShrinkHorizontally() mayGrowHorizontally() + mayShrinkVertically() mayGrowVertically() +*/ + +/*! + \fn void TQSizePolicy::setHorData( SizeType d ) + + Sets the horizontal component of the size policy to size type \a + d. + + \sa horData() setVerData() +*/ + +/*! + \fn void TQSizePolicy::setVerData( SizeType d ) + + Sets the vertical component of the size policy to size type \a d. + + \sa verData() setHorData() +*/ + +/*! + \fn bool TQSizePolicy::hasHeightForWidth() const + + Returns TRUE if the widget's preferred height depends on its + width; otherwise returns FALSE. + + \sa setHeightForWidth() +*/ + +/*! + \fn void TQSizePolicy::setHeightForWidth( bool b ) + + Sets the hasHeightForWidth() flag to \a b. + + \sa hasHeightForWidth() +*/ + +/*! + \fn uint TQSizePolicy::horStretch() const + + Returns the horizontal stretch factor of the size policy. + + \sa setHorStretch() verStretch() +*/ + +/*! + \fn uint TQSizePolicy::verStretch() const + + Returns the vertical stretch factor of the size policy. + + \sa setVerStretch() horStretch() +*/ + +/*! + \fn void TQSizePolicy::setHorStretch( uchar sf ) + + Sets the horizontal stretch factor of the size policy to \a sf. + + \sa horStretch() setVerStretch() +*/ + +/*! + \fn void TQSizePolicy::setVerStretch( uchar sf ) + + Sets the vertical stretch factor of the size policy to \a sf. + + \sa verStretch() setHorStretch() +*/ + +/*! + \fn void TQSizePolicy::transpose() + + Swaps the horizontal and vertical policies and stretches. +*/ + + +/*! + \fn bool TQSizePolicy::operator==( const TQSizePolicy &s ) const + + Returns TRUE if this policy is equal to \a s; otherwise returns + FALSE. + + \sa operator!=() +*/ + +/*! + \fn bool TQSizePolicy::operator!=( const TQSizePolicy &s ) const + + Returns TRUE if this policy is different from \a s; otherwise + returns FALSE. + + \sa operator==() +*/ + +/*! + \class TQGLayoutIterator + \brief The TQGLayoutIterator class is an abstract base class of internal layout iterators. + + \ingroup appearance + \ingroup geomanagement + + (This class is \e not OpenGL related, it just happens to start with + the letters TQGL...) + + Subclass this class to create a custom layout. The functions that + must be implemented are next(), current(), and takeCurrent(). + + The TQGLayoutIterator implements the functionality of + TQLayoutIterator. Each subclass of TQLayout needs a + TQGLayoutIterator subclass. +*/ + +/*! + \fn TQLayoutItem *TQGLayoutIterator::next() + + Implemented in subclasses to move the iterator to the next item + and return that item, or 0 if there is no next item. +*/ + +/*! + \fn TQLayoutItem *TQGLayoutIterator::current() + + Implemented in subclasses to return the current item, or 0 if + there is no current item. +*/ + +/*! + \fn TQLayoutItem *TQGLayoutIterator::takeCurrent() + + Implemented in subclasses. The function must remove the current + item from the layout without deleting it, move the iterator to the + next item and return the removed item, or 0 if no item was + removed. +*/ + +/*! + Destroys the iterator +*/ +TQGLayoutIterator::~TQGLayoutIterator() +{ +} + +/*! + \class TQLayoutIterator + \brief The TQLayoutIterator class provides iterators over TQLayoutItem. + + \ingroup appearance + \ingroup geomanagement + + Use TQLayoutItem::iterator() to create an iterator over a layout. + + TQLayoutIterator uses \e explicit sharing with a reference count. + If an iterator is copied and one of the copies is modified, both + iterators will be modified. + + A TQLayoutIterator is not protected against changes in its layout. If + the layout is modified or deleted the iterator will become invalid. + It is not possible to test for validity. It is safe to delete an + invalid layout; any other access may lead to an illegal memory + reference and the abnormal termination of the program. + + Calling takeCurrent() or deleteCurrent() leaves the iterator in a + valid state, but may invalidate any other iterators that access the + same layout. + + The following code will draw a rectangle for each layout item in + the layout structure of the widget. + \code + static void paintLayout( TQPainter *p, TQLayoutItem *lay ) + { + TQLayoutIterator it = lay->iterator(); + TQLayoutItem *child; + while ( (child = it.current()) != 0 ) { + paintLayout( p, child ); + ++it; + } + p->drawRect( lay->geometry() ); + } + void ExampleWidget::paintEvent( TQPaintEvent * ) + { + TQPainter p( this ); + if ( layout() ) + paintLayout( &p, layout() ); + } + \endcode + + All the functionality of TQLayoutIterator is implemented by + subclasses of \l TQGLayoutIterator. TQLayoutIterator itself is not + designed to be subclassed. +*/ + +/*! + \fn TQLayoutIterator::TQLayoutIterator( TQGLayoutIterator *gi ) + + Constructs an iterator based on \a gi. The constructed iterator + takes ownership of \a gi and will delete it. + + This constructor is provided for layout implementors. Application + programmers should use TQLayoutItem::iterator() to create an + iterator over a layout. +*/ + +/*! + \fn TQLayoutIterator::TQLayoutIterator( const TQLayoutIterator &i ) + + Creates a shallow copy of \a i, i.e. if the copy is modified, then + the original will also be modified. +*/ + +/*! + \fn TQLayoutIterator::~TQLayoutIterator() + + Destroys the iterator. +*/ + +/*! + \fn TQLayoutIterator &TQLayoutIterator::operator=( const TQLayoutIterator &i ) + + Assigns \a i to this iterator and returns a reference to this + iterator. +*/ + +/*! + \fn TQLayoutItem *TQLayoutIterator::operator++() + + Moves the iterator to the next child item and returns that item, + or 0 if there is no such item. +*/ + +/*! + \fn TQLayoutItem *TQLayoutIterator::current() + + Returns the current item, or 0 if there is no current item. +*/ + +/*! + \fn TQLayoutItem *TQLayoutIterator::takeCurrent() + + Removes the current child item from the layout without deleting + it, and moves the iterator to the next item. Returns the removed + item, or 0 if there was no item to be removed. This iterator will + still be valid, but any other iterator over the same layout may + become invalid. +*/ + +/*! + \fn void TQLayoutIterator::deleteCurrent() + + Removes and deletes the current child item from the layout and + moves the iterator to the next item. This iterator will still be + valid, but any other iterator over the same layout may become + invalid. +*/ + +/*! + \enum TQLayout::ResizeMode + + The possible values are: + + \value Auto If the main widget is a top-level widget with no + height-for-width (hasHeightForWidth()), this is + the same as \c Minimium; otherwise, this is the + same as \c FreeResize. + \value Fixed The main widget's size is set to sizeHint(); it + cannot be resized at all. + \value Minimum The main widget's minimum size is set to + minimumSize(); it cannot be smaller. + \value FreeResize The widget is not constrained. +*/ + +/*! + \property TQLayout::resizeMode + \brief the resize mode of the layout + + The default mode is \c Auto. + + \sa TQLayout::ResizeMode +*/ + +void TQLayout::setResizeMode( ResizeMode mode ) +{ + if ( mode == resizeMode() ) + return; + + switch ( mode ) { + case Auto: + frozen = FALSE; + autoMinimum = FALSE; + autoResizeMode = TRUE; + break; + case Fixed: + frozen = TRUE; + autoMinimum = FALSE; + autoResizeMode = FALSE; + break; + case FreeResize: + frozen = FALSE; + autoMinimum = FALSE; + autoResizeMode = FALSE; + break; + case Minimum: + frozen = FALSE; + autoMinimum = TRUE; + autoResizeMode = FALSE; + } + if ( mainWidget() && mainWidget()->isVisible() ) + activate(); +} + +TQLayout::ResizeMode TQLayout::resizeMode() const +{ + return ( autoResizeMode ? Auto : + (frozen ? Fixed : (autoMinimum ? Minimum : FreeResize)) ); +} + +/*! + \fn bool TQLayout::autoAdd() const + + Returns TRUE if this layout automatically grabs all new + mainWidget()'s new children and adds them as defined by addItem(); + otherwise returns FALSE. This has effect only for top-level + layouts, i.e. layouts that are direct children of their + mainWidget(). + + autoAdd() is disabled by default. + + Note that a top-level layout is not necessarily associated with + the top-level widget. + + \sa setAutoAdd() +*/ + +/*! + If \a b is TRUE, auto-add is enabled; otherwise auto-add is + disabled. + + \warning If auto-add is enabled, you cannot set stretch factors + on the child widgets until the widgets are actually inserted in + the layout (after control returned to the event loop). We + therefore recommend that you avoid the auto-add feature in new + programs. + + \sa autoAdd() +*/ +void TQLayout::setAutoAdd( bool b ) +{ + autoNewChild = b; +} + +/*! + \fn bool TQLayout::supportsMargin() const + + Returns TRUE if this layout supports \l TQLayout::margin on + non-top-level layouts; otherwise returns FALSE. + + \sa margin +*/ + +/*! + Sets the value returned by supportsMargin(). If \a b is TRUE, + margin() handling is implemented by the subclass. If \a b is + FALSE (the default), TQLayout will add margin() around top-level + layouts. + + If \a b is TRUE, margin handling needs to be implemented in + setGeometry(), maximumSize(), minimumSize(), sizeHint() and + heightForWidth(). + + \sa supportsMargin() +*/ +void TQLayout::setSupportsMargin( bool b ) +{ + marginImpl = b; +} + +/*! + Returns the rectangle that should be covered when the geometry of + this layout is set to \a r, provided that this layout supports + setAlignment(). + + The result is derived from sizeHint() and expanding(). It is never + larger than \a r. +*/ +TQRect TQLayout::alignmentRect( const TQRect &r ) const +{ + TQSize s = sizeHint(); + int a = alignment(); + + /* + This is a hack to obtain the real maximum size, not + TQSize(TQLAYOUTSIZE_MAX, TQLAYOUTSIZE_MAX), the value consistently + returned by TQLayoutItems that have an alignment. + */ + TQLayout *that = (TQLayout *) this; + that->setAlignment( 0 ); + TQSize ms = maximumSize(); + that->setAlignment( a ); + + if ( (expanding() & TQSizePolicy::Horizontally) || + !(a & TQt::AlignHorizontal_Mask ) ) { + s.setWidth( TQMIN(r.width(), ms.width()) ); + } + if ( (expanding() & TQSizePolicy::Vertically) || + !(a & TQt::AlignVertical_Mask) ) { + s.setHeight( TQMIN(r.height(), ms.height()) ); + } else if ( hasHeightForWidth() ) { + int hfw = heightForWidth( s.width() ); + if ( hfw < s.height() ) + s.setHeight( TQMIN(hfw, ms.height()) ); + } + + int x = r.x(); + int y = r.y(); + + if ( a & TQt::AlignBottom ) + y += ( r.height() - s.height() ); + else if ( !(a & TQt::AlignTop) ) + y += ( r.height() - s.height() ) / 2; + + a = TQApplication::horizontalAlignment( a ); + if ( a & TQt::AlignRight ) + x += ( r.width() - s.width() ); + else if ( !(a & TQt::AlignLeft) ) + x += ( r.width() - s.width() ) / 2; + + return TQRect( x, y, s.width(), s.height() ); +} + +/*! + Removes the widget \a widget from the layout. After this call, it + is the caller's responsibility to give the widget a reasonable + geometry or to put the widget back into a layout. + + \sa removeItem(), TQWidget::setGeometry(), add() +*/ +void TQLayout::remove( TQWidget *widget ) +{ + TQLayoutIterator it = iterator(); + TQLayoutItem *child; + while ( (child = it.current()) != 0 ) { + if ( child->widget() == widget ) { + it.deleteCurrent(); + invalidate(); // maybe redundant + TQApplication::postEvent( mainWidget(), + new TQEvent(TQEvent::LayoutHint) ); + } else { + ++it; + } + } +} + +/*! + Removes the layout item \a item from the layout. It is the + caller's responsibility to delete the item. + + Notice that \a item can be a layout (since TQLayout inherits + TQLayoutItem). + + \sa remove(), addItem() +*/ +void TQLayout::removeItem( TQLayoutItem *item ) +{ + TQLayoutIterator it = iterator(); + TQLayoutItem *child; + while ( (child = it.current()) != 0 ) { + if ( child == item ) { + it.takeCurrent(); + invalidate(); // maybe redundant + TQApplication::postEvent( mainWidget(), + new TQEvent(TQEvent::LayoutHint) ); + } else { + ++it; + } + } +} + +/*! + Enables this layout if \a enable is TRUE, otherwise disables it. + + An enabled layout adjusts dynamically to changes; a disabled + layout acts as if it did not exist. + + By default all layouts are enabled. + + \sa isEnabled() +*/ +void TQLayout::setEnabled( bool enable ) +{ + enabled = enable; +} + +/*! + Returns TRUE if the layout is enabled; otherwise returns FALSE. + + \sa setEnabled() +*/ +bool TQLayout::isEnabled() const +{ + return enabled; +} + +void TQLayout::propagateSpacing( TQLayout *parent ) +{ + TQLayoutIterator it = parent->iterator(); + TQLayoutItem *child; + while ( (child = it.current()) ) { + TQLayout *childLayout = child->layout(); + if ( childLayout && childLayout->insideSpacing < 0 ) { + childLayout->insideSpacing = parent->insideSpacing; + propagateSpacing( childLayout ); + } + ++it; + } +} + +#endif // QT_NO_LAYOUT |