src/gui/widgets/qradiobutton.cpp
changeset 0 1918ee327afb
child 4 3b1da2848fc7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/gui/widgets/qradiobutton.cpp	Mon Jan 11 14:00:40 2010 +0000
@@ -0,0 +1,288 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtGui module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qradiobutton.h"
+#include "qapplication.h"
+#include "qbitmap.h"
+#include "qbuttongroup.h"
+#include "qstylepainter.h"
+#include "qstyle.h"
+#include "qstyleoption.h"
+#include "qevent.h"
+
+#include "private/qabstractbutton_p.h"
+
+QT_BEGIN_NAMESPACE
+
+class QRadioButtonPrivate : public QAbstractButtonPrivate
+{
+    Q_DECLARE_PUBLIC(QRadioButton)
+
+public:
+    QRadioButtonPrivate() : QAbstractButtonPrivate(QSizePolicy::RadioButton), hovering(true) {}
+    void init();
+    uint hovering : 1;
+};
+
+/*
+    Initializes the radio button.
+*/
+void QRadioButtonPrivate::init()
+{
+    Q_Q(QRadioButton);
+    q->setCheckable(true);
+    q->setAutoExclusive(true);
+    q->setMouseTracking(true);
+    q->setForegroundRole(QPalette::WindowText);
+    setLayoutItemMargins(QStyle::SE_RadioButtonLayoutItem);
+}
+
+/*!
+    \class QRadioButton
+    \brief The QRadioButton widget provides a radio button with a text label.
+
+    \ingroup basicwidgets
+
+
+    A QRadioButton is an option button that can be switched on (checked) or
+    off (unchecked). Radio buttons typically present the user with a "one
+    of many" choice. In a group of radio buttons only one radio button at
+    a time can be checked; if the user selects another button, the
+    previously selected button is switched off.
+
+    Radio buttons are autoExclusive by default. If auto-exclusive is
+    enabled, radio buttons that belong to the same parent widget
+    behave as if they were part of the same exclusive button group. If
+    you need multiple exclusive button groups for radio buttons that
+    belong to the same parent widget, put them into a QButtonGroup.
+
+    Whenever a button is switched on or off it emits the toggled() signal.
+    Connect to this signal if you want to trigger an action each time the
+    button changes state. Use isChecked() to see if a particular button is
+    selected.
+
+    Just like QPushButton, a radio button displays text, and
+    optionally a small icon. The icon is set with setIcon(). The text
+    can be set in the constructor or with setText(). A shortcut key
+    can be specified by preceding the preferred character with an
+    ampersand in the text. For example:
+
+    \snippet doc/src/snippets/code/src_gui_widgets_qradiobutton.cpp 0
+
+    In this example the shortcut is \e{Alt+c}. See the \l
+    {QShortcut#mnemonic}{QShortcut} documentation for details (to
+    display an actual ampersand, use '&&').
+
+    Important inherited members: text(), setText(), text(),
+    setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(),
+    toggle(), pressed(), released(), clicked(), and toggled().
+
+    \table 100%
+    \row \o \inlineimage plastique-radiobutton.png Screenshot of a Plastique radio button
+         \o A radio button shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}.
+    \row \o \inlineimage windows-radiobutton.png Screenshot of a Windows XP radio button
+         \o A radio button shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}.
+    \row \o \inlineimage macintosh-radiobutton.png Screenshot of a Macintosh radio button
+         \o A radio button shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
+    \endtable
+
+    \sa QPushButton, QToolButton, QCheckBox, {fowler}{GUI Design Handbook: Radio Button},
+        {Group Box Example}
+*/
+
+
+/*!
+    Constructs a radio button with the given \a parent, but with no text or
+    pixmap.
+
+    The \a parent argument is passed on to the QAbstractButton constructor.
+*/
+
+QRadioButton::QRadioButton(QWidget *parent)
+    : QAbstractButton(*new QRadioButtonPrivate, parent)
+{
+    Q_D(QRadioButton);
+    d->init();
+}
+
+/*!
+    Constructs a radio button with the given \a parent and a \a text string.
+
+    The \a parent argument is passed on to the QAbstractButton constructor.
+*/
+
+QRadioButton::QRadioButton(const QString &text, QWidget *parent)
+    : QAbstractButton(*new QRadioButtonPrivate, parent)
+{
+    Q_D(QRadioButton);
+    d->init();
+    setText(text);
+}
+
+/*!
+    Initialize \a option with the values from this QRadioButton. This method is useful
+    for subclasses when they need a QStyleOptionButton, but don't want to fill
+    in all the information themselves.
+
+    \sa QStyleOption::initFrom()
+*/
+void QRadioButton::initStyleOption(QStyleOptionButton *option) const
+{
+    if (!option)
+        return;
+    Q_D(const QRadioButton);
+    option->initFrom(this);
+    option->text = d->text;
+    option->icon = d->icon;
+    option->iconSize = iconSize();
+    if (d->down)
+        option->state |= QStyle::State_Sunken;
+    option->state |= (d->checked) ? QStyle::State_On : QStyle::State_Off;
+    if (testAttribute(Qt::WA_Hover) && underMouse()) {
+        if (d->hovering)
+            option->state |= QStyle::State_MouseOver;
+        else
+            option->state &= ~QStyle::State_MouseOver;
+    }
+}
+
+/*!
+    \reimp
+*/
+QSize QRadioButton::sizeHint() const
+{
+    Q_D(const QRadioButton);
+    if (d->sizeHint.isValid())
+        return d->sizeHint;
+    ensurePolished();
+    QStyleOptionButton opt;
+    initStyleOption(&opt);
+    QSize sz = style()->itemTextRect(fontMetrics(), QRect(0, 0, 1, 1), Qt::TextShowMnemonic,
+                                     false, text()).size();
+    if (!opt.icon.isNull())
+        sz = QSize(sz.width() + opt.iconSize.width() + 4, qMax(sz.height(), opt.iconSize.height()));
+    d->sizeHint = (style()->sizeFromContents(QStyle::CT_RadioButton, &opt, sz, this).
+                  expandedTo(QApplication::globalStrut()));
+    return d->sizeHint;
+}
+
+/*!
+    \reimp
+*/
+bool QRadioButton::hitButton(const QPoint &pos) const
+{
+    QStyleOptionButton opt;
+    initStyleOption(&opt);
+    return style()->subElementRect(QStyle::SE_RadioButtonClickRect, &opt, this).contains(pos);
+}
+
+/*!
+    \reimp
+*/
+void QRadioButton::mouseMoveEvent(QMouseEvent *e)
+{
+    Q_D(QRadioButton);
+    if (testAttribute(Qt::WA_Hover)) {
+        bool hit = false;
+        if (underMouse())
+            hit = hitButton(e->pos());
+
+        if (hit != d->hovering) {
+            update();
+            d->hovering = hit;
+        }
+    }
+
+    QAbstractButton::mouseMoveEvent(e);
+}
+
+/*!\reimp
+ */
+void QRadioButton::paintEvent(QPaintEvent *)
+{
+    QStylePainter p(this);
+    QStyleOptionButton opt;
+    initStyleOption(&opt);
+    p.drawControl(QStyle::CE_RadioButton, opt);
+}
+
+/*! \reimp */
+bool QRadioButton::event(QEvent *e)
+{
+    Q_D(QRadioButton);
+    if (e->type() == QEvent::StyleChange
+#ifdef Q_WS_MAC
+            || e->type() == QEvent::MacSizeChange
+#endif
+            )
+        d->setLayoutItemMargins(QStyle::SE_RadioButtonLayoutItem);
+    return QAbstractButton::event(e);
+}
+
+#ifdef QT3_SUPPORT
+/*!
+    Use one of the constructors that doesn't take the \a name
+    argument and then use setObjectName() instead.
+*/
+QRadioButton::QRadioButton(QWidget *parent, const char* name)
+    : QAbstractButton(*new QRadioButtonPrivate, parent)
+{
+    Q_D(QRadioButton);
+    d->init();
+    setObjectName(QString::fromAscii(name));
+}
+
+/*!
+    Use one of the constructors that doesn't take the \a name
+    argument and then use setObjectName() instead.
+*/
+QRadioButton::QRadioButton(const QString &text, QWidget *parent, const char* name)
+    : QAbstractButton(*new QRadioButtonPrivate, parent)
+{
+    Q_D(QRadioButton);
+    d->init();
+    setObjectName(QString::fromAscii(name));
+    setText(text);
+}
+
+#endif
+
+QT_END_NAMESPACE