summaryrefslogtreecommitdiffstats
path: root/src/widgets/widgets/qradiobutton.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/widgets/widgets/qradiobutton.cpp')
-rw-r--r--src/widgets/widgets/qradiobutton.cpp296
1 files changed, 296 insertions, 0 deletions
diff --git a/src/widgets/widgets/qradiobutton.cpp b/src/widgets/widgets/qradiobutton.cpp
new file mode 100644
index 0000000000..bb13017dbc
--- /dev/null
+++ b/src/widgets/widgets/qradiobutton.cpp
@@ -0,0 +1,296 @@
+/****************************************************************************
+**
+** Copyright (C) 2011 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(), 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
+*/
+QSize QRadioButton::minimumSizeHint() const
+{
+ return 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