qabstractbutton.cpp

Absolute File Name:

/home/qt/qt5_coco/qt5/qtbase/src/widgets/widgets/qabstractbutton.cpp

Source code

Switch to Preprocessed file

Line Source Count

1 /**************************************************************************** -

2 ** -

4 ** Contact: https://www.qt.io/licensing/ -

5 ** -

6 ** This file is part of the QtWidgets module of the Qt Toolkit. -

7 ** -

8 ** $QT_BEGIN_LICENSE:LGPL$ -

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 https://www.qt.io/terms-conditions. For further -

15 ** information use the contact form at https://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.LGPL3 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-3.0.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 (at your option) the GNU General -

28 ** Public license version 3 or any later version approved by the KDE Free -

29 ** Qt Foundation. The licenses are as published by the Free Software -

30 ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 -

31 ** included in the packaging of this file. Please review the following -

32 ** information to ensure the GNU General Public License requirements will -

33 ** be met: https://www.gnu.org/licenses/gpl-2.0.html and -

34 ** https://www.gnu.org/licenses/gpl-3.0.html. -

35 ** -

36 ** $QT_END_LICENSE$ -

37 ** -

38 ****************************************************************************/ -

39 -

40 #include "private/qabstractbutton_p.h" -

41 -

42 #include "private/qbuttongroup_p.h" -

43 #include "qabstractitemview.h" -

44 #include "qbuttongroup.h" -

45 #include "qabstractbutton_p.h" -

46 #include "qevent.h" -

47 #include "qpainter.h" -

48 #include "qapplication.h" -

49 #include "qstyle.h" -

50 #include "qaction.h" -

51 #ifndef QT_NO_ACCESSIBILITY -

52 #include "qaccessible.h" -

53 #endif -

54 -

55 #include <algorithm> -

56 -

57 QT_BEGIN_NAMESPACE -

58 -

59 #define AUTO_REPEAT_DELAY 300 -

60 #define AUTO_REPEAT_INTERVAL 100 -

61 -

62 Q_WIDGETS_EXPORT extern bool qt_tab_all_widgets(); -

63 -

64 /*! -

65 \class QAbstractButton -

66 -

67 \brief The QAbstractButton class is the abstract base class of -

68 button widgets, providing functionality common to buttons. -

69 -

70 \ingroup abstractwidgets -

71 \inmodule QtWidgets -

72 -

73 This class implements an \e abstract button. -

74 Subclasses of this class handle user actions, and specify how the button -

75 is drawn. -

76 -

77 QAbstractButton provides support for both push buttons and checkable -

78 (toggle) buttons. Checkable buttons are implemented in the QRadioButton -

79 and QCheckBox classes. Push buttons are implemented in the -

80 QPushButton and QToolButton classes; these also provide toggle -

81 behavior if required. -

82 -

83 Any button can display a label containing text and an icon. setText() -

84 sets the text; setIcon() sets the icon. If a button is disabled, its label -

85 is changed to give the button a "disabled" appearance. -

86 -

87 If the button is a text button with a string containing an -

88 ampersand ('&'), QAbstractButton automatically creates a shortcut -

89 key. For example: -

90 -

91 \snippet code/src_gui_widgets_qabstractbutton.cpp 0 -

92 -

93 The \uicontrol Alt+C shortcut is assigned to the button, i.e., when the -

94 user presses \uicontrol Alt+C the button will call animateClick(). See -

95 the \l {QShortcut#mnemonic}{QShortcut} documentation for details. To -

96 display an actual ampersand, use '&&'. -

97 -

98 You can also set a custom shortcut key using the setShortcut() -

99 function. This is useful mostly for buttons that do not have any -

100 text, and therefore can't have any automatic shortcut. -

101 -

102 \snippet code/src_gui_widgets_qabstractbutton.cpp 1 -

103 -

104 All the buttons provided by Qt (QPushButton, QToolButton, -

105 QCheckBox, and QRadioButton) can display both \l text and \l{icon}{icons}. -

106 -

107 A button can be made the default button in a dialog by means of -

108 QPushButton::setDefault() and QPushButton::setAutoDefault(). -

109 -

110 QAbstractButton provides most of the states used for buttons: -

111 -

112 \list -

113 -

114 \li isDown() indicates whether the button is \e pressed down. -

115 -

116 \li isChecked() indicates whether the button is \e checked. Only -

117 checkable buttons can be checked and unchecked (see below). -

118 -

119 \li isEnabled() indicates whether the button can be pressed by the -

120 user. \note As opposed to other widgets, buttons derived from -

121 QAbstractButton accept mouse and context menu events -

122 when disabled. -

123 -

124 \li setAutoRepeat() sets whether the button will auto-repeat if the -

125 user holds it down. \l autoRepeatDelay and \l autoRepeatInterval -

126 define how auto-repetition is done. -

127 -

128 \li setCheckable() sets whether the button is a toggle button or not. -

129 -

130 \endlist -

131 -

132 The difference between isDown() and isChecked() is as follows. -

133 When the user clicks a toggle button to check it, the button is first -

134 \e pressed then released into the \e checked state. When the user -

135 clicks it again (to uncheck it), the button moves first to the -

136 \e pressed state, then to the \e unchecked state (isChecked() and -

137 isDown() are both false). -

138 -

139 QAbstractButton provides four signals: -

140 -

141 \list 1 -

142 -

143 \li pressed() is emitted when the left mouse button is pressed while -

144 the mouse cursor is inside the button. -

145 -

146 \li released() is emitted when the left mouse button is released. -

147 -

148 \li clicked() is emitted when the button is first pressed and then -

149 released, when the shortcut key is typed, or when click() or -

150 animateClick() is called. -

151 -

152 \li toggled() is emitted when the state of a toggle button changes. -

153 -

154 \endlist -

155 -

156 To subclass QAbstractButton, you must reimplement at least -

157 paintEvent() to draw the button's outline and its text or pixmap. It -

158 is generally advisable to reimplement sizeHint() as well, and -

159 sometimes hitButton() (to determine whether a button press is within -

160 the button). For buttons with more than two states (like tri-state -

161 buttons), you will also have to reimplement checkStateSet() and -

162 nextCheckState(). -

163 -

164 \sa QButtonGroup -

165 */ -

166 -

167 QAbstractButtonPrivate::QAbstractButtonPrivate(QSizePolicy::ControlType type) -

168 : -

169 #ifndef QT_NO_SHORTCUT -

170 shortcutId(0), -

171 #endif -

172 checkable(false), checked(false), autoRepeat(false), autoExclusive(false), -

173 down(false), blockRefresh(false), pressed(false), -

174 #ifndef QT_NO_BUTTONGROUP -

175 group(0), -

176 #endif -

177 autoRepeatDelay(AUTO_REPEAT_DELAY), -

178 autoRepeatInterval(AUTO_REPEAT_INTERVAL), -

179 controlType(type) -

180 {} -

181 -

182 QList<QAbstractButton *>QAbstractButtonPrivate::queryButtonList() const -

183 { -

184 #ifndef QT_NO_BUTTONGROUP -

185

if (group)

group	Description
TRUE	never evaluated
FALSE	never evaluated

186

return group->d_func()->buttonList;

never executed: return group->d_func()->buttonList;

187 #endif -

188 -

189 QList<QAbstractButton*>candidates = parent->findChildren<QAbstractButton *>(); -

190

if (autoExclusive) {

autoExclusive	Description
TRUE	never evaluated
FALSE	never evaluated

191 for (int iauto isNoMemberOfMyAutoExclusiveGroup = candidates.count() - 1; i >= 0; --i) {[](QAbstractButton *candidate= candidates.at(i); -

if (!) {

192

return !