/**************************************************************************** ** ** Implementation of QSplitter class ** ** Created : 980105 ** ** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved. ** ** This file is part of the widgets 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. ** **********************************************************************/ #include "qsplitter.h" #ifndef QT_NO_SPLITTER #include "qlayout.h" #include "../kernel/qlayoutengine_p.h" #include "qapplication.h" #include "qbitmap.h" #include "qdrawutil.h" #include "qmemarray.h" #include "qobjectlist.h" #include "qpainter.h" #include "qptrlist.h" #include "qstyle.h" const uint Default = QT_QSPLITTER_DEFAULT; static int mouseOffset; static int opaqueOldPos = -1; // this assumes that there's only one mouse static QPoint toggle( QWidget *w, QPoint pos ) { QSize minS = qSmartMinSize( w ); return -pos - QPoint( minS.width(), minS.height() ); } static bool isCollapsed( QWidget *w ) { return w->x() < 0 || w->y() < 0; } static QPoint topLeft( QWidget *w ) { if ( isCollapsed(w) ) { return toggle( w, w->pos() ); } else { return w->pos(); } } static QPoint bottomRight( QWidget *w ) { if ( isCollapsed(w) ) { return toggle( w, w->pos() ) - QPoint( 1, 1 ); } else { return w->geometry().bottomRight(); } } QSplitterHandle::QSplitterHandle( Orientation o, QSplitter *parent, const char * name ) : QWidget( parent, name ) { s = parent; setOrientation( o ); } QSize QSplitterHandle::sizeHint() const { int hw = s->handleWidth(); return parentWidget()->style().sizeFromContents( QStyle::CT_Splitter, s, QSize(hw, hw) ) .expandedTo( QApplication::globalStrut() ); } void QSplitterHandle::setOrientation( Orientation o ) { orient = o; #ifndef QT_NO_CURSOR setCursor( o == QSplitter::Horizontal ? splitHCursor : splitVCursor ); #endif } void QSplitterHandle::mouseMoveEvent( QMouseEvent *e ) { if ( !(e->state()&LeftButton) ) return; QCOORD pos = s->pick( parentWidget()->mapFromGlobal(e->globalPos()) ) - mouseOffset; if ( opaque() ) { s->moveSplitter( pos, id() ); } else { s->setRubberband( s->adjustPos(pos, id()) ); } } void QSplitterHandle::mousePressEvent( QMouseEvent *e ) { if ( e->button() == LeftButton ) mouseOffset = s->pick( e->pos() ); } void QSplitterHandle::mouseReleaseEvent( QMouseEvent *e ) { if ( !opaque() && e->button() == LeftButton ) { QCOORD pos = s->pick( parentWidget()->mapFromGlobal(e->globalPos()) ) - mouseOffset; s->setRubberband( -1 ); s->moveSplitter( pos, id() ); } } void QSplitterHandle::paintEvent( QPaintEvent * ) { QStyle::SFlags flags = (orientation() == Horizontal ? QStyle::Style_Horizontal : 0); if (hasMouse()) { flags |= QStyle::Style_MouseOver; } QPainter p( this ); parentWidget()->style().drawPrimitive( QStyle::PE_Splitter, &p, rect(), colorGroup(), flags ); } QCOORD QSplitterLayoutStruct::getSizer( Orientation orient ) { if ( sizer == -1 ) { QSize s = wid->sizeHint(); if ( !s.isValid() || wid->testWState(WState_Resized) ) s = wid->size(); sizer = ( orient == Horizontal ) ? s.width() : s.height(); } return sizer; } /*! \class QSplitter \brief The QSplitter class implements a splitter widget. \ingroup organizers \mainclass A splitter lets the user control the size of child widgets by dragging the boundary between the children. Any number of widgets may be controlled by a single splitter. To show a QListBox, a QListView and a QTextEdit side by side: \code QSplitter *split = new QSplitter( parent ); QListBox *lb = new QListBox( split ); QListView *lv = new QListView( split ); QTextEdit *ed = new QTextEdit( split ); \endcode QSplitter lays out its children horizontally (side by side); you can use setOrientation(QSplitter::Vertical) to lay out the children vertically. By default, all widgets can be as large or as small as the user wishes, between the \l minimumSizeHint() (or \l minimumSize()) and \l maximumSize() of the widgets. Use setResizeMode() to specify that a widget should keep its size when the splitter is resized, or set the stretch component of the \l sizePolicy. Although QSplitter normally resizes the children only at the end of a resize operation, if you call setOpaqueResize(TRUE) the widgets are resized as often as possible. The initial distribution of size between the widgets is determined by the initial size of each widget. You can also use setSizes() to set the sizes of all the widgets. The function sizes() returns the sizes set by the user. If you hide() a child its space will be distributed among the other children. It will be reinstated when you show() it again. It is also possible to reorder the widgets within the splitter using moveToFirst() and moveToLast(). \sa QTabBar */ /*! Constructs a horizontal splitter with the \a parent and \a name arguments being passed on to the QFrame constructor. */ QSplitter::QSplitter( QWidget *parent, const char *name ) : QFrame( parent, name, WPaintUnclipped ) { orient = Horizontal; init(); } /*! Constructs a splitter with orientation \a o with the \a parent and \a name arguments being passed on to the QFrame constructor. */ QSplitter::QSplitter( Orientation o, QWidget *parent, const char *name ) : QFrame( parent, name, WPaintUnclipped ) { orient = o; init(); } /*! Destroys the splitter and any children. */ QSplitter::~QSplitter() { delete d; } void QSplitter::init() { d = new QSplitterPrivate; d->list.setAutoDelete( TRUE ); QSizePolicy sp( QSizePolicy::Expanding, QSizePolicy::Preferred ); if ( orient == Vertical ) sp.transpose(); setSizePolicy( sp ); clearWState( WState_OwnSizePolicy ); } /*! \fn void QSplitter::refresh() Updates the splitter's state. You should not need to call this function. */ /*! \property QSplitter::orientation \brief the orientation of the splitter By default the orientation is horizontal (the widgets are side by side). The possible orientations are \c Horizontal and \c Vertical. */ void QSplitter::setOrientation( Orientation o ) { if ( orient == o ) return; if ( !testWState( WState_OwnSizePolicy ) ) { QSizePolicy sp = sizePolicy(); sp.transpose(); setSizePolicy( sp ); clearWState( WState_OwnSizePolicy ); } orient = o; QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( s->isHandle ) ((QSplitterHandle*)s->wid)->setOrientation( o ); s = d->list.next(); } recalc( isVisible() ); } /*! \property QSplitter::childrenCollapsible \brief whether child widgets can be resized down to size 0 by the user By default, children are collapsible. It is possible to enable and disable the collapsing of individual children; see setCollapsible(). */ void QSplitter::setChildrenCollapsible( bool collapse ) { d->childrenCollapsible = collapse; } bool QSplitter::childrenCollapsible() const { return d->childrenCollapsible; } /*! Sets whether the child widget \a w is collapsible to \a collapse. By default, children are collapsible, meaning that the user can resize them down to size 0, even if they have a non-zero minimumSize() or minimumSizeHint(). This behavior can be changed on a per-widget basis by calling this function, or globally for all the widgets in the splitter by setting the \l childrenCollapsible property. \sa childrenCollapsible */ void QSplitter::setCollapsible( QWidget *w, bool collapse ) { findWidget( w )->collapsible = collapse ? 1 : 0; } /*! \reimp */ void QSplitter::resizeEvent( QResizeEvent * ) { doResize(); } QSplitterLayoutStruct *QSplitter::findWidget( QWidget *w ) { processChildEvents(); QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( s->wid == w ) return s; s = d->list.next(); } return addWidget( w ); } /* Inserts the widget \a w at the end (or at the beginning if \a prepend is TRUE) of the splitter's list of widgets. It is the responsibility of the caller to make sure that \a w is not already in the splitter and to call recalcId() if needed. (If \a prepend is TRUE, then recalcId() is very probably needed.) */ QSplitterLayoutStruct *QSplitter::addWidget( QWidget *w, bool prepend ) { QSplitterLayoutStruct *s; QSplitterHandle *newHandle = 0; if ( d->list.count() > 0 ) { s = new QSplitterLayoutStruct; s->resizeMode = KeepSize; QString tmp = "qt_splithandle_"; tmp += w->name(); newHandle = new QSplitterHandle( orientation(), this, tmp ); s->wid = newHandle; newHandle->setId( d->list.count() ); s->isHandle = TRUE; s->sizer = pick( newHandle->sizeHint() ); if ( prepend ) d->list.prepend( s ); else d->list.append( s ); } s = new QSplitterLayoutStruct; s->resizeMode = DefaultResizeMode; s->wid = w; s->isHandle = FALSE; if ( prepend ) d->list.prepend( s ); else d->list.append( s ); if ( newHandle && isVisible() ) newHandle->show(); // will trigger sending of post events return s; } /*! Tells the splitter that the child widget described by \a c has been inserted or removed. */ void QSplitter::childEvent( QChildEvent *c ) { if ( c->type() == QEvent::ChildInserted ) { if ( !c->child()->isWidgetType() ) return; if ( ((QWidget*)c->child())->testWFlags( WType_TopLevel ) ) return; QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( s->wid == c->child() ) return; s = d->list.next(); } addWidget( (QWidget*)c->child() ); recalc( isVisible() ); } else if ( c->type() == QEvent::ChildRemoved ) { QSplitterLayoutStruct *prev = 0; if ( d->list.count() > 1 ) prev = d->list.at( 1 ); // yes, this is correct QSplitterLayoutStruct *curr = d->list.first(); while ( curr ) { if ( curr->wid == c->child() ) { d->list.removeRef( curr ); if ( prev && prev->isHandle ) { QWidget *w = prev->wid; d->list.removeRef( prev ); delete w; // will call childEvent() } recalcId(); doResize(); return; } prev = curr; curr = d->list.next(); } } } /*! Displays a rubber band at position \a p. If \a p is negative, the rubber band is removed. */ void QSplitter::setRubberband( int p ) { QPainter paint( this ); paint.setPen( gray ); paint.setBrush( gray ); paint.setRasterOp( XorROP ); QRect r = contentsRect(); const int rBord = 3; // customizable? int hw = handleWidth(); if ( orient == Horizontal ) { if ( opaqueOldPos >= 0 ) paint.drawRect( opaqueOldPos + hw / 2 - rBord, r.y(), 2 * rBord, r.height() ); if ( p >= 0 ) paint.drawRect( p + hw / 2 - rBord, r.y(), 2 * rBord, r.height() ); } else { if ( opaqueOldPos >= 0 ) paint.drawRect( r.x(), opaqueOldPos + hw / 2 - rBord, r.width(), 2 * rBord ); if ( p >= 0 ) paint.drawRect( r.x(), p + hw / 2 - rBord, r.width(), 2 * rBord ); } opaqueOldPos = p; } /*! \reimp */ bool QSplitter::event( QEvent *e ) { switch ( e->type() ) { case QEvent::Show: if ( !d->firstShow ) break; d->firstShow = FALSE; // fall through case QEvent::LayoutHint: recalc( isVisible() ); break; default: ; } return QWidget::event( e ); } /*! \obsolete Draws the splitter handle in the rectangle described by \a x, \a y, \a w, \a h using painter \a p. \sa QStyle::drawPrimitive() */ // ### Remove this in 4.0 void QSplitter::drawSplitter( QPainter *p, QCOORD x, QCOORD y, QCOORD w, QCOORD h ) { style().drawPrimitive(QStyle::PE_Splitter, p, QRect(x, y, w, h), colorGroup(), (orientation() == Horizontal ? QStyle::Style_Horizontal : 0)); } /*! Returns the ID of the widget to the right of or below the widget \a w, or 0 if there is no such widget (i.e. it is either not in this QSplitter or \a w is at the end). */ int QSplitter::idAfter( QWidget* w ) const { QSplitterLayoutStruct *s = d->list.first(); bool seen_w = FALSE; while ( s ) { if ( s->isHandle && seen_w ) return d->list.at(); if ( !s->isHandle && s->wid == w ) seen_w = TRUE; s = d->list.next(); } return 0; } /*! Moves the left/top edge of the splitter handle with ID \a id as close as possible to position \a p, which is the distance from the left (or top) edge of the widget. For Arabic, Hebrew and other right-to-left languages the layout is reversed. \a p is then the distance from the right (or top) edge of the widget. \sa idAfter() */ void QSplitter::moveSplitter( QCOORD p, int id ) { QSplitterLayoutStruct *s = d->list.at( id ); int farMin; int min; int max; int farMax; p = adjustPos( p, id, &farMin, &min, &max, &farMax ); int oldP = pick( s->wid->pos() ); if ( QApplication::reverseLayout() && orient == Horizontal ) { int q = p + s->wid->width(); doMove( FALSE, q, id - 1, -1, (q > oldP), (p > max) ); doMove( TRUE, q, id, -1, (q > oldP), (p < min) ); } else { doMove( FALSE, p, id, +1, (p < oldP), (p > max) ); doMove( TRUE, p, id - 1, +1, (p < oldP), (p < min) ); } storeSizes(); } void QSplitter::setGeo( QWidget *w, int p, int s, bool splitterMoved ) { QRect r; if ( orient == Horizontal ) { if ( QApplication::reverseLayout() && orient == Horizontal && !splitterMoved ) p = contentsRect().width() - p - s; r.setRect( p, contentsRect().y(), s, contentsRect().height() ); } else { r.setRect( contentsRect().x(), p, contentsRect().width(), s ); } /* Hide the child widget, but without calling hide() so that the splitter handle is still shown. */ if ( !w->isHidden() && s <= 0 && pick(qSmartMinSize(w)) > 0 ) r.moveTopLeft( toggle(w, r.topLeft()) ); w->setGeometry( r ); } void QSplitter::doMove( bool backwards, int pos, int id, int delta, bool upLeft, bool mayCollapse ) { if ( id < 0 || id >= (int) d->list.count() ) return; QSplitterLayoutStruct *s = d->list.at( id ); QWidget *w = s->wid; int nextId = backwards ? id - delta : id + delta; if ( w->isHidden() ) { doMove( backwards, pos, nextId, delta, upLeft, TRUE ); } else { if ( s->isHandle ) { int dd = s->getSizer( orient ); int nextPos = backwards ? pos - dd : pos + dd; int left = backwards ? pos - dd : pos; setGeo( w, left, dd, TRUE ); doMove( backwards, nextPos, nextId, delta, upLeft, mayCollapse ); } else { int dd = backwards ? pos - pick( topLeft(w) ) : pick( bottomRight(w) ) - pos + 1; if ( dd > 0 || (!isCollapsed(w) && !mayCollapse) ) { dd = QMAX( pick(qSmartMinSize(w)), QMIN(dd, pick(w->maximumSize())) ); } else { dd = 0; } setGeo( w, backwards ? pos - dd : pos, dd, TRUE ); doMove( backwards, backwards ? pos - dd : pos + dd, nextId, delta, upLeft, TRUE ); } } } int QSplitter::findWidgetJustBeforeOrJustAfter( int id, int delta, int &collapsibleSize ) { id += delta; do { QWidget *w = d->list.at( id )->wid; if ( !w->isHidden() ) { if ( collapsible(d->list.at(id)) ) collapsibleSize = pick( qSmartMinSize(w) ); return id; } id += 2 * delta; // go to previous (or next) widget, skip the handle } while ( id >= 0 && id < (int)d->list.count() ); return -1; } void QSplitter::getRange( int id, int *farMin, int *min, int *max, int *farMax ) { int n = d->list.count(); if ( id <= 0 || id >= n - 1 ) return; int collapsibleSizeBefore = 0; int idJustBefore = findWidgetJustBeforeOrJustAfter( id, -1, collapsibleSizeBefore ); int collapsibleSizeAfter = 0; int idJustAfter = findWidgetJustBeforeOrJustAfter( id, +1, collapsibleSizeAfter ); int minBefore = 0; int minAfter = 0; int maxBefore = 0; int maxAfter = 0; int i; for ( i = 0; i < id; i++ ) addContribution( i, &minBefore, &maxBefore, i == idJustBefore ); for ( i = id; i < n; i++ ) addContribution( i, &minAfter, &maxAfter, i == idJustAfter ); QRect r = contentsRect(); int farMinVal; int minVal; int maxVal; int farMaxVal; int smartMinBefore = QMAX( minBefore, pick(r.size()) - maxAfter ); int smartMaxBefore = QMIN( maxBefore, pick(r.size()) - minAfter ); if ( orient == Vertical || !QApplication::reverseLayout() ) { minVal = pick( r.topLeft() ) + smartMinBefore; maxVal = pick( r.topLeft() ) + smartMaxBefore; farMinVal = minVal; if ( minBefore - collapsibleSizeBefore >= pick(r.size()) - maxAfter ) farMinVal -= collapsibleSizeBefore; farMaxVal = maxVal; if ( pick(r.size()) - (minAfter - collapsibleSizeAfter) <= maxBefore ) farMaxVal += collapsibleSizeAfter; } else { int hw = handleWidth(); minVal = r.width() - smartMaxBefore - hw; maxVal = r.width() - smartMinBefore - hw; farMinVal = minVal; if ( pick(r.size()) - (minAfter - collapsibleSizeAfter) <= maxBefore ) farMinVal -= collapsibleSizeAfter; farMaxVal = maxVal; if ( minBefore - collapsibleSizeBefore >= pick(r.size()) - maxAfter ) farMaxVal += collapsibleSizeBefore; } if ( farMin ) *farMin = farMinVal; if ( min ) *min = minVal; if ( max ) *max = maxVal; if ( farMax ) *farMax = farMaxVal; } /*! Returns the valid range of the splitter with ID \a id in \a *min and \a *max if \a min and \a max are not 0. \sa idAfter() */ void QSplitter::getRange( int id, int *min, int *max ) { getRange( id, min, 0, 0, max ); } /*! Returns the closest legal position to \a pos of the widget with ID \a id. \sa idAfter() */ int QSplitter::adjustPos( int pos, int id ) { int x, i, n, u; return adjustPos( pos, id, &u, &n, &i, &x ); } int QSplitter::adjustPos( int pos, int id, int *farMin, int *min, int *max, int *farMax ) { const int Threshold = 40; getRange( id, farMin, min, max, farMax ); if ( pos >= *min ) { if ( pos <= *max ) { return pos; } else { int delta = pos - *max; int width = *farMax - *max; if ( delta > width / 2 && delta >= QMIN(Threshold, width) ) { return *farMax; } else { return *max; } } } else { int delta = *min - pos; int width = *min - *farMin; if ( delta > width / 2 && delta >= QMIN(Threshold, width) ) { return *farMin; } else { return *min; } } } bool QSplitter::collapsible( QSplitterLayoutStruct *s ) { if (pick(qSmartMinSize(s->wid)) == 1) return FALSE; if ( s->collapsible != Default ) { return (bool) s->collapsible; } else { return d->childrenCollapsible; } } void QSplitter::doResize() { QRect r = contentsRect(); int n = d->list.count(); QMemArray a( n ); for ( int pass = 0; pass < 2; pass++ ) { int numAutoWithStretch = 0; int numAutoWithoutStretch = 0; for ( int i = 0; i < n; i++ ) { a[i].init(); QSplitterLayoutStruct *s = d->list.at( i ); if ( s->wid->isHidden() || isCollapsed(s->wid) ) { a[i].maximumSize = 0; } else if ( s->isHandle ) { a[i].sizeHint = a[i].minimumSize = a[i].maximumSize = s->sizer; a[i].empty = FALSE; } else { int mode = s->resizeMode; int stretch = 1; if ( mode == DefaultResizeMode ) { QSizePolicy p = s->wid->sizePolicy(); int sizePolicyStretch = pick( QSize(p.horStretch(), p.verStretch()) ); if ( sizePolicyStretch > 0 ) { mode = Stretch; stretch = sizePolicyStretch; numAutoWithStretch++; } else { /* Do things differently on the second pass, if there's one. A second pass is necessary if it was found out during the first pass that all DefaultResizeMode items are KeepSize items. In that case, we make them all Stretch items instead, for a more Qt 3.0-compatible behavior. */ mode = ( pass == 0 ) ? KeepSize : Stretch; numAutoWithoutStretch++; } } a[i].minimumSize = pick( qSmartMinSize(s->wid) ); a[i].maximumSize = pick( s->wid->maximumSize() ); a[i].empty = FALSE; if ( mode == Stretch ) { if ( s->getSizer(orient) > 1 ) stretch *= s->getSizer( orient ); // QMIN(): ad hoc work-around for layout engine limitation a[i].stretch = QMIN( stretch, 8192 ); a[i].sizeHint = a[i].minimumSize; } else if ( mode == KeepSize ) { a[i].sizeHint = s->getSizer( orient ); } else { // mode == FollowSizeHint a[i].sizeHint = pick( s->wid->sizeHint() ); } } } // a second pass would yield the same results if ( numAutoWithStretch > 0 || numAutoWithoutStretch == 0 ) break; } qGeomCalc( a, 0, n, pick( r.topLeft() ), pick( r.size() ), 0 ); for ( int i = 0; i < n; i++ ) { QSplitterLayoutStruct *s = d->list.at(i); setGeo( s->wid, a[i].pos, a[i].size, FALSE ); } } void QSplitter::recalc( bool update ) { int fi = 2 * frameWidth(); int maxl = fi; int minl = fi; int maxt = QWIDGETSIZE_MAX; int mint = fi; int n = d->list.count(); bool first = TRUE; /* Splitter handles before the first visible widget or right before a hidden widget must be hidden. */ for ( int i = 0; i < n; i++ ) { QSplitterLayoutStruct *s = d->list.at( i ); if ( !s->isHandle ) { QSplitterLayoutStruct *p = 0; if ( i > 0 ) p = d->list.at( i - 1 ); // may trigger new recalc if ( p && p->isHandle ) p->wid->setHidden( first || s->wid->isHidden() ); if ( !s->wid->isHidden() ) first = FALSE; } } bool empty = TRUE; for ( int j = 0; j < n; j++ ) { QSplitterLayoutStruct *s = d->list.at( j ); if ( !s->wid->isHidden() ) { empty = FALSE; if ( s->isHandle ) { minl += s->getSizer( orient ); maxl += s->getSizer( orient ); } else { QSize minS = qSmartMinSize( s->wid ); minl += pick( minS ); maxl += pick( s->wid->maximumSize() ); mint = QMAX( mint, trans(minS) ); int tm = trans( s->wid->maximumSize() ); if ( tm > 0 ) maxt = QMIN( maxt, tm ); } } } if ( empty ) { if ( ::qt_cast(parentWidget()) ) { // nested splitters; be nice maxl = maxt = 0; } else { // QSplitter with no children yet maxl = QWIDGETSIZE_MAX; } } else { maxl = QMIN( maxl, QWIDGETSIZE_MAX ); } if ( maxt < mint ) maxt = mint; if ( orient == Horizontal ) { setMaximumSize( maxl, maxt ); setMinimumSize( minl, mint ); } else { setMaximumSize( maxt, maxl ); setMinimumSize( mint, minl ); } if ( update ) doResize(); else d->firstShow = TRUE; } /*! \enum QSplitter::ResizeMode This enum type describes how QSplitter will resize each of its child widgets. \value Auto The widget will be resized according to the stretch factors set in its sizePolicy(). \value Stretch The widget will be resized when the splitter itself is resized. \value KeepSize QSplitter will try to keep the widget's size unchanged. \value FollowSizeHint QSplitter will resize the widget when the widget's size hint changes. */ /*! Sets resize mode of widget \a w to \a mode. (The default is \c Auto.) */ void QSplitter::setResizeMode( QWidget *w, ResizeMode mode ) { findWidget( w )->resizeMode = mode; } /*! \property QSplitter::opaqueResize \brief whether resizing is opaque Opaque resizing is off by default. */ bool QSplitter::opaqueResize() const { return d->opaque; } void QSplitter::setOpaqueResize( bool on ) { d->opaque = on; } /*! Moves widget \a w to the leftmost/top position. */ void QSplitter::moveToFirst( QWidget *w ) { processChildEvents(); bool found = FALSE; QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( s->wid == w ) { found = TRUE; QSplitterLayoutStruct *p = d->list.prev(); if ( p ) { // not already at first place d->list.take(); // take p d->list.take(); // take s d->list.prepend( p ); d->list.prepend( s ); } break; } s = d->list.next(); } if ( !found ) addWidget( w, TRUE ); recalcId(); } /*! Moves widget \a w to the rightmost/bottom position. */ void QSplitter::moveToLast( QWidget *w ) { processChildEvents(); bool found = FALSE; QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( s->wid == w ) { found = TRUE; d->list.take(); // take s QSplitterLayoutStruct *p = d->list.current(); if ( p ) { // the splitter handle after s d->list.take(); // take p d->list.append( p ); } d->list.append( s ); break; } s = d->list.next(); } if ( !found ) addWidget( w ); recalcId(); } void QSplitter::recalcId() { int n = d->list.count(); for ( int i = 0; i < n; i++ ) { QSplitterLayoutStruct *s = d->list.at( i ); if ( s->isHandle ) ((QSplitterHandle*)s->wid)->setId( i ); } } /*! \reimp */ QSize QSplitter::sizeHint() const { constPolish(); int l = 0; int t = 0; if ( children() ) { const QObjectList * c = children(); QObjectListIt it( *c ); QObject * o; while( (o = it.current()) != 0 ) { ++it; if ( o->isWidgetType() && !((QWidget*)o)->isHidden() ) { QSize s = ((QWidget*)o)->sizeHint(); if ( s.isValid() ) { l += pick( s ); t = QMAX( t, trans( s ) ); } } } } return orientation() == Horizontal ? QSize( l, t ) : QSize( t, l ); } /*! \reimp */ QSize QSplitter::minimumSizeHint() const { constPolish(); int l = 0; int t = 0; if ( children() ) { const QObjectList * c = children(); QObjectListIt it( *c ); QObject * o; while ( (o = it.current()) != 0 ) { ++it; if ( o->isWidgetType() && !((QWidget*)o)->isHidden() ) { QSize s = qSmartMinSize( (QWidget*)o ); if ( s.isValid() ) { l += pick( s ); t = QMAX( t, trans( s ) ); } } } } return orientation() == Horizontal ? QSize( l, t ) : QSize( t, l ); } void QSplitter::storeSizes() { QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( !s->isHandle ) s->sizer = pick( s->wid->size() ); s = d->list.next(); } } void QSplitter::addContribution( int id, int *min, int *max, bool mayCollapse ) { QSplitterLayoutStruct *s = d->list.at( id ); if ( !s->wid->isHidden() ) { if ( s->isHandle ) { *min += s->getSizer( orient ); *max += s->getSizer( orient ); } else { if ( mayCollapse || !isCollapsed(s->wid) ) *min += pick( qSmartMinSize(s->wid) ); *max += pick( s->wid->maximumSize() ); } } } /*! Returns a list of the size parameters of all the widgets in this splitter. If the splitter's orientation is horizontal, the list is a list of widget widths; if the orientation is vertical, the list is a list of widget heights. Giving the values to another splitter's setSizes() function will produce a splitter with the same layout as this one. Note that if you want to iterate over the list, you should iterate over a copy, e.g. \code QValueList list = mySplitter.sizes(); QValueList::Iterator it = list.begin(); while( it != list.end() ) { myProcessing( *it ); ++it; } \endcode \sa setSizes() */ QValueList QSplitter::sizes() const { if ( !testWState(WState_Polished) ) constPolish(); QValueList list; QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( !s->isHandle ) list.append( isCollapsed(s->wid) ? 0 : pick(s->wid->size())); s = d->list.next(); } return list; } /*! Sets the size parameters to the values given in the \a list. If the splitter is horizontal, the values set the widths of each widget going from left to right. If the splitter is vertical, the values set the heights of each widget going from top to bottom. Extra values in the \a list are ignored. If \a list contains too few values, the result is undefined but the program will still be well-behaved. Note that the values in \a list should be the height/width that the widgets should be resized to. \sa sizes() */ void QSplitter::setSizes( QValueList list ) { processChildEvents(); QValueList::Iterator it = list.begin(); QSplitterLayoutStruct *s = d->list.first(); while ( s && it != list.end() ) { if ( !s->isHandle ) { s->sizer = QMAX( *it, 0 ); int smartMinSize = pick( qSmartMinSize(s->wid) ); // Make sure that we reset the collapsed state. if ( s->sizer == 0 ) { if ( collapsible(s) && smartMinSize > 0 ) { s->wid->move( -1, -1 ); } else { s->sizer = smartMinSize; s->wid->move( 0, 0 ); } } else { if ( s->sizer < smartMinSize ) s->sizer = smartMinSize; s->wid->move( 0, 0 ); } ++it; } s = d->list.next(); } doResize(); } /*! \property QSplitter::handleWidth \brief the width of the splitter handle */ int QSplitter::handleWidth() const { if ( d->handleWidth > 0 ) { return d->handleWidth; } else { return style().pixelMetric( QStyle::PM_SplitterWidth, this ); } } void QSplitter::setHandleWidth( int width ) { d->handleWidth = width; updateHandles(); } /*! Processes all posted child events, ensuring that the internal state of the splitter is kept consistent. */ void QSplitter::processChildEvents() { QApplication::sendPostedEvents( this, QEvent::ChildInserted ); } /*! \reimp */ void QSplitter::styleChange( QStyle& old ) { updateHandles(); QFrame::styleChange( old ); } void QSplitter::updateHandles() { int hw = handleWidth(); QSplitterLayoutStruct *s = d->list.first(); while ( s ) { if ( s->isHandle ) s->sizer = hw; s = d->list.next(); } recalc( isVisible() ); } #ifndef QT_NO_TEXTSTREAM /*! \relates QSplitter Writes the sizes and the hidden state of the widgets in the splitter \a splitter to the text stream \a ts. \sa operator>>(), sizes(), QWidget::isHidden() */ QTextStream& operator<<( QTextStream& ts, const QSplitter& splitter ) { QSplitterLayoutStruct *s = splitter.d->list.first(); bool first = TRUE; ts << "["; while ( s != 0 ) { if ( !s->isHandle ) { if ( !first ) ts << ","; if ( s->wid->isHidden() ) { ts << "H"; } else if ( isCollapsed(s->wid) ) { ts << 0; } else { ts << s->getSizer( splitter.orientation() ); } first = FALSE; } s = splitter.d->list.next(); } ts << "]" << endl; return ts; } /*! \relates QSplitter Reads the sizes and the hidden state of the widgets in the splitter \a splitter from the text stream \a ts. The sizes must have been previously written by the operator<<() function. \sa operator<<(), setSizes(), QWidget::hide() */ QTextStream& operator>>( QTextStream& ts, QSplitter& splitter ) { #undef SKIP_SPACES #define SKIP_SPACES() \ while ( line[i].isSpace() ) \ i++ splitter.processChildEvents(); QSplitterLayoutStruct *s = splitter.d->list.first(); QString line = ts.readLine(); int i = 0; SKIP_SPACES(); if ( line[i] == '[' ) { i++; SKIP_SPACES(); while ( line[i] != ']' ) { while ( s != 0 && s->isHandle ) s = splitter.d->list.next(); if ( s == 0 ) break; if ( line[i].upper() == 'H' ) { s->wid->hide(); i++; } else { s->wid->show(); int dim = 0; while ( line[i].digitValue() >= 0 ) { dim *= 10; dim += line[i].digitValue(); i++; } s->sizer = dim; if ( dim == 0 ) splitter.setGeo( s->wid, 0, 0, FALSE ); } SKIP_SPACES(); if ( line[i] == ',' ) { i++; } else { break; } SKIP_SPACES(); s = splitter.d->list.next(); } } splitter.doResize(); return ts; } #endif #endif