/****************************************************************************** $Id: qt/src/widgets/qsplitter.cpp   2.3.12   edited 2005-10-27 $****  Splitter widget****  Created:  980105**** Copyright (C) 1992-2000 Trolltech AS.  All rights reserved.**** This file is part of the widgets module of the Qt GUI Toolkit.**** This file may be distributed under the terms of the Q Public License** as defined by Trolltech AS of Norway and appearing in the file** LICENSE.QPL included in the packaging of this file.**** This file may be distributed and/or modified under the terms of the** GNU General Public License version 2 as published by the Free Software** Foundation and appearing in the file LICENSE.GPL included in the** packaging of this file.**** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition** licenses may use this file in accordance with the Qt Commercial License** Agreement provided with the Software.**** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.**** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for**   information about Qt Commercial License Agreements.** See http://www.trolltech.com/qpl/ for QPL licensing information.** See http://www.trolltech.com/gpl/ for GPL licensing information.**** Contact info@trolltech.com if any conditions of this licensing are** not clear to you.************************************************************************/#include "qsplitter.h"#ifndef QT_NO_SPLITTER#include "qpainter.h"#include "qdrawutil.h"#include "qbitmap.h"#include "../kernel/qlayoutengine_p.h"#include "qlist.h"#include "qarray.h"#include "qobjectlist.h"#include "qapplication.h" //sendPostedEventsclass QSplitterHandle : public QWidget{public:    QSplitterHandle( Qt::Orientation o,		       QSplitter *parent, const char* name=0 );    void setOrientation( Qt::Orientation o );    Qt::Orientation orientation() const { return orient; }    bool opaque() const { return s->opaqueResize(); }    QSize sizeHint() const;    QSizePolicy sizePolicy() const;    int id() const { return myId; } // data->list.at(id())->wid == this    void setId( int i ) { myId = i; }protected:    void paintEvent( QPaintEvent * );    void mouseMoveEvent( QMouseEvent * );    void mousePressEvent( QMouseEvent * );    void mouseReleaseEvent( QMouseEvent * );private:    Qt::Orientation orient;    bool opaq;    int myId;    QSplitter *s;};static int mouseOffset;static int opaqueOldPos = -1; //### there's only one mouse, but this is a bit riskyQSplitterHandle::QSplitterHandle( Qt::Orientation o,				  QSplitter *parent, const char * name )    : QWidget( parent, name ){    s = parent;    setOrientation(o);}QSizePolicy QSplitterHandle::sizePolicy() const{    //### removeme 3.0    return QWidget::sizePolicy();}QSize QSplitterHandle::sizeHint() const{    int sw = style().splitterWidth();    return QSize(sw,sw).expandedTo( QApplication::globalStrut() );}void QSplitterHandle::setOrientation( Qt::Orientation o ){    orient = o;#ifndef QT_NO_CURSOR    if ( o == QSplitter::Horizontal )	setCursor( splitHCursor );    else	setCursor( 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 {	int min = pos; int max = pos;	s->getRange( id(), &min, &max );	s->setRubberband( QMAX( min, QMIN(max, pos )));    }}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()));	s->setRubberband( -1 );	s->moveSplitter( pos, id() );    }}void QSplitterHandle::paintEvent( QPaintEvent * ){    QPainter p( this );    s->drawSplitter( &p, 0, 0, width(), height() );}class QSplitterLayoutStruct{public:    QSplitter::ResizeMode mode;    QCOORD sizer;    bool isSplitter;    QWidget *wid;};class QSplitterData{public:    QSplitterData() : opaque( FALSE ), firstShow( TRUE ) {}    QList<QSplitterLayoutStruct> list;    bool opaque;    bool firstShow;};// NOT REVISED/*!  \class QSplitter qsplitter.h  \brief The QSplitter class implements a splitter widget.  \ingroup organizers  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.  To show a QListBox, a QListView and a QMultiLineEdit side by side:  \code    QSplitter *split = new QSplitter( parent );    QListBox *lb = new QListBox( split );    QListView *lv = new QListView( split );    QMultiLineEdit *ed = new QMultiLineEdit( split );  \endcode  In QSplitter the boundary can be either horizontal or vertical.  The  default is horizontal (the children are side by side) and you  can use setOrientation( QSplitter::Vertical ) to set it to vertical.  By default, all widgets can be as large or as small as the user  wishes, down to \link QWidget::minimumSizeHint() minimumSizeHint()\endlink.  You can naturally use setMinimumSize() and/or  setMaximumSize() on the children. Use setResizeMode() to specify that  a widget should keep its size when the splitter is resized.  QSplitter normally resizes the children only at the end of a  resize operation, but 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. When you show() it again, it will be reinstated.  <img src=qsplitter-m.png> <img src=qsplitter-w.png>  \sa QTabBar*/static QSize minSize( const QWidget *w ){    QSize min = w->minimumSize();    QSize s;    if ( min.height() <= 0 || min.width() <= 0 )	s = w->minimumSizeHint();    if ( min.height() > 0 )	s.setHeight( min.height() );    if ( min.width() > 0 )	s.setWidth( min.width() );    return s.expandedTo(QSize(0,0));}/*!  Constructs a horizontal splitter.*/QSplitter::QSplitter( QWidget *parent, const char *name )    :QFrame(parent,name,WPaintUnclipped){     orient = Horizontal;     init();}/*!  Constructs splitter with orientation \a o.*/QSplitter::QSplitter( Orientation o, QWidget *parent, const char *name )    :QFrame(parent,name,WPaintUnclipped){     orient = o;     init();}/*!  Destructs the splitter.*/QSplitter::~QSplitter(){    data->list.setAutoDelete( TRUE );    delete data;}void QSplitter::init(){    data = new QSplitterData;    if ( orient == Horizontal )	setSizePolicy( QSizePolicy(QSizePolicy::Fixed,QSizePolicy::Minimum) );    else    	setSizePolicy( QSizePolicy(QSizePolicy::Minimum,QSizePolicy::Fixed) );}/*!  \fn void QSplitter::refresh()  Updates the splitter state. You should not need to call this  function during normal use of the splitter.*//*!  Sets the orientation to \a o.  By default the orientation is  horizontal (the widgets are side by side).  \sa orientation()*/void QSplitter::setOrientation( Orientation o ){    if ( orient == o )	return;    orient = o;    if ( orient == Horizontal )	setSizePolicy( QSizePolicy( QSizePolicy::Fixed, QSizePolicy::Minimum ) );    else    	setSizePolicy( QSizePolicy( QSizePolicy::Minimum, QSizePolicy::Fixed ) );    QSplitterLayoutStruct *s = data->list.first();    while ( s ) {	if ( s->isSplitter )	    ((QSplitterHandle*)s->wid)->setOrientation( o );	s = data->list.next();  // ### next at end of loop, no iterator    }    recalc( isVisible() );}/*!   \fn Orientation QSplitter::orientation() const   Returns the orientation (\c Horizontal or \c Vertical) of the splitter.   \sa setOrientation()*//*!  \reimp*/void QSplitter::resizeEvent( QResizeEvent * ){    doResize();}/*!  Inserts the widget \a w at the end, or at the beginning if \a first is TRUE  It is the responsibility of the caller of this function to make sure  that \a w is not already in the splitter, and to call recalcId if  needed.  (If \a first is TRUE, then recalcId is very probably  needed.)*/QSplitterLayoutStruct *QSplitter::addWidget( QWidget *w, bool first ){    QSplitterLayoutStruct *s;    QSplitterHandle *newHandle = 0;    if ( data->list.count() > 0 ) {	s = new QSplitterLayoutStruct;	s->mode = KeepSize;	newHandle = new QSplitterHandle( orientation(), this );	s->wid = newHandle;	newHandle->setId(data->list.count());	s->isSplitter = TRUE;	s->sizer = pick( newHandle->sizeHint() );	if ( first )	    data->list.insert( 0, s );	else	    data->list.append( s );    }    s = new QSplitterLayoutStruct;    s->mode = Stretch;    s->wid = w;    if ( !testWState( WState_Resized ) && w->sizeHint().isValid() )	s->sizer = pick( w->sizeHint() );    else	s->sizer = pick( w->size() );    s->isSplitter = FALSE;    if ( first )	data->list.insert( 0, s );    else	data->list.append( s );    if ( newHandle && isVisible() )	newHandle->show(); //will trigger sending of post events    return s;}/*!  Tells the splitter that a child widget has been inserted/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 = data->list.first();	while ( s ) {	    if ( s->wid == c->child() )		return;	    s = data->list.next();	}	addWidget( (QWidget*)c->child() );	recalc( isVisible() );    } else if ( c->type() == QEvent::ChildRemoved ) {	QSplitterLayoutStruct *p = 0;	if ( data->list.count() > 1 )	    p = data->list.at(1); //remove handle _after_ first widget.	QSplitterLayoutStruct *s = data->list.first();	while ( s ) {	    if ( s->wid == c->child() ) {		data->list.removeRef( s );		delete s;		if ( p && p->isSplitter ) {		    data->list.removeRef( p );		    delete p->wid; //will call childEvent		    delete p;		}		recalcId();		doResize();		return;	    }	    p = s;	    s = data->list.next();	}    }}/*!  Shows 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; //Themable????    const int sw = style().splitterWidth();    if ( orient == Horizontal ) {	if ( opaqueOldPos >= 0 )	    paint.drawRect( opaqueOldPos + sw/2 - rBord , r.y(),			    2*rBord, r.height() );	if ( p >= 0 )	    paint.drawRect( p  + sw/2 - rBord, r.y(), 2*rBord, r.height() );    } else {	if ( opaqueOldPos >= 0 )	    paint.drawRect( r.x(), opaqueOldPos + sw/2 - rBord,			    r.width(), 2*rBord );	if ( p >= 0 )	    paint.drawRect( r.x(), p + sw/2 - rBord, r.width(), 2*rBord );    }    opaqueOldPos = p;}/*! \reimp */bool QSplitter::event( QEvent *e ){    if ( e->type() == QEvent::LayoutHint || ( e->type() == QEvent::Show && data->firstShow ) ) {	recalc( isVisible() );	if ( e->type() == QEvent::Show )	    data->firstShow = FALSE;    }    return QWidget::event( e );}/*!  Draws the splitter handle in the rectangle described by \a x, \a y,  \a w, \a h using painter \a p.  \sa QStyle::drawSplitter*/void QSplitter::drawSplitter( QPainter *p,			      QCOORD x, QCOORD y, QCOORD w, QCOORD h ){    style().drawSplitter( p, x, y, w, h, colorGroup(), orient );}/*!  Returns the id of the splitter to the right of or below the widget \a w,  or 0 if there is no such splitter.  (ie. it is either not in this QSplitter, or it is at the end).*/int QSplitter::idAfter( QWidget* w ) const{    QSplitterLayoutStruct *s = data->list.first();    bool seen_w = FALSE;    while ( s ) {	if ( s->isSplitter && seen_w )	    return data->list.at();	if ( !s->isSplitter && s->wid == w )	    seen_w = TRUE;	s = data->list.next();    }    return 0;}/*!  Moves the left/top edge of the splitter handle with id \a id as  close as possible to \a p which is the distance from the left (or  top) edge of the widget.  \sa idAfter()*/void QSplitter::moveSplitter( QCOORD p, int id ){    p = adjustPos( p, id );    QSplitterLayoutStruct *s = data->list.at(id);    int oldP = orient == Horizontal? s->wid->x() : s->wid->y();    bool upLeft = p < oldP;    moveAfter( p, id, upLeft );    moveBefore( p-1, id-1, upLeft );    storeSizes();}void QSplitter::setG( QWidget *w, int p, int s ){    if ( orient == Horizontal )	w->setGeometry( p, contentsRect().y(), s, contentsRect().height() );    else	w->setGeometry( contentsRect().x(), p, contentsRect().width(), s );}/*!  Places the right/bottom edge of the widget at \a id at position \a pos.  \sa idAfter()*/void QSplitter::moveBefore( int pos, int id, bool upLeft ){    QSplitterLayoutStruct *s = data->list.at(id);    if ( !s )	return;    QWidget *w = s->wid;    if ( w->isHidden() ) {	moveBefore( pos, id-1, upLeft );    } else if ( s->isSplitter ) {	int dd = s->sizer;	if ( upLeft ) {	    setG( w, pos-dd+1, dd );	    moveBefore( pos-dd, id-1, upLeft );	} else {	    moveBefore( pos-dd, id-1, upLeft );	    setG( w, pos-dd+1, dd );	}    } else {	int left = pick( w->pos() );	int dd = pos - left + 1;	dd = QMAX( pick(minSize(w)), QMIN(dd, pick(w->maximumSize())));	int newLeft = pos-dd+1;	setG( w, newLeft, dd );	if ( left != newLeft )	    moveBefore( newLeft-1, id-1, upLeft );    }}/*!  Places the left/top edge of the widget at \a id at position \a pos.