/****************************************************************************** $Id: qt/src/widgets/qtoolbutton.cpp   2.3.12   edited 2005-10-27 $**** Implementation of QToolButton class**** Created : 980320**** 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 "qtoolbutton.h"#ifndef QT_NO_TOOLBUTTON#include "qdrawutil.h"#include "qpainter.h"#include "qpixmap.h"#include "qwmatrix.h"#include "qapplication.h"#include "qtooltip.h"#include "qtoolbar.h"#include "qimage.h"#include "qiconset.h"#include "qtimer.h"#include "qpopupmenu.h"#include "qguardedptr.h"#ifdef QT_KEYPAD_MODEextern bool qt_modalEditingEnabled;#endifstatic QToolButton * threeDeeButton = 0;class QToolButtonPrivate{    // ### add tool tip magic herepublic:#ifndef QT_NO_POPUPMENU    QGuardedPtr<QPopupMenu> popup;    QTimer* popupTimer;    int delay;#endif    bool autoraise, repeat;    Qt::ArrowType arrow;};// NOT REVISED/*!  \class QToolButton qtoolbutton.h  \brief The QToolButton class provides a quick-access button to  specific commands or options, usually used inside a QToolBar.  \ingroup basic  A tool button is a special button that provides quick-access to  specific commands or options. As opposed to a normal command button,  a tool button usually doesn't show a text label, but an icon.  Its  classic usage is to select tools, for example the "pen"-tool in a  drawing program. This would be implemented with a QToolButton as  toggle button (see setToggleButton() ).  QToolButton supports auto-raising. In auto-raise mode, the button  draws a 3D frame only when the mouse points at it.  The feature is  automatically turned on when a button is used inside a QToolBar.  Change it with setAutoRaise().  A tool button's icon is set as QIconSet. This makes it possible to  specify different pixmaps for the disabled and active state. The  disabled pixmap is used when the button's functionality is not  available. The active pixmap is displayed when the button is  auto-raised because the user is pointing at it.  The button's look and dimension is adjustable with  setUsesBigPixmap() and setUsesTextLabel(). When used inside a  QToolBar, the button automatically adjusts to QMainWindow's settings  (see QMainWindow::setUsesTextLabel() and  QMainWindow::setUsesBigPixmaps()).  A tool button can offer additional choices in a popup menu.  The  feature is sometimes used with the "Back" button in a web browsers:  After pressing the button down for a while, a menu pops up showing  all possible pages to browse back.  With QToolButton, you can set a  popup menu using setPopup(). The default delay is 600ms, you may  adjust it with setPopupDelay().  \sa QPushButton QToolBar QMainWindow  <a href="guibooks.html#fowler">GUI Design Handbook: Push Button</a>*//*!  Constructs an empty tool button.*/QToolButton::QToolButton( QWidget * parent, const char *name )    : QButton( parent, name ){    init();#ifndef QT_NO_TOOLBAR    if ( parent && parent->inherits( "QToolBar" ) ) {	setAutoRaise( TRUE );	QToolBar* tb = (QToolBar*)parent;	if ( tb->mainWindow() ) {	    connect( tb->mainWindow(), SIGNAL(pixmapSizeChanged(bool)),	             this, SLOT(setUsesBigPixmap(bool)) );	    setUsesBigPixmap( tb->mainWindow()->usesBigPixmaps() );	    connect( tb->mainWindow(), SIGNAL(usesTextLabelChanged(bool)),	             this, SLOT(setUsesTextLabel(bool)) );	    setUsesTextLabel( tb->mainWindow()->usesTextLabel() );	} else {	    setUsesBigPixmap( FALSE );	}    } else#endif    {	setUsesBigPixmap( FALSE );    }}/*!  Constructs a tool button as arrow button. The ArrowType \a type  defines the arrow direction. Possible values are LeftArrow,  RightArrow, UpArrow and DownArrow.  An arrow button has auto repeat turned on.  The \a parent and \a name arguments are sent to the QWidget constructor.*/QToolButton::QToolButton( ArrowType type, QWidget *parent, const char *name )    : QButton( parent, name ){    init();    setUsesBigPixmap( FALSE );    setAutoRepeat( TRUE );    d->arrow = type;    hasArrow = TRUE;}/*!  Set-up code common to all the constructors */void QToolButton::init(){    d = new QToolButtonPrivate;#ifndef QT_NO_POPUPMENU    d->delay = 600;    d->popup = 0;    d->popupTimer = 0;#endif    d->autoraise = FALSE;    d->arrow = LeftArrow;    bpID = bp.serialNumber();    spID = sp.serialNumber();    utl = FALSE;    ubp = TRUE;    hasArrow = FALSE;    s = 0;    son = 0;#ifdef QT_KEYPAD_MODE    if( !qt_modalEditingEnabled )#endif    setFocusPolicy( NoFocus );    setBackgroundMode( PaletteButton);    setSizePolicy( QSizePolicy( QSizePolicy::Minimum, QSizePolicy::Minimum ) );}#ifndef QT_NO_TOOLBAR/*!  Constructs a tool button that is a child of \a parent (which must be  a QToolBar) and named \a name.  The tool button will display \a pm, with text label or tool tip \a  textLabel and status-bar message \a grouptext, connected to \a slot  in object \a receiver, and returns the button.*/QToolButton::QToolButton( const QPixmap &pm, const QString &textLabel,			  const QString &grouptext,			  QObject * receiver, const char *slot,			  QToolBar * parent, const char *name )    : QButton( parent, name ){    init();    setAutoRaise( TRUE );    setPixmap( pm );    setTextLabel( textLabel );    if ( receiver && slot )	connect( this, SIGNAL(clicked()), receiver, slot );    if ( parent->mainWindow() ) {	connect( parent->mainWindow(), SIGNAL(pixmapSizeChanged(bool)),		 this, SLOT(setUsesBigPixmap(bool)) );	setUsesBigPixmap( parent->mainWindow()->usesBigPixmaps() );	connect( parent->mainWindow(), SIGNAL(usesTextLabelChanged(bool)),		 this, SLOT(setUsesTextLabel(bool)) );	setUsesTextLabel( parent->mainWindow()->usesTextLabel() );    } else {	setUsesBigPixmap( FALSE );    }#ifndef QT_NO_TOOLTIP    if ( !textLabel.isEmpty() ) {	if ( !grouptext.isEmpty() )	    QToolTip::add( this, textLabel,			   parent->mainWindow()->toolTipGroup(), grouptext );	else	    QToolTip::add( this, textLabel );    }#endif	}/*!  Constructs a tool button that is a child of \a parent (which must be  a QToolBar) and named \a name.  The tool button will display \a iconSet, with text label or tool tip \a  textLabel and status-bar message \a grouptext, connected to \a slot  in object \a receiver, and returns the button.*/QToolButton::QToolButton( const QIconSet& iconSet, const QString &textLabel,			  const QString& grouptext,			  QObject * receiver, const char *slot,			  QToolBar * parent, const char *name )    : QButton( parent, name ){    init();    setAutoRaise( TRUE );    setIconSet( iconSet );    setTextLabel( textLabel );    if ( receiver && slot )	connect( this, SIGNAL(clicked()), receiver, slot );    if ( parent->mainWindow() ) {	connect( parent->mainWindow(), SIGNAL(pixmapSizeChanged(bool)),		 this, SLOT(setUsesBigPixmap(bool)) );	setUsesBigPixmap( parent->mainWindow()->usesBigPixmaps() );	connect( parent->mainWindow(), SIGNAL(usesTextLabelChanged(bool)),		 this, SLOT(setUsesTextLabel(bool)) );	setUsesTextLabel( parent->mainWindow()->usesTextLabel() );    } else {	setUsesBigPixmap( FALSE );    }#ifndef QT_NO_TOOLTIP    if ( !textLabel.isEmpty() ) {	if ( !grouptext.isEmpty() )	    QToolTip::add( this, textLabel,			   parent->mainWindow()->toolTipGroup(), grouptext );	else	    QToolTip::add( this, textLabel );    }#endif}#endif/*! Destroys the object and frees any allocated resources. */QToolButton::~QToolButton(){#ifndef QT_NO_POPUPMENU    d->popupTimer = 0;    d->popup = 0;#endif    delete d;    delete s;    delete son;    threeDeeButton = 0;}/*!  Makes the tool button a toggle button if \e enable is TRUE, or a normal  tool button if \e enable is FALSE.  Toggle buttons have an on/off state similar to \link QCheckBox check  boxes. \endlink A tool button is initially not a toggle button.  \sa setOn(), toggle(), isToggleButton() toggled()*/void QToolButton::setToggleButton( bool enable ){    QButton::setToggleButton( enable );}/*!  \reimp*/QSize QToolButton::sizeHint() const{    constPolish();    int w = 0;    int h = 0;    if ( !text().isNull()) {	w = fontMetrics().width( text() );	h = fontMetrics().height(); // boundingRect()?    } else if ( usesBigPixmap() ) {	QPixmap pm = iconSet(TRUE).pixmap(QIconSet::Large, QIconSet::Normal);	w = pm.width();	h = pm.height();	if ( w < 32 )	    w = 32;	if ( h < 32 )	    h = 32;    } else {	w = h = 16;	QPixmap pm = iconSet(TRUE).pixmap(QIconSet::Small, QIconSet::Normal);	w = pm.width();	h = pm.height();#ifndef _WS_QWS_ // shouldn't be on any platform...	if ( w < 16 )	    w = 16;	if ( h < 16 )	    h = 16;#endif    }    if ( usesTextLabel() ) {	h += 4 + fontMetrics().height();	int tw = fontMetrics().width( textLabel() ) + fontMetrics().width("  ");	if ( tw > w )	    w = tw;    }    return QSize( w + 7, h + 6 ).expandedTo( QApplication::globalStrut() );}/*!\reimp*/QSizePolicy QToolButton::sizePolicy() const{    //### removeme 3.0    return QWidget::sizePolicy();}/* \fn bool QToolButton::usesBigPixmap() const  Returns TRUE or FALSE.*//* \fn bool QToolButton::usesTextLabel() const  Returns TRUE or FALSE.*//*! \fn QString QToolButton::textLabel() const  Returns the text label in use by this tool button, or 0.  \sa setTextLabel() usesTextLabel() setUsesTextLabel() setText()*//*!  Sets this button to use the big pixmaps provided by its QIconSet  if \a enable is TRUE, and to use the small ones else.  QToolButton automatically connects this slot to the relevant signal  in the QMainWindow in which it resides.  You're strongly urged to  use QMainWindow::setUsesBigPixmaps() instead.  \warning If you set some buttons (in a QMainWindow) to have big and  others small pixmaps, QMainWindow may have trouble getting the  geometry correct.*/void QToolButton::setUsesBigPixmap( bool enable ){    if ( (bool)ubp == enable )	return;    ubp = enable;    if ( isVisible() ) {	update();	updateGeometry();    }}/*!  \fn bool QToolButton::usesBigPixmap() const  Returns TRUE if this tool button uses the big (32-pixel) pixmaps,  and FALSE if it does not.  \sa setUsesBigPixmap(), setPixmap(),  usesTextLabel*//*!  Sets this button to draw a text label below the icon if \a enable  is TRUE, and to not draw it if \a enable is FALSE.  QToolButton automatically connects this slot to the relevant signal  in the QMainWindow in which is resides.*/void QToolButton::setUsesTextLabel( bool enable ){    if ( (bool)utl == enable )	return;    utl = enable;    if ( isVisible() ) {	update();	updateGeometry();    }}/*! \fn bool QToolButton::usesTextLabel() const