1 | /**************************************************************************** |
2 | ** |
3 | ** Copyright (C) 2017 The Qt Company Ltd. |
4 | ** Contact: http://www.qt.io/licensing/ |
5 | ** |
6 | ** This file is part of the Qt Quick Templates 2 module of the Qt Toolkit. |
7 | ** |
8 | ** $QT_BEGIN_LICENSE:LGPL3$ |
9 | ** Commercial License Usage |
10 | ** Licensees holding valid commercial Qt licenses may use this file in |
11 | ** accordance with the commercial license agreement provided with the |
12 | ** Software or, alternatively, in accordance with the terms contained in |
13 | ** a written agreement between you and The Qt Company. For licensing terms |
14 | ** and conditions see http://www.qt.io/terms-conditions. For further |
15 | ** information use the contact form at http://www.qt.io/contact-us. |
16 | ** |
17 | ** GNU Lesser General Public License Usage |
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser |
19 | ** General Public License version 3 as published by the Free Software |
20 | ** Foundation and appearing in the file LICENSE.LGPLv3 included in the |
21 | ** packaging of this file. Please review the following information to |
22 | ** ensure the GNU Lesser General Public License version 3 requirements |
23 | ** will be met: https://www.gnu.org/licenses/lgpl.html. |
24 | ** |
25 | ** GNU General Public License Usage |
26 | ** Alternatively, this file may be used under the terms of the GNU |
27 | ** General Public License version 2.0 or later as published by the Free |
28 | ** Software Foundation and appearing in the file LICENSE.GPL included in |
29 | ** the packaging of this file. Please review the following information to |
30 | ** ensure the GNU General Public License version 2.0 requirements will be |
31 | ** met: http://www.gnu.org/licenses/gpl-2.0.html. |
32 | ** |
33 | ** $QT_END_LICENSE$ |
34 | ** |
35 | ****************************************************************************/ |
36 | |
37 | #include "qquickradiobutton_p.h" |
38 | #include "qquickcontrol_p_p.h" |
39 | |
40 | #include <QtGui/qpa/qplatformtheme.h> |
41 | |
42 | QT_BEGIN_NAMESPACE |
43 | |
44 | /*! |
45 | \qmltype RadioButton |
46 | \inherits AbstractButton |
47 | //! \instantiates QQuickRadioButton |
48 | \inqmlmodule QtQuick.Controls |
49 | \since 5.7 |
50 | \ingroup qtquickcontrols2-buttons |
51 | \brief Exclusive radio button that can be toggled on or off. |
52 | |
53 | \image qtquickcontrols2-radiobutton.gif |
54 | |
55 | RadioButton presents an option button that can be toggled on (checked) or |
56 | off (unchecked). Radio buttons are typically used to select one option |
57 | from a set of options. |
58 | |
59 | RadioButton inherits its API from \l AbstractButton. For instance, |
60 | you can set \l {AbstractButton::text}{text} and react to |
61 | \l {AbstractButton::clicked}{clicks} using the AbstractButton API. |
62 | The state of the radio button can be set with the |
63 | \l {AbstractButton::}{checked} property. |
64 | |
65 | Radio buttons are \l {AbstractButton::autoExclusive}{auto-exclusive} |
66 | by default. Only one button can be checked at any time amongst radio |
67 | buttons that belong to the same parent item; checking another button |
68 | automatically unchecks the previously checked one. For radio buttons |
69 | that do not share a common parent, ButtonGroup can be used to manage |
70 | exclusivity. |
71 | |
72 | \l RadioDelegate is similar to RadioButton, except that it is typically |
73 | used in views. |
74 | |
75 | \code |
76 | ColumnLayout { |
77 | RadioButton { |
78 | checked: true |
79 | text: qsTr("First") |
80 | } |
81 | RadioButton { |
82 | text: qsTr("Second") |
83 | } |
84 | RadioButton { |
85 | text: qsTr("Third") |
86 | } |
87 | } |
88 | \endcode |
89 | |
90 | \sa ButtonGroup, {Customizing RadioButton}, {Button Controls}, RadioDelegate |
91 | */ |
92 | |
93 | QQuickRadioButton::QQuickRadioButton(QQuickItem *parent) |
94 | : QQuickAbstractButton(parent) |
95 | { |
96 | setCheckable(true); |
97 | setAutoExclusive(true); |
98 | } |
99 | |
100 | QFont QQuickRadioButton::defaultFont() const |
101 | { |
102 | return QQuickTheme::font(scope: QQuickTheme::RadioButton); |
103 | } |
104 | |
105 | QPalette QQuickRadioButton::defaultPalette() const |
106 | { |
107 | return QQuickTheme::palette(scope: QQuickTheme::RadioButton); |
108 | } |
109 | |
110 | #if QT_CONFIG(accessibility) |
111 | QAccessible::Role QQuickRadioButton::accessibleRole() const |
112 | { |
113 | return QAccessible::RadioButton; |
114 | } |
115 | #endif |
116 | |
117 | QT_END_NAMESPACE |
118 | |