summaryrefslogtreecommitdiffstats
path: root/src/widgets/qgroupbox.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/widgets/qgroupbox.cpp')
-rw-r--r--src/widgets/qgroupbox.cpp989
1 files changed, 989 insertions, 0 deletions
diff --git a/src/widgets/qgroupbox.cpp b/src/widgets/qgroupbox.cpp
new file mode 100644
index 0000000..6097ece
--- /dev/null
+++ b/src/widgets/qgroupbox.cpp
@@ -0,0 +1,989 @@
+/**********************************************************************
+**
+** Implementation of QGroupBox widget class
+**
+** Created : 950203
+**
+** 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 "qgroupbox.h"
+#ifndef QT_NO_GROUPBOX
+#include "qlayout.h"
+#include "qpainter.h"
+#include "qbitmap.h"
+#include "qaccel.h"
+#include "qradiobutton.h"
+#include "qfocusdata.h"
+#include "qobjectlist.h"
+#include "qdrawutil.h"
+#include "qapplication.h"
+#include "qstyle.h"
+#include "qcheckbox.h"
+#include "qbuttongroup.h"
+#if defined(QT_ACCESSIBILITY_SUPPORT)
+#include "qaccessible.h"
+#endif
+
+/*!
+ \class QGroupBox qgroupbox.h
+ \brief The QGroupBox widget provides a group box frame with a title.
+
+ \ingroup organizers
+ \ingroup geomanagement
+ \ingroup appearance
+ \mainclass
+
+ A group box provides a frame, a title and a keyboard shortcut, and
+ displays various other widgets inside itself. The title is on top,
+ the keyboard shortcut moves keyboard focus to one of the group
+ box's child widgets, and the child widgets are usually laid out
+ horizontally (or vertically) inside the frame.
+
+ The simplest way to use it is to create a group box with the
+ desired number of columns (or rows) and orientation, and then just
+ create widgets with the group box as parent.
+
+ It is also possible to change the orientation() and number of
+ columns() after construction, or to ignore all the automatic
+ layout support and manage the layout yourself. You can add 'empty'
+ spaces to the group box with addSpace().
+
+ QGroupBox also lets you set the title() (normally set in the
+ constructor) and the title's alignment().
+
+ You can change the spacing used by the group box with
+ setInsideMargin() and setInsideSpacing(). To minimize space
+ consumption, you can remove the right, left and bottom edges of
+ the frame with setFlat().
+
+ <img src=qgrpbox-w.png>
+
+ \sa QButtonGroup
+*/
+
+class QCheckBox;
+
+class QGroupBoxPrivate
+{
+public:
+ QGroupBoxPrivate():
+ spacer( 0 ),
+ checkbox( 0 ) {}
+
+ QSpacerItem *spacer;
+ QCheckBox *checkbox;
+};
+
+
+
+
+/*!
+ Constructs a group box widget with no title.
+
+ The \a parent and \a name arguments are passed to the QWidget
+ constructor.
+
+ This constructor does not do automatic layout.
+*/
+
+QGroupBox::QGroupBox( QWidget *parent, const char *name )
+ : QFrame( parent, name )
+{
+ init();
+}
+
+/*!
+ Constructs a group box with the title \a title.
+
+ The \a parent and \a name arguments are passed to the QWidget
+ constructor.
+
+ This constructor does not do automatic layout.
+*/
+
+QGroupBox::QGroupBox( const QString &title, QWidget *parent, const char *name )
+ : QFrame( parent, name )
+{
+ init();
+ setTitle( title );
+}
+
+/*!
+ Constructs a group box with no title. Child widgets will be
+ arranged in \a strips rows or columns (depending on \a
+ orientation).
+
+ The \a parent and \a name arguments are passed to the QWidget
+ constructor.
+*/
+
+QGroupBox::QGroupBox( int strips, Orientation orientation,
+ QWidget *parent, const char *name )
+ : QFrame( parent, name )
+{
+ init();
+ setColumnLayout( strips, orientation );
+}
+
+/*!
+ Constructs a group box titled \a title. Child widgets will be
+ arranged in \a strips rows or columns (depending on \a
+ orientation).
+
+ The \a parent and \a name arguments are passed to the QWidget
+ constructor.
+*/
+
+QGroupBox::QGroupBox( int strips, Orientation orientation,
+ const QString &title, QWidget *parent,
+ const char *name )
+ : QFrame( parent, name )
+{
+ init();
+ setTitle( title );
+ setColumnLayout( strips, orientation );
+}
+
+/*!
+ Destroys the group box.
+*/
+QGroupBox::~QGroupBox()
+{
+ delete d;
+}
+
+void QGroupBox::init()
+{
+ align = AlignAuto;
+ setFrameStyle( QFrame::GroupBoxPanel | QFrame::Sunken );
+#ifndef QT_NO_ACCEL
+ accel = 0;
+#endif
+ vbox = 0;
+ grid = 0;
+ d = new QGroupBoxPrivate();
+ lenvisible = 0;
+ nCols = nRows = 0;
+ dir = Horizontal;
+ marg = 11;
+ spac = 5;
+ bFlat = FALSE;
+}
+
+void QGroupBox::setTextSpacer()
+{
+ if ( !d->spacer )
+ return;
+ int h = 0;
+ int w = 0;
+ if ( isCheckable() || lenvisible ) {
+ QFontMetrics fm = fontMetrics();
+ int fh = fm.height();
+ if ( isCheckable() ) {
+#ifndef QT_NO_CHECKBOX
+ fh = d->checkbox->sizeHint().height() + 2;
+ w = d->checkbox->sizeHint().width() + 2*fm.width( "xx" );
+#endif
+ } else {
+ fh = fm.height();
+ w = fm.width( str, lenvisible ) + 2*fm.width( "xx" );
+ }
+ h = frameRect().y();
+ if ( layout() ) {
+ int m = layout()->margin();
+ int sp = layout()->spacing();
+ // do we have a child layout?
+ for ( QLayoutIterator it = layout()->iterator(); it.current(); ++it ) {
+ if ( it.current()->layout() ) {
+ m += it.current()->layout()->margin();
+ sp = QMAX( sp, it.current()->layout()->spacing() );
+ break;
+ }
+ }
+ h = QMAX( fh-m, h );
+ h += QMAX( sp - (h+m - fh), 0 );
+ }
+ }
+ d->spacer->changeSize( w, h, QSizePolicy::Minimum, QSizePolicy::Fixed );
+}
+
+
+void QGroupBox::setTitle( const QString &title )
+{
+ if ( str == title ) // no change
+ return;
+ str = title;
+#ifndef QT_NO_ACCEL
+ if ( accel )
+ delete accel;
+ accel = 0;
+ int s = QAccel::shortcutKey( title );
+ if ( s ) {
+ accel = new QAccel( this, "automatic focus-change accelerator" );
+ accel->connectItem( accel->insertItem( s, 0 ),
+ this, SLOT(fixFocus()) );
+ }
+#endif
+#ifndef QT_NO_CHECKBOX
+ if ( d->checkbox ) {
+ d->checkbox->setText( str );
+ updateCheckBoxGeometry();
+ }
+#endif
+ calculateFrame();
+ setTextSpacer();
+
+ update();
+ updateGeometry();
+#if defined(QT_ACCESSIBILITY_SUPPORT)
+ QAccessible::updateAccessibility( this, 0, QAccessible::NameChanged );
+#endif
+}
+
+/*!
+ \property QGroupBox::title
+ \brief the group box title text.
+
+ The group box title text will have a focus-change keyboard
+ accelerator if the title contains \&, followed by a letter.
+
+ \code
+ g->setTitle( "&User information" );
+ \endcode
+ This produces "<u>U</u>ser information"; Alt+U moves the keyboard
+ focus to the group box.
+
+ There is no default title text.
+*/
+
+/*!
+ \property QGroupBox::alignment
+ \brief the alignment of the group box title.
+
+ The title is always placed on the upper frame line. The horizontal
+ alignment can be specified by the alignment parameter.
+
+ The alignment is one of the following flags:
+ \list
+ \i \c AlignAuto aligns the title according to the language,
+ usually to the left.
+ \i \c AlignLeft aligns the title text to the left.
+ \i \c AlignRight aligns the title text to the right.
+ \i \c AlignHCenter aligns the title text centered.
+ \endlist
+
+ The default alignment is \c AlignAuto.
+
+ \sa Qt::AlignmentFlags
+*/
+
+void QGroupBox::setAlignment( int alignment )
+{
+ align = alignment;
+#ifndef QT_NO_CHECKBOX
+ updateCheckBoxGeometry();
+#endif
+ update();
+}
+
+/*! \reimp
+*/
+void QGroupBox::resizeEvent( QResizeEvent *e )
+{
+ QFrame::resizeEvent(e);
+#ifndef QT_NO_CHECKBOX
+ if ( align & AlignRight || align & AlignCenter ||
+ ( QApplication::reverseLayout() && !(align & AlignLeft) ) )
+ updateCheckBoxGeometry();
+#endif
+ calculateFrame();
+}
+
+/*! \reimp
+
+ \internal
+ overrides QFrame::paintEvent
+*/
+
+void QGroupBox::paintEvent( QPaintEvent *event )
+{
+ QPainter paint( this );
+
+ if ( lenvisible && !isCheckable() ) { // draw title
+ QFontMetrics fm = paint.fontMetrics();
+ int h = fm.height();
+ int tw = fm.width( str, lenvisible ) + fm.width(QChar(' '));
+ int x;
+ int marg = bFlat ? 0 : 8;
+ if ( align & AlignHCenter ) // center alignment
+ x = frameRect().width()/2 - tw/2;
+ else if ( align & AlignRight ) // right alignment
+ x = frameRect().width() - tw - marg;
+ else if ( align & AlignLeft ) // left alignment
+ x = marg;
+ else { // auto align
+ if( QApplication::reverseLayout() )
+ x = frameRect().width() - tw - marg;
+ else
+ x = marg;
+ }
+ QRect r( x, 0, tw, h );
+ int va = style().styleHint(QStyle::SH_GroupBox_TextLabelVerticalAlignment, this);
+ if(va & AlignTop)
+ r.moveBy(0, fm.descent());
+ QColor pen( (QRgb) style().styleHint(QStyle::SH_GroupBox_TextLabelColor, this ) );
+ if (!style().styleHint(QStyle::SH_UnderlineAccelerator, this))
+ va |= NoAccel;
+ style().drawItem( &paint, r, ShowPrefix | AlignHCenter | va, colorGroup(),
+ isEnabled(), 0, str, -1, ownPalette() ? 0 : &pen );
+ paint.setClipRegion( event->region().subtract( r ) ); // clip everything but title
+#ifndef QT_NO_CHECKBOX
+ } else if ( d->checkbox ) {
+ QRect cbClip = d->checkbox->geometry();
+ QFontMetrics fm = paint.fontMetrics();
+ cbClip.setX( cbClip.x() - fm.width(QChar(' ')) );
+ cbClip.setWidth( cbClip.width() + fm.width(QChar(' ')) );
+ paint.setClipRegion( event->region().subtract( cbClip ) );
+#endif
+ }
+ if ( bFlat ) {
+ QRect fr = frameRect();
+ QPoint p1( fr.x(), fr.y() + 1 );
+ QPoint p2( fr.x() + fr.width(), p1.y() );
+ // ### This should probably be a style primitive.
+ qDrawShadeLine( &paint, p1, p2, colorGroup(), TRUE,
+ lineWidth(), midLineWidth() );
+ } else {
+ drawFrame(&paint);
+ }
+ drawContents( &paint ); // draw the contents
+}
+
+
+/*!
+ Adds an empty cell at the next free position. If \a size is
+ greater than 0, the empty cell takes \a size to be its fixed width
+ (if orientation() is \c Horizontal) or height (if orientation() is
+ \c Vertical).
+
+ Use this method to separate the widgets in the group box or to
+ skip the next free cell. For performance reasons, call this method
+ after calling setColumnLayout() or by changing the \l
+ QGroupBox::columns or \l QGroupBox::orientation properties. It is
+ generally a good idea to call these methods first (if needed at
+ all), and insert the widgets and spaces afterwards.
+*/
+void QGroupBox::addSpace( int size )
+{
+ QApplication::sendPostedEvents( this, QEvent::ChildInserted );
+
+ if ( nCols <= 0 || nRows <= 0 )
+ return;
+
+ if ( row >= nRows || col >= nCols )
+ grid->expand( row+1, col+1 );
+
+ if ( size > 0 ) {
+ QSpacerItem *spacer
+ = new QSpacerItem( ( dir == Horizontal ) ? 0 : size,
+ ( dir == Vertical ) ? 0 : size,
+ QSizePolicy::Fixed, QSizePolicy::Fixed );
+ grid->addItem( spacer, row, col );
+ }
+
+ skip();
+}
+
+/*!
+ \property QGroupBox::columns
+ \brief the number of columns or rows (depending on \l QGroupBox::orientation) in the group box
+
+ Usually it is not a good idea to set this property because it is
+ slow (it does a complete layout). It is best to set the number
+ of columns directly in the constructor.
+*/
+int QGroupBox::columns() const
+{
+ if ( dir == Horizontal )
+ return nCols;
+ return nRows;
+}
+
+void QGroupBox::setColumns( int c )
+{
+ setColumnLayout( c, dir );
+}
+
+/*!
+ Returns the width of the empty space between the items in the
+ group and the frame of the group.
+
+ Only applies if the group box has a defined orientation.
+
+ The default is usually 11, by may vary depending on the platform
+ and style.
+
+ \sa setInsideMargin(), orientation
+*/
+int QGroupBox::insideMargin() const
+{
+ return marg;
+}
+
+/*!
+ Returns the width of the empty space between each of the items
+ in the group.
+
+ Only applies if the group box has a defined orientation.
+
+ The default is usually 5, by may vary depending on the platform
+ and style.
+
+ \sa setInsideSpacing(), orientation
+*/
+int QGroupBox::insideSpacing() const
+{
+ return spac;
+}
+
+/*!
+ Sets the the width of the inside margin to \a m pixels.
+
+ \sa insideMargin()
+*/
+void QGroupBox::setInsideMargin( int m )
+{
+ marg = m;
+ setColumnLayout( columns(), dir );
+}
+
+/*!
+ Sets the width of the empty space between each of the items in
+ the group to \a s pixels.
+
+ \sa insideSpacing()
+*/
+void QGroupBox::setInsideSpacing( int s )
+{
+ spac = s;
+ setColumnLayout( columns(), dir );
+}
+
+/*!
+ \property QGroupBox::orientation
+ \brief the group box's orientation
+
+ A horizontal group box arranges it's children in columns, while a
+ vertical group box arranges them in rows.
+
+ Usually it is not a good idea to set this property because it is
+ slow (it does a complete layout). It is better to set the
+ orientation directly in the constructor.
+*/
+void QGroupBox::setOrientation( Qt::Orientation o )
+{
+ setColumnLayout( columns(), o );
+}
+
+/*!
+ Changes the layout of the group box. This function is only useful
+ in combination with the default constructor that does not take any
+ layout information. This function will put all existing children
+ in the new layout. It is not good Qt programming style to call
+ this function after children have been inserted. Sets the number
+ of columns or rows to be \a strips, depending on \a direction.
+
+ \sa orientation columns
+*/
+void QGroupBox::setColumnLayout(int strips, Orientation direction)
+{
+ if ( layout() )
+ delete layout();
+
+ vbox = 0;
+ grid = 0;
+
+ if ( strips < 0 ) // if 0, we create the vbox but not the grid. See below.
+ return;
+
+ vbox = new QVBoxLayout( this, marg, 0 );
+
+ d->spacer = new QSpacerItem( 0, 0, QSizePolicy::Minimum,
+ QSizePolicy::Fixed );
+
+ setTextSpacer();
+ vbox->addItem( d->spacer );
+
+ nCols = 0;
+ nRows = 0;
+ dir = direction;
+
+ // Send all child events and ignore them. Otherwise we will end up
+ // with doubled insertion. This won't do anything because nCols ==
+ // nRows == 0.
+ QApplication::sendPostedEvents( this, QEvent::ChildInserted );
+
+ // if 0 or smaller , create a vbox-layout but no grid. This allows
+ // the designer to handle its own grid layout in a group box.
+ if ( strips <= 0 )
+ return;
+
+ dir = direction;
+ if ( dir == Horizontal ) {
+ nCols = strips;
+ nRows = 1;
+ } else {
+ nCols = 1;
+ nRows = strips;
+ }
+ grid = new QGridLayout( nRows, nCols, spac );
+ row = col = 0;
+ grid->setAlignment( AlignTop );
+ vbox->addLayout( grid );
+
+ // Add all children
+ if ( children() ) {
+ QObjectListIt it( *children() );
+ QWidget *w;
+ while( (w=(QWidget *)it.current()) != 0 ) {
+ ++it;
+ if ( w->isWidgetType()
+#ifndef QT_NO_CHECKBOX
+ && w != d->checkbox
+#endif
+ )
+ insertWid( w );
+ }
+ }
+}
+
+
+/*! \reimp */
+bool QGroupBox::event( QEvent * e )
+{
+ if ( e->type() == QEvent::LayoutHint && layout() )
+ setTextSpacer();
+ return QFrame::event( e );
+}
+
+/*!\reimp */
+void QGroupBox::childEvent( QChildEvent *c )
+{
+ if ( !c->inserted() || !c->child()->isWidgetType() )
+ return;
+ QWidget *w = (QWidget*)c->child();
+#ifndef QT_NO_CHECKBOX
+ if ( d->checkbox ) {
+ if ( w == d->checkbox )
+ return;
+ if ( d->checkbox->isChecked() ) {
+ if ( !w->testWState( WState_ForceDisabled ) )
+ w->setEnabled( TRUE );
+ } else {
+ if ( w->isEnabled() ) {
+ w->setEnabled( FALSE );
+ ((QGroupBox*)w)->clearWState( WState_ForceDisabled );
+ }
+ }
+ }
+#endif
+ if ( !grid )
+ return;
+ insertWid( w );
+}
+
+void QGroupBox::insertWid( QWidget* w )
+{
+ if ( row >= nRows || col >= nCols )
+ grid->expand( row+1, col+1 );
+ grid->addWidget( w, row, col );
+ skip();
+ QApplication::postEvent( this, new QEvent( QEvent::LayoutHint ) );
+}
+
+
+void QGroupBox::skip()
+{
+ // Same as QGrid::skip()
+ if ( dir == Horizontal ) {
+ if ( col+1 < nCols ) {
+ col++;
+ } else {
+ col = 0;
+ row++;
+ }
+ } else { //Vertical
+ if ( row+1 < nRows ) {
+ row++;
+ } else {
+ row = 0;
+ col++;
+ }
+ }
+}
+
+
+/*!
+ \internal
+
+ This private slot finds a widget in this group box that can accept
+ focus, and gives the focus to that widget.
+*/
+
+void QGroupBox::fixFocus()
+{
+ QFocusData * fd = focusData();
+ QWidget * orig = fd->home();
+ QWidget * best = 0;
+ QWidget * candidate = 0;
+ QWidget * w = orig;
+ do {
+ QWidget * p = w;
+ while( p && p != this && !p->isTopLevel() )
+ p = p->parentWidget();
+ if ( p == this && ( w->focusPolicy() & TabFocus ) == TabFocus
+ && w->isVisibleTo(this) ) {
+ if ( w->hasFocus()
+#ifndef QT_NO_RADIOBUTTON
+ || ( !best && ::qt_cast<QRadioButton*>(w)
+ && ((QRadioButton*)w)->isChecked() )
+#endif
+ )
+ // we prefer a checked radio button or a widget that
+ // already has focus, if there is one
+ best = w;
+ else if ( !candidate )
+ // but we'll accept anything that takes focus
+ candidate = w;
+ }
+ w = fd->next();
+ } while( w != orig );
+ if ( best )
+ best->setFocus();
+ else if ( candidate )
+ candidate->setFocus();
+}
+
+
+/*
+ Sets the right frame rect depending on the title. Also calculates
+ the visible part of the title.
+*/
+void QGroupBox::calculateFrame()
+{
+ lenvisible = str.length();
+
+ if ( lenvisible && !isCheckable() ) { // do we have a label?
+ QFontMetrics fm = fontMetrics();
+ while ( lenvisible ) {
+ int tw = fm.width( str, lenvisible ) + 4*fm.width(QChar(' '));
+ if ( tw < width() )
+ break;
+ lenvisible--;
+ }
+ if ( lenvisible ) { // but do we also have a visible label?
+ QRect r = rect();
+ int va = style().styleHint(QStyle::SH_GroupBox_TextLabelVerticalAlignment, this);
+ if(va & AlignVCenter)
+ r.setTop( fm.height()/2 ); // frame rect should be
+ else if(va & AlignTop)
+ r.setTop(fm.ascent());
+ setFrameRect( r ); // smaller than client rect
+ return;
+ }
+ } else if ( isCheckable() ) {
+#ifndef QT_NO_CHECKBOX
+ QRect r = rect();
+ int va = style().styleHint(QStyle::SH_GroupBox_TextLabelVerticalAlignment, this);
+ if( va & AlignVCenter )
+ r.setTop( d->checkbox->rect().height()/2 );
+ else if( va & AlignTop )
+ r.setTop( fontMetrics().ascent() );
+ setFrameRect( r );
+ return;
+#endif
+ }
+
+ // no visible label
+ setFrameRect( QRect(0,0,0,0) ); // then use client rect
+}
+
+
+
+/*! \reimp
+ */
+void QGroupBox::focusInEvent( QFocusEvent * )
+{ // note no call to super
+ fixFocus();
+}
+
+
+/*!\reimp
+ */
+void QGroupBox::fontChange( const QFont & oldFont )
+{
+ QWidget::fontChange( oldFont );
+#ifndef QT_NO_CHECKBOX
+ updateCheckBoxGeometry();
+#endif
+ calculateFrame();
+ setTextSpacer();
+}
+
+/*!
+ \reimp
+*/
+
+QSize QGroupBox::sizeHint() const
+{
+ QFontMetrics fm( font() );
+ int tw, th;
+ if ( isCheckable() ) {
+#ifndef QT_NO_CHECKBOX
+ tw = d->checkbox->sizeHint().width() + 2*fm.width( "xx" );
+ th = d->checkbox->sizeHint().height() + fm.width( QChar(' ') );
+#endif
+ } else {
+ tw = fm.width( title() ) + 2 * fm.width( "xx" );
+ th = fm.height() + fm.width( QChar(' ') );
+ }
+
+ QSize s;
+ if ( layout() ) {
+ s = QFrame::sizeHint();
+ return s.expandedTo( QSize( tw, 0 ) );
+ } else {
+ QRect r = childrenRect();
+ QSize s( 100, 50 );
+ s = s.expandedTo( QSize( tw, th ) );
+ if ( r.isNull() )
+ return s;
+
+ return s.expandedTo( QSize( r.width() + 2 * r.x(), r.height()+ 2 * r.y() ) );
+ }
+}
+
+/*!
+ \property QGroupBox::flat
+ \brief whether the group box is painted flat or has a frame
+
+ By default a group box has a surrounding frame, with the title
+ being placed on the upper frame line. In flat mode the right, left
+ and bottom frame lines are omitted, and only the thin line at the
+ top is drawn.
+
+ \sa title
+*/
+bool QGroupBox::isFlat() const
+{
+ return bFlat;
+}
+
+void QGroupBox::setFlat( bool b )
+{
+ if ( (bool)bFlat == b )
+ return;
+ bFlat = b;
+ update();
+}
+
+
+/*!
+ \property QGroupBox::checkable
+ \brief Whether the group box has a checkbox in its title.
+
+ If this property is TRUE, the group box has a checkbox. If the
+ checkbox is checked (which is the default), the group box's
+ children are enabled.
+
+ setCheckable() controls whether or not the group box has a
+ checkbox, and isCheckable() controls whether the checkbox is
+ checked or not.
+*/
+#ifndef QT_NO_CHECKBOX
+void QGroupBox::setCheckable( bool b )
+{
+ if ( (d->checkbox != 0) == b )
+ return;
+
+ if ( b ) {
+ if ( !d->checkbox ) {
+ d->checkbox = new QCheckBox( title(), this, "qt_groupbox_checkbox" );
+ if (QButtonGroup *meAsButtonGroup = ::qt_cast<QButtonGroup*>(this))
+ meAsButtonGroup->remove(d->checkbox);
+ setChecked( TRUE );
+ setChildrenEnabled( TRUE );
+ connect( d->checkbox, SIGNAL( toggled(bool) ),
+ this, SLOT( setChildrenEnabled(bool) ) );
+ connect( d->checkbox, SIGNAL( toggled(bool) ),
+ this, SIGNAL( toggled(bool) ) );
+ updateCheckBoxGeometry();
+ }
+ d->checkbox->show();
+ } else {
+ setChildrenEnabled( TRUE );
+ delete d->checkbox;
+ d->checkbox = 0;
+ }
+ calculateFrame();
+ setTextSpacer();
+ update();
+}
+#endif //QT_NO_CHECKBOX
+
+bool QGroupBox::isCheckable() const
+{
+#ifndef QT_NO_CHECKBOX
+ return ( d->checkbox != 0 );
+#else
+ return FALSE;
+#endif
+}
+
+
+bool QGroupBox::isChecked() const
+{
+#ifndef QT_NO_CHECKBOX
+ return d->checkbox && d->checkbox->isChecked();
+#else
+ return FALSE;
+#endif
+}
+
+
+/*!
+ \fn void QGroupBox::toggled( bool on )
+
+ If the group box has a check box (see \l isCheckable()) this signal
+ is emitted when the check box is toggled. \a on is TRUE if the check
+ box is checked; otherwise it is FALSE.
+*/
+
+/*!
+ \property QGroupBox::checked
+ \brief Whether the group box's checkbox is checked.
+
+ If the group box has a check box (see \l isCheckable()), and the
+ check box is checked (see \l isChecked()), the group box's children
+ are enabled. If the checkbox is unchecked the children are
+ disabled.
+*/
+#ifndef QT_NO_CHECKBOX
+void QGroupBox::setChecked( bool b )
+{
+ if ( d->checkbox )
+ d->checkbox->setChecked( b );
+}
+#endif
+
+/*
+ sets all children of the group box except the qt_groupbox_checkbox
+ to either disabled/enabled
+*/
+void QGroupBox::setChildrenEnabled( bool b )
+{
+ if ( !children() )
+ return;
+ QObjectListIt it( *children() );
+ QObject *o;
+ while( (o = it.current()) ) {
+ ++it;
+ if ( o->isWidgetType()
+#ifndef QT_NO_CHECKBOX
+ && o != d->checkbox
+#endif
+ ) {
+ QWidget *w = (QWidget*)o;
+ if ( b ) {
+ if ( !w->testWState( WState_ForceDisabled ) )
+ w->setEnabled( TRUE );
+ } else {
+ if ( w->isEnabled() ) {
+ w->setEnabled( FALSE );
+ ((QGroupBox*)w)->clearWState( WState_ForceDisabled );
+ }
+ }
+ }
+ }
+}
+
+/*! \reimp */
+void QGroupBox::setEnabled(bool on)
+{
+ QFrame::setEnabled(on);
+ if ( !d->checkbox || !on )
+ return;
+
+#ifndef QT_NO_CHECKBOX
+ // we are being enabled - disable children
+ if ( !d->checkbox->isChecked() )
+ setChildrenEnabled( FALSE );
+#endif
+}
+
+/*
+ recalculates and sets the checkbox setGeometry
+*/
+#ifndef QT_NO_CHECKBOX
+void QGroupBox::updateCheckBoxGeometry()
+{
+ if ( d->checkbox ) {
+ QSize cbSize = d->checkbox->sizeHint();
+ QRect cbRect( 0, 0, cbSize.width(), cbSize.height() );
+
+ int marg = bFlat ? 2 : 8;
+ marg += fontMetrics().width( QChar(' ') );
+
+ if ( align & AlignHCenter ) {
+ cbRect.moveCenter( frameRect().center() );
+ cbRect.moveTop( 0 );
+ } else if ( align & AlignRight ) {
+ cbRect.moveRight( frameRect().right() - marg );
+ } else if ( align & AlignLeft ) {
+ cbRect.moveLeft( frameRect().left() + marg );
+ } else { // auto align
+ if( QApplication::reverseLayout() )
+ cbRect.moveRight( frameRect().right() - marg );
+ else
+ cbRect.moveLeft( frameRect().left() + marg );
+ }
+
+ d->checkbox->setGeometry( cbRect );
+ }
+}
+#endif //QT_NO_CHECKBOX
+
+
+#endif //QT_NO_GROUPBOX