Add Qt3 development HEAD version

1 files changed, 760 insertions, 0 deletions

diff --git a/src/widgets/qpushbutton.cpp b/src/widgets/qpushbutton.cpp
new file mode 100644
index 0000000..e3db3f7
--- /dev/null
+++ b/src/widgets/qpushbutton.cpp
@@ -0,0 +1,760 @@
+/****************************************************************************
+**
+** Implementation of QPushButton class
+**
+** Created : 940221
+**
+** 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 "qpushbutton.h"
+#ifndef QT_NO_PUSHBUTTON
+#include "qdialog.h"
+#include "qfontmetrics.h"
+#include "qpainter.h"
+#include "qdrawutil.h"
+#include "qpixmap.h"
+#include "qbitmap.h"
+#include "qpopupmenu.h"
+#include "qguardedptr.h"
+#include "qapplication.h"
+#include "qtoolbar.h"
+#include "qstyle.h"
+#if defined(QT_ACCESSIBILITY_SUPPORT)
+#include "qaccessible.h"
+#endif
+
+/*!
+    \class QPushButton qpushbutton.h
+    \brief The QPushButton widget provides a command button.
+
+    \ingroup basic
+    \mainclass
+
+    The push button, or command button, is perhaps the most commonly
+    used widget in any graphical user interface. Push (click) a button
+    to command the computer to perform some action, or to answer a
+    question. Typical buttons are OK, Apply, Cancel, Close, Yes, No
+    and Help.
+
+    A command button is rectangular and typically displays a text
+    label describing its action. An underlined character in the label
+    (signified by preceding it with an ampersand in the text)
+    indicates an accelerator key, e.g.
+    \code
+	QPushButton *pb = new QPushButton( "&Download", this );
+    \endcode
+    In this example the accelerator is \e{Alt+D}, and the label text
+    will be displayed as <b><u>D</u>ownload</b>.
+
+    Push buttons can display a textual label or a pixmap, and
+    optionally a small icon. These can be set using the constructors
+    and changed later using setText(), setPixmap() and setIconSet().
+    If the button is disabled the appearance of the text or pixmap and
+    iconset will be manipulated with respect to the GUI style to make
+    the button look "disabled".
+
+    A push button emits the signal clicked() when it is activated by
+    the mouse, the Spacebar or by a keyboard accelerator. Connect to
+    this signal to perform the button's action. Push buttons also
+    provide less commonly used signals, for example, pressed() and
+    released().
+
+    Command buttons in dialogs are by default auto-default buttons,
+    i.e. they become the default push button automatically when they
+    receive the keyboard input focus. A default button is a push
+    button that is activated when the user presses the Enter or Return
+    key in a dialog. You can change this with setAutoDefault(). Note
+    that auto-default buttons reserve a little extra space which is
+    necessary to draw a default-button indicator. If you do not want
+    this space around your buttons, call setAutoDefault(FALSE).
+
+    Being so central, the button widget has grown to accommodate a
+    great many variations in the past decade. The Microsoft style
+    guide now shows about ten different states of Windows push buttons
+    and the text implies that there are dozens more when all the
+    combinations of features are taken into consideration.
+
+    The most important modes or states are:
+    \list
+    \i Available or not (grayed out, disabled).
+    \i Standard push button, toggling push button or menu button.
+    \i On or off (only for toggling push buttons).
+    \i Default or normal. The default button in a dialog can generally
+       be "clicked" using the Enter or Return key.
+    \i Auto-repeat or not.
+    \i Pressed down or not.
+    \endlist
+
+    As a general rule, use a push button when the application or
+    dialog window performs an action when the user clicks on it (such
+    as Apply, Cancel, Close and Help) \e and when the widget is
+    supposed to have a wide, rectangular shape with a text label.
+    Small, typically square buttons that change the state of the
+    window rather than performing an action (such as the buttons in
+    the top-right corner of the QFileDialog) are not command buttons,
+    but tool buttons. Qt provides a special class (QToolButton) for
+    these buttons.
+
+    If you need toggle behavior (see setToggleButton()) or a button
+    that auto-repeats the activation signal when being pushed down
+    like the arrows in a scroll bar (see setAutoRepeat()), a command
+    button is probably not what you want. When in doubt, use a tool
+    button.
+
+    A variation of a command button is a menu button. These provide
+    not just one command, but several, since when they are clicked
+    they pop up a menu of options. Use the method setPopup() to
+    associate a popup menu with a push button.
+
+    Other classes of buttons are option buttons (see QRadioButton) and
+    check boxes (see QCheckBox).
+
+    <img src="qpushbt-m.png"> <img src="qpushbt-w.png">
+
+    In Qt, the QButton abstract base class provides most of the modes
+    and other API, and QPushButton provides GUI logic. See QButton for
+    more information about the API.
+
+    \important text, setText, text, pixmap, setPixmap, accel, setAccel,
+    isToggleButton, setDown, isDown, isOn, state, autoRepeat,
+    isExclusiveToggle, group, setAutoRepeat, toggle, pressed, released,
+    clicked, toggled, state stateChanged
+
+    \sa QToolButton, QRadioButton QCheckBox
+    \link guibooks.html#fowler GUI Design Handbook: Push Button\endlink
+*/
+
+/*!
+    \property QPushButton::autoDefault
+    \brief whether the push button is the auto default button
+
+    If this property is set to TRUE then the push button is the auto
+    default button in a dialog.
+
+    In some GUI styles a default button is drawn with an extra frame
+    around it, up to 3 pixels or more. Qt automatically keeps this
+    space free around auto-default buttons, i.e. auto-default buttons
+    may have a slightly larger size hint.
+
+    This property's default is TRUE for buttons that have a QDialog
+    parent; otherwise it defaults to FALSE.
+
+    See the \l default property for details of how \l default and
+    auto-default interact.
+*/
+
+/*!
+    \property QPushButton::autoMask
+    \brief whether the button is automatically masked
+
+    \sa QWidget::setAutoMask()
+*/
+
+/*!
+    \property QPushButton::default
+    \brief whether the push button is the default button
+
+    If this property is set to TRUE then the push button will be
+    pressed if the user presses the Enter (or Return) key in a dialog.
+
+    Regardless of focus, if the user presses Enter: If there is a
+    default button the default button is pressed; otherwise, if
+    there are one or more \l autoDefault buttons the first \l autoDefault
+    button that is next in the tab order is pressed. If there are no
+    default or \l autoDefault buttons only pressing Space on a button
+    with focus, mouse clicking, or using an accelerator will press a
+    button.
+
+    In a dialog, only one push button at a time can be the default
+    button. This button is then displayed with an additional frame
+    (depending on the GUI style).
+
+    The default button behavior is provided only in dialogs. Buttons
+    can always be clicked from the keyboard by pressing Enter (or
+    Return) or the Spacebar when the button has focus.
+
+    This property's default is FALSE.
+*/
+
+/*!
+    \property QPushButton::flat
+    \brief whether the border is disabled
+
+    This property's default is FALSE.
+*/
+
+/*!
+    \property QPushButton::iconSet
+    \brief the icon set on the push button
+
+    This property will return 0 if the push button has no iconset.
+*/
+
+/*!
+    \property QPushButton::on
+    \brief whether the push button is toggled
+
+    This property should only be set for toggle push buttons. The
+    default value is FALSE.
+
+    \sa isOn(), toggle(), toggled(), isToggleButton()
+*/
+
+/*!
+    \property QPushButton::toggleButton
+    \brief whether the button is a toggle button
+
+    Toggle buttons have an on/off state similar to \link QCheckBox
+    check boxes. \endlink A push button is initially not a toggle
+    button.
+
+    \sa setOn(), toggle(), isToggleButton() toggled()
+*/
+
+/*! \property QPushButton::menuButton
+    \brief whether the push button has a menu button on it
+    \obsolete
+
+  If this property is set to TRUE, then a down arrow is drawn on the push
+  button to indicate that a menu will pop up if the user clicks on the
+  arrow.
+*/
+
+class QPushButtonPrivate
+{
+public:
+    QPushButtonPrivate()
+	:iconset( 0 )
+    {}
+    ~QPushButtonPrivate()
+    {
+#ifndef QT_NO_ICONSET
+	delete iconset;
+#endif
+    }
+#ifndef QT_NO_POPUPMENU
+    QGuardedPtr<QPopupMenu> popup;
+#endif
+    QIconSet* iconset;
+};
+
+
+/*!
+    Constructs a push button with no text.
+
+    The \a parent and \a name arguments are sent on to the QWidget
+    constructor.
+*/
+
+QPushButton::QPushButton( QWidget *parent, const char *name )
+	: QButton( parent, name )
+{
+    init();
+}
+
+/*!
+    Constructs a push button called \a name with the parent \a parent
+    and the text \a text.
+*/
+
+QPushButton::QPushButton( const QString &text, QWidget *parent,
+			  const char *name )
+	: QButton( parent, name )
+{
+    init();
+    setText( text );
+}
+
+
+/*!
+    Constructs a push button with an \a icon and a \a text.
+
+    Note that you can also pass a QPixmap object as an icon (thanks to
+    the implicit type conversion provided by C++).
+
+    The \a parent and \a name arguments are sent to the QWidget
+    constructor.
+*/
+#ifndef QT_NO_ICONSET
+QPushButton::QPushButton( const QIconSet& icon, const QString &text,
+			  QWidget *parent, const char *name )
+	: QButton( parent, name )
+{
+    init();
+    setText( text );
+    setIconSet( icon );
+}
+#endif
+
+
+/*!
+    Destroys the push button.
+*/
+QPushButton::~QPushButton()
+{
+    delete d;
+}
+
+void QPushButton::init()
+{
+    d = 0;
+    defButton = FALSE;
+    lastEnabled = FALSE;
+    hasMenuArrow = FALSE;
+    flt = FALSE;
+#ifndef QT_NO_DIALOG
+    autoDefButton = ::qt_cast<QDialog*>(topLevelWidget()) != 0;
+#else
+    autoDefButton = FALSE;
+#endif
+    setBackgroundMode( PaletteButton );
+    setSizePolicy( QSizePolicy( QSizePolicy::Minimum, QSizePolicy::Fixed ) );
+}
+
+
+/*
+  Makes the push button a toggle button if \a enable is TRUE or a normal
+  push button if \a enable is FALSE.
+
+  Toggle buttons have an on/off state similar to \link QCheckBox check
+  boxes. \endlink A push button is initially not a toggle button.
+
+  \sa setOn(), toggle(), isToggleButton() toggled()
+*/
+
+void QPushButton::setToggleButton( bool enable )
+{
+    QButton::setToggleButton( enable );
+}
+
+
+/*
+  Switches a toggle button on if \a enable is TRUE or off if \a enable is
+  FALSE.
+  \sa isOn(), toggle(), toggled(), isToggleButton()
+*/
+
+void QPushButton::setOn( bool enable )
+{
+    if ( !isToggleButton() )
+	return;
+    QButton::setOn( enable );
+}
+
+void QPushButton::setAutoDefault( bool enable )
+{
+    if ( (bool)autoDefButton == enable )
+	return;
+    autoDefButton = enable;
+    update();
+    updateGeometry();
+}
+
+
+void QPushButton::setDefault( bool enable )
+{
+    if ( (bool)defButton == enable )
+	return;					// no change
+    defButton = enable;
+#ifndef QT_NO_DIALOG
+    if ( defButton && ::qt_cast<QDialog*>(topLevelWidget()) )
+ 	((QDialog*)topLevelWidget())->setMainDefault( this );
+#endif
+    update();
+#if defined(QT_ACCESSIBILITY_SUPPORT)
+    QAccessible::updateAccessibility( this, 0, QAccessible::StateChanged );
+#endif
+}
+
+
+/*!
+    \reimp
+*/
+QSize QPushButton::sizeHint() const
+{
+    constPolish();
+
+    int w = 0, h = 0;
+
+    // calculate contents size...
+#ifndef QT_NO_ICONSET
+    if ( iconSet() && !iconSet()->isNull() ) {
+	int iw = iconSet()->pixmap( QIconSet::Small, QIconSet::Normal ).width() + 4;
+	int ih = iconSet()->pixmap( QIconSet::Small, QIconSet::Normal ).height();
+	w += iw;
+	h = QMAX( h, ih );
+    }
+#endif
+    if ( isMenuButton() )
+	w += style().pixelMetric(QStyle::PM_MenuButtonIndicator, this);
+
+    if ( pixmap() ) {
+	QPixmap *pm = (QPixmap *)pixmap();
+	w += pm->width();
+	h += pm->height();
+    } else {
+	QString s( text() );
+	bool empty = s.isEmpty();
+	if ( empty )
+	    s = QString::fromLatin1("XXXX");
+	QFontMetrics fm = fontMetrics();
+	QSize sz = fm.size( ShowPrefix, s );
+	if(!empty || !w)
+	    w += sz.width();
+	if(!empty || !h)
+	    h = QMAX(h, sz.height());
+    }
+
+    return (style().sizeFromContents(QStyle::CT_PushButton, this, QSize(w, h)).
+	    expandedTo(QApplication::globalStrut()));
+}
+
+
+/*!
+    \reimp
+*/
+void QPushButton::move( int x, int y )
+{
+    QWidget::move( x, y );
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::move( const QPoint &p )
+{
+    move( p.x(), p.y() );
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::resize( int w, int h )
+{
+    QWidget::resize( w, h );
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::resize( const QSize &s )
+{
+    resize( s.width(), s.height() );
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::setGeometry( int x, int y, int w, int h )
+{
+    QWidget::setGeometry( x, y, w, h );
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::setGeometry( const QRect &r )
+{
+    QWidget::setGeometry( r );
+}
+
+/*!
+    \reimp
+ */
+void QPushButton::resizeEvent( QResizeEvent * )
+{
+    if ( autoMask() )
+	updateMask();
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::drawButton( QPainter *paint )
+{
+    int diw = 0;
+    if ( isDefault() || autoDefault() ) {
+	diw = style().pixelMetric(QStyle::PM_ButtonDefaultIndicator, this);
+
+	if ( diw > 0 ) {
+	    if (backgroundMode() == X11ParentRelative) {
+		erase( 0, 0, width(), diw );
+		erase( 0, 0, diw, height() );
+		erase( 0, height() - diw, width(), diw );
+		erase( width() - diw, 0, diw, height() );
+	    } else if ( parentWidget() && parentWidget()->backgroundPixmap() ){
+		// pseudo tranparency
+		paint->drawTiledPixmap( 0, 0, width(), diw,
+					*parentWidget()->backgroundPixmap(),
+					x(), y() );
+		paint->drawTiledPixmap( 0, 0, diw, height(),
+					*parentWidget()->backgroundPixmap(),
+					x(), y() );
+		paint->drawTiledPixmap( 0, height()-diw, width(), diw,
+					*parentWidget()->backgroundPixmap(),
+					x(), y()+height() );
+		paint->drawTiledPixmap( width()-diw, 0, diw, height(),
+					*parentWidget()->backgroundPixmap(),
+					x()+width(), y() );
+	    } else {
+		paint->fillRect( 0, 0, width(), diw,
+				 colorGroup().brush(QColorGroup::Background) );
+		paint->fillRect( 0, 0, diw, height(),
+				 colorGroup().brush(QColorGroup::Background) );
+		paint->fillRect( 0, height()-diw, width(), diw,
+				 colorGroup().brush(QColorGroup::Background) );
+		paint->fillRect( width()-diw, 0, diw, height(),
+				 colorGroup().brush(QColorGroup::Background) );
+	    }
+
+	}
+    }
+
+    QStyle::SFlags flags = QStyle::Style_Default;
+    if (isEnabled())
+	flags |= QStyle::Style_Enabled;
+    if (hasFocus())
+	flags |= QStyle::Style_HasFocus;
+    if (isDown())
+	flags |= QStyle::Style_Down;
+    if (isOn())
+	flags |= QStyle::Style_On;
+    if (! isFlat() && ! isDown())
+	flags |= QStyle::Style_Raised;
+    if (isDefault())
+	flags |= QStyle::Style_ButtonDefault;
+
+    style().drawControl(QStyle::CE_PushButton, paint, this, rect(), colorGroup(), flags);
+    drawButtonLabel( paint );
+
+    lastEnabled = isEnabled();
+}
+
+
+/*!
+    \reimp
+*/
+void QPushButton::drawButtonLabel( QPainter *paint )
+{
+
+    QStyle::SFlags flags = QStyle::Style_Default;
+    if (isEnabled())
+	flags |= QStyle::Style_Enabled;
+    if (hasFocus())
+	flags |= QStyle::Style_HasFocus;
+    if (isDown())
+	flags |= QStyle::Style_Down;
+    if (isOn())
+	flags |= QStyle::Style_On;
+    if (! isFlat() && ! isDown())
+	flags |= QStyle::Style_Raised;
+    if (isDefault())
+	flags |= QStyle::Style_ButtonDefault;
+
+    style().drawControl(QStyle::CE_PushButtonLabel, paint, this,
+			style().subRect(QStyle::SR_PushButtonContents, this),
+			colorGroup(), flags);
+}
+
+
+/*!
+    \reimp
+ */
+void QPushButton::updateMask()
+{
+    QBitmap bm( size() );
+    bm.fill( color0 );
+
+    {
+	QPainter p( &bm, this );
+	style().drawControlMask(QStyle::CE_PushButton, &p, this, rect());
+    }
+
+    setMask( bm );
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::focusInEvent( QFocusEvent *e )
+{
+    if (autoDefButton && !defButton) {
+	defButton = TRUE;
+#ifndef QT_NO_DIALOG
+	if ( defButton && ::qt_cast<QDialog*>(topLevelWidget()) )
+ 	    ((QDialog*)topLevelWidget())->setDefault( this );
+#endif
+    }
+    QButton::focusInEvent( e );
+}
+
+/*!
+    \reimp
+*/
+void QPushButton::focusOutEvent( QFocusEvent *e )
+{
+#ifndef QT_NO_DIALOG
+    if ( defButton && autoDefButton ) {
+	if ( ::qt_cast<QDialog*>(topLevelWidget()) )
+	    ((QDialog*)topLevelWidget())->setDefault( 0 );
+    }
+#endif
+
+    QButton::focusOutEvent( e );
+#ifndef QT_NO_POPUPMENU
+    if ( popup() && popup()->isVisible() )	// restore pressed status
+	setDown( TRUE );
+#endif
+}
+
+
+#ifndef QT_NO_POPUPMENU
+/*!
+    Associates the popup menu \a popup with this push button. This
+    turns the button into a menu button.
+
+    Ownership of the popup menu is \e not transferred to the push
+    button.
+
+    \sa popup()
+*/
+void QPushButton::setPopup( QPopupMenu* popup )
+{
+    if ( !d )
+	d = new QPushButtonPrivate;
+    if ( popup && !d->popup )
+	connect( this, SIGNAL( pressed() ), this, SLOT( popupPressed() ) );
+
+    d->popup = popup;
+    setIsMenuButton( popup != 0 );
+}
+#endif //QT_NO_POPUPMENU
+#ifndef QT_NO_ICONSET
+void QPushButton::setIconSet( const QIconSet& icon )
+{
+    if ( !d )
+	d = new QPushButtonPrivate;
+    if ( !icon.isNull() ) {
+	if ( d->iconset )
+	    *d->iconset = icon;
+	else
+	    d->iconset = new QIconSet( icon );
+    } else if ( d->iconset) {
+	delete d->iconset;
+	d->iconset = 0;
+    }
+
+    update();
+    updateGeometry();
+}
+
+
+QIconSet* QPushButton::iconSet() const
+{
+    return d ? d->iconset : 0;
+}
+#endif // QT_NO_ICONSET
+#ifndef QT_NO_POPUPMENU
+/*!
+    Returns the button's associated popup menu or 0 if no popup menu
+    has been set.
+
+    \sa setPopup()
+*/
+QPopupMenu* QPushButton::popup() const
+{
+    return d ? (QPopupMenu*)d->popup : 0;
+}
+
+void QPushButton::popupPressed()
+{
+    QPopupMenu* popup = d ? (QPopupMenu*) d->popup : 0;
+    QGuardedPtr<QPushButton> that = this;
+    if ( isDown() && popup ) {
+	bool horizontal = TRUE;
+	bool topLeft = TRUE;			// ### always TRUE
+#ifndef QT_NO_TOOLBAR
+	QToolBar *tb = ::qt_cast<QToolBar*>(parentWidget());
+	if ( tb && tb->orientation() == Vertical )
+	    horizontal = FALSE;
+#endif
+	if ( horizontal ) {
+	    if ( topLeft ) {
+		if ( mapToGlobal( QPoint( 0, rect().bottom() ) ).y() + popup->sizeHint().height() <= qApp->desktop()->height() )
+		    popup->exec( mapToGlobal( rect().bottomLeft() ) );
+		else
+		    popup->exec( mapToGlobal( rect().topLeft() - QPoint( 0, popup->sizeHint().height() ) ) );
+	    } else {
+		QSize sz( popup->sizeHint() );
+		QPoint p = mapToGlobal( rect().topLeft() );
+		p.ry() -= sz.height();
+		popup->exec( p );
+	    }
+	} else {
+	    if ( topLeft ) {
+		if ( mapToGlobal( QPoint( rect().right(), 0 ) ).x() + popup->sizeHint().width() <= qApp->desktop()->width() )
+		    popup->exec( mapToGlobal( rect().topRight() ) );
+		else
+		    popup->exec( mapToGlobal( rect().topLeft() - QPoint( popup->sizeHint().width(), 0 ) ) );
+	    } else {
+		QSize sz( popup->sizeHint() );
+		QPoint p = mapToGlobal( rect().topLeft() );
+		p.rx() -= sz.width();
+		popup->exec( p );
+	    }
+	}
+        if (that)
+            setDown( FALSE );
+    }
+}
+#endif
+
+void QPushButton::setFlat( bool f )
+{
+    flt = f;
+    update();
+}
+
+bool QPushButton::isFlat() const
+{
+    return flt;
+}
+
+/*!
+    \obsolete
+    \fn virtual void QPushButton::setIsMenuButton( bool enable )
+*/
+
+#endif