qwizard.cpp

Absolute File Name:

/home/qt/qt5_coco/qt5/qtbase/src/widgets/dialogs/qwizard.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 "qwizard.h" -

41 -

42 #ifndef QT_NO_WIZARD -

43 -

44 #include "qabstractspinbox.h" -

45 #include "qalgorithms.h" -

46 #include "qapplication.h" -

47 #include "qboxlayout.h" -

48 #include "qlayoutitem.h" -

49 #include "qdesktopwidget.h" -

50 #include "qevent.h" -

51 #include "qframe.h" -

52 #include "qlabel.h" -

53 #include "qlineedit.h" -

54 #include "qpainter.h" -

55 #include "qwindow.h" -

56 #include "qpushbutton.h" -

57 #include "qset.h" -

58 #include "qstyle.h" -

59 #include "qvarlengtharray.h" -

60 #if defined(Q_OS_MACX) -

61 #include <QtCore/QMetaMethod> -

62 #include <QtGui/QGuiApplication> -

63 #include <qpa/qplatformnativeinterface.h> -

64 #elif !defined(QT_NO_STYLE_WINDOWSVISTA) -

65 #include "qwizard_win_p.h" -

66 #include "qtimer.h" -

67 #endif -

68 -

69 #include "private/qdialog_p.h" -

70 #include <qdebug.h> -

71 -

72 #ifdef Q_OS_WINCE -

73 extern bool qt_wince_is_mobile(); //defined in qguifunctions_wce.cpp -

74 #endif -

75 -

76 #include <string.h> // for memset() -

77 #include <algorithm> -

78 -

79 QT_BEGIN_NAMESPACE -

80 -

81 // These fudge terms were needed a few places to obtain pixel-perfect results -

82 const int GapBetweenLogoAndRightEdge = 5; -

83 const int ModernHeaderTopMargin = 2; -

84 const int ClassicHMargin = 4; -

85 const int MacButtonTopMargin = 13; -

86 const int MacLayoutLeftMargin = 20; -

87 //const int MacLayoutTopMargin = 14; // Unused. Save some space and avoid warning. -

88 const int MacLayoutRightMargin = 20; -

89 const int MacLayoutBottomMargin = 17; -

90 -

91 static void changeSpacerSize(QLayout *layout, int index, int width, int height) -

92 { -

93 QSpacerItem *spacer = layout->itemAt(index)->spacerItem(); -

if (!spacer)

!spacer	Description
TRUE	never evaluated
FALSE	never evaluated

return;

never executed: return;

96 spacer->changeSize(width, height); -

}

never executed: end of block

98 -

99 static QWidget *iWantTheFocus(QWidget *ancestor) -

100 { -

101 const int MaxIterations = 100; -

102 -

103 QWidget *candidate = ancestor; -

104

for (int i = 0; i < MaxIterations; ++i) {

i < MaxIterations	Description
TRUE	never evaluated
FALSE	never evaluated

105 candidate = candidate->nextInFocusChain(); -

106

if (!candidate)

!candidate	Description
TRUE	never evaluated
FALSE	never evaluated

107

break;

never executed: break;

108 -

109

if (candidate->focusPolicy() & Qt::TabFocus) {

candidate->foc...& Qt::TabFocus	Description
TRUE	never evaluated
FALSE	never evaluated

110

if (candidate != ancestor && ancestor->isAncestorOf(candidate))

candidate != ancestor	Description
TRUE	never evaluated
FALSE	never evaluated

ancestor->isAn...rOf(candidate)	Description
TRUE	never evaluated
FALSE	never evaluated

111

return candidate;

never executed: return candidate;

112

}

never executed: end of block

113

}

never executed: end of block

114

return 0;

never executed: return 0;

115 } -

116 -

117 static bool objectInheritsXAndXIsCloserThanY(const QObject *object, const QByteArray &classX, -

118 const QByteArray &classY) -

119 { -

120 const QMetaObject *metaObject = object->metaObject(); -

121

while (metaObject) {

metaObject	Description
TRUE	never evaluated
FALSE	never evaluated

122

if (metaObject->className() == classX)

metaObject->cl...me() == classX	Description
TRUE	never evaluated
FALSE	never evaluated

123

return true;

never executed: return true;

124

if (metaObject->className() == classY)

metaObject->cl...me() == classY	Description
TRUE	never evaluated
FALSE	never evaluated

125

return false;

never executed: return false;

126 metaObject = metaObject->superClass(); -

127

}

never executed: end of block

128

return false;

never executed: return false;

129 } -

130 -

131 const struct { -

132 const char className[16]; -

133 const char property[13]; -

134 } fallbackProperties[] = { -

135 // If you modify this list, make sure to update the documentation (and the auto test) -

136 { "QAbstractButton", "checked" }, -

137 { "QAbstractSlider", "value" }, -

138 { "QComboBox", "currentIndex" }, -

139 { "QDateTimeEdit", "dateTime" }, -

140 { "QLineEdit", "text" }, -

141 { "QListWidget", "currentRow" }, -

142 { "QSpinBox", "value" }, -

143 }; -

144 const size_t NFallbackDefaultProperties = sizeof fallbackProperties / sizeof *fallbackProperties; -

145 -

146 static const char *changed_signal(int which) -

147 { -

148 // since it might expand to a runtime function call (to -

149 // qFlagLocations()), we cannot store the result of SIGNAL() in a -

150 // character array and expect it to be statically initialized. To -

151 // avoid the relocations caused by a char pointer table, use a -

152 // switch statement: -

153 switch (which) { -

154

case 0: return SIGNAL(toggled(bool));

never executed: return qFlagLocation("2""toggled(bool)" "\0" __FILE__ ":" "154");

never executed: case 0:

155

case 1: return SIGNAL(valueChanged(int));

never executed: return qFlagLocation("2""valueChanged(int)" "\0" __FILE__ ":" "155");

never executed: case 1:

156

case 2: return SIGNAL(currentIndexChanged(int));

never executed: return qFlagLocation("2""currentIndexChanged(int)" "\0" __FILE__ ":" "156");

never executed: case 2:

157

case 3: return SIGNAL(dateTimeChanged(QDateTime));

never executed: return qFlagLocation("2""dateTimeChanged(QDateTime)" "\0" __FILE__ ":" "157");

never executed: case 3:

158

case 4: return SIGNAL(textChanged(QString));

never executed: return qFlagLocation("2""textChanged(QString)" "\0" __FILE__ ":" "158");

never executed: case 4:

159

case 5: return SIGNAL(currentRowChanged(int));

never executed: return qFlagLocation("2""currentRowChanged(int)" "\0" __FILE__ ":" "159");

never executed: case 5:

160

case 6: return SIGNAL(valueChanged(int));

never executed: return qFlagLocation("2""valueChanged(int)" "\0" __FILE__ ":" "160");

never executed: case 6:

161 }; -

162 Q_STATIC_ASSERT(7 == NFallbackDefaultProperties); -

163 Q_UNREACHABLE(); -

164

return 0;

never executed: return 0;

165 } -

166 -

167 class QWizardDefaultProperty -

168 { -

169 public: -

170 QByteArray className; -

171 QByteArray property; -

172 QByteArray changedSignal; -

173 -

174 inline QWizardDefaultProperty() {} -

175 inline QWizardDefaultProperty(const char *className, const char *property, -

176 const char *changedSignal) -

177

: className(className), property(property), changedSignal(changedSignal) {}

never executed: end of block

178 }; -

179 Q_DECLARE_TYPEINFO(QWizardDefaultProperty, Q_MOVABLE_TYPE); -

180 -

181 class QWizardField -

182 { -

183 public: -

184 inline QWizardField() {} -

185 QWizardField(QWizardPage *page, const QString &spec, QObject *object, const char *property, -

186 const char *changedSignal); -

187 -

188 void resolve(const QVector<QWizardDefaultProperty> &defaultPropertyTable); -

189 void findProperty(const QWizardDefaultProperty *properties, int propertyCount); -

190 -

191 QWizardPage *page; -

192 QString name; -

193 bool mandatory; -

194 QObject *object; -

195 QByteArray property; -

196 QByteArray changedSignal; -

197 QVariant initialValue; -

198 }; -

199 Q_DECLARE_TYPEINFO(QWizardField, Q_MOVABLE_TYPE); -

200 -

201 QWizardField::QWizardField(QWizardPage *page, const QString &spec, QObject *object, -

202 const char *property, const char *changedSignal) -

203 : page(page), name(spec), mandatory(false), object(object), property(property), -

204 changedSignal(changedSignal) -

205 { -

206

if (name.endsWith(QLatin1Char('*'))) {

name.endsWith(...tin1Char('*'))	Description
TRUE	never evaluated
FALSE	never evaluated

207 name.chop(1); -

208 mandatory = true; -

209

}

never executed: end of block

210

}

never executed: end of block

211 -

212 void QWizardField::resolve(const QVector<QWizardDefaultProperty> &defaultPropertyTable) -

213 { -

214

if (property.isEmpty())

property.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

215

findProperty(defaultPropertyTable.constData(), defaultPropertyTable.count());

never executed: findProperty(defaultPropertyTable.constData(), defaultPropertyTable.count());

216 initialValue = object->property(property); -

217

}

never executed: end of block

218 -

219 void QWizardField::findProperty(const QWizardDefaultProperty *properties, int propertyCount) -

220 { -

221 QByteArray className; -

222 -

223

for (int i = 0; i < propertyCount; ++i) {

i < propertyCount	Description
TRUE	never evaluated
FALSE	never evaluated

224

if (objectInheritsXAndXIsCloserThanY(object, properties[i].className, className)) {

objectInherits...me, className)	Description
TRUE	never evaluated
FALSE	never evaluated

225 className = properties[i].className; -

226 property = properties[i].property; -

227 changedSignal = properties[i].changedSignal; -

228

}

never executed: end of block

229

}

never executed: end of block

230

}

never executed: end of block

231 -

232 class QWizardLayoutInfo -

233 { -

234 public: -

235 inline QWizardLayoutInfo() -

236 : topLevelMarginLeft(-1), topLevelMarginRight(-1), topLevelMarginTop(-1), -

237 topLevelMarginBottom(-1), childMarginLeft(-1), childMarginRight(-1), -

238 childMarginTop(-1), childMarginBottom(-1), hspacing(-1), vspacing(-1), -

239 wizStyle(QWizard::ClassicStyle), header(false), watermark(false), title(false), -

240

subTitle(false), extension(false), sideWidget(false) {}

never executed: end of block

241 -

242 int topLevelMarginLeft; -

243 int topLevelMarginRight; -

244 int topLevelMarginTop; -

245 int topLevelMarginBottom; -

246 int childMarginLeft; -

247 int childMarginRight; -

248 int childMarginTop; -

249 int childMarginBottom; -

250 int hspacing; -

251 int vspacing; -

252 int buttonSpacing; -

253 QWizard::WizardStyle wizStyle; -

254 bool header; -

255 bool watermark; -

256 bool title; -

257 bool subTitle; -

258 bool extension; -

259 bool sideWidget; -

260 -

261 bool operator==(const QWizardLayoutInfo &other); -

262

inline bool operator!=(const QWizardLayoutInfo &other) { return !operator==(other); }

never executed: return !operator==(other);

263 }; -

264 -

265 bool QWizardLayoutInfo::operator==(const QWizardLayoutInfo &other) -

266 { -

267

return topLevelMarginLeft == other.topLevelMarginLeft

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

268

&& topLevelMarginRight == other.topLevelMarginRight

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

269

&& topLevelMarginTop == other.topLevelMarginTop

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

270

&& topLevelMarginBottom == other.topLevelMarginBottom

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

271

&& childMarginLeft == other.childMarginLeft

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

272

&& childMarginRight == other.childMarginRight

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

273

&& childMarginTop == other.childMarginTop

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

274

&& childMarginBottom == other.childMarginBottom

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

275

&& hspacing == other.hspacing

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

276

&& vspacing == other.vspacing

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

277

&& buttonSpacing == other.buttonSpacing

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

278

&& wizStyle == other.wizStyle

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

279

&& header == other.header

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

280

&& watermark == other.watermark

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

281

&& title == other.title

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

282

&& subTitle == other.subTitle

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

283

&& extension == other.extension

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

284

&& sideWidget == other.sideWidget;

never executed:

return topLevelMarginLeft == other.topLevelMarginLeft && topLevelMarginRight == other.topLevelMarginRight && topLevelMarginTop == other.topLevelMarginTop && topLevelMarginBottom == other.topLevelMarginBottom && childMarginLeft == other.childMarginLeft && ...pacing && buttonSpacing == other.buttonSpacing && wizStyle == other.wizStyle && header == other.header && watermark == other.watermark && title == other.title && subTitle == other.subTitle && extension == other.extension && sideWidget == other.sideWidget;

285 } -

286 -

287 class QWizardHeader : public QWidget -

288 { -

289 public: -

290 enum RulerType { Ruler }; -

291 -

292 inline QWizardHeader(RulerType /* ruler */, QWidget *parent = 0) -

293

: QWidget(parent) { setFixedHeight(2); }

never executed: end of block

294 QWizardHeader(QWidget *parent = 0); -

295 -

296 void setup(const QWizardLayoutInfo &info, const QString &title, -

297 const QString &subTitle, const QPixmap &logo, const QPixmap &banner, -

298 Qt::TextFormat titleFormat, Qt::TextFormat subTitleFormat); -

299 -

300 protected: -

301 void paintEvent(QPaintEvent *event) Q_DECL_OVERRIDE; -

302 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

303 private: -

304 bool vistaDisabled() const; -

305 #endif -

306 private: -

307 QLabel *titleLabel; -

308 QLabel *subTitleLabel; -

309 QLabel *logoLabel; -

310 QGridLayout *layout; -

311 QPixmap bannerPixmap; -

312 }; -

313 -

314 QWizardHeader::QWizardHeader(QWidget *parent) -

315 : QWidget(parent) -

316 { -

317 setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed); -

318 setBackgroundRole(QPalette::Base); -

319 -

320 titleLabel = new QLabel(this); -

321 titleLabel->setBackgroundRole(QPalette::Base); -

322 -

323 subTitleLabel = new QLabel(this); -

324 subTitleLabel->setAlignment(Qt::AlignTop | Qt::AlignLeft); -

325 subTitleLabel->setWordWrap(true); -

326 -

327 logoLabel = new QLabel(this); -

328 -

329 QFont font = titleLabel->font(); -

330 font.setBold(true); -

331 titleLabel->setFont(font); -

332 -

333 layout = new QGridLayout(this); -

334 layout->setMargin(0); -

335 layout->setSpacing(0); -

336 -

337 layout->setRowMinimumHeight(3, 1); -

338 layout->setRowStretch(4, 1); -

339 -

340 layout->setColumnStretch(2, 1); -

341 layout->setColumnMinimumWidth(4, 2 * GapBetweenLogoAndRightEdge); -

342 layout->setColumnMinimumWidth(6, GapBetweenLogoAndRightEdge); -

343 -

344 layout->addWidget(titleLabel, 2, 1, 1, 2); -

345 layout->addWidget(subTitleLabel, 4, 2); -

346 layout->addWidget(logoLabel, 1, 5, 5, 1); -

347

}

never executed: end of block

348 -

349 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

350 bool QWizardHeader::vistaDisabled() const -

351 { -

352 bool styleDisabled = false; -

353 QWizard *wiz = parentWidget() ? qobject_cast <QWizard *>(parentWidget()->parentWidget()) : 0; -

354 if (wiz) { -

355 // Designer dosen't support the Vista style for Wizards. This property is used to turn -

356 // off the Vista style. -

357 const QVariant v = wiz->property("_q_wizard_vista_off"); -

358 styleDisabled = v.isValid() && v.toBool(); -

359 } -

360 return styleDisabled; -

361 } -

362 #endif -

363 -

364 void QWizardHeader::setup(const QWizardLayoutInfo &info, const QString &title, -

365 const QString &subTitle, const QPixmap &logo, const QPixmap &banner, -

366 Qt::TextFormat titleFormat, Qt::TextFormat subTitleFormat) -

367 { -

368 bool modern = ((info.wizStyle == QWizard::ModernStyle) -

369 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

370 || ((info.wizStyle == QWizard::AeroStyle -

371 && QVistaHelper::vistaState() == QVistaHelper::Classic) || vistaDisabled()) -

372 #endif -

373 ); -

374 -

375 layout->setRowMinimumHeight(0, modern ? ModernHeaderTopMargin : 0); -

376 layout->setRowMinimumHeight(1, modern ? info.topLevelMarginTop - ModernHeaderTopMargin - 1 : 0); -

377 layout->setRowMinimumHeight(6, (modern ? 3 : GapBetweenLogoAndRightEdge) + 2); -

378 -

379

int minColumnWidth0 = modern ? info.topLevelMarginLeft + info.topLevelMarginRight : 0;

modern	Description
TRUE	never evaluated
FALSE	never evaluated

380

int minColumnWidth1 = modern ? info.topLevelMarginLeft + info.topLevelMarginRight + 1

modern	Description
TRUE	never evaluated
FALSE	never evaluated

381 : info.topLevelMarginLeft + ClassicHMargin; -

382 layout->setColumnMinimumWidth(0, minColumnWidth0); -

383 layout->setColumnMinimumWidth(1, minColumnWidth1); -

384 -

385 titleLabel->setTextFormat(titleFormat); -

386 titleLabel->setText(title); -

387 logoLabel->setPixmap(logo); -

388 -

389 subTitleLabel->setTextFormat(subTitleFormat); -

390 subTitleLabel->setText(QLatin1String("Pq\nPq")); -

391 int desiredSubTitleHeight = subTitleLabel->sizeHint().height(); -

392 subTitleLabel->setText(subTitle); -

393 -

394

if (modern) {

modern	Description
TRUE	never evaluated
FALSE	never evaluated

395 bannerPixmap = banner; -

396

} else {

never executed: end of block

397 bannerPixmap = QPixmap(); -

398

}

never executed: end of block

399 -

400

if (bannerPixmap.isNull()) {

bannerPixmap.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

401 /* -

402 There is no widthForHeight() function, so we simulate it with a loop. -

403 */ -

404 int candidateSubTitleWidth = qMin(512, 2 * QApplication::desktop()->width() / 3); -

405 int delta = candidateSubTitleWidth >> 1; -

406

while (delta > 0) {

delta > 0	Description
TRUE	never evaluated
FALSE	never evaluated

407

if (subTitleLabel->heightForWidth(candidateSubTitleWidth - delta)

subTitleLabel-...SubTitleHeight	Description
TRUE	never evaluated
FALSE	never evaluated

408

<= desiredSubTitleHeight)

subTitleLabel-...SubTitleHeight	Description
TRUE	never evaluated
FALSE	never evaluated

409

candidateSubTitleWidth -= delta;

never executed: candidateSubTitleWidth -= delta;

410 delta >>= 1; -

411

}

never executed: end of block

412 -

413 subTitleLabel->setMinimumSize(candidateSubTitleWidth, desiredSubTitleHeight); -

414 -

415 QSize size = layout->totalMinimumSize(); -

416 setMinimumSize(size); -

417 setMaximumSize(QWIDGETSIZE_MAX, size.height()); -

418

} else {

never executed: end of block

419 subTitleLabel->setMinimumSize(0, 0); -

420 setFixedSize(banner.size() + QSize(0, 2)); -

421

}

never executed: end of block

422 updateGeometry(); -

423

}

never executed: end of block

424 -

425 void QWizardHeader::paintEvent(QPaintEvent * /* event */) -

426 { -

427 QPainter painter(this); -

428 painter.drawPixmap(0, 0, bannerPixmap); -

429 -

430 int x = width() - 2; -

431 int y = height() - 2; -

432 const QPalette &pal = palette(); -

433 painter.setPen(pal.mid().color()); -

434 painter.drawLine(0, y, x, y); -

435 painter.setPen(pal.base().color()); -

436 painter.drawPoint(x + 1, y); -

437 painter.drawLine(0, y + 1, x + 1, y + 1); -

438

}

never executed: end of block

439 -

440 // We save one vtable by basing QWizardRuler on QWizardHeader -

441 class QWizardRuler : public QWizardHeader -

442 { -

443 public: -

444 inline QWizardRuler(QWidget *parent = 0) -

445

: QWizardHeader(Ruler, parent) {}

never executed: end of block

446 }; -

447 -

448 class QWatermarkLabel : public QLabel -

449 { -

450 public: -

451 QWatermarkLabel(QWidget *parent, QWidget *sideWidget) : QLabel(parent), m_sideWidget(sideWidget) { -

452 m_layout = new QVBoxLayout(this); -

453

if (m_sideWidget)

m_sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

454

m_layout->addWidget(m_sideWidget);

never executed: m_layout->addWidget(m_sideWidget);

455

}

never executed: end of block

456 -

457 QSize minimumSizeHint() const Q_DECL_OVERRIDE { -

458

if (!pixmap() && !pixmap()->isNull())

!pixmap()	Description
TRUE	never evaluated
FALSE	never evaluated

!pixmap()->isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

459

return pixmap()->size();

never executed: return pixmap()->size();

460

return QFrame::minimumSizeHint();

never executed: return QFrame::minimumSizeHint();

461 } -

462 -

463 void setSideWidget(QWidget *widget) { -

464

if (m_sideWidget == widget)

m_sideWidget == widget	Description
TRUE	never evaluated
FALSE	never evaluated

465

return;

never executed: return;

466

if (m_sideWidget) {

m_sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

467 m_layout->removeWidget(m_sideWidget); -

468 m_sideWidget->hide(); -

469

}

never executed: end of block

470 m_sideWidget = widget; -

471

if (m_sideWidget)

m_sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

472

m_layout->addWidget(m_sideWidget);

never executed: m_layout->addWidget(m_sideWidget);

473

}

never executed: end of block

474 QWidget *sideWidget() const { -

475

return m_sideWidget;

never executed: return m_sideWidget;

476 } -

477 private: -

478 QVBoxLayout *m_layout; -

479 QWidget *m_sideWidget; -

480 }; -

481 -

482 class QWizardPagePrivate : public QWidgetPrivate -

483 { -

484 Q_DECLARE_PUBLIC(QWizardPage) -

485 -

486 public: -

487 enum TriState { Tri_Unknown = -1, Tri_False, Tri_True }; -

488 -

489 inline QWizardPagePrivate() -

490

: wizard(0), completeState(Tri_Unknown), explicitlyFinal(false), commit(false) {}

never executed: end of block

491 -

492 bool cachedIsComplete() const; -

493 void _q_maybeEmitCompleteChanged(); -

494 void _q_updateCachedCompleteState(); -

495 -

496 QWizard *wizard; -

497 QString title; -

498 QString subTitle; -

499 QPixmap pixmaps[QWizard::NPixmaps]; -

500 QVector<QWizardField> pendingFields; -

501 mutable TriState completeState; -

502 bool explicitlyFinal; -

503 bool commit; -

504 QMap<int, QString> buttonCustomTexts; -

505 }; -

506 -

507 bool QWizardPagePrivate::cachedIsComplete() const -

508 { -

509 Q_Q(const QWizardPage); -

510

if (completeState == Tri_Unknown)

completeState == Tri_Unknown	Description
TRUE	never evaluated
FALSE	never evaluated

511

completeState = q->isComplete() ? Tri_True : Tri_False;

never executed: completeState = q->isComplete() ? Tri_True : Tri_False;

q->isComplete()	Description
TRUE	never evaluated
FALSE	never evaluated

512

return completeState == Tri_True;

never executed: return completeState == Tri_True;

513 } -

514 -

515 void QWizardPagePrivate::_q_maybeEmitCompleteChanged() -

516 { -

517 Q_Q(QWizardPage); -

518

TriState newState = q->isComplete() ? Tri_True : Tri_False;

q->isComplete()	Description
TRUE	never evaluated
FALSE	never evaluated

519

if (newState != completeState)

newState != completeState	Description
TRUE	never evaluated
FALSE	never evaluated

520

emit q->completeChanged();

never executed: q->completeChanged();

521

}

never executed: end of block

522 -

523 void QWizardPagePrivate::_q_updateCachedCompleteState() -

524 { -

525 Q_Q(QWizardPage); -

526

completeState = q->isComplete() ? Tri_True : Tri_False;

q->isComplete()	Description
TRUE	never evaluated
FALSE	never evaluated

527

}

never executed: end of block

528 -

529 class QWizardAntiFlickerWidget : public QWidget -

530 { -

531 public: -

532 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

533 QWizardPrivate *wizardPrivate; -

534 QWizardAntiFlickerWidget(QWizard *wizard, QWizardPrivate *wizardPrivate) -

535 : QWidget(wizard) -

536 , wizardPrivate(wizardPrivate) {} -

537 protected: -

538 void paintEvent(QPaintEvent *); -

539 #else -

540 QWizardAntiFlickerWidget(QWizard *wizard, QWizardPrivate *) -

541 : QWidget(wizard) -

542

{}

never executed: end of block

543 #endif -

544 }; -

545 -

546 class QWizardPrivate : public QDialogPrivate -

547 { -

548 Q_DECLARE_PUBLIC(QWizard) -

549 -

550 public: -

551 typedef QMap<int, QWizardPage *> PageMap; -

552 -

553 enum Direction { -

554 Backward, -

555 Forward -

556 }; -

557 -

558 inline QWizardPrivate() -

559 : start(-1) -

560 , startSetByUser(false) -

561 , current(-1) -

562 , canContinue(false) -

563 , canFinish(false) -

564 , disableUpdatesCount(0) -

565 , wizStyle(QWizard::ClassicStyle) -

566 , opts(0) -

567 , buttonsHaveCustomLayout(false) -

568 , titleFmt(Qt::AutoText) -

569 , subTitleFmt(Qt::AutoText) -

570 , placeholderWidget1(0) -

571 , placeholderWidget2(0) -

572 , headerWidget(0) -

573 , watermarkLabel(0) -

574 , sideWidget(0) -

575 , pageFrame(0) -

576 , titleLabel(0) -

577 , subTitleLabel(0) -

578 , bottomRuler(0) -

579 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

580 , vistaHelper(0) -

581 , vistaInitPending(false) -

582 , vistaState(QVistaHelper::Dirty) -

583 , vistaStateChanged(false) -

584 , inHandleAeroStyleChange(false) -

585 #endif -

586 , minimumWidth(0) -

587 , minimumHeight(0) -

588 , maximumWidth(QWIDGETSIZE_MAX) -

589 , maximumHeight(QWIDGETSIZE_MAX) -

590 { -

591 std::fill(btns, btns + QWizard::NButtons, static_cast<QAbstractButton *>(0)); -

592 -

593 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

594 if (QSysInfo::WindowsVersion >= QSysInfo::WV_VISTA -

595 && (QSysInfo::WindowsVersion & QSysInfo::WV_NT_based)) -

596 vistaInitPending = true; -

597 #endif -

598

}

never executed: end of block

599 -

600 void init(); -

601 void reset(); -

602 void cleanupPagesNotInHistory(); -

603 void addField(const QWizardField &field); -

604 void removeFieldAt(int index); -

605 void switchToPage(int newId, Direction direction); -

606 QWizardLayoutInfo layoutInfoForCurrentPage(); -

607 void recreateLayout(const QWizardLayoutInfo &info); -

608 void updateLayout(); -

609 void updateMinMaxSizes(const QWizardLayoutInfo &info); -

610 void updateCurrentPage(); -

611 bool ensureButton(QWizard::WizardButton which) const; -

612 void connectButton(QWizard::WizardButton which) const; -

613 void updateButtonTexts(); -

614 void updateButtonLayout(); -

615 void setButtonLayout(const QWizard::WizardButton *array, int size); -

616 bool buttonLayoutContains(QWizard::WizardButton which); -

617 void updatePixmap(QWizard::WizardPixmap which); -

618 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

619 bool vistaDisabled() const; -

620 bool isVistaThemeEnabled(QVistaHelper::VistaState state) const; -

621 bool handleAeroStyleChange(); -

622 #endif -

623 bool isVistaThemeEnabled() const; -

624 void disableUpdates(); -

625 void enableUpdates(); -

626 void _q_emitCustomButtonClicked(); -

627 void _q_updateButtonStates(); -

628 void _q_handleFieldObjectDestroyed(QObject *); -

629 void setStyle(QStyle *style); -

630 #ifdef Q_OS_MACX -

631 static QPixmap findDefaultBackgroundPixmap(); -

632 #endif -

633 -

634 PageMap pageMap; -

635 QVector<QWizardField> fields; -

636 QMap<QString, int> fieldIndexMap; -

637 QVector<QWizardDefaultProperty> defaultPropertyTable; -

638 QList<int> history; -

639 QSet<int> initialized; // ### remove and move bit to QWizardPage? -

640 int start; -

641 bool startSetByUser; -

642 int current; -

643 bool canContinue; -

644 bool canFinish; -

645 QWizardLayoutInfo layoutInfo; -

646 int disableUpdatesCount; -

647 -

648 QWizard::WizardStyle wizStyle; -

649 QWizard::WizardOptions opts; -

650 QMap<int, QString> buttonCustomTexts; -

651 bool buttonsHaveCustomLayout; -

652 QList<QWizard::WizardButton> buttonsCustomLayout; -

653 Qt::TextFormat titleFmt; -

654 Qt::TextFormat subTitleFmt; -

655 mutable QPixmap defaultPixmaps[QWizard::NPixmaps]; -

656 -

657 union { -

658 // keep in sync with QWizard::WizardButton -

659 mutable struct { -

660 QAbstractButton *back; -

661 QAbstractButton *next; -

662 QAbstractButton *commit; -

663 QAbstractButton *finish; -

664 QAbstractButton *cancel; -

665 QAbstractButton *help; -

666 } btn; -

667 mutable QAbstractButton *btns[QWizard::NButtons]; -

668 }; -

669 QWizardAntiFlickerWidget *antiFlickerWidget; -

670 QWidget *placeholderWidget1; -

671 QWidget *placeholderWidget2; -

672 QWizardHeader *headerWidget; -

673 QWatermarkLabel *watermarkLabel; -

674 QWidget *sideWidget; -

675 QFrame *pageFrame; -

676 QLabel *titleLabel; -

677 QLabel *subTitleLabel; -

678 QWizardRuler *bottomRuler; -

679 -

680 QVBoxLayout *pageVBoxLayout; -

681 QHBoxLayout *buttonLayout; -

682 QGridLayout *mainLayout; -

683 -

684 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

685 QVistaHelper *vistaHelper; -

686 bool vistaInitPending; -

687 QVistaHelper::VistaState vistaState; -

688 bool vistaStateChanged; -

689 bool inHandleAeroStyleChange; -

690 #endif -

691 int minimumWidth; -

692 int minimumHeight; -

693 int maximumWidth; -

694 int maximumHeight; -

695 }; -

696 -

697 static QString buttonDefaultText(int wstyle, int which, const QWizardPrivate *wizardPrivate) -

698 { -

699 #if defined(QT_NO_STYLE_WINDOWSVISTA) -

700 Q_UNUSED(wizardPrivate); -

701 #endif -

702 const bool macStyle = (wstyle == QWizard::MacStyle); -

703 switch (which) { -

704

case QWizard::BackButton:

never executed: case QWizard::BackButton:

705

return macStyle ? QWizard::tr("Go Back") : QWizard::tr("< &Back");

never executed: return macStyle ? QWizard::tr("Go Back") : QWizard::tr("< &Back");

706

case QWizard::NextButton:

never executed: case QWizard::NextButton:

707

if (macStyle)

macStyle	Description
TRUE	never evaluated
FALSE	never evaluated

708

return QWizard::tr("Continue");

never executed: return QWizard::tr("Continue");

709 else -

710

return wizardPrivate->isVistaThemeEnabled()

never executed: return wizardPrivate->isVistaThemeEnabled() ? QWizard::tr("&Next") : QWizard::tr("&Next >");

711

? QWizard::tr("&Next") : QWizard::tr("&Next >");

never executed: return wizardPrivate->isVistaThemeEnabled() ? QWizard::tr("&Next") : QWizard::tr("&Next >");

712

case QWizard::CommitButton:

never executed: case QWizard::CommitButton:

713

return QWizard::tr("Commit");

never executed: return QWizard::tr("Commit");

714

case QWizard::FinishButton:

never executed: case QWizard::FinishButton:

715

return macStyle ? QWizard::tr("Done") : QWizard::tr("&Finish");

never executed: return macStyle ? QWizard::tr("Done") : QWizard::tr("&Finish");

716

case QWizard::CancelButton:

never executed: case QWizard::CancelButton:

717

return QWizard::tr("Cancel");

never executed: return QWizard::tr("Cancel");

718

case QWizard::HelpButton:

never executed: case QWizard::HelpButton:

719

return macStyle ? QWizard::tr("Help") : QWizard::tr("&Help");

never executed: return macStyle ? QWizard::tr("Help") : QWizard::tr("&Help");

720

default:

never executed: default:

721

return QString();

never executed: return QString();

722 } -

723 } -

724 -

725 void QWizardPrivate::init() -

726 { -

727 Q_Q(QWizard); -

728 -

729 antiFlickerWidget = new QWizardAntiFlickerWidget(q, this); -

730 wizStyle = QWizard::WizardStyle(q->style()->styleHint(QStyle::SH_WizardStyle, 0, q)); -

731

if (wizStyle == QWizard::MacStyle) {

wizStyle == QWizard::MacStyle	Description
TRUE	never evaluated
FALSE	never evaluated

732 opts = (QWizard::NoDefaultButton | QWizard::NoCancelButton); -

733

} else if (wizStyle == QWizard::ModernStyle) {

never executed: end of block

wizStyle == QW...d::ModernStyle	Description
TRUE	never evaluated
FALSE	never evaluated

734 opts = QWizard::HelpButtonOnRight; -

735

}

never executed: end of block

736 -

737 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

738 vistaHelper = new QVistaHelper(q); -

739 #endif -

740 -

741 // create these buttons right away; create the other buttons as necessary -

742 ensureButton(QWizard::BackButton); -

743 ensureButton(QWizard::NextButton); -

744 ensureButton(QWizard::CommitButton); -

745 ensureButton(QWizard::FinishButton); -

746 -

747 pageFrame = new QFrame(antiFlickerWidget); -

748 pageFrame->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Preferred); -

749 -

750 pageVBoxLayout = new QVBoxLayout(pageFrame); -

751 pageVBoxLayout->setSpacing(0); -

752 pageVBoxLayout->addSpacing(0); -

753 QSpacerItem *spacerItem = new QSpacerItem(0, 0, QSizePolicy::Ignored, QSizePolicy::MinimumExpanding); -

754 pageVBoxLayout->addItem(spacerItem); -

755 -

756 buttonLayout = new QHBoxLayout; -

757 mainLayout = new QGridLayout(antiFlickerWidget); -

758 mainLayout->setSizeConstraint(QLayout::SetNoConstraint); -

759 -

760 updateButtonLayout(); -

761 -

762 defaultPropertyTable.reserve(NFallbackDefaultProperties); -

763

for (uint i = 0; i < NFallbackDefaultProperties; ++i)

i < NFallbackDefaultProperties	Description
TRUE	never evaluated
FALSE	never evaluated

764

defaultPropertyTable.append(QWizardDefaultProperty(fallbackProperties[i].className,

never executed:

defaultPropertyTable.append(QWizardDefaultProperty(fallbackProperties[i].className, fallbackProperties[i].property, changed_signal(i)));

765

fallbackProperties[i].property,

never executed:

defaultPropertyTable.append(QWizardDefaultProperty(fallbackProperties[i].className, fallbackProperties[i].property, changed_signal(i)));

766

changed_signal(i)));

never executed:

defaultPropertyTable.append(QWizardDefaultProperty(fallbackProperties[i].className, fallbackProperties[i].property, changed_signal(i)));

767

}

never executed: end of block

768 -

769 void QWizardPrivate::reset() -

770 { -

771 Q_Q(QWizard); -

772

if (current != -1) {

current != -1	Description
TRUE	never evaluated
FALSE	never evaluated

773 q->currentPage()->hide(); -

774 cleanupPagesNotInHistory(); -

775

for (int i = history.count() - 1; i >= 0; --i)

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

776

q->cleanupPage(history.at(i));

never executed: q->cleanupPage(history.at(i));

777 history.clear(); -

778 initialized.clear(); -

779 -

780 current = -1; -

781 emit q->currentIdChanged(-1); -

782

}

never executed: end of block

783

}

never executed: end of block

784 -

785 void QWizardPrivate::cleanupPagesNotInHistory() -

786 { -

787 Q_Q(QWizard); -

788 -

789 const QSet<int> original = initialized; -

790 QSet<int>::const_iterator i = original.constBegin(); -

791 QSet<int>::const_iterator end = original.constEnd(); -

792 -

793

for (; i != end; ++i) {

i != end	Description
TRUE	never evaluated
FALSE	never evaluated

794

if (!history.contains(*i)) {

!history.contains(*i)	Description
TRUE	never evaluated
FALSE	never evaluated

795 q->cleanupPage(*i); -

796 initialized.remove(*i); -

797

}

never executed: end of block

798

}

never executed: end of block

799

}

never executed: end of block

800 -

801 void QWizardPrivate::addField(const QWizardField &field) -

802 { -

803 Q_Q(QWizard); -

804 -

805 QWizardField myField = field; -

806 myField.resolve(defaultPropertyTable); -

807 -

808

if (Q_UNLIKELY(fieldIndexMap.contains(myField.name))) {

__builtin_expe...name)), false)	Description
TRUE	never evaluated
FALSE	never evaluated

809 qWarning("QWizardPage::addField: Duplicate field '%ls'", qUtf16Printable(myField.name)); -

810

return;

never executed: return;

811 } -

812 -

813 fieldIndexMap.insert(myField.name, fields.count()); -

814 fields += myField; -

815

if (myField.mandatory && !myField.changedSignal.isEmpty())

myField.mandatory	Description
TRUE	never evaluated
FALSE	never evaluated

!myField.chang...gnal.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

816

QObject::connect(myField.object, myField.changedSignal,

never executed:

QObject::connect(myField.object, myField.changedSignal, myField.page, qFlagLocation("1""_q_maybeEmitCompleteChanged()" "\0" __FILE__ ":" "817"));

817

myField.page, SLOT(_q_maybeEmitCompleteChanged()));

never executed:

QObject::connect(myField.object, myField.changedSignal, myField.page, qFlagLocation("1""_q_maybeEmitCompleteChanged()" "\0" __FILE__ ":" "817"));

818 QObject::connect( -

819 myField.object, SIGNAL(destroyed(QObject*)), q, -

820 SLOT(_q_handleFieldObjectDestroyed(QObject*))); -

821

}

never executed: end of block

822 -

823 void QWizardPrivate::removeFieldAt(int index) -

824 { -

825 Q_Q(QWizard); -

826 -

827 const QWizardField &field = fields.at(index); -

828 fieldIndexMap.remove(field.name); -

829

if (field.mandatory && !field.changedSignal.isEmpty())

field.mandatory	Description
TRUE	never evaluated
FALSE	never evaluated

!field.changedSignal.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

830

QObject::disconnect(field.object, field.changedSignal,

never executed:

QObject::disconnect(field.object, field.changedSignal, field.page, qFlagLocation("1""_q_maybeEmitCompleteChanged()" "\0" __FILE__ ":" "831"));

831

field.page, SLOT(_q_maybeEmitCompleteChanged()));

never executed:

QObject::disconnect(field.object, field.changedSignal, field.page, qFlagLocation("1""_q_maybeEmitCompleteChanged()" "\0" __FILE__ ":" "831"));

832 QObject::disconnect( -

833 field.object, SIGNAL(destroyed(QObject*)), q, -

834 SLOT(_q_handleFieldObjectDestroyed(QObject*))); -

835 fields.remove(index); -

836

}

never executed: end of block

837 -

838 void QWizardPrivate::switchToPage(int newId, Direction direction) -

839 { -

840 Q_Q(QWizard); -

841 -

842 disableUpdates(); -

843 -

844 int oldId = current; -

845

if (QWizardPage *oldPage = q->currentPage()) {

QWizardPage *o...>currentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

846 oldPage->hide(); -

847 -

848

if (direction == Backward) {

direction == Backward	Description
TRUE	never evaluated
FALSE	never evaluated

849

if (!(opts & QWizard::IndependentPages)) {

!(opts & QWiza...ependentPages)	Description
TRUE	never evaluated
FALSE	never evaluated

850 q->cleanupPage(oldId); -

851 initialized.remove(oldId); -

852

}

never executed: end of block

853 Q_ASSERT(history.constLast() == oldId); -

854 history.removeLast(); -

855 Q_ASSERT(history.constLast() == newId); -

856

}

never executed: end of block

857

}

never executed: end of block

858 -

859 current = newId; -

860 -

861 QWizardPage *newPage = q->currentPage(); -

862

if (newPage) {

newPage	Description
TRUE	never evaluated
FALSE	never evaluated

863

if (direction == Forward) {

direction == Forward	Description
TRUE	never evaluated
FALSE	never evaluated

864

if (!initialized.contains(current)) {

!initialized.contains(current)	Description
TRUE	never evaluated
FALSE	never evaluated

865 initialized.insert(current); -

866 q->initializePage(current); -

867

}

never executed: end of block

868 history.append(current); -

869

}

never executed: end of block

870 newPage->show(); -

871

}

never executed: end of block

872 -

873 canContinue = (q->nextId() != -1); -

874

canFinish = (newPage && newPage->isFinalPage());

newPage	Description
TRUE	never evaluated
FALSE	never evaluated

newPage->isFinalPage()	Description
TRUE	never evaluated
FALSE	never evaluated

875 -

876 _q_updateButtonStates(); -

877 updateButtonTexts(); -

878 -

879 const QWizard::WizardButton nextOrCommit = -

880

newPage && newPage->isCommitPage() ? QWizard::CommitButton : QWizard::NextButton;

newPage	Description
TRUE	never evaluated
FALSE	never evaluated

newPage->isCommitPage()	Description
TRUE	never evaluated
FALSE	never evaluated

881 QAbstractButton *nextOrFinishButton = -

882 btns[canContinue ? nextOrCommit : QWizard::FinishButton]; -

883 QWidget *candidate = 0; -

884 -

885 /* -

886 If there is no default button and the Next or Finish button -

887 is enabled, give focus directly to it as a convenience to the -

888 user. This is the normal case on OS X. -

889 -

890 Otherwise, give the focus to the new page's first child that -

891 can handle it. If there is no such child, give the focus to -

892 Next or Finish. -

893 */ -

894

if ((opts & QWizard::NoDefaultButton) && nextOrFinishButton->isEnabled()) {

(opts & QWizar...DefaultButton)	Description
TRUE	never evaluated
FALSE	never evaluated

nextOrFinishBu...n->isEnabled()	Description
TRUE	never evaluated
FALSE	never evaluated

895 candidate = nextOrFinishButton; -

896

} else if (newPage) {

never executed: end of block

newPage	Description
TRUE	never evaluated
FALSE	never evaluated

897 candidate = iWantTheFocus(newPage); -

898

}

never executed: end of block

899

if (!candidate)

!candidate	Description
TRUE	never evaluated
FALSE	never evaluated

900

candidate = nextOrFinishButton;

never executed: candidate = nextOrFinishButton;

901 candidate->setFocus(); -

902 -

903

if (wizStyle == QWizard::MacStyle)

wizStyle == QWizard::MacStyle	Description
TRUE	never evaluated
FALSE	never evaluated

904

q->updateGeometry();

never executed: q->updateGeometry();

905 -

906 enableUpdates(); -

907 updateLayout(); -

908 -

909 emit q->currentIdChanged(current); -

910

}

never executed: end of block

911 -

912 // keep in sync with QWizard::WizardButton -

913 static const char * buttonSlots(QWizard::WizardButton which) -

914 { -

915 switch (which) { -

916

case QWizard::BackButton:

never executed: case QWizard::BackButton:

917

return SLOT(back());

never executed: return qFlagLocation("1""back()" "\0" __FILE__ ":" "917");

918

case QWizard::NextButton:

never executed: case QWizard::NextButton:

919

case QWizard::CommitButton:

never executed: case QWizard::CommitButton:

920

return SLOT(next());

never executed: return qFlagLocation("1""next()" "\0" __FILE__ ":" "920");

921

case QWizard::FinishButton:

never executed: case QWizard::FinishButton:

922

return SLOT(accept());

never executed: return qFlagLocation("1""accept()" "\0" __FILE__ ":" "922");

923

case QWizard::CancelButton:

never executed: case QWizard::CancelButton:

924

return SLOT(reject());

never executed: return qFlagLocation("1""reject()" "\0" __FILE__ ":" "924");

925

case QWizard::HelpButton:

never executed: case QWizard::HelpButton:

926

return SIGNAL(helpRequested());

never executed: return qFlagLocation("2""helpRequested()" "\0" __FILE__ ":" "926");

927

case QWizard::CustomButton1:

never executed: case QWizard::CustomButton1:

928

case QWizard::CustomButton2:

never executed: case QWizard::CustomButton2:

929

case QWizard::CustomButton3:

never executed: case QWizard::CustomButton3:

930

case QWizard::Stretch:

never executed: case QWizard::Stretch:

931

case QWizard::NoButton:

never executed: case QWizard::NoButton:

932 Q_UNREACHABLE(); -

933

};

never executed: end of block

934

return 0;

never executed: return 0;

935 }; -

936 -

937 QWizardLayoutInfo QWizardPrivate::layoutInfoForCurrentPage() -

938 { -

939 Q_Q(QWizard); -

940 QStyle *style = q->style(); -

941 -

942 QWizardLayoutInfo info; -

943 -

944 const int layoutHorizontalSpacing = style->pixelMetric(QStyle::PM_LayoutHorizontalSpacing); -

945 info.topLevelMarginLeft = style->pixelMetric(QStyle::PM_LayoutLeftMargin, 0, q); -

946 info.topLevelMarginRight = style->pixelMetric(QStyle::PM_LayoutRightMargin, 0, q); -

947 info.topLevelMarginTop = style->pixelMetric(QStyle::PM_LayoutTopMargin, 0, q); -

948 info.topLevelMarginBottom = style->pixelMetric(QStyle::PM_LayoutBottomMargin, 0, q); -

949 info.childMarginLeft = style->pixelMetric(QStyle::PM_LayoutLeftMargin, 0, titleLabel); -

950 info.childMarginRight = style->pixelMetric(QStyle::PM_LayoutRightMargin, 0, titleLabel); -

951 info.childMarginTop = style->pixelMetric(QStyle::PM_LayoutTopMargin, 0, titleLabel); -

952 info.childMarginBottom = style->pixelMetric(QStyle::PM_LayoutBottomMargin, 0, titleLabel); -

953

info.hspacing = (layoutHorizontalSpacing == -1)

(layoutHorizon...Spacing == -1)	Description
TRUE	never evaluated
FALSE	never evaluated

954 ? style->layoutSpacing(QSizePolicy::DefaultType, QSizePolicy::DefaultType, Qt::Horizontal) -

955 : layoutHorizontalSpacing; -

956 info.vspacing = style->pixelMetric(QStyle::PM_LayoutVerticalSpacing); -

957

info.buttonSpacing = (layoutHorizontalSpacing == -1)

(layoutHorizon...Spacing == -1)	Description
TRUE	never evaluated
FALSE	never evaluated

958 ? style->layoutSpacing(QSizePolicy::PushButton, QSizePolicy::PushButton, Qt::Horizontal) -

959 : layoutHorizontalSpacing; -

960 -

961

if (wizStyle == QWizard::MacStyle)

wizStyle == QWizard::MacStyle	Description
TRUE	never evaluated
FALSE	never evaluated

962

info.buttonSpacing = 12;

never executed: info.buttonSpacing = 12;

963 -

964 info.wizStyle = wizStyle; -

965

if (info.wizStyle == QWizard::AeroStyle

info.wizStyle ...ard::AeroStyle	Description
TRUE	never evaluated
FALSE	never evaluated

966 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

967 && (QVistaHelper::vistaState() == QVistaHelper::Classic || vistaDisabled()) -

968 #endif -

969 ) -

970

info.wizStyle = QWizard::ModernStyle;

never executed: info.wizStyle = QWizard::ModernStyle;

971 -

972 QString titleText; -

973 QString subTitleText; -

974 QPixmap backgroundPixmap; -

975 QPixmap watermarkPixmap; -

976 -

977

if (QWizardPage *page = q->currentPage()) {

QWizardPage *p...>currentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

978 titleText = page->title(); -

979 subTitleText = page->subTitle(); -

980 backgroundPixmap = page->pixmap(QWizard::BackgroundPixmap); -

981 watermarkPixmap = page->pixmap(QWizard::WatermarkPixmap); -

982

}

never executed: end of block

983 -

984

info.header = (info.wizStyle == QWizard::ClassicStyle || info.wizStyle == QWizard::ModernStyle)

info.wizStyle ...::ClassicStyle	Description
TRUE	never evaluated
FALSE	never evaluated

info.wizStyle ...d::ModernStyle	Description
TRUE	never evaluated
FALSE	never evaluated

985

&& !(opts & QWizard::IgnoreSubTitles) && !subTitleText.isEmpty();

!(opts & QWiza...noreSubTitles)	Description
TRUE	never evaluated
FALSE	never evaluated

!subTitleText.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

986 info.sideWidget = sideWidget; -

987

info.watermark = (info.wizStyle != QWizard::MacStyle) && (info.wizStyle != QWizard::AeroStyle)

(info.wizStyle...ard::MacStyle)	Description
TRUE	never evaluated
FALSE	never evaluated

(info.wizStyle...rd::AeroStyle)	Description
TRUE	never evaluated
FALSE	never evaluated

988

&& !watermarkPixmap.isNull();

!watermarkPixmap.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

989

info.title = !info.header && !titleText.isEmpty();

!info.header	Description
TRUE	never evaluated
FALSE	never evaluated

!titleText.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

990

info.subTitle = !(opts & QWizard::IgnoreSubTitles) && !info.header && !subTitleText.isEmpty();

!(opts & QWiza...noreSubTitles)	Description
TRUE	never evaluated
FALSE	never evaluated

!info.header	Description
TRUE	never evaluated
FALSE	never evaluated

!subTitleText.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

991

info.extension = (info.watermark || info.sideWidget) && (opts & QWizard::ExtendedWatermarkPixmap);

info.watermark	Description
TRUE	never evaluated
FALSE	never evaluated

info.sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

(opts & QWizar...termarkPixmap)	Description
TRUE	never evaluated
FALSE	never evaluated

992 -

993

return info;

never executed: return info;

994 } -

995 -

996 void QWizardPrivate::recreateLayout(const QWizardLayoutInfo &info) -

997 { -

998 Q_Q(QWizard); -

999 -

1000 /* -

1001 Start by undoing the main layout. -

1002 */ -

1003

for (int i = mainLayout->count() - 1; i >= 0; --i) {

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

1004 QLayoutItem *item = mainLayout->takeAt(i); -

1005

if (item->layout()) {

item->layout()	Description
TRUE	never evaluated
FALSE	never evaluated

1006 item->layout()->setParent(0); -

1007

} else {

never executed: end of block

1008 delete item; -

1009

}

never executed: end of block

1010 } -

1011

for (int i = mainLayout->columnCount() - 1; i >= 0; --i)

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

1012

mainLayout->setColumnMinimumWidth(i, 0);

never executed: mainLayout->setColumnMinimumWidth(i, 0);

1013

for (int i = mainLayout->rowCount() - 1; i >= 0; --i)

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

1014

mainLayout->setRowMinimumHeight(i, 0);

never executed: mainLayout->setRowMinimumHeight(i, 0);

1015 -

1016 /* -

1017 Now, recreate it. -

1018 */ -

1019 -

1020 bool mac = (info.wizStyle == QWizard::MacStyle); -

1021 bool classic = (info.wizStyle == QWizard::ClassicStyle); -

1022 bool modern = (info.wizStyle == QWizard::ModernStyle); -

1023 bool aero = (info.wizStyle == QWizard::AeroStyle); -

1024 int deltaMarginLeft = info.topLevelMarginLeft - info.childMarginLeft; -

1025 int deltaMarginRight = info.topLevelMarginRight - info.childMarginRight; -

1026 int deltaMarginTop = info.topLevelMarginTop - info.childMarginTop; -

1027 int deltaMarginBottom = info.topLevelMarginBottom - info.childMarginBottom; -

1028 int deltaVSpacing = info.topLevelMarginBottom - info.vspacing; -

1029 -

1030 int row = 0; -

1031 int numColumns; -

1032

if (mac) {

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1033 numColumns = 3; -

1034

} else if (info.watermark || info.sideWidget) {

never executed: end of block

info.watermark	Description
TRUE	never evaluated
FALSE	never evaluated

info.sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

1035 numColumns = 2; -

1036

} else {

never executed: end of block

1037 numColumns = 1; -

1038

}

never executed: end of block

1039 int pageColumn = qMin(1, numColumns - 1); -

1040 -

1041

if (mac) {

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1042 mainLayout->setMargin(0); -

1043 mainLayout->setSpacing(0); -

1044 buttonLayout->setContentsMargins(MacLayoutLeftMargin, MacButtonTopMargin, MacLayoutRightMargin, MacLayoutBottomMargin); -

1045 pageVBoxLayout->setMargin(7); -

1046

} else {

never executed: end of block

1047

if (modern) {

modern	Description
TRUE	never evaluated
FALSE	never evaluated

1048 mainLayout->setMargin(0); -

1049 mainLayout->setSpacing(0); -

1050 pageVBoxLayout->setContentsMargins(deltaMarginLeft, deltaMarginTop, -

1051 deltaMarginRight, deltaMarginBottom); -

1052 buttonLayout->setContentsMargins(info.topLevelMarginLeft, info.topLevelMarginTop, -

1053 info.topLevelMarginRight, info.topLevelMarginBottom); -

1054

} else {

never executed: end of block

1055 mainLayout->setContentsMargins(info.topLevelMarginLeft, info.topLevelMarginTop, -

1056 info.topLevelMarginRight, info.topLevelMarginBottom); -

1057 mainLayout->setHorizontalSpacing(info.hspacing); -

1058 mainLayout->setVerticalSpacing(info.vspacing); -

1059 pageVBoxLayout->setContentsMargins(0, 0, 0, 0); -

1060 buttonLayout->setContentsMargins(0, 0, 0, 0); -

1061

}

never executed: end of block

1062 } -

1063 buttonLayout->setSpacing(info.buttonSpacing); -

1064 -

1065

if (info.header) {

info.header	Description
TRUE	never evaluated
FALSE	never evaluated

1066

if (!headerWidget)

!headerWidget	Description
TRUE	never evaluated
FALSE	never evaluated

1067

headerWidget = new QWizardHeader(antiFlickerWidget);

never executed: headerWidget = new QWizardHeader(antiFlickerWidget);

1068 headerWidget->setAutoFillBackground(modern); -

1069 mainLayout->addWidget(headerWidget, row++, 0, 1, numColumns); -

1070

}

never executed: end of block

1071

if (headerWidget)

headerWidget	Description
TRUE	never evaluated
FALSE	never evaluated

1072

headerWidget->setVisible(info.header);

never executed: headerWidget->setVisible(info.header);

1073 -

1074 int watermarkStartRow = row; -

1075 -

1076

if (mac)

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1077

mainLayout->setRowMinimumHeight(row++, 10);

never executed: mainLayout->setRowMinimumHeight(row++, 10);

1078 -

1079

if (info.title) {

info.title	Description
TRUE	never evaluated
FALSE	never evaluated

1080

if (!titleLabel) {

!titleLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1081 titleLabel = new QLabel(antiFlickerWidget); -

1082 titleLabel->setBackgroundRole(QPalette::Base); -

1083 titleLabel->setWordWrap(true); -

1084

}

never executed: end of block

1085 -

1086 QFont titleFont = q->font(); -

1087 titleFont.setPointSize(titleFont.pointSize() + (mac ? 3 : 4)); -

1088 titleFont.setBold(true); -

1089 titleLabel->setPalette(QPalette()); -

1090 -

1091

if (aero) {

aero	Description
TRUE	never evaluated
FALSE	never evaluated

1092 // ### hardcoded for now: -

1093 titleFont = QFont(QLatin1String("Segoe UI"), 12); -

1094 QPalette pal(titleLabel->palette()); -

1095 pal.setColor(QPalette::Text, "#003399"); -

1096 titleLabel->setPalette(pal); -

1097

}

never executed: end of block

1098 -

1099 titleLabel->setFont(titleFont); -

1100 const int aeroTitleIndent = 25; // ### hardcoded for now - should be calculated somehow -

1101

if (aero)

aero	Description
TRUE	never evaluated
FALSE	never evaluated

1102

titleLabel->setIndent(aeroTitleIndent);

never executed: titleLabel->setIndent(aeroTitleIndent);

1103

else if (mac)

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1104

titleLabel->setIndent(2);

never executed: titleLabel->setIndent(2);

1105

else if (classic)

classic	Description
TRUE	never evaluated
FALSE	never evaluated

1106

titleLabel->setIndent(info.childMarginLeft);

never executed: titleLabel->setIndent(info.childMarginLeft);

1107 else -

1108

titleLabel->setIndent(info.topLevelMarginLeft);

never executed: titleLabel->setIndent(info.topLevelMarginLeft);

1109

if (modern) {

modern	Description
TRUE	never evaluated
FALSE	never evaluated

1110

if (!placeholderWidget1) {

!placeholderWidget1	Description
TRUE	never evaluated
FALSE	never evaluated

1111 placeholderWidget1 = new QWidget(antiFlickerWidget); -

1112 placeholderWidget1->setBackgroundRole(QPalette::Base); -

1113

}

never executed: end of block

1114 placeholderWidget1->setFixedHeight(info.topLevelMarginLeft + 2); -

1115 mainLayout->addWidget(placeholderWidget1, row++, pageColumn); -

1116

}

never executed: end of block

1117 mainLayout->addWidget(titleLabel, row++, pageColumn); -

1118

if (modern) {

modern	Description
TRUE	never evaluated
FALSE	never evaluated

1119

if (!placeholderWidget2) {

!placeholderWidget2	Description
TRUE	never evaluated
FALSE	never evaluated

1120 placeholderWidget2 = new QWidget(antiFlickerWidget); -

1121 placeholderWidget2->setBackgroundRole(QPalette::Base); -

1122

}

never executed: end of block

1123 placeholderWidget2->setFixedHeight(5); -

1124 mainLayout->addWidget(placeholderWidget2, row++, pageColumn); -

1125

}

never executed: end of block

1126

if (mac)

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1127

mainLayout->setRowMinimumHeight(row++, 7);

never executed: mainLayout->setRowMinimumHeight(row++, 7);

1128

}

never executed: end of block

1129

if (placeholderWidget1)

placeholderWidget1	Description
TRUE	never evaluated
FALSE	never evaluated

1130

placeholderWidget1->setVisible(info.title && modern);

never executed: placeholderWidget1->setVisible(info.title && modern);

1131

if (placeholderWidget2)

placeholderWidget2	Description
TRUE	never evaluated
FALSE	never evaluated

1132

placeholderWidget2->setVisible(info.title && modern);

never executed: placeholderWidget2->setVisible(info.title && modern);

1133 -

1134

if (info.subTitle) {

info.subTitle	Description
TRUE	never evaluated
FALSE	never evaluated

1135

if (!subTitleLabel) {

!subTitleLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1136 subTitleLabel = new QLabel(pageFrame); -

1137 subTitleLabel->setWordWrap(true); -

1138 -

1139 subTitleLabel->setContentsMargins(info.childMarginLeft , 0, -

1140 info.childMarginRight , 0); -

1141 -

1142 pageVBoxLayout->insertWidget(1, subTitleLabel); -

1143

}

never executed: end of block

1144

}

never executed: end of block

1145 -

1146 // ### try to replace with margin. -

1147 changeSpacerSize(pageVBoxLayout, 0, 0, info.subTitle ? info.childMarginLeft : 0); -

1148 -

1149

int hMargin = mac ? 1 : 0;

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1150 int vMargin = hMargin; -

1151 -

1152 pageFrame->setFrameStyle(mac ? (QFrame::Box | QFrame::Raised) : QFrame::NoFrame); -

1153 pageFrame->setLineWidth(0); -

1154 pageFrame->setMidLineWidth(hMargin); -

1155 -

1156

if (info.header) {

info.header	Description
TRUE	never evaluated
FALSE	never evaluated

1157

if (modern) {

modern	Description
TRUE	never evaluated
FALSE	never evaluated

1158 hMargin = info.topLevelMarginLeft; -

1159 vMargin = deltaMarginBottom; -

1160

} else if (classic) {

never executed: end of block

classic	Description
TRUE	never evaluated
FALSE	never evaluated

1161 hMargin = deltaMarginLeft + ClassicHMargin; -

1162 vMargin = 0; -

1163

}

never executed: end of block

1164

}

never executed: end of block

1165 -

1166

if (aero) {

aero	Description
TRUE	never evaluated
FALSE	never evaluated

1167 int leftMargin = 18; // ### hardcoded for now - should be calculated somehow -

1168 int topMargin = vMargin; -

1169 int rightMargin = hMargin; // ### for now -

1170 int bottomMargin = vMargin; -

1171 pageFrame->setContentsMargins(leftMargin, topMargin, rightMargin, bottomMargin); -

1172

} else {

never executed: end of block

1173 pageFrame->setContentsMargins(hMargin, vMargin, hMargin, vMargin); -

1174

}

never executed: end of block

1175 -

1176

if ((info.watermark || info.sideWidget) && !watermarkLabel) {

info.watermark	Description
TRUE	never evaluated
FALSE	never evaluated

info.sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

!watermarkLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1177 watermarkLabel = new QWatermarkLabel(antiFlickerWidget, sideWidget); -

1178 watermarkLabel->setBackgroundRole(QPalette::Base); -

1179 watermarkLabel->setMinimumHeight(1); -

1180 watermarkLabel->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Expanding); -

1181 watermarkLabel->setAlignment(Qt::AlignLeft | Qt::AlignTop); -

1182

}

never executed: end of block

1183 -

1184 //bool wasSemiTransparent = pageFrame->testAttribute(Qt::WA_SetPalette); -

1185 const bool wasSemiTransparent = -

1186

pageFrame->palette().brush(QPalette::Window).color().alpha() < 255

pageFrame->pal....alpha() < 255	Description
TRUE	never evaluated
FALSE	never evaluated

1187

|| pageFrame->palette().brush(QPalette::Base).color().alpha() < 255;

pageFrame->pal....alpha() < 255	Description
TRUE	never evaluated
FALSE	never evaluated

1188

if (mac) {

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1189

if (!wasSemiTransparent) {

!wasSemiTransparent	Description
TRUE	never evaluated
FALSE	never evaluated

1190 QPalette pal = pageFrame->palette(); -

1191 pal.setBrush(QPalette::Window, QColor(255, 255, 255, 153)); -

1192 // ### The next line is required to ensure visual semitransparency when -

1193 // ### switching from ModernStyle to MacStyle. See TAG1 below. -

1194 pal.setBrush(QPalette::Base, QColor(255, 255, 255, 153)); -

1195 pageFrame->setPalette(pal); -

1196 pageFrame->setAutoFillBackground(true); -

1197 antiFlickerWidget->setAutoFillBackground(false); -

1198

}

never executed: end of block

1199

} else {

never executed: end of block

1200

if (wasSemiTransparent)

wasSemiTransparent	Description
TRUE	never evaluated
FALSE	never evaluated

1201

pageFrame->setPalette(QPalette());

never executed: pageFrame->setPalette(QPalette());

1202 -

1203

bool baseBackground = (modern && !info.header); // ### TAG1

modern	Description
TRUE	never evaluated
FALSE	never evaluated

!info.header	Description
TRUE	never evaluated
FALSE	never evaluated

1204 pageFrame->setBackgroundRole(baseBackground ? QPalette::Base : QPalette::Window); -

1205 -

1206

if (titleLabel)

titleLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1207

titleLabel->setAutoFillBackground(baseBackground);

never executed: titleLabel->setAutoFillBackground(baseBackground);

1208 pageFrame->setAutoFillBackground(baseBackground); -

1209

if (watermarkLabel)

watermarkLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1210

watermarkLabel->setAutoFillBackground(baseBackground);

never executed: watermarkLabel->setAutoFillBackground(baseBackground);

1211

if (placeholderWidget1)

placeholderWidget1	Description
TRUE	never evaluated
FALSE	never evaluated

1212

placeholderWidget1->setAutoFillBackground(baseBackground);

never executed: placeholderWidget1->setAutoFillBackground(baseBackground);

1213

if (placeholderWidget2)

placeholderWidget2	Description
TRUE	never evaluated
FALSE	never evaluated

1214

placeholderWidget2->setAutoFillBackground(baseBackground);

never executed: placeholderWidget2->setAutoFillBackground(baseBackground);

1215 -

1216

if (aero) {

aero	Description
TRUE	never evaluated
FALSE	never evaluated

1217 QPalette pal = pageFrame->palette(); -

1218 pal.setBrush(QPalette::Window, QColor(255, 255, 255)); -

1219 pageFrame->setPalette(pal); -

1220 pageFrame->setAutoFillBackground(true); -

1221 pal = antiFlickerWidget->palette(); -

1222 pal.setBrush(QPalette::Window, QColor(255, 255, 255)); -

1223 antiFlickerWidget->setPalette(pal); -

1224 antiFlickerWidget->setAutoFillBackground(true); -

1225

}

never executed: end of block

1226

}

never executed: end of block

1227 -

1228 mainLayout->addWidget(pageFrame, row++, pageColumn); -

1229 -

1230 int watermarkEndRow = row; -

1231

if (classic)

classic	Description
TRUE	never evaluated
FALSE	never evaluated

1232

mainLayout->setRowMinimumHeight(row++, deltaVSpacing);

never executed: mainLayout->setRowMinimumHeight(row++, deltaVSpacing);

1233 -

1234

if (aero) {

aero	Description
TRUE	never evaluated
FALSE	never evaluated

1235 buttonLayout->setContentsMargins(9, 9, 9, 9); -

1236 mainLayout->setContentsMargins(0, 11, 0, 0); -

1237

}

never executed: end of block

1238 -

1239

int buttonStartColumn = info.extension ? 1 : 0;

info.extension	Description
TRUE	never evaluated
FALSE	never evaluated

1240

int buttonNumColumns = info.extension ? 1 : numColumns;

info.extension	Description
TRUE	never evaluated
FALSE	never evaluated

1241 -

1242

if (classic || modern) {

classic	Description
TRUE	never evaluated
FALSE	never evaluated

modern	Description
TRUE	never evaluated
FALSE	never evaluated

1243

if (!bottomRuler)

!bottomRuler	Description
TRUE	never evaluated
FALSE	never evaluated

1244

bottomRuler = new QWizardRuler(antiFlickerWidget);

never executed: bottomRuler = new QWizardRuler(antiFlickerWidget);

1245 mainLayout->addWidget(bottomRuler, row++, buttonStartColumn, 1, buttonNumColumns); -

1246

}

never executed: end of block

1247 -

1248

if (classic)

classic	Description
TRUE	never evaluated
FALSE	never evaluated

1249

mainLayout->setRowMinimumHeight(row++, deltaVSpacing);

never executed: mainLayout->setRowMinimumHeight(row++, deltaVSpacing);

1250 -

1251 mainLayout->addLayout(buttonLayout, row++, buttonStartColumn, 1, buttonNumColumns); -

1252 -

1253

if (info.watermark || info.sideWidget) {

info.watermark	Description
TRUE	never evaluated
FALSE	never evaluated

info.sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

1254

if (info.extension)

info.extension	Description
TRUE	never evaluated
FALSE	never evaluated

1255

watermarkEndRow = row;

never executed: watermarkEndRow = row;

1256 mainLayout->addWidget(watermarkLabel, watermarkStartRow, 0, -

1257 watermarkEndRow - watermarkStartRow, 1); -

1258

}

never executed: end of block

1259 -

1260 mainLayout->setColumnMinimumWidth(0, mac && !info.watermark ? 181 : 0); -

1261

if (mac)

mac	Description
TRUE	never evaluated
FALSE	never evaluated

1262

mainLayout->setColumnMinimumWidth(2, 21);

never executed: mainLayout->setColumnMinimumWidth(2, 21);

1263 -

1264

if (headerWidget)

headerWidget	Description
TRUE	never evaluated
FALSE	never evaluated

1265

headerWidget->setVisible(info.header);

never executed: headerWidget->setVisible(info.header);

1266

if (titleLabel)

titleLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1267

titleLabel->setVisible(info.title);

never executed: titleLabel->setVisible(info.title);

1268

if (subTitleLabel)

subTitleLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1269

subTitleLabel->setVisible(info.subTitle);

never executed: subTitleLabel->setVisible(info.subTitle);

1270

if (bottomRuler)

bottomRuler	Description
TRUE	never evaluated
FALSE	never evaluated

1271

bottomRuler->setVisible(classic || modern);

never executed: bottomRuler->setVisible(classic || modern);

1272

if (watermarkLabel)

watermarkLabel	Description
TRUE	never evaluated
FALSE	never evaluated

1273

watermarkLabel->setVisible(info.watermark || info.sideWidget);

never executed: watermarkLabel->setVisible(info.watermark || info.sideWidget);

1274 -

1275 layoutInfo = info; -

1276

}

never executed: end of block

1277 -

1278 void QWizardPrivate::updateLayout() -

1279 { -

1280 Q_Q(QWizard); -

1281 -

1282 disableUpdates(); -

1283 -

1284 QWizardLayoutInfo info = layoutInfoForCurrentPage(); -

1285

if (layoutInfo != info)

layoutInfo != info	Description
TRUE	never evaluated
FALSE	never evaluated

1286

recreateLayout(info);

never executed: recreateLayout(info);

1287 QWizardPage *page = q->currentPage(); -

1288 -

1289 // If the page can expand vertically, let it stretch "infinitely" more -

1290 // than the QSpacerItem at the bottom. Otherwise, let the QSpacerItem -

1291 // stretch "infinitely" more than the page. Change the bottom item's -

1292 // policy accordingly. The case that the page has no layout is basically -

1293 // for Designer, only. -

1294

if (page) {

page	Description
TRUE	never evaluated
FALSE	never evaluated

1295 bool expandPage = !page->layout(); -

1296

if (!expandPage) {

!expandPage	Description
TRUE	never evaluated
FALSE	never evaluated

1297 const QLayoutItem *pageItem = pageVBoxLayout->itemAt(pageVBoxLayout->indexOf(page)); -

1298 expandPage = pageItem->expandingDirections() & Qt::Vertical; -

1299

}

never executed: end of block

1300 QSpacerItem *bottomSpacer = pageVBoxLayout->itemAt(pageVBoxLayout->count() - 1)->spacerItem(); -

1301 Q_ASSERT(bottomSpacer); -

1302 bottomSpacer->changeSize(0, 0, QSizePolicy::Ignored, expandPage ? QSizePolicy::Ignored : QSizePolicy::MinimumExpanding); -

1303 pageVBoxLayout->invalidate(); -

1304

}

never executed: end of block

1305 -

1306

if (info.header) {

info.header	Description
TRUE	never evaluated
FALSE	never evaluated

1307 Q_ASSERT(page); -

1308 headerWidget->setup(info, page->title(), page->subTitle(), -

1309 page->pixmap(QWizard::LogoPixmap), page->pixmap(QWizard::BannerPixmap), -

1310 titleFmt, subTitleFmt); -

1311

}

never executed: end of block

1312 -

1313

if (info.watermark || info.sideWidget) {

info.watermark	Description
TRUE	never evaluated
FALSE	never evaluated

info.sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

1314 QPixmap pix; -

1315

if (info.watermark) {

info.watermark	Description
TRUE	never evaluated
FALSE	never evaluated

1316

if (page)

page	Description
TRUE	never evaluated
FALSE	never evaluated

1317

pix = page->pixmap(QWizard::WatermarkPixmap);

never executed: pix = page->pixmap(QWizard::WatermarkPixmap);

1318 else -

1319

pix = q->pixmap(QWizard::WatermarkPixmap);

never executed: pix = q->pixmap(QWizard::WatermarkPixmap);

1320 } -

1321 watermarkLabel->setPixmap(pix); // in case there is no watermark and we show the side widget we need to clear the watermark -

1322

}

never executed: end of block

1323 -

1324

if (info.title) {

info.title	Description
TRUE	never evaluated
FALSE	never evaluated

1325 Q_ASSERT(page); -

1326 titleLabel->setTextFormat(titleFmt); -

1327 titleLabel->setText(page->title()); -

1328

}

never executed: end of block

1329

if (info.subTitle) {

info.subTitle	Description
TRUE	never evaluated
FALSE	never evaluated

1330 Q_ASSERT(page); -

1331 subTitleLabel->setTextFormat(subTitleFmt); -

1332 subTitleLabel->setText(page->subTitle()); -

1333

}

never executed: end of block

1334 -

1335 enableUpdates(); -

1336 updateMinMaxSizes(info); -

1337

}

never executed: end of block

1338 -

1339 void QWizardPrivate::updateMinMaxSizes(const QWizardLayoutInfo &info) -

1340 { -

1341 Q_Q(QWizard); -

1342 -

1343 int extraHeight = 0; -

1344 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

1345 if (isVistaThemeEnabled()) -

1346 extraHeight = vistaHelper->titleBarSize() + vistaHelper->topOffset(); -

1347 #endif -

1348 QSize minimumSize = mainLayout->totalMinimumSize() + QSize(0, extraHeight); -

1349 QSize maximumSize = mainLayout->totalMaximumSize(); -

1350

if (info.header && headerWidget->maximumWidth() != QWIDGETSIZE_MAX) {

info.header	Description
TRUE	never evaluated
FALSE	never evaluated

headerWidget->...!= ((1<<24)-1)	Description
TRUE	never evaluated
FALSE	never evaluated

1351 minimumSize.setWidth(headerWidget->maximumWidth()); -

1352 maximumSize.setWidth(headerWidget->maximumWidth()); -

1353

}

never executed: end of block

1354

if (info.watermark && !info.sideWidget) {

info.watermark	Description
TRUE	never evaluated
FALSE	never evaluated

!info.sideWidget	Description
TRUE	never evaluated
FALSE	never evaluated

1355 minimumSize.setHeight(mainLayout->totalSizeHint().height()); -

1356

}

never executed: end of block

1357

if (q->minimumWidth() == minimumWidth) {

q->minimumWidt...= minimumWidth	Description
TRUE	never evaluated
FALSE	never evaluated

1358 minimumWidth = minimumSize.width(); -

1359 q->setMinimumWidth(minimumWidth); -

1360

}

never executed: end of block

1361

if (q->minimumHeight() == minimumHeight) {

q->minimumHeig... minimumHeight	Description
TRUE	never evaluated
FALSE	never evaluated

1362 minimumHeight = minimumSize.height(); -

1363 q->setMinimumHeight(minimumHeight); -

1364

}

never executed: end of block

1365

if (q->maximumWidth() == maximumWidth) {

q->maximumWidt...= maximumWidth	Description
TRUE	never evaluated
FALSE	never evaluated

1366 maximumWidth = maximumSize.width(); -

1367 q->setMaximumWidth(maximumWidth); -

1368

}

never executed: end of block

1369

if (q->maximumHeight() == maximumHeight) {

q->maximumHeig... maximumHeight	Description
TRUE	never evaluated
FALSE	never evaluated

1370 maximumHeight = maximumSize.height(); -

1371 q->setMaximumHeight(maximumHeight); -

1372

}

never executed: end of block

1373

}

never executed: end of block

1374 -

1375 void QWizardPrivate::updateCurrentPage() -

1376 { -

1377 Q_Q(QWizard); -

1378

if (q->currentPage()) {

q->currentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

1379 canContinue = (q->nextId() != -1); -

1380 canFinish = q->currentPage()->isFinalPage(); -

1381

} else {

never executed: end of block

1382 canContinue = false; -

1383 canFinish = false; -

1384

}

never executed: end of block

1385 _q_updateButtonStates(); -

1386 updateButtonTexts(); -

1387

}

never executed: end of block

1388 -

1389 static QString object_name_for_button(QWizard::WizardButton which) -

1390 { -

1391 switch (which) { -

1392

case QWizard::CommitButton:

never executed: case QWizard::CommitButton:

1393

return QLatin1String("qt_wizard_") + QLatin1String("commit");

never executed: return QLatin1String("qt_wizard_") + QLatin1String("commit");

1394

case QWizard::FinishButton:

never executed: case QWizard::FinishButton:

1395

return QLatin1String("qt_wizard_") + QLatin1String("finish");

never executed: return QLatin1String("qt_wizard_") + QLatin1String("finish");

1396

case QWizard::CancelButton:

never executed: case QWizard::CancelButton:

1397

return QLatin1String("qt_wizard_") + QLatin1String("cancel");

never executed: return QLatin1String("qt_wizard_") + QLatin1String("cancel");

1398

case QWizard::BackButton:

never executed: case QWizard::BackButton:

1399

case QWizard::NextButton:

never executed: case QWizard::NextButton:

1400

case QWizard::HelpButton:

never executed: case QWizard::HelpButton:

1401

case QWizard::CustomButton1:

never executed: case QWizard::CustomButton1:

1402

case QWizard::CustomButton2:

never executed: case QWizard::CustomButton2:

1403

case QWizard::CustomButton3:

never executed: case QWizard::CustomButton3:

1404 // Make navigation buttons detectable as passive interactor in designer -

1405

return QLatin1String("__qt__passive_wizardbutton") + QString::number(which);

never executed: return QLatin1String("__qt__passive_wizardbutton") + QString::number(which);

1406

case QWizard::Stretch:

never executed: case QWizard::Stretch:

1407

case QWizard::NoButton:

never executed: case QWizard::NoButton:

1408 //case QWizard::NStandardButtons: -

1409 //case QWizard::NButtons: -

1410 ; -

1411

}

never executed: end of block

1412 Q_UNREACHABLE(); -

1413

return QString();

never executed: return QString();

1414 } -

1415 -

1416 bool QWizardPrivate::ensureButton(QWizard::WizardButton which) const -

1417 { -

1418 Q_Q(const QWizard); -

1419

if (uint(which) >= QWizard::NButtons)

uint(which) >=...zard::NButtons	Description
TRUE	never evaluated
FALSE	never evaluated

1420

return false;

never executed: return false;

1421 -

1422

if (!btns[which]) {

!btns[which]	Description
TRUE	never evaluated
FALSE	never evaluated

1423 QPushButton *pushButton = new QPushButton(antiFlickerWidget); -

1424 QStyle *style = q->style(); -

1425

if (style != QApplication::style()) // Propagate style

style != QApplication::style()	Description
TRUE	never evaluated
FALSE	never evaluated

1426

pushButton->setStyle(style);

never executed: pushButton->setStyle(style);

1427 pushButton->setObjectName(object_name_for_button(which)); -

1428 #ifdef Q_OS_MACX -

1429 pushButton->setAutoDefault(false); -

1430 #endif -

1431 pushButton->hide(); -

1432 #ifdef Q_CC_HPACC -

1433 const_cast<QWizardPrivate *>(this)->btns[which] = pushButton; -

1434 #else -

1435 btns[which] = pushButton; -

1436 #endif -

1437

if (which < QWizard::NStandardButtons)

which < QWizar...tandardButtons	Description
TRUE	never evaluated
FALSE	never evaluated

1438

pushButton->setText(buttonDefaultText(wizStyle, which, this));

never executed: pushButton->setText(buttonDefaultText(wizStyle, which, this));

1439 -

1440 connectButton(which); -

1441

}

never executed: end of block

1442

return true;

never executed: return true;

1443 } -

1444 -

1445 void QWizardPrivate::connectButton(QWizard::WizardButton which) const -

1446 { -

1447 Q_Q(const QWizard); -

1448

if (which < QWizard::NStandardButtons) {

which < QWizar...tandardButtons	Description
TRUE	never evaluated
FALSE	never evaluated

1449 QObject::connect(btns[which], SIGNAL(clicked()), q, buttonSlots(which)); -

1450

} else {

never executed: end of block

1451 QObject::connect(btns[which], SIGNAL(clicked()), q, SLOT(_q_emitCustomButtonClicked())); -

1452

}

never executed: end of block

1453 } -

1454 -

1455 void QWizardPrivate::updateButtonTexts() -

1456 { -

1457 Q_Q(QWizard); -

1458

for (int i = 0; i < QWizard::NButtons; ++i) {

i < QWizard::NButtons	Description
TRUE	never evaluated
FALSE	never evaluated

1459

if (btns[i]) {

btns[i]	Description
TRUE	never evaluated
FALSE	never evaluated

1460

if (q->currentPage() && (q->currentPage()->d_func()->buttonCustomTexts.contains(i)))

q->currentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

(q->currentPag...s.contains(i))	Description
TRUE	never evaluated
FALSE	never evaluated

1461

btns[i]->setText(q->currentPage()->d_func()->buttonCustomTexts.value(i));

never executed: btns[i]->setText(q->currentPage()->d_func()->buttonCustomTexts.value(i));

1462

else if (buttonCustomTexts.contains(i))

buttonCustomTexts.contains(i)	Description
TRUE	never evaluated
FALSE	never evaluated

1463

btns[i]->setText(buttonCustomTexts.value(i));

never executed: btns[i]->setText(buttonCustomTexts.value(i));

1464

else if (i < QWizard::NStandardButtons)

i < QWizard::NStandardButtons	Description
TRUE	never evaluated
FALSE	never evaluated

1465

btns[i]->setText(buttonDefaultText(wizStyle, i, this));

never executed: btns[i]->setText(buttonDefaultText(wizStyle, i, this));

1466

}

never executed: end of block

1467

}

never executed: end of block

1468 // Vista: Add shortcut for 'next'. Note: native dialogs use ALT-Right -

1469 // even in RTL mode, so do the same, even if it might be counter-intuitive. -

1470 // The shortcut for 'back' is set in class QVistaBackButton. -

1471

if (btns[QWizard::NextButton])

btns[QWizard::NextButton]	Description
TRUE	never evaluated
FALSE	never evaluated

1472

btns[QWizard::NextButton]->setShortcut(isVistaThemeEnabled() ? QKeySequence(Qt::ALT | Qt::Key_Right) : QKeySequence());

never executed: btns[QWizard::NextButton]->setShortcut(isVistaThemeEnabled() ? QKeySequence(Qt::ALT | Qt::Key_Right) : QKeySequence());

1473

}

never executed: end of block

1474 -

1475 void QWizardPrivate::updateButtonLayout() -

1476 { -

1477

if (buttonsHaveCustomLayout) {

buttonsHaveCustomLayout	Description
TRUE	never evaluated
FALSE	never evaluated

1478 QVarLengthArray<QWizard::WizardButton, QWizard::NButtons> array(buttonsCustomLayout.count()); -

1479

for (int i = 0; i < buttonsCustomLayout.count(); ++i)

i < buttonsCus...Layout.count()	Description
TRUE	never evaluated
FALSE	never evaluated

1480

array[i] = buttonsCustomLayout.at(i);

never executed: array[i] = buttonsCustomLayout.at(i);

1481 setButtonLayout(array.constData(), array.count()); -

1482

} else {

never executed: end of block

1483 // Positions: -

1484 // Help Stretch Custom1 Custom2 Custom3 Cancel Back Next Commit Finish Cancel Help -

1485 -

1486 const int ArraySize = 12; -

1487 QWizard::WizardButton array[ArraySize]; -

1488 memset(array, -1, sizeof(array)); -

1489 Q_ASSERT(array[0] == QWizard::NoButton); -

1490 -

1491

if (opts & QWizard::HaveHelpButton) {

opts & QWizard::HaveHelpButton	Description
TRUE	never evaluated
FALSE	never evaluated

1492

int i = (opts & QWizard::HelpButtonOnRight) ? 11 : 0;

(opts & QWizar...ButtonOnRight)	Description
TRUE	never evaluated
FALSE	never evaluated

1493 array[i] = QWizard::HelpButton; -

1494

}

never executed: end of block

1495 array[1] = QWizard::Stretch; -

1496

if (opts & QWizard::HaveCustomButton1)

opts & QWizard...eCustomButton1	Description
TRUE	never evaluated
FALSE	never evaluated

1497

array[2] = QWizard::CustomButton1;

never executed: array[2] = QWizard::CustomButton1;

1498

if (opts & QWizard::HaveCustomButton2)

opts & QWizard...eCustomButton2	Description
TRUE	never evaluated
FALSE	never evaluated

1499

array[3] = QWizard::CustomButton2;

never executed: array[3] = QWizard::CustomButton2;

1500

if (opts & QWizard::HaveCustomButton3)

opts & QWizard...eCustomButton3	Description
TRUE	never evaluated
FALSE	never evaluated

1501

array[4] = QWizard::CustomButton3;

never executed: array[4] = QWizard::CustomButton3;

1502 -

1503

if (!(opts & QWizard::NoCancelButton)) {

!(opts & QWiza...oCancelButton)	Description
TRUE	never evaluated
FALSE	never evaluated

1504

int i = (opts & QWizard::CancelButtonOnLeft) ? 5 : 10;

(opts & QWizar...lButtonOnLeft)	Description
TRUE	never evaluated
FALSE	never evaluated

1505 array[i] = QWizard::CancelButton; -

1506

}

never executed: end of block

1507 array[6] = QWizard::BackButton; -

1508 array[7] = QWizard::NextButton; -

1509 array[8] = QWizard::CommitButton; -

1510 array[9] = QWizard::FinishButton; -

1511 -

1512 setButtonLayout(array, ArraySize); -

1513

}

never executed: end of block

1514 } -

1515 -

1516 void QWizardPrivate::setButtonLayout(const QWizard::WizardButton *array, int size) -

1517 { -

1518 QWidget *prev = pageFrame; -

1519 -

1520

for (int i = buttonLayout->count() - 1; i >= 0; --i) {

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

1521 QLayoutItem *item = buttonLayout->takeAt(i); -

1522

if (QWidget *widget = item->widget())

QWidget *widge...item->widget()	Description
TRUE	never evaluated
FALSE	never evaluated

1523

widget->hide();

never executed: widget->hide();

1524 delete item; -

1525

}

never executed: end of block

1526 -

1527

for (int i = 0; i < size; ++i) {

i < size	Description
TRUE	never evaluated
FALSE	never evaluated

1528 QWizard::WizardButton which = array[i]; -

1529

if (which == QWizard::Stretch) {

which == QWizard::Stretch	Description
TRUE	never evaluated
FALSE	never evaluated

1530 buttonLayout->addStretch(1); -

1531

} else if (which != QWizard::NoButton) {

never executed: end of block

which != QWizard::NoButton	Description
TRUE	never evaluated
FALSE	never evaluated

1532 ensureButton(which); -

1533 buttonLayout->addWidget(btns[which]); -

1534 -

1535 // Back, Next, Commit, and Finish are handled in _q_updateButtonStates() -

1536

if (which != QWizard::BackButton && which != QWizard::NextButton

which != QWizard::BackButton	Description
TRUE	never evaluated
FALSE	never evaluated

which != QWizard::NextButton	Description
TRUE	never evaluated
FALSE	never evaluated

1537

&& which != QWizard::CommitButton && which != QWizard::FinishButton)

which != QWizard::CommitButton	Description
TRUE	never evaluated
FALSE	never evaluated

which != QWizard::FinishButton	Description
TRUE	never evaluated
FALSE	never evaluated

1538

btns[which]->show();

never executed: btns[which]->show();

1539 -

1540

if (prev)

prev	Description
TRUE	never evaluated
FALSE	never evaluated

1541

QWidget::setTabOrder(prev, btns[which]);

never executed: QWidget::setTabOrder(prev, btns[which]);

1542 prev = btns[which]; -

1543

}

never executed: end of block

1544

}

never executed: end of block

1545 -

1546 _q_updateButtonStates(); -

1547

}

never executed: end of block

1548 -

1549 bool QWizardPrivate::buttonLayoutContains(QWizard::WizardButton which) -

1550 { -

1551

return !buttonsHaveCustomLayout || buttonsCustomLayout.contains(which);

never executed: return !buttonsHaveCustomLayout || buttonsCustomLayout.contains(which);

1552 } -

1553 -

1554 void QWizardPrivate::updatePixmap(QWizard::WizardPixmap which) -

1555 { -

1556 Q_Q(QWizard); -

1557

if (which == QWizard::BackgroundPixmap) {

which == QWiza...ckgroundPixmap	Description
TRUE	never evaluated
FALSE	never evaluated

1558

if (wizStyle == QWizard::MacStyle) {

wizStyle == QWizard::MacStyle	Description
TRUE	never evaluated
FALSE	never evaluated

1559 q->update(); -

1560 q->updateGeometry(); -

1561

}

never executed: end of block

1562

} else {

never executed: end of block

1563 updateLayout(); -

1564

}

never executed: end of block

1565 } -

1566 -

1567 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

1568 bool QWizardPrivate::vistaDisabled() const -

1569 { -

1570 Q_Q(const QWizard); -

1571 const QVariant v = q->property("_q_wizard_vista_off"); -

1572 return v.isValid() && v.toBool(); -

1573 } -

1574 -

1575 bool QWizardPrivate::isVistaThemeEnabled(QVistaHelper::VistaState state) const -

1576 { -

1577 return wizStyle == QWizard::AeroStyle -

1578 && QVistaHelper::vistaState() == state -

1579 && !vistaDisabled(); -

1580 } -

1581 -

1582 bool QWizardPrivate::handleAeroStyleChange() -

1583 { -

1584 Q_Q(QWizard); -

1585 -

1586 if (inHandleAeroStyleChange) -

1587 return false; // prevent recursion -

1588 // For top-level wizards, we need the platform window handle for the -

1589 // DWM changes. Delay aero initialization to the show event handling if -

1590 // it does not exist. If we are a child, skip DWM and just make room by -

1591 // moving the antiFlickerWidget. -

1592 const bool isWindow = q->isWindow(); -

1593 if (isWindow && (!q->windowHandle() || !q->windowHandle()->handle())) -

1594 return false; -

1595 inHandleAeroStyleChange = true; -

1596 -

1597 vistaHelper->disconnectBackButton(); -

1598 q->removeEventFilter(vistaHelper); -

1599 -

1600 bool vistaMargins = false; -

1601 -

1602 if (isVistaThemeEnabled()) { -

1603 if (isVistaThemeEnabled(QVistaHelper::VistaAero)) { -

1604 if (isWindow) { -

1605 vistaHelper->setDWMTitleBar(QVistaHelper::ExtendedTitleBar); -

1606 q->installEventFilter(vistaHelper); -

1607 } -

1608 q->setMouseTracking(true); -

1609 antiFlickerWidget->move(0, vistaHelper->titleBarSize() + vistaHelper->topOffset()); -

1610 vistaHelper->backButton()->move( -

1611 0, vistaHelper->topOffset() // ### should ideally work without the '+ 1' -

1612 - qMin(vistaHelper->topOffset(), vistaHelper->topPadding() + 1)); -

1613 vistaMargins = true; -

1614 vistaHelper->backButton()->show(); -

1615 } else { -

1616 if (isWindow) -

1617 vistaHelper->setDWMTitleBar(QVistaHelper::NormalTitleBar); -

1618 q->setMouseTracking(true); -

1619 antiFlickerWidget->move(0, vistaHelper->topOffset()); -

1620 vistaHelper->backButton()->move(0, -1); // ### should ideally work with (0, 0) -

1621 } -

1622 if (isWindow) -

1623 vistaHelper->setTitleBarIconAndCaptionVisible(false); -

1624 QObject::connect( -

1625 vistaHelper->backButton(), SIGNAL(clicked()), q, buttonSlots(QWizard::BackButton)); -

1626 vistaHelper->backButton()->show(); -

1627 } else { -

1628 q->setMouseTracking(true); // ### original value possibly different -

1629 #ifndef QT_NO_CURSOR -

1630 q->unsetCursor(); // ### ditto -

1631 #endif -

1632 antiFlickerWidget->move(0, 0); -

1633 vistaHelper->hideBackButton(); -

1634 if (isWindow) -

1635 vistaHelper->setTitleBarIconAndCaptionVisible(true); -

1636 } -

1637 -

1638 _q_updateButtonStates(); -

1639 -

1640 vistaHelper->updateCustomMargins(vistaMargins); -

1641 -

1642 inHandleAeroStyleChange = false; -

1643 return true; -

1644 } -

1645 #endif -

1646 -

1647 bool QWizardPrivate::isVistaThemeEnabled() const -

1648 { -

1649 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

1650 return isVistaThemeEnabled(QVistaHelper::VistaAero) -

1651 || isVistaThemeEnabled(QVistaHelper::VistaBasic); -

1652 #else -

1653

return false;

never executed: return false;

1654 #endif -

1655 } -

1656 -

1657 void QWizardPrivate::disableUpdates() -

1658 { -

1659 Q_Q(QWizard); -

1660

if (disableUpdatesCount++ == 0) {

disableUpdatesCount++ == 0	Description
TRUE	never evaluated
FALSE	never evaluated

1661 q->setUpdatesEnabled(false); -

1662 antiFlickerWidget->hide(); -

1663

}

never executed: end of block

1664

}

never executed: end of block

1665 -

1666 void QWizardPrivate::enableUpdates() -

1667 { -

1668 Q_Q(QWizard); -

1669

if (--disableUpdatesCount == 0) {

--disableUpdatesCount == 0	Description
TRUE	never evaluated
FALSE	never evaluated

1670 antiFlickerWidget->show(); -

1671 q->setUpdatesEnabled(true); -

1672

}

never executed: end of block

1673

}

never executed: end of block

1674 -

1675 void QWizardPrivate::_q_emitCustomButtonClicked() -

1676 { -

1677 Q_Q(QWizard); -

1678 QObject *button = q->sender(); -

1679

for (int i = QWizard::NStandardButtons; i < QWizard::NButtons; ++i) {

i < QWizard::NButtons	Description
TRUE	never evaluated
FALSE	never evaluated

1680

if (btns[i] == button) {

btns[i] == button	Description
TRUE	never evaluated
FALSE	never evaluated

1681 emit q->customButtonClicked(QWizard::WizardButton(i)); -

1682

break;

never executed: break;

1683 } -

1684

}

never executed: end of block

1685

}

never executed: end of block

1686 -

1687 void QWizardPrivate::_q_updateButtonStates() -

1688 { -

1689 Q_Q(QWizard); -

1690 -

1691 disableUpdates(); -

1692 -

1693 const QWizardPage *page = q->currentPage(); -

1694

bool complete = page && page->isComplete();

page	Description
TRUE	never evaluated
FALSE	never evaluated

page->isComplete()	Description
TRUE	never evaluated
FALSE	never evaluated

1695 -

1696 btn.back->setEnabled(history.count() > 1 -

1697 && !q->page(history.at(history.count() - 2))->isCommitPage() -

1698 && (!canFinish || !(opts & QWizard::DisabledBackButtonOnLastPage))); -

1699 btn.next->setEnabled(canContinue && complete); -

1700 btn.commit->setEnabled(canContinue && complete); -

1701 btn.finish->setEnabled(canFinish && complete); -

1702 -

1703

const bool backButtonVisible = buttonLayoutContains(QWizard::BackButton)

buttonLayoutCo...d::BackButton)	Description
TRUE	never evaluated
FALSE	never evaluated

1704

&& (history.count() > 1 || !(opts & QWizard::NoBackButtonOnStartPage))

history.count() > 1	Description
TRUE	never evaluated
FALSE	never evaluated

!(opts & QWiza...onOnStartPage)	Description
TRUE	never evaluated
FALSE	never evaluated

1705

&& (canContinue || !(opts & QWizard::NoBackButtonOnLastPage));

canContinue	Description
TRUE	never evaluated
FALSE	never evaluated

!(opts & QWiza...tonOnLastPage)	Description
TRUE	never evaluated
FALSE	never evaluated

1706

bool commitPage = page && page->isCommitPage();

page	Description
TRUE	never evaluated
FALSE	never evaluated

page->isCommitPage()	Description
TRUE	never evaluated
FALSE	never evaluated

1707 btn.back->setVisible(backButtonVisible); -

1708 btn.next->setVisible(buttonLayoutContains(QWizard::NextButton) && !commitPage -

1709 && (canContinue || (opts & QWizard::HaveNextButtonOnLastPage))); -

1710 btn.commit->setVisible(buttonLayoutContains(QWizard::CommitButton) && commitPage -

1711 && canContinue); -

1712 btn.finish->setVisible(buttonLayoutContains(QWizard::FinishButton) -

1713 && (canFinish || (opts & QWizard::HaveFinishButtonOnEarlyPages))); -

1714 -

1715

if (!(opts & QWizard::NoCancelButton))

!(opts & QWiza...oCancelButton)	Description
TRUE	never evaluated
FALSE	never evaluated

1716

btn.cancel->setVisible(buttonLayoutContains(QWizard::CancelButton)

never executed:

btn.cancel->setVisible(buttonLayoutContains(QWizard::CancelButton) && (canContinue || !(opts & QWizard::NoCancelButtonOnLastPage)));

1717

&& (canContinue || !(opts & QWizard::NoCancelButtonOnLastPage)));

never executed:

btn.cancel->setVisible(buttonLayoutContains(QWizard::CancelButton) && (canContinue || !(opts & QWizard::NoCancelButtonOnLastPage)));

1718 -

1719 bool useDefault = !(opts & QWizard::NoDefaultButton); -

1720

if (QPushButton *nextPush = qobject_cast<QPushButton *>(btn.next))

QPushButton n...n >(btn.next)	Description
TRUE	never evaluated
FALSE	never evaluated

1721

nextPush->setDefault(canContinue && useDefault && !commitPage);

never executed: nextPush->setDefault(canContinue && useDefault && !commitPage);

1722

if (QPushButton *commitPush = qobject_cast<QPushButton *>(btn.commit))

QPushButton c...>(btn.commit)	Description
TRUE	never evaluated
FALSE	never evaluated

1723

commitPush->setDefault(canContinue && useDefault && commitPage);

never executed: commitPush->setDefault(canContinue && useDefault && commitPage);

1724

if (QPushButton *finishPush = qobject_cast<QPushButton *>(btn.finish))

QPushButton f...>(btn.finish)	Description
TRUE	never evaluated
FALSE	never evaluated

1725

finishPush->setDefault(!canContinue && useDefault);

never executed: finishPush->setDefault(!canContinue && useDefault);

1726 -

1727 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

1728 if (isVistaThemeEnabled()) { -

1729 vistaHelper->backButton()->setEnabled(btn.back->isEnabled()); -

1730 vistaHelper->backButton()->setVisible(backButtonVisible); -

1731 btn.back->setVisible(false); -

1732 } -

1733 #endif -

1734 -

1735 enableUpdates(); -

1736

}

never executed: end of block

1737 -

1738 void QWizardPrivate::_q_handleFieldObjectDestroyed(QObject *object) -

1739 { -

1740 int destroyed_index = -1; -

1741 QVector<QWizardField>::iterator it = fields.begin(); -

1742

while (it != fields.end()) {

it != fields.end()	Description
TRUE	never evaluated
FALSE	never evaluated

1743 const QWizardField &field = *it; -

1744

if (field.object == object) {

field.object == object	Description
TRUE	never evaluated
FALSE	never evaluated

1745 destroyed_index = fieldIndexMap.value(field.name, -1); -

1746 fieldIndexMap.remove(field.name); -

1747 it = fields.erase(it); -

1748

} else {

never executed: end of block

1749 ++it; -

1750

}

never executed: end of block

1751 } -

1752

if (destroyed_index != -1) {

destroyed_index != -1	Description
TRUE	never evaluated
FALSE	never evaluated

1753 QMap<QString, int>::iterator it2 = fieldIndexMap.begin(); -

1754

while (it2 != fieldIndexMap.end()) {

it2 != fieldIndexMap.end()	Description
TRUE	never evaluated
FALSE	never evaluated

1755 int index = it2.value(); -

1756

if (index > destroyed_index) {

index > destroyed_index	Description
TRUE	never evaluated
FALSE	never evaluated

1757 QString field_name = it2.key(); -

1758 fieldIndexMap.insert(field_name, index-1); -

1759

}

never executed: end of block

1760 ++it2; -

1761

}

never executed: end of block

1762

}

never executed: end of block

1763

}

never executed: end of block

1764 -

1765 void QWizardPrivate::setStyle(QStyle *style) -

1766 { -

1767

for (int i = 0; i < QWizard::NButtons; i++)

i < QWizard::NButtons	Description
TRUE	never evaluated
FALSE	never evaluated

1768

if (btns[i])

btns[i]	Description
TRUE	never evaluated
FALSE	never evaluated

1769

btns[i]->setStyle(style);

never executed: btns[i]->setStyle(style);

1770 const PageMap::const_iterator pcend = pageMap.constEnd(); -

1771

for (PageMap::const_iterator it = pageMap.constBegin(); it != pcend; ++it)

it != pcend	Description
TRUE	never evaluated
FALSE	never evaluated

1772

it.value()->setStyle(style);

never executed: it.value()->setStyle(style);

1773

}

never executed: end of block

1774 -

1775 #ifdef Q_OS_MACX -

1776 -

1777 QPixmap QWizardPrivate::findDefaultBackgroundPixmap() -

1778 { -

1779 QGuiApplication *app = qobject_cast<QGuiApplication *>(QCoreApplication::instance()); -

1780 if (!app) -

1781 return QPixmap(); -

1782 QPlatformNativeInterface *platformNativeInterface = app->platformNativeInterface(); -

1783 int at = platformNativeInterface->metaObject()->indexOfMethod("defaultBackgroundPixmapForQWizard()"); -

1784 if (at == -1) -

1785 return QPixmap(); -

1786 QMetaMethod defaultBackgroundPixmapForQWizard = platformNativeInterface->metaObject()->method(at); -

1787 QPixmap result; -

1788 if (!defaultBackgroundPixmapForQWizard.invoke(platformNativeInterface, Q_RETURN_ARG(QPixmap, result))) -

1789 return QPixmap(); -

1790 return result; -

1791 } -

1792 -

1793 #endif -

1794 -

1795 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

1796 void QWizardAntiFlickerWidget::paintEvent(QPaintEvent *) -

1797 { -

1798 if (wizardPrivate->isVistaThemeEnabled()) { -

1799 int leftMargin, topMargin, rightMargin, bottomMargin; -

1800 wizardPrivate->buttonLayout->getContentsMargins( -

1801 &leftMargin, &topMargin, &rightMargin, &bottomMargin); -

1802 const int buttonLayoutTop = wizardPrivate->buttonLayout->contentsRect().top() - topMargin; -

1803 QPainter painter(this); -

1804 const QBrush brush(QColor(240, 240, 240)); // ### hardcoded for now -

1805 painter.fillRect(0, buttonLayoutTop, width(), height() - buttonLayoutTop, brush); -

1806 painter.setPen(QPen(QBrush(QColor(223, 223, 223)), 0)); // ### hardcoded for now -

1807 painter.drawLine(0, buttonLayoutTop, width(), buttonLayoutTop); -

1808 if (wizardPrivate->isVistaThemeEnabled(QVistaHelper::VistaBasic)) { -

1809 if (window()->isActiveWindow()) -

1810 painter.setPen(QPen(QBrush(QColor(169, 191, 214)), 0)); // ### hardcoded for now -

1811 else -

1812 painter.setPen(QPen(QBrush(QColor(182, 193, 204)), 0)); // ### hardcoded for now -

1813 painter.drawLine(0, 0, width(), 0); -

1814 } -

1815 } -

1816 } -

1817 #endif -

1818 -

1819 /*! -

1820 \class QWizard -

1821 \since 4.3 -

1822 \brief The QWizard class provides a framework for wizards. -

1823 -

1824 \inmodule QtWidgets -

1825 -

1826 A wizard (also called an assistant on \macos) is a special type -

1827 of input dialog that consists of a sequence of pages. A wizard's -

1828 purpose is to guide the user through a process step by step. -

1829 Wizards are useful for complex or infrequent tasks that users may -

1830 find difficult to learn. -

1831 -

1832 QWizard inherits QDialog and represents a wizard. Each page is a -

1833 QWizardPage (a QWidget subclass). To create your own wizards, you -

1834 can use these classes directly, or you can subclass them for more -

1835 control. -

1836 -

1837 Topics: -

1838 -

1839 \tableofcontents -

1840 -

1841 \section1 A Trivial Example -

1842 -

1843 The following example illustrates how to create wizard pages and -

1844 add them to a wizard. For more advanced examples, see -

1845 \l{dialogs/classwizard}{Class Wizard} and \l{dialogs/licensewizard}{License -

1846 Wizard}. -

1847 -

1848 \snippet dialogs/trivialwizard/trivialwizard.cpp 1 -

1849 \snippet dialogs/trivialwizard/trivialwizard.cpp 3 -

1850 \dots -

1851 \snippet dialogs/trivialwizard/trivialwizard.cpp 4 -

1852 \codeline -

1853 \snippet dialogs/trivialwizard/trivialwizard.cpp 5 -

1854 \snippet dialogs/trivialwizard/trivialwizard.cpp 7 -

1855 \dots -

1856 \snippet dialogs/trivialwizard/trivialwizard.cpp 8 -

1857 \codeline -

1858 \snippet dialogs/trivialwizard/trivialwizard.cpp 10 -

1859 -

1860 \section1 Wizard Look and Feel -

1861 -

1862 QWizard supports four wizard looks: -

1863 -

1864 \list -

1865 \li ClassicStyle -

1866 \li ModernStyle -

1867 \li MacStyle -

1868 \li AeroStyle -

1869 \endlist -

1870 -

1871 You can explicitly set the look to use using setWizardStyle() -

1872 (e.g., if you want the same look on all platforms). -

1873 -

1874 \table -

1875 \header \li ClassicStyle -

1876 \li ModernStyle -

1877 \li MacStyle -

1878 \li AeroStyle -

1879 \row \li \inlineimage qtwizard-classic1.png -

1880 \li \inlineimage qtwizard-modern1.png -

1881 \li \inlineimage qtwizard-mac1.png -

1882 \li \inlineimage qtwizard-aero1.png -

1883 \row \li \inlineimage qtwizard-classic2.png -

1884 \li \inlineimage qtwizard-modern2.png -

1885 \li \inlineimage qtwizard-mac2.png -

1886 \li \inlineimage qtwizard-aero2.png -

1887 \endtable -

1888 -

1889 Note: AeroStyle has effect only on a Windows Vista system with alpha compositing enabled. -

1890 ModernStyle is used as a fallback when this condition is not met. -

1891 -

1892 In addition to the wizard style, there are several options that -

1893 control the look and feel of the wizard. These can be set using -

1894 setOption() or setOptions(). For example, HaveHelpButton makes -

1895 QWizard show a \uicontrol Help button along with the other wizard -

1896 buttons. -

1897 -

1898 You can even change the order of the wizard buttons to any -

1899 arbitrary order using setButtonLayout(), and you can add up to -

1900 three custom buttons (e.g., a \uicontrol Print button) to the button -

1901 row. This is achieved by calling setButton() or setButtonText() -

1902 with CustomButton1, CustomButton2, or CustomButton3 to set up the -

1903 button, and by enabling the HaveCustomButton1, HaveCustomButton2, -

1904 or HaveCustomButton3 options. Whenever the user clicks a custom -

1905 button, customButtonClicked() is emitted. For example: -

1906 -

1907 \snippet dialogs/licensewizard/licensewizard.cpp 29 -

1908 -

1909 \section1 Elements of a Wizard Page -

1910 -

1911 Wizards consist of a sequence of \l{QWizardPage}s. At any time, -

1912 only one page is shown. A page has the following attributes: -

1913 -

1914 \list -

1915 \li A \l{QWizardPage::}{title}. -

1916 \li A \l{QWizardPage::}{subTitle}. -

1917 \li A set of pixmaps, which may or may not be honored, depending -

1918 on the wizard's style: -

1919 \list -

1920 \li WatermarkPixmap (used by ClassicStyle and ModernStyle) -

1921 \li BannerPixmap (used by ModernStyle) -

1922 \li LogoPixmap (used by ClassicStyle and ModernStyle) -

1923 \li BackgroundPixmap (used by MacStyle) -

1924 \endlist -

1925 \endlist -

1926 -

1927 The diagram belows shows how QWizard renders these attributes, -

1928 assuming they are all present and ModernStyle is used: -

1929 -

1930 \image qtwizard-nonmacpage.png -

1931 -

1932 When a \l{QWizardPage::}{subTitle} is set, QWizard displays it -

1933 in a header, in which case it also uses the BannerPixmap and the -

1934 LogoPixmap to decorate the header. The WatermarkPixmap is -

1935 displayed on the left side, below the header. At the bottom, -

1936 there is a row of buttons allowing the user to navigate through -

1937 the pages. -

1938 -

1939 The page itself (the \l{QWizardPage} widget) occupies the area -

1940 between the header, the watermark, and the button row. Typically, -

1941 the page is a QWizardPage on which a QGridLayout is installed, -

1942 with standard child widgets (\l{QLabel}s, \l{QLineEdit}s, etc.). -

1943 -

1944 If the wizard's style is MacStyle, the page looks radically -

1945 different: -

1946 -

1947 \image qtwizard-macpage.png -

1948 -

1949 The watermark, banner, and logo pixmaps are ignored by the -

1950 MacStyle. If the BackgroundPixmap is set, it is used as the -

1951 background for the wizard; otherwise, a default "assistant" image -

1952 is used. -

1953 -

1954 The title and subtitle are set by calling -

1955 QWizardPage::setTitle() and QWizardPage::setSubTitle() on the -

1956 individual pages. They may be plain text or HTML (see titleFormat -

1957 and subTitleFormat). The pixmaps can be set globally for the -

1958 entire wizard using setPixmap(), or on a per-page basis using -

1959 QWizardPage::setPixmap(). -

1960 -

1961 \target field mechanism -

1962 \section1 Registering and Using Fields -

1963 -

1964 In many wizards, the contents of a page may affect the default -

1965 values of the fields of a later page. To make it easy to -

1966 communicate between pages, QWizard supports a "field" mechanism -

1967 that allows you to register a field (e.g., a QLineEdit) on a page -

1968 and to access its value from any page. It is also possible to -

1969 specify mandatory fields (i.e., fields that must be filled before -

1970 the user can advance to the next page). -

1971 -

1972 To register a field, call QWizardPage::registerField() field. -

1973 For example: -

1974 -

1975 \snippet dialogs/classwizard/classwizard.cpp 8 -

1976 \dots -

1977 \snippet dialogs/classwizard/classwizard.cpp 10 -

1978 \snippet dialogs/classwizard/classwizard.cpp 11 -

1979 \dots -

1980 \snippet dialogs/classwizard/classwizard.cpp 13 -

1981 -

1982 The above code registers three fields, \c className, \c -

1983 baseClass, and \c qobjectMacro, which are associated with three -

1984 child widgets. The asterisk (\c *) next to \c className denotes a -

1985 mandatory field. -

1986 -

1987 \target initialize page -

1988 The fields of any page are accessible from any other page. For -

1989 example: -

1990 -

1991 \snippet dialogs/classwizard/classwizard.cpp 17 -

1992 -

1993 Here, we call QWizardPage::field() to access the contents of the -

1994 \c className field (which was defined in the \c ClassInfoPage) -

1995 and use it to initialize the \c OutputFilePage. The field's -

1996 contents is returned as a QVariant. -

1997 -

1998 When we create a field using QWizardPage::registerField(), we -

1999 pass a unique field name and a widget. We can also provide a Qt -

2000 property name and a "changed" signal (a signal that is emitted -

2001 when the property changes) as third and fourth arguments; -

2002 however, this is not necessary for the most common Qt widgets, -

2003 such as QLineEdit, QCheckBox, and QComboBox, because QWizard -

2004 knows which properties to look for. -

2005 -

2006 \target mandatory fields -

2007 -

2008 If an asterisk (\c *) is appended to the name when the property -

2009 is registered, the field is a \e{mandatory field}. When a page has -

2010 mandatory fields, the \uicontrol Next and/or \uicontrol Finish buttons are -

2011 enabled only when all mandatory fields are filled. -

2012 -

2013 To consider a field "filled", QWizard simply checks that the -

2014 field's current value doesn't equal the original value (the value -

2015 it had when initializePage() was called). For QLineEdit and -

2016 QAbstractSpinBox subclasses, QWizard also checks that -

2017 \l{QLineEdit::hasAcceptableInput()}{hasAcceptableInput()} returns -

2018 true, to honor any validator or mask. -

2019 -

2020 QWizard's mandatory field mechanism is provided for convenience. -

2021 A more powerful (but also more cumbersome) alternative is to -

2022 reimplement QWizardPage::isComplete() and to emit the -

2023 QWizardPage::completeChanged() signal whenever the page becomes -

2024 complete or incomplete. -

2025 -

2026 The enabled/disabled state of the \uicontrol Next and/or \uicontrol Finish -

2027 buttons is one way to perform validation on the user input. -

2028 Another way is to reimplement validateCurrentPage() (or -

2029 QWizardPage::validatePage()) to perform some last-minute -

2030 validation (and show an error message if the user has entered -

2031 incomplete or invalid information). If the function returns \c true, -

2032 the next page is shown (or the wizard finishes); otherwise, the -

2033 current page stays up. -

2034 -

2035 \section1 Creating Linear Wizards -

2036 -

2037 Most wizards have a linear structure, with page 1 followed by -

2038 page 2 and so on until the last page. The \l{dialogs/classwizard}{Class -

2039 Wizard} example is such a wizard. With QWizard, linear wizards -

2040 are created by instantiating the \l{QWizardPage}s and inserting -

2041 them using addPage(). By default, the pages are shown in the -

2042 order in which they were added. For example: -

2043 -

2044 \snippet dialogs/classwizard/classwizard.cpp 0 -

2045 \dots -

2046 \snippet dialogs/classwizard/classwizard.cpp 2 -

2047 -

2048 When a page is about to be shown, QWizard calls initializePage() -

2049 (which in turn calls QWizardPage::initializePage()) to fill the -

2050 page with default values. By default, this function does nothing, -

2051 but it can be reimplemented to initialize the page's contents -

2052 based on other pages' fields (see the \l{initialize page}{example -

2053 above}). -

2054 -

2055 If the user presses \uicontrol Back, cleanupPage() is called (which in -

2056 turn calls QWizardPage::cleanupPage()). The default -

2057 implementation resets the page's fields to their original values -

2058 (the values they had before initializePage() was called). If you -

2059 want the \uicontrol Back button to be non-destructive and keep the -

2060 values entered by the user, simply enable the IndependentPages -

2061 option. -

2062 -

2063 \section1 Creating Non-Linear Wizards -

2064 -

2065 Some wizards are more complex in that they allow different -

2066 traversal paths based on the information provided by the user. -

2067 The \l{dialogs/licensewizard}{License Wizard} example illustrates this. -

2068 It provides five wizard pages; depending on which options are -

2069 selected, the user can reach different pages. -

2070 -

2071 \image licensewizard-flow.png -

2072 -

2073 In complex wizards, pages are identified by IDs. These IDs are -

2074 typically defined using an enum. For example: -

2075 -

2076 \snippet dialogs/licensewizard/licensewizard.h 0 -

2077 \dots -

2078 \snippet dialogs/licensewizard/licensewizard.h 2 -

2079 \dots -

2080 \snippet dialogs/licensewizard/licensewizard.h 3 -

2081 -

2082 The pages are inserted using setPage(), which takes an ID and an -

2083 instance of QWizardPage (or of a subclass): -

2084 -

2085 \snippet dialogs/licensewizard/licensewizard.cpp 1 -

2086 \dots -

2087 \snippet dialogs/licensewizard/licensewizard.cpp 8 -

2088 -

2089 By default, the pages are shown in increasing ID order. To -

2090 provide a dynamic order that depends on the options chosen by the -

2091 user, we must reimplement QWizardPage::nextId(). For example: -

2092 -

2093 \snippet dialogs/licensewizard/licensewizard.cpp 18 -

2094 \codeline -

2095 \snippet dialogs/licensewizard/licensewizard.cpp 23 -

2096 \codeline -

2097 \snippet dialogs/licensewizard/licensewizard.cpp 24 -

2098 \codeline -

2099 \snippet dialogs/licensewizard/licensewizard.cpp 25 -

2100 \codeline -

2101 \snippet dialogs/licensewizard/licensewizard.cpp 26 -

2102 -

2103 It would also be possible to put all the logic in one place, in a -

2104 QWizard::nextId() reimplementation. For example: -

2105 -

2106 \snippet code/src_gui_dialogs_qwizard.cpp 0 -

2107 -

2108 To start at another page than the page with the lowest ID, call -

2109 setStartId(). -

2110 -

2111 To test whether a page has been visited or not, call -

2112 hasVisitedPage(). For example: -

2113 -

2114 \snippet dialogs/licensewizard/licensewizard.cpp 27 -

2115 -

2116 \sa QWizardPage, {Class Wizard Example}, {License Wizard Example} -

2117 */ -

2118 -

2119 /*! -

2120 \enum QWizard::WizardButton -

2121 -

2122 This enum specifies the buttons in a wizard. -

2123 -

2124 \value BackButton The \uicontrol Back button (\uicontrol {Go Back} on \macos) -

2125 \value NextButton The \uicontrol Next button (\uicontrol Continue on \macos) -

2126 \value CommitButton The \uicontrol Commit button -

2127 \value FinishButton The \uicontrol Finish button (\uicontrol Done on \macos) -

2128 \value CancelButton The \uicontrol Cancel button (see also NoCancelButton) -

2129 \value HelpButton The \uicontrol Help button (see also HaveHelpButton) -

2130 \value CustomButton1 The first user-defined button (see also HaveCustomButton1) -

2131 \value CustomButton2 The second user-defined button (see also HaveCustomButton2) -

2132 \value CustomButton3 The third user-defined button (see also HaveCustomButton3) -

2133 -

2134 The following value is only useful when calling setButtonLayout(): -

2135 -

2136 \value Stretch A horizontal stretch in the button layout -

2137 -

2138 \omitvalue NoButton -

2139 \omitvalue NStandardButtons -

2140 \omitvalue NButtons -

2141 -

2142 \sa setButton(), setButtonText(), setButtonLayout(), customButtonClicked() -

2143 */ -

2144 -

2145 /*! -

2146 \enum QWizard::WizardPixmap -

2147 -

2148 This enum specifies the pixmaps that can be associated with a page. -

2149 -

2150 \value WatermarkPixmap The tall pixmap on the left side of a ClassicStyle or ModernStyle page -

2151 \value LogoPixmap The small pixmap on the right side of a ClassicStyle or ModernStyle page header -

2152 \value BannerPixmap The pixmap that occupies the background of a ModernStyle page header -

2153 \value BackgroundPixmap The pixmap that occupies the background of a MacStyle wizard -

2154 -

2155 \omitvalue NPixmaps -

2156 -

2157 \sa setPixmap(), QWizardPage::setPixmap(), {Elements of a Wizard Page} -

2158 */ -

2159 -

2160 /*! -

2161 \enum QWizard::WizardStyle -

2162 -

2163 This enum specifies the different looks supported by QWizard. -

2164 -

2165 \value ClassicStyle Classic Windows look -

2166 \value ModernStyle Modern Windows look -

2167 \value MacStyle \macos look -

2168 \value AeroStyle Windows Aero look -

2169 -

2170 \omitvalue NStyles -

2171 -

2172 \sa setWizardStyle(), WizardOption, {Wizard Look and Feel} -

2173 */ -

2174 -

2175 /*! -

2176 \enum QWizard::WizardOption -

2177 -

2178 This enum specifies various options that affect the look and feel -

2179 of a wizard. -

2180 -

2181 \value IndependentPages The pages are independent of each other -

2182 (i.e., they don't derive values from each -

2183 other). -

2184 \value IgnoreSubTitles Don't show any subtitles, even if they are set. -

2185 \value ExtendedWatermarkPixmap Extend any WatermarkPixmap all the -

2186 way down to the window's edge. -

2187 \value NoDefaultButton Don't make the \uicontrol Next or \uicontrol Finish button the -

2188 dialog's \l{QPushButton::setDefault()}{default button}. -

2189 \value NoBackButtonOnStartPage Don't show the \uicontrol Back button on the start page. -

2190 \value NoBackButtonOnLastPage Don't show the \uicontrol Back button on the last page. -

2191 \value DisabledBackButtonOnLastPage Disable the \uicontrol Back button on the last page. -

2192 \value HaveNextButtonOnLastPage Show the (disabled) \uicontrol Next button on the last page. -

2193 \value HaveFinishButtonOnEarlyPages Show the (disabled) \uicontrol Finish button on non-final pages. -

2194 \value NoCancelButton Don't show the \uicontrol Cancel button. -

2195 \value CancelButtonOnLeft Put the \uicontrol Cancel button on the left of \uicontrol Back (rather than on -

2196 the right of \uicontrol Finish or \uicontrol Next). -

2197 \value HaveHelpButton Show the \uicontrol Help button. -

2198 \value HelpButtonOnRight Put the \uicontrol Help button on the far right of the button layout -

2199 (rather than on the far left). -

2200 \value HaveCustomButton1 Show the first user-defined button (CustomButton1). -

2201 \value HaveCustomButton2 Show the second user-defined button (CustomButton2). -

2202 \value HaveCustomButton3 Show the third user-defined button (CustomButton3). -

2203 \value NoCancelButtonOnLastPage Don't show the \uicontrol Cancel button on the last page. -

2204 -

2205 \sa setOptions(), setOption(), testOption() -

2206 */ -

2207 -

2208 /*! -

2209 Constructs a wizard with the given \a parent and window \a flags. -

2210 -

2211 \sa parent(), windowFlags() -

2212 */ -

2213 QWizard::QWizard(QWidget *parent, Qt::WindowFlags flags) -

2214 : QDialog(*new QWizardPrivate, parent, flags) -

2215 { -

2216 Q_D(QWizard); -

2217 d->init(); -

2218 #ifdef Q_OS_WINCE -

2219 if (!qt_wince_is_mobile()) -

2220 setWindowFlags(windowFlags() & ~Qt::WindowOkButtonHint); -

2221 #endif -

2222

}

never executed: end of block

2223 -

2224 /*! -

2225 Destroys the wizard and its pages, releasing any allocated resources. -

2226 */ -

2227 QWizard::~QWizard() -

2228 { -

2229 Q_D(QWizard); -

2230 delete d->buttonLayout; -

2231

}

never executed: end of block

2232 -

2233 /*! -

2234 Adds the given \a page to the wizard, and returns the page's ID. -

2235 -

2236 The ID is guaranteed to be larger than any other ID in the -

2237 QWizard so far. -

2238 -

2239 \sa setPage(), page(), pageAdded() -

2240 */ -

2241 int QWizard::addPage(QWizardPage *page) -

2242 { -

2243 Q_D(QWizard); -

2244 int theid = 0; -

2245

if (!d->pageMap.isEmpty())

!d->pageMap.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

2246

theid = (d->pageMap.constEnd() - 1).key() + 1;

never executed: theid = (d->pageMap.constEnd() - 1).key() + 1;

2247 setPage(theid, page); -

2248

return theid;

never executed: return theid;

2249 } -

2250 -

2251 /*! -

2252 \fn void QWizard::setPage(int id, QWizardPage *page) -

2253 -

2254 Adds the given \a page to the wizard with the given \a id. -

2255 -

2256 \note Adding a page may influence the value of the startId property -

2257 in case it was not set explicitly. -

2258 -

2259 \sa addPage(), page(), pageAdded() -

2260 */ -

2261 void QWizard::setPage(int theid, QWizardPage *page) -

2262 { -

2263 Q_D(QWizard); -

2264 -

2265

if (Q_UNLIKELY(!page)) {

__builtin_expe...!page), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2266 qWarning("QWizard::setPage: Cannot insert null page"); -

2267

return;

never executed: return;

2268 } -

2269 -

2270

if (Q_UNLIKELY(theid == -1)) {

__builtin_expe...== -1), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2271 qWarning("QWizard::setPage: Cannot insert page with ID -1"); -

2272

return;

never executed: return;

2273 } -

2274 -

2275

if (Q_UNLIKELY(d->pageMap.contains(theid))) {

__builtin_expe...heid)), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2276 qWarning("QWizard::setPage: Page with duplicate ID %d ignored", theid); -

2277

return;

never executed: return;

2278 } -

2279 -

2280 page->setParent(d->pageFrame); -

2281 -

2282 QVector<QWizardField> &pendingFields = page->d_func()->pendingFields; -

2283

for (int i = 0; i < pendingFields.count(); ++i)

i < pendingFields.count()	Description
TRUE	never evaluated
FALSE	never evaluated

2284

d->addField(pendingFields.at(i));

never executed: d->addField(pendingFields.at(i));

2285 pendingFields.clear(); -

2286 -

2287 connect(page, SIGNAL(completeChanged()), this, SLOT(_q_updateButtonStates())); -

2288 -

2289 d->pageMap.insert(theid, page); -

2290 page->d_func()->wizard = this; -

2291 -

2292 int n = d->pageVBoxLayout->count(); -

2293 -

2294 // disable layout to prevent layout updates while adding -

2295 bool pageVBoxLayoutEnabled = d->pageVBoxLayout->isEnabled(); -

2296 d->pageVBoxLayout->setEnabled(false); -

2297 -

2298 d->pageVBoxLayout->insertWidget(n - 1, page); -

2299 -

2300 // hide new page and reset layout to old status -

2301 page->hide(); -

2302 d->pageVBoxLayout->setEnabled(pageVBoxLayoutEnabled); -

2303 -

2304

if (!d->startSetByUser && d->pageMap.constBegin().key() == theid)

!d->startSetByUser	Description
TRUE	never evaluated
FALSE	never evaluated

d->pageMap.con...key() == theid	Description
TRUE	never evaluated
FALSE	never evaluated

2305

d->start = theid;

never executed: d->start = theid;

2306 emit pageAdded(theid); -

2307

}

never executed: end of block

2308 -

2309 /*! -

2310 Removes the page with the given \a id. cleanupPage() will be called if necessary. -

2311 -

2312 \note Removing a page may influence the value of the startId property. -

2313 -

2314 \since 4.5 -

2315 \sa addPage(), setPage(), pageRemoved(), startId() -

2316 */ -

2317 void QWizard::removePage(int id) -

2318 { -

2319 Q_D(QWizard); -

2320 -

2321 QWizardPage *removedPage = 0; -

2322 -

2323 // update startItem accordingly -

2324

if (d->pageMap.count() > 0) { // only if we have any pages

d->pageMap.count() > 0	Description
TRUE	never evaluated
FALSE	never evaluated

2325

if (d->start == id) {

d->start == id	Description
TRUE	never evaluated
FALSE	never evaluated

2326 const int firstId = d->pageMap.constBegin().key(); -

2327

if (firstId == id) {

firstId == id	Description
TRUE	never evaluated
FALSE	never evaluated

2328

if (d->pageMap.count() > 1)

d->pageMap.count() > 1	Description
TRUE	never evaluated
FALSE	never evaluated

2329

d->start = (++d->pageMap.constBegin()).key(); // secondId

never executed: d->start = (++d->pageMap.constBegin()).key();

2330 else -

2331

d->start = -1; // removing the last page

never executed: d->start = -1;

2332 } else { // startSetByUser has to be "true" here -

2333 d->start = firstId; -

2334

}

never executed: end of block

2335 d->startSetByUser = false; -

2336

}

never executed: end of block

2337

}

never executed: end of block

2338 -

2339

if (d->pageMap.contains(id))

d->pageMap.contains(id)	Description
TRUE	never evaluated
FALSE	never evaluated

2340

emit pageRemoved(id);

never executed: pageRemoved(id);

2341 -

2342

if (!d->history.contains(id)) {

!d->history.contains(id)	Description
TRUE	never evaluated
FALSE	never evaluated

2343 // Case 1: removing a page not in the history -

2344 removedPage = d->pageMap.take(id); -

2345 d->updateCurrentPage(); -

2346

} else if (id != d->current) {

never executed: end of block

id != d->current	Description
TRUE	never evaluated
FALSE	never evaluated

2347 // Case 2: removing a page in the history before the current page -

2348 removedPage = d->pageMap.take(id); -

2349 d->history.removeOne(id); -

2350 d->_q_updateButtonStates(); -

2351

} else if (d->history.count() == 1) {

never executed: end of block

d->history.count() == 1	Description
TRUE	never evaluated
FALSE	never evaluated

2352 // Case 3: removing the current page which is the first (and only) one in the history -

2353 d->reset(); -

2354 removedPage = d->pageMap.take(id); -

2355

if (d->pageMap.isEmpty())

d->pageMap.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

2356

d->updateCurrentPage();

never executed: d->updateCurrentPage();

2357 else -

2358

restart();

never executed: restart();

2359 } else { -

2360 // Case 4: removing the current page which is not the first one in the history -

2361 back(); -

2362 removedPage = d->pageMap.take(id); -

2363 d->updateCurrentPage(); -

2364

}

never executed: end of block

2365 -

2366

if (removedPage) {

removedPage	Description
TRUE	never evaluated
FALSE	never evaluated

2367

if (d->initialized.contains(id)) {

d->initialized.contains(id)	Description
TRUE	never evaluated
FALSE	never evaluated

2368 cleanupPage(id); -

2369 d->initialized.remove(id); -

2370

}

never executed: end of block

2371 -

2372 d->pageVBoxLayout->removeWidget(removedPage); -

2373 -

2374

for (int i = d->fields.count() - 1; i >= 0; --i) {

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

2375

if (d->fields.at(i).page == removedPage) {

d->fields.at(i...== removedPage	Description
TRUE	never evaluated
FALSE	never evaluated

2376 removedPage->d_func()->pendingFields += d->fields.at(i); -

2377 d->removeFieldAt(i); -

2378

}

never executed: end of block

2379

}

never executed: end of block

2380

}

never executed: end of block

2381

}

never executed: end of block

2382 -

2383 /*! -

2384 \fn QWizardPage *QWizard::page(int id) const -

2385 -

2386 Returns the page with the given \a id, or 0 if there is no such -

2387 page. -

2388 -

2389 \sa addPage(), setPage() -

2390 */ -

2391 QWizardPage *QWizard::page(int theid) const -

2392 { -

2393 Q_D(const QWizard); -

2394

return d->pageMap.value(theid);

never executed: return d->pageMap.value(theid);

2395 } -

2396 -

2397 /*! -

2398 \fn bool QWizard::hasVisitedPage(int id) const -

2399 -

2400 Returns \c true if the page history contains page \a id; otherwise, -

2401 returns \c false. -

2402 -

2403 Pressing \uicontrol Back marks the current page as "unvisited" again. -

2404 -

2405 \sa visitedPages() -

2406 */ -

2407 bool QWizard::hasVisitedPage(int theid) const -

2408 { -

2409 Q_D(const QWizard); -

2410

return d->history.contains(theid);

never executed: return d->history.contains(theid);

2411 } -

2412 -

2413 /*! -

2414 Returns the list of IDs of visited pages, in the order in which the pages -

2415 were visited. -

2416 -

2417 Pressing \uicontrol Back marks the current page as "unvisited" again. -

2418 -

2419 \sa hasVisitedPage() -

2420 */ -

2421 QList<int> QWizard::visitedPages() const -

2422 { -

2423 Q_D(const QWizard); -

2424

return d->history;

never executed: return d->history;

2425 } -

2426 -

2427 /*! -

2428 Returns the list of page IDs. -

2429 \since 4.5 -

2430 */ -

2431 QList<int> QWizard::pageIds() const -

2432 { -

2433 Q_D(const QWizard); -

2434

return d->pageMap.keys();

never executed: return d->pageMap.keys();

2435 } -

2436 -

2437 /*! -

2438 \property QWizard::startId -

2439 \brief the ID of the first page -

2440 -

2441 If this property isn't explicitly set, this property defaults to -

2442 the lowest page ID in this wizard, or -1 if no page has been -

2443 inserted yet. -

2444 -

2445 \sa restart(), nextId() -

2446 */ -

2447 void QWizard::setStartId(int theid) -

2448 { -

2449 Q_D(QWizard); -

2450 int newStart = theid; -

2451

if (theid == -1)

theid == -1	Description
TRUE	never evaluated
FALSE	never evaluated

2452

newStart = d->pageMap.count() ? d->pageMap.constBegin().key() : -1;

never executed: newStart = d->pageMap.count() ? d->pageMap.constBegin().key() : -1;

d->pageMap.count()	Description
TRUE	never evaluated
FALSE	never evaluated

2453 -

2454

if (d->start == newStart) {

d->start == newStart	Description
TRUE	never evaluated
FALSE	never evaluated

2455 d->startSetByUser = theid != -1; -

2456

return;

never executed: return;

2457 } -

2458 -

2459

if (Q_UNLIKELY(!d->pageMap.contains(newStart))) {

__builtin_expe...tart)), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2460 qWarning("QWizard::setStartId: Invalid page ID %d", newStart); -

2461

return;

never executed: return;

2462 } -

2463 d->start = newStart; -

2464 d->startSetByUser = theid != -1; -

2465

}

never executed: end of block

2466 -

2467 int QWizard::startId() const -

2468 { -

2469 Q_D(const QWizard); -

2470

return d->start;

never executed: return d->start;

2471 } -

2472 -

2473 /*! -

2474 Returns a pointer to the current page, or 0 if there is no current -

2475 page (e.g., before the wizard is shown). -

2476 -

2477 This is equivalent to calling page(currentId()). -

2478 -

2479 \sa page(), currentId(), restart() -

2480 */ -

2481 QWizardPage *QWizard::currentPage() const -

2482 { -

2483 Q_D(const QWizard); -

2484

return page(d->current);

never executed: return page(d->current);

2485 } -

2486 -

2487 /*! -

2488 \property QWizard::currentId -

2489 \brief the ID of the current page -

2490 -

2491 This property cannot be set directly. To change the current page, -

2492 call next(), back(), or restart(). -

2493 -

2494 By default, this property has a value of -1, indicating that no page is -

2495 currently shown. -

2496 -

2497 \sa currentPage() -

2498 */ -

2499 int QWizard::currentId() const -

2500 { -

2501 Q_D(const QWizard); -

2502

return d->current;

never executed: return d->current;

2503 } -

2504 -

2505 /*! -

2506 Sets the value of the field called \a name to \a value. -

2507 -

2508 This function can be used to set fields on any page of the wizard. -

2509 -

2510 \sa QWizardPage::registerField(), QWizardPage::setField(), field() -

2511 */ -

2512 void QWizard::setField(const QString &name, const QVariant &value) -

2513 { -

2514 Q_D(QWizard); -

2515 -

2516 int index = d->fieldIndexMap.value(name, -1); -

2517

if (Q_UNLIKELY(index == -1)) {

__builtin_expe...== -1), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2518 qWarning("QWizard::setField: No such field '%ls'", qUtf16Printable(name)); -

2519

return;

never executed: return;

2520 } -

2521 -

2522 const QWizardField &field = d->fields.at(index); -

2523

if (Q_UNLIKELY(!field.object->setProperty(field.property, value)))

__builtin_expe...alue)), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2524

qWarning("QWizard::setField: Couldn't write to property '%s'",

never executed:

QMessageLogger(__FILE__, 2524, __PRETTY_FUNCTION__).warning("QWizard::setField: Couldn't write to property '%s'", field.property.constData());

2525

field.property.constData());

never executed:

QMessageLogger(__FILE__, 2524, __PRETTY_FUNCTION__).warning("QWizard::setField: Couldn't write to property '%s'", field.property.constData());

2526

}

never executed: end of block

2527 -

2528 /*! -

2529 Returns the value of the field called \a name. -

2530 -

2531 This function can be used to access fields on any page of the wizard. -

2532 -

2533 \sa QWizardPage::registerField(), QWizardPage::field(), setField() -

2534 */ -

2535 QVariant QWizard::field(const QString &name) const -

2536 { -

2537 Q_D(const QWizard); -

2538 -

2539 int index = d->fieldIndexMap.value(name, -1); -

2540

if (Q_UNLIKELY(index == -1)) {

__builtin_expe...== -1), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2541 qWarning("QWizard::field: No such field '%ls'", qUtf16Printable(name)); -

2542

return QVariant();

never executed: return QVariant();

2543 } -

2544 -

2545 const QWizardField &field = d->fields.at(index); -

2546

return field.object->property(field.property);

never executed: return field.object->property(field.property);

2547 } -

2548 -

2549 /*! -

2550 \property QWizard::wizardStyle -

2551 \brief the look and feel of the wizard -

2552 -

2553 By default, QWizard uses the AeroStyle on a Windows Vista system with alpha compositing -

2554 enabled, regardless of the current widget style. If this is not the case, the default -

2555 wizard style depends on the current widget style as follows: MacStyle is the default if -

2556 the current widget style is QMacStyle, ModernStyle is the default if the current widget -

2557 style is QWindowsStyle, and ClassicStyle is the default in all other cases. -

2558 -

2559 \sa {Wizard Look and Feel}, options -

2560 */ -

2561 void QWizard::setWizardStyle(WizardStyle style) -

2562 { -

2563 Q_D(QWizard); -

2564 -

2565 const bool styleChange = style != d->wizStyle; -

2566 -

2567 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

2568 const bool aeroStyleChange = -

2569 d->vistaInitPending || d->vistaStateChanged || (styleChange && (style == AeroStyle || d->wizStyle == AeroStyle)); -

2570 d->vistaStateChanged = false; -

2571 d->vistaInitPending = false; -

2572 #endif -

2573 -

2574

if (styleChange

styleChange	Description
TRUE	never evaluated
FALSE	never evaluated

2575 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

2576 || aeroStyleChange -

2577 #endif -

2578 ) { -

2579 d->disableUpdates(); -

2580 d->wizStyle = style; -

2581 d->updateButtonTexts(); -

2582 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

2583 if (aeroStyleChange) { -

2584 //Send a resizeevent since the antiflicker widget probably needs a new size -

2585 //because of the backbutton in the window title -

2586 QResizeEvent ev(geometry().size(), geometry().size()); -

2587 QApplication::sendEvent(this, &ev); -

2588 } -

2589 #endif -

2590 d->updateLayout(); -

2591 updateGeometry(); -

2592 d->enableUpdates(); -

2593 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

2594 // Delay initialization when activating Aero style fails due to missing native window. -

2595 if (aeroStyleChange && !d->handleAeroStyleChange() && d->wizStyle == AeroStyle) -

2596 d->vistaInitPending = true; -

2597 #endif -

2598

}

never executed: end of block

2599

}

never executed: end of block

2600 -

2601 QWizard::WizardStyle QWizard::wizardStyle() const -

2602 { -

2603 Q_D(const QWizard); -

2604

return d->wizStyle;

never executed: return d->wizStyle;

2605 } -

2606 -

2607 /*! -

2608 Sets the given \a option to be enabled if \a on is true; -

2609 otherwise, clears the given \a option. -

2610 -

2611 \sa options, testOption(), setWizardStyle() -

2612 */ -

2613 void QWizard::setOption(WizardOption option, bool on) -

2614 { -

2615 Q_D(QWizard); -

2616

if (!(d->opts & option) != !on)

!(d->opts & option) != !on	Description
TRUE	never evaluated
FALSE	never evaluated

2617

setOptions(d->opts ^ option);

never executed: setOptions(d->opts ^ option);

2618

}

never executed: end of block

2619 -

2620 /*! -

2621 Returns \c true if the given \a option is enabled; otherwise, returns -

2622 false. -

2623 -

2624 \sa options, setOption(), setWizardStyle() -

2625 */ -

2626 bool QWizard::testOption(WizardOption option) const -

2627 { -

2628 Q_D(const QWizard); -

2629

return (d->opts & option) != 0;

never executed: return (d->opts & option) != 0;

2630 } -

2631 -

2632 /*! -

2633 \property QWizard::options -

2634 \brief the various options that affect the look and feel of the wizard -

2635 -

2636 By default, the following options are set (depending on the platform): -

2637 -

2638 \list -

2639 \li Windows: HelpButtonOnRight. -

2640 \li \macos: NoDefaultButton and NoCancelButton. -

2641 \li X11 and QWS (Qt for Embedded Linux): none. -

2642 \endlist -

2643 -

2644 \sa wizardStyle -

2645 */ -

2646 void QWizard::setOptions(WizardOptions options) -

2647 { -

2648 Q_D(QWizard); -

2649 -

2650 WizardOptions changed = (options ^ d->opts); -

2651

if (!changed)

!changed	Description
TRUE	never evaluated
FALSE	never evaluated

2652

return;

never executed: return;

2653 -

2654 d->disableUpdates(); -

2655 -

2656 d->opts = options; -

2657

if ((changed & IndependentPages) && !(d->opts & IndependentPages))

(changed & IndependentPages)	Description
TRUE	never evaluated
FALSE	never evaluated

!(d->opts & IndependentPages)	Description
TRUE	never evaluated
FALSE	never evaluated

2658

d->cleanupPagesNotInHistory();

never executed: d->cleanupPagesNotInHistory();

2659 -

2660

if (changed & (NoDefaultButton | HaveHelpButton | HelpButtonOnRight | NoCancelButton

changed & (NoD...CustomButton3)	Description
TRUE	never evaluated
FALSE	never evaluated

2661

| CancelButtonOnLeft | HaveCustomButton1 | HaveCustomButton2

changed & (NoD...CustomButton3)	Description
TRUE	never evaluated
FALSE	never evaluated

2662

| HaveCustomButton3)) {

changed & (NoD...CustomButton3)	Description
TRUE	never evaluated
FALSE	never evaluated

2663 d->updateButtonLayout(); -

2664

} else if (changed & (NoBackButtonOnStartPage | NoBackButtonOnLastPage

never executed: end of block

changed & (NoB...tonOnLastPage)	Description
TRUE	never evaluated
FALSE	never evaluated

2665

| HaveNextButtonOnLastPage | HaveFinishButtonOnEarlyPages

changed & (NoB...tonOnLastPage)	Description
TRUE	never evaluated
FALSE	never evaluated

2666

| DisabledBackButtonOnLastPage | NoCancelButtonOnLastPage)) {

changed & (NoB...tonOnLastPage)	Description
TRUE	never evaluated
FALSE	never evaluated

2667 d->_q_updateButtonStates(); -

2668

}

never executed: end of block

2669 -

2670 d->enableUpdates(); -

2671 d->updateLayout(); -

2672

}

never executed: end of block

2673 -

2674 QWizard::WizardOptions QWizard::options() const -

2675 { -

2676 Q_D(const QWizard); -

2677

return d->opts;

never executed: return d->opts;

2678 } -

2679 -

2680 /*! -

2681 Sets the text on button \a which to be \a text. -

2682 -

2683 By default, the text on buttons depends on the wizardStyle. For -

2684 example, on \macos, the \uicontrol Next button is called \uicontrol -

2685 Continue. -

2686 -

2687 To add extra buttons to the wizard (e.g., a \uicontrol Print button), -

2688 one way is to call setButtonText() with CustomButton1, -

2689 CustomButton2, or CustomButton3 to set their text, and make the -

2690 buttons visible using the HaveCustomButton1, HaveCustomButton2, -

2691 and/or HaveCustomButton3 options. -

2692 -

2693 Button texts may also be set on a per-page basis using QWizardPage::setButtonText(). -

2694 -

2695 \sa setButton(), button(), setButtonLayout(), setOptions(), QWizardPage::setButtonText() -

2696 */ -

2697 void QWizard::setButtonText(WizardButton which, const QString &text) -

2698 { -

2699 Q_D(QWizard); -

2700 -

2701

if (!d->ensureButton(which))

!d->ensureButton(which)	Description
TRUE	never evaluated
FALSE	never evaluated

2702

return;

never executed: return;

2703 -

2704 d->buttonCustomTexts.insert(which, text); -

2705 -

2706

if (!currentPage() || !currentPage()->d_func()->buttonCustomTexts.contains(which))

!currentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

!currentPage()...ontains(which)	Description
TRUE	never evaluated
FALSE	never evaluated

2707

d->btns[which]->setText(text);

never executed: d->btns[which]->setText(text);

2708

}

never executed: end of block

2709 -

2710 /*! -

2711 Returns the text on button \a which. -

2712 -

2713 If a text has ben set using setButtonText(), this text is returned. -

2714 -

2715 By default, the text on buttons depends on the wizardStyle. For -

2716 example, on \macos, the \uicontrol Next button is called \uicontrol -

2717 Continue. -

2718 -

2719 \sa button(), setButton(), setButtonText(), QWizardPage::buttonText(), -

2720 QWizardPage::setButtonText() -

2721 */ -

2722 QString QWizard::buttonText(WizardButton which) const -

2723 { -

2724 Q_D(const QWizard); -

2725 -

2726

if (!d->ensureButton(which))

!d->ensureButton(which)	Description
TRUE	never evaluated
FALSE	never evaluated

2727

return QString();

never executed: return QString();

2728 -

2729

if (d->buttonCustomTexts.contains(which))

d->buttonCusto...ontains(which)	Description
TRUE	never evaluated
FALSE	never evaluated

2730

return d->buttonCustomTexts.value(which);

never executed: return d->buttonCustomTexts.value(which);

2731 -

2732 const QString defText = buttonDefaultText(d->wizStyle, which, d); -

2733

if(!defText.isNull())

!defText.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

2734

return defText;

never executed: return defText;

2735 -

2736

return d->btns[which]->text();

never executed: return d->btns[which]->text();

2737 } -

2738 -

2739 /*! -

2740 Sets the order in which buttons are displayed to \a layout, where -

2741 \a layout is a list of \l{WizardButton}s. -

2742 -

2743 The default layout depends on the options (e.g., whether -

2744 HelpButtonOnRight) that are set. You can call this function if -

2745 you need more control over the buttons' layout than what \l -

2746 options already provides. -

2747 -

2748 You can specify horizontal stretches in the layout using \l -

2749 Stretch. -

2750 -

2751 Example: -

2752 -

2753 \snippet code/src_gui_dialogs_qwizard.cpp 1 -

2754 -

2755 \sa setButton(), setButtonText(), setOptions() -

2756 */ -

2757 void QWizard::setButtonLayout(const QList<WizardButton> &layout) -

2758 { -

2759 Q_D(QWizard); -

2760 -

2761

for (int i = 0; i < layout.count(); ++i) {

i < layout.count()	Description
TRUE	never evaluated
FALSE	never evaluated

2762 WizardButton button1 = layout.at(i); -

2763 -

2764

if (button1 == NoButton || button1 == Stretch)

button1 == NoButton	Description
TRUE	never evaluated
FALSE	never evaluated

button1 == Stretch	Description
TRUE	never evaluated
FALSE	never evaluated

2765

continue;

never executed: continue;

2766

if (!d->ensureButton(button1))

!d->ensureButton(button1)	Description
TRUE	never evaluated
FALSE	never evaluated

2767

return;

never executed: return;

2768 -

2769 // O(n^2), but n is very small -

2770

for (int j = 0; j < i; ++j) {

j < i	Description
TRUE	never evaluated
FALSE	never evaluated

2771 WizardButton button2 = layout.at(j); -

2772

if (Q_UNLIKELY(button2 == button1)) {

__builtin_expe...tton1), false)	Description
TRUE	never evaluated
FALSE	never evaluated

2773 qWarning("QWizard::setButtonLayout: Duplicate button in layout"); -

2774

return;

never executed: return;

2775 } -

2776

}

never executed: end of block

2777

}

never executed: end of block

2778 -

2779 d->buttonsHaveCustomLayout = true; -

2780 d->buttonsCustomLayout = layout; -

2781 d->updateButtonLayout(); -

2782

}

never executed: end of block

2783 -

2784 /*! -

2785 Sets the button corresponding to role \a which to \a button. -

2786 -

2787 To add extra buttons to the wizard (e.g., a \uicontrol Print button), -

2788 one way is to call setButton() with CustomButton1 to -

2789 CustomButton3, and make the buttons visible using the -

2790 HaveCustomButton1 to HaveCustomButton3 options. -

2791 -

2792 \sa setButtonText(), setButtonLayout(), options -

2793 */ -

2794 void QWizard::setButton(WizardButton which, QAbstractButton *button) -

2795 { -

2796 Q_D(QWizard); -

2797 -

2798

if (uint(which) >= NButtons || d->btns[which] == button)

uint(which) >= NButtons	Description
TRUE	never evaluated
FALSE	never evaluated

d->btns[which] == button	Description
TRUE	never evaluated
FALSE	never evaluated

2799

return;

never executed: return;

2800 -

2801

if (QAbstractButton *oldButton = d->btns[which]) {

QAbstractButto...d->btns[which]	Description
TRUE	never evaluated
FALSE	never evaluated

2802 d->buttonLayout->removeWidget(oldButton); -

2803 delete oldButton; -

2804

}

never executed: end of block

2805 -

2806 d->btns[which] = button; -

2807

if (button) {

button	Description
TRUE	never evaluated
FALSE	never evaluated

2808 button->setParent(d->antiFlickerWidget); -

2809 d->buttonCustomTexts.insert(which, button->text()); -

2810 d->connectButton(which); -

2811

} else {

never executed: end of block

2812 d->buttonCustomTexts.remove(which); // ### what about page-specific texts set for 'which' -

2813 d->ensureButton(which); // (QWizardPage::setButtonText())? Clear them as well? -

2814

}

never executed: end of block

2815 -

2816 d->updateButtonLayout(); -

2817

}

never executed: end of block

2818 -

2819 /*! -

2820 Returns the button corresponding to role \a which. -

2821 -

2822 \sa setButton(), setButtonText() -

2823 */ -

2824 QAbstractButton *QWizard::button(WizardButton which) const -

2825 { -

2826 Q_D(const QWizard); -

2827 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

2828 if (d->wizStyle == AeroStyle && which == BackButton) -

2829 return d->vistaHelper->backButton(); -

2830 #endif -

2831

if (!d->ensureButton(which))

!d->ensureButton(which)	Description
TRUE	never evaluated
FALSE	never evaluated

2832

return 0;

never executed: return 0;

2833

return d->btns[which];

never executed: return d->btns[which];

2834 } -

2835 -

2836 /*! -

2837 \property QWizard::titleFormat -

2838 \brief the text format used by page titles -

2839 -

2840 The default format is Qt::AutoText. -

2841 -

2842 \sa QWizardPage::title, subTitleFormat -

2843 */ -

2844 void QWizard::setTitleFormat(Qt::TextFormat format) -

2845 { -

2846 Q_D(QWizard); -

2847 d->titleFmt = format; -

2848 d->updateLayout(); -

2849

}

never executed: end of block

2850 -

2851 Qt::TextFormat QWizard::titleFormat() const -

2852 { -

2853 Q_D(const QWizard); -

2854

return d->titleFmt;

never executed: return d->titleFmt;

2855 } -

2856 -

2857 /*! -

2858 \property QWizard::subTitleFormat -

2859 \brief the text format used by page subtitles -

2860 -

2861 The default format is Qt::AutoText. -

2862 -

2863 \sa QWizardPage::title, titleFormat -

2864 */ -

2865 void QWizard::setSubTitleFormat(Qt::TextFormat format) -

2866 { -

2867 Q_D(QWizard); -

2868 d->subTitleFmt = format; -

2869 d->updateLayout(); -

2870

}

never executed: end of block

2871 -

2872 Qt::TextFormat QWizard::subTitleFormat() const -

2873 { -

2874 Q_D(const QWizard); -

2875

return d->subTitleFmt;

never executed: return d->subTitleFmt;

2876 } -

2877 -

2878 /*! -

2879 Sets the pixmap for role \a which to \a pixmap. -

2880 -

2881 The pixmaps are used by QWizard when displaying a page. Which -

2882 pixmaps are actually used depend on the \l{Wizard Look and -

2883 Feel}{wizard style}. -

2884 -

2885 Pixmaps can also be set for a specific page using -

2886 QWizardPage::setPixmap(). -

2887 -

2888 \sa QWizardPage::setPixmap(), {Elements of a Wizard Page} -

2889 */ -

2890 void QWizard::setPixmap(WizardPixmap which, const QPixmap &pixmap) -

2891 { -

2892 Q_D(QWizard); -

2893 Q_ASSERT(uint(which) < NPixmaps); -

2894 d->defaultPixmaps[which] = pixmap; -

2895 d->updatePixmap(which); -

2896

}

never executed: end of block

2897 -

2898 /*! -

2899 Returns the pixmap set for role \a which. -

2900 -

2901 By default, the only pixmap that is set is the BackgroundPixmap on -

2902 \macos. -

2903 -

2904 \sa QWizardPage::pixmap(), {Elements of a Wizard Page} -

2905 */ -

2906 QPixmap QWizard::pixmap(WizardPixmap which) const -

2907 { -

2908 Q_D(const QWizard); -

2909 Q_ASSERT(uint(which) < NPixmaps); -

2910 #ifdef Q_OS_MACX -

2911 if (which == BackgroundPixmap && d->defaultPixmaps[BackgroundPixmap].isNull()) -

2912 d->defaultPixmaps[BackgroundPixmap] = d->findDefaultBackgroundPixmap(); -

2913 #endif -

2914

return d->defaultPixmaps[which];

never executed: return d->defaultPixmaps[which];

2915 } -

2916 -

2917 /*! -

2918 Sets the default property for \a className to be \a property, -

2919 and the associated change signal to be \a changedSignal. -

2920 -

2921 The default property is used when an instance of \a className (or -

2922 of one of its subclasses) is passed to -

2923 QWizardPage::registerField() and no property is specified. -

2924 -

2925 QWizard knows the most common Qt widgets. For these (or their -

2926 subclasses), you don't need to specify a \a property or a \a -

2927 changedSignal. The table below lists these widgets: -

2928 -

2929 \table -

2930 \header \li Widget \li Property \li Change Notification Signal -

2931 \row \li QAbstractButton \li bool \l{QAbstractButton::}{checked} \li \l{QAbstractButton::}{toggled()} -

2932 \row \li QAbstractSlider \li int \l{QAbstractSlider::}{value} \li \l{QAbstractSlider::}{valueChanged()} -

2933 \row \li QComboBox \li int \l{QComboBox::}{currentIndex} \li \l{QComboBox::}{currentIndexChanged()} -

2934 \row \li QDateTimeEdit \li QDateTime \l{QDateTimeEdit::}{dateTime} \li \l{QDateTimeEdit::}{dateTimeChanged()} -

2935 \row \li QLineEdit \li QString \l{QLineEdit::}{text} \li \l{QLineEdit::}{textChanged()} -

2936 \row \li QListWidget \li int \l{QListWidget::}{currentRow} \li \l{QListWidget::}{currentRowChanged()} -

2937 \row \li QSpinBox \li int \l{QSpinBox::}{value} \li \l{QSpinBox::}{valueChanged()} -

2938 \endtable -

2939 -

2940 \sa QWizardPage::registerField() -

2941 */ -

2942 void QWizard::setDefaultProperty(const char *className, const char *property, -

2943 const char *changedSignal) -

2944 { -

2945 Q_D(QWizard); -

2946

for (int i = d->defaultPropertyTable.count() - 1; i >= 0; --i) {

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

2947

if (qstrcmp(d->defaultPropertyTable.at(i).className, className) == 0) {

qstrcmp(d->def...lassName) == 0	Description
TRUE	never evaluated
FALSE	never evaluated

2948 d->defaultPropertyTable.remove(i); -

2949

break;

never executed: break;

2950 } -

2951

}

never executed: end of block

2952 d->defaultPropertyTable.append(QWizardDefaultProperty(className, property, changedSignal)); -

2953

}

never executed: end of block

2954 -

2955 /*! -

2956 \since 4.7 -

2957 -

2958 Sets the given \a widget to be shown on the left side of the wizard. -

2959 For styles which use the WatermarkPixmap (ClassicStyle and ModernStyle) -

2960 the side widget is displayed on top of the watermark, for other styles -

2961 or when the watermark is not provided the side widget is displayed -

2962 on the left side of the wizard. -

2963 -

2964 Passing 0 shows no side widget. -

2965 -

2966 When the \a widget is not 0 the wizard reparents it. -

2967 -

2968 Any previous side widget is hidden. -

2969 -

2970 You may call setSideWidget() with the same widget at different -

2971 times. -

2972 -

2973 All widgets set here will be deleted by the wizard when it is -

2974 destroyed unless you separately reparent the widget after setting -

2975 some other side widget (or 0). -

2976 -

2977 By default, no side widget is present. -

2978 */ -

2979 void QWizard::setSideWidget(QWidget *widget) -

2980 { -

2981 Q_D(QWizard); -

2982 -

2983 d->sideWidget = widget; -

2984

if (d->watermarkLabel) {

d->watermarkLabel	Description
TRUE	never evaluated
FALSE	never evaluated

2985 d->watermarkLabel->setSideWidget(widget); -

2986 d->updateLayout(); -

2987

}

never executed: end of block

2988

}

never executed: end of block

2989 -

2990 /*! -

2991 \since 4.7 -

2992 -

2993 Returns the widget on the left side of the wizard or 0. -

2994 -

2995 By default, no side widget is present. -

2996 */ -

2997 QWidget *QWizard::sideWidget() const -

2998 { -

2999 Q_D(const QWizard); -

3000 -

3001

return d->sideWidget;

never executed: return d->sideWidget;

3002 } -

3003 -

3004 /*! -

3005 \reimp -

3006 */ -

3007 void QWizard::setVisible(bool visible) -

3008 { -

3009 Q_D(QWizard); -

3010

if (visible) {

visible	Description
TRUE	never evaluated
FALSE	never evaluated

3011

if (d->current == -1)

d->current == -1	Description
TRUE	never evaluated
FALSE	never evaluated

3012

restart();

never executed: restart();

3013

}

never executed: end of block

3014 QDialog::setVisible(visible); -

3015

}

never executed: end of block

3016 -

3017 /*! -

3018 \reimp -

3019 */ -

3020 QSize QWizard::sizeHint() const -

3021 { -

3022 Q_D(const QWizard); -

3023 QSize result = d->mainLayout->totalSizeHint(); -

3024 QSize extra(500, 360); -

3025

if (d->wizStyle == MacStyle && d->current != -1) {

d->wizStyle == MacStyle	Description
TRUE	never evaluated
FALSE	never evaluated

d->current != -1	Description
TRUE	never evaluated
FALSE	never evaluated

3026 QSize pixmap(currentPage()->pixmap(BackgroundPixmap).size()); -

3027 extra.setWidth(616); -

3028

if (!pixmap.isNull()) {

!pixmap.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

3029 extra.setHeight(pixmap.height()); -

3030 -

3031 /* -

3032 The width isn't always reliable as a size hint, as -

3033 some wizard backgrounds just cover the leftmost area. -

3034 Use a rule of thumb to determine if the width is -

3035 reliable or not. -

3036 */ -

3037

if (pixmap.width() >= pixmap.height())

pixmap.width()...ixmap.height()	Description
TRUE	never evaluated
FALSE	never evaluated

3038

extra.setWidth(pixmap.width());

never executed: extra.setWidth(pixmap.width());

3039

}

never executed: end of block

3040

}

never executed: end of block

3041

return result.expandedTo(extra);

never executed: return result.expandedTo(extra);

3042 } -

3043 -

3044 /*! -

3045 \fn void QWizard::currentIdChanged(int id) -

3046 -

3047 This signal is emitted when the current page changes, with the new -

3048 current \a id. -

3049 -

3050 \sa currentId(), currentPage() -

3051 */ -

3052 -

3053 /*! -

3054 \fn void QWizard::pageAdded(int id) -

3055 -

3056 \since 4.7 -

3057 -

3058 This signal is emitted whenever a page is added to the -

3059 wizard. The page's \a id is passed as parameter. -

3060 -

3061 \sa addPage(), setPage(), startId() -

3062 */ -

3063 -

3064 /*! -

3065 \fn void QWizard::pageRemoved(int id) -

3066 -

3067 \since 4.7 -

3068 -

3069 This signal is emitted whenever a page is removed from the -

3070 wizard. The page's \a id is passed as parameter. -

3071 -

3072 \sa removePage(), startId() -

3073 */ -

3074 -

3075 /*! -

3076 \fn void QWizard::helpRequested() -

3077 -

3078 This signal is emitted when the user clicks the \uicontrol Help button. -

3079 -

3080 By default, no \uicontrol Help button is shown. Call -

3081 setOption(HaveHelpButton, true) to have one. -

3082 -

3083 Example: -

3084 -

3085 \snippet dialogs/licensewizard/licensewizard.cpp 0 -

3086 \dots -

3087 \snippet dialogs/licensewizard/licensewizard.cpp 5 -

3088 \snippet dialogs/licensewizard/licensewizard.cpp 7 -

3089 \dots -

3090 \snippet dialogs/licensewizard/licensewizard.cpp 8 -

3091 \codeline -

3092 \snippet dialogs/licensewizard/licensewizard.cpp 10 -

3093 \dots -

3094 \snippet dialogs/licensewizard/licensewizard.cpp 12 -

3095 \codeline -

3096 \snippet dialogs/licensewizard/licensewizard.cpp 14 -

3097 \codeline -

3098 \snippet dialogs/licensewizard/licensewizard.cpp 15 -

3099 -

3100 \sa customButtonClicked() -

3101 */ -

3102 -

3103 /*! -

3104 \fn void QWizard::customButtonClicked(int which) -

3105 -

3106 This signal is emitted when the user clicks a custom button. \a -

3107 which can be CustomButton1, CustomButton2, or CustomButton3. -

3108 -

3109 By default, no custom button is shown. Call setOption() with -

3110 HaveCustomButton1, HaveCustomButton2, or HaveCustomButton3 to have -

3111 one, and use setButtonText() or setButton() to configure it. -

3112 -

3113 \sa helpRequested() -

3114 */ -

3115 -

3116 /*! -

3117 Goes back to the previous page. -

3118 -

3119 This is equivalent to pressing the \uicontrol Back button. -

3120 -

3121 \sa next(), accept(), reject(), restart() -

3122 */ -

3123 void QWizard::back() -

3124 { -

3125 Q_D(QWizard); -

3126 int n = d->history.count() - 2; -

3127

if (n < 0)

n < 0	Description
TRUE	never evaluated
FALSE	never evaluated

3128

return;

never executed: return;

3129 d->switchToPage(d->history.at(n), QWizardPrivate::Backward); -

3130

}

never executed: end of block

3131 -

3132 /*! -

3133 Advances to the next page. -

3134 -

3135 This is equivalent to pressing the \uicontrol Next or \uicontrol Commit button. -

3136 -

3137 \sa nextId(), back(), accept(), reject(), restart() -

3138 */ -

3139 void QWizard::next() -

3140 { -

3141 Q_D(QWizard); -

3142 -

3143

if (d->current == -1)

d->current == -1	Description
TRUE	never evaluated
FALSE	never evaluated

3144

return;

never executed: return;

3145 -

3146

if (validateCurrentPage()) {

validateCurrentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

3147 int next = nextId(); -

3148

if (next != -1) {

next != -1	Description
TRUE	never evaluated
FALSE	never evaluated

3149

if (Q_UNLIKELY(d->history.contains(next))) {

__builtin_expe...next)), false)	Description
TRUE	never evaluated
FALSE	never evaluated

3150 qWarning("QWizard::next: Page %d already met", next); -

3151

return;

never executed: return;

3152 } -

3153

if (Q_UNLIKELY(!d->pageMap.contains(next))) {

__builtin_expe...next)), false)	Description
TRUE	never evaluated
FALSE	never evaluated

3154 qWarning("QWizard::next: No such page %d", next); -

3155

return;

never executed: return;

3156 } -

3157 d->switchToPage(next, QWizardPrivate::Forward); -

3158

}

never executed: end of block

3159

}

never executed: end of block

3160

}

never executed: end of block

3161 -

3162 /*! -

3163 Restarts the wizard at the start page. This function is called automatically when the -

3164 wizard is shown. -

3165 -

3166 \sa startId() -

3167 */ -

3168 void QWizard::restart() -

3169 { -

3170 Q_D(QWizard); -

3171 d->disableUpdates(); -

3172 d->reset(); -

3173 d->switchToPage(startId(), QWizardPrivate::Forward); -

3174 d->enableUpdates(); -

3175

}

never executed: end of block

3176 -

3177 /*! -

3178 \reimp -

3179 */ -

3180 bool QWizard::event(QEvent *event) -

3181 { -

3182 Q_D(QWizard); -

3183

if (event->type() == QEvent::StyleChange) { // Propagate style

event->type() ...t::StyleChange	Description
TRUE	never evaluated
FALSE	never evaluated

3184 d->setStyle(style()); -

3185 d->updateLayout(); -

3186

}

never executed: end of block

3187 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

3188 else if (event->type() == QEvent::Show && d->vistaInitPending) { -

3189 d->vistaInitPending = false; -

3190 // Do not force AeroStyle when in Classic theme. -

3191 // Note that d->handleAeroStyleChange() needs to be called in any case as it does some -

3192 // necessary initialization, like ensures that the Aero specific back button is hidden if -

3193 // Aero theme isn't active. -

3194 if (QVistaHelper::vistaState() != QVistaHelper::Classic) -

3195 d->wizStyle = AeroStyle; -

3196 d->handleAeroStyleChange(); -

3197 } -

3198 else if (d->isVistaThemeEnabled()) { -

3199 if (event->type() == QEvent::Resize -

3200 || event->type() == QEvent::LayoutDirectionChange) { -

3201 const int buttonLeft = (layoutDirection() == Qt::RightToLeft -

3202 ? width() - d->vistaHelper->backButton()->sizeHint().width() -

3203 : 0); -

3204 -

3205 d->vistaHelper->backButton()->move(buttonLeft, -

3206 d->vistaHelper->backButton()->y()); -

3207 } -

3208 -

3209 d->vistaHelper->mouseEvent(event); -

3210 } -

3211 #endif -

3212

return QDialog::event(event);

never executed: return QDialog::event(event);

3213 } -

3214 -

3215 /*! -

3216 \reimp -

3217 */ -

3218 void QWizard::resizeEvent(QResizeEvent *event) -

3219 { -

3220 Q_D(QWizard); -

3221 int heightOffset = 0; -

3222 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

3223 if (d->isVistaThemeEnabled()) { -

3224 heightOffset = d->vistaHelper->topOffset(); -

3225 if (d->isVistaThemeEnabled(QVistaHelper::VistaAero)) -

3226 heightOffset += d->vistaHelper->titleBarSize(); -

3227 } -

3228 #endif -

3229 d->antiFlickerWidget->resize(event->size().width(), event->size().height() - heightOffset); -

3230 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

3231 if (d->isVistaThemeEnabled()) -

3232 d->vistaHelper->resizeEvent(event); -

3233 #endif -

3234 QDialog::resizeEvent(event); -

3235

}

never executed: end of block

3236 -

3237 /*! -

3238 \reimp -

3239 */ -

3240 void QWizard::paintEvent(QPaintEvent * event) -

3241 { -

3242 Q_D(QWizard); -

3243

if (d->wizStyle == MacStyle && currentPage()) {

d->wizStyle == MacStyle	Description
TRUE	never evaluated
FALSE	never evaluated

currentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

3244 QPixmap backgroundPixmap = currentPage()->pixmap(BackgroundPixmap); -

3245

if (backgroundPixmap.isNull())

backgroundPixmap.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

3246

return;

never executed: return;

3247 -

3248 QPainter painter(this); -

3249 painter.drawPixmap(0, (height() - backgroundPixmap.height()) / 2, backgroundPixmap); -

3250

}

never executed: end of block

3251 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

3252 else if (d->isVistaThemeEnabled()) { -

3253 if (d->isVistaThemeEnabled(QVistaHelper::VistaBasic)) { -

3254 QPainter painter(this); -

3255 QColor color = d->vistaHelper->basicWindowFrameColor(); -

3256 painter.fillRect(0, 0, width(), QVistaHelper::topOffset(), color); -

3257 } -

3258 d->vistaHelper->paintEvent(event); -

3259 } -

3260 #else -

3261 Q_UNUSED(event); -

3262 #endif -

3263

}

never executed: end of block

3264 -

3265 #if defined(Q_OS_WIN) -

3266 /*! -

3267 \reimp -

3268 */ -

3269 bool QWizard::nativeEvent(const QByteArray &eventType, void *message, long *result) -

3270 { -

3271 #if !defined(QT_NO_STYLE_WINDOWSVISTA) -

3272 Q_D(QWizard); -

3273 if (d->isVistaThemeEnabled() && eventType == "windows_generic_MSG") { -

3274 MSG *windowsMessage = static_cast<MSG *>(message); -

3275 const bool winEventResult = d->vistaHelper->handleWinEvent(windowsMessage, result); -

3276 if (QVistaHelper::vistaState() != d->vistaState) { -

3277 d->vistaState = QVistaHelper::vistaState(); -

3278 d->vistaStateChanged = true; -

3279 setWizardStyle(AeroStyle); -

3280 } -

3281 return winEventResult; -

3282 } else { -

3283 return QDialog::nativeEvent(eventType, message, result); -

3284 } -

3285 #else -

3286 return QDialog::nativeEvent(eventType, message, result); -

3287 #endif -

3288 } -

3289 #endif -

3290 -

3291 /*! -

3292 \reimp -

3293 */ -

3294 void QWizard::done(int result) -

3295 { -

3296 Q_D(QWizard); -

3297 // canceling leaves the wizard in a known state -

3298

if (result == Rejected) {

result == Rejected	Description
TRUE	never evaluated
FALSE	never evaluated

3299 d->reset(); -

3300

} else {

never executed: end of block

3301

if (!validateCurrentPage())

!validateCurrentPage()	Description
TRUE	never evaluated
FALSE	never evaluated

3302

return;

never executed: return;

3303

}

never executed: end of block

3304 QDialog::done(result); -

3305

}

never executed: end of block

3306 -

3307 /*! -

3308 \fn void QWizard::initializePage(int id) -

3309 -

3310 This virtual function is called by QWizard to prepare page \a id -

3311 just before it is shown either as a result of QWizard::restart() -

3312 being called, or as a result of the user clicking \uicontrol Next. (However, if the \l -

3313 QWizard::IndependentPages option is set, this function is only -

3314 called the first time the page is shown.) -

3315 -

3316 By reimplementing this function, you can ensure that the page's -

3317 fields are properly initialized based on fields from previous -

3318 pages. -

3319 -

3320 The default implementation calls QWizardPage::initializePage() on -

3321 page(\a id). -

3322 -

3323 \sa QWizardPage::initializePage(), cleanupPage() -

3324 */ -

3325 void QWizard::initializePage(int theid) -

3326 { -

3327 QWizardPage *page = this->page(theid); -

3328

if (page)

page	Description
TRUE	never evaluated
FALSE	never evaluated

3329

page->initializePage();

never executed: page->initializePage();

3330

}

never executed: end of block

3331 -

3332 /*! -

3333 \fn void QWizard::cleanupPage(int id) -

3334 -

3335 This virtual function is called by QWizard to clean up page \a id just before the -

3336 user leaves it by clicking \uicontrol Back (unless the \l QWizard::IndependentPages option is set). -

3337 -

3338 The default implementation calls QWizardPage::cleanupPage() on -

3339 page(\a id). -

3340 -

3341 \sa QWizardPage::cleanupPage(), initializePage() -

3342 */ -

3343 void QWizard::cleanupPage(int theid) -

3344 { -

3345 QWizardPage *page = this->page(theid); -

3346

if (page)

page	Description
TRUE	never evaluated
FALSE	never evaluated

3347

page->cleanupPage();

never executed: page->cleanupPage();

3348

}

never executed: end of block

3349 -

3350 /*! -

3351 This virtual function is called by QWizard when the user clicks -

3352 \uicontrol Next or \uicontrol Finish to perform some last-minute validation. -

3353 If it returns \c true, the next page is shown (or the wizard -

3354 finishes); otherwise, the current page stays up. -

3355 -

3356 The default implementation calls QWizardPage::validatePage() on -

3357 the currentPage(). -

3358 -

3359 When possible, it is usually better style to disable the \uicontrol -

3360 Next or \uicontrol Finish button (by specifying \l{mandatory fields} or -

3361 by reimplementing QWizardPage::isComplete()) than to reimplement -

3362 validateCurrentPage(). -

3363 -

3364 \sa QWizardPage::validatePage(), currentPage() -

3365 */ -

3366 bool QWizard::validateCurrentPage() -

3367 { -

3368 QWizardPage *page = currentPage(); -

3369

if (!page)

!page	Description
TRUE	never evaluated
FALSE	never evaluated

3370

return true;

never executed: return true;

3371 -

3372

return page->validatePage();

never executed: return page->validatePage();

3373 } -

3374 -

3375 /*! -

3376 This virtual function is called by QWizard to find out which page -

3377 to show when the user clicks the \uicontrol Next button. -

3378 -

3379 The return value is the ID of the next page, or -1 if no page follows. -

3380 -

3381 The default implementation calls QWizardPage::nextId() on the -

3382 currentPage(). -

3383 -

3384 By reimplementing this function, you can specify a dynamic page -

3385 order. -

3386 -

3387 \sa QWizardPage::nextId(), currentPage() -

3388 */ -

3389 int QWizard::nextId() const -

3390 { -

3391 const QWizardPage *page = currentPage(); -

3392

if (!page)

!page	Description
TRUE	never evaluated
FALSE	never evaluated

3393

return -1;

never executed: return -1;

3394 -

3395

return page->nextId();

never executed: return page->nextId();

3396 } -

3397 -

3398 /*! -

3399 \class QWizardPage -

3400 \since 4.3 -

3401 \brief The QWizardPage class is the base class for wizard pages. -

3402 -

3403 \inmodule QtWidgets -

3404 -

3405 QWizard represents a wizard. Each page is a QWizardPage. When -

3406 you create your own wizards, you can use QWizardPage directly, -

3407 or you can subclass it for more control. -

3408 -

3409 A page has the following attributes, which are rendered by -

3410 QWizard: a \l title, a \l subTitle, and a \l{setPixmap()}{set of -

3411 pixmaps}. See \l{Elements of a Wizard Page} for details. Once a -

3412 page is added to the wizard (using QWizard::addPage() or -

3413 QWizard::setPage()), wizard() returns a pointer to the -

3414 associated QWizard object. -

3415 -

3416 Page provides five virtual functions that can be reimplemented to -

3417 provide custom behavior: -

3418 -

3419 \list -

3420 \li initializePage() is called to initialize the page's contents -

3421 when the user clicks the wizard's \uicontrol Next button. If you -

3422 want to derive the page's default from what the user entered -

3423 on previous pages, this is the function to reimplement. -

3424 \li cleanupPage() is called to reset the page's contents when the -

3425 user clicks the wizard's \uicontrol Back button. -

3426 \li validatePage() validates the page when the user clicks \uicontrol -

3427 Next or \uicontrol Finish. It is often used to show an error message -

3428 if the user has entered incomplete or invalid information. -

3429 \li nextId() returns the ID of the next page. It is useful when -

3430 \l{creating non-linear wizards}, which allow different -

3431 traversal paths based on the information provided by the user. -

3432 \li isComplete() is called to determine whether the \uicontrol Next -

3433 and/or \uicontrol Finish button should be enabled or disabled. If -

3434 you reimplement isComplete(), also make sure that -

3435 completeChanged() is emitted whenever the complete state -

3436 changes. -

3437 \endlist -

3438 -

3439 Normally, the \uicontrol Next button and the \uicontrol Finish button of a -

3440 wizard are mutually exclusive. If isFinalPage() returns \c true, \uicontrol -

3441 Finish is available; otherwise, \uicontrol Next is available. By -

3442 default, isFinalPage() is true only when nextId() returns -1. If -

3443 you want to show \uicontrol Next and \uicontrol Final simultaneously for a -

3444 page (letting the user perform an "early finish"), call -

3445 setFinalPage(true) on that page. For wizards that support early -

3446 finishes, you might also want to set the -

3447 \l{QWizard::}{HaveNextButtonOnLastPage} and -

3448 \l{QWizard::}{HaveFinishButtonOnEarlyPages} options on the -

3449 wizard. -

3450 -

3451 In many wizards, the contents of a page may affect the default -

3452 values of the fields of a later page. To make it easy to -

3453 communicate between pages, QWizard supports a \l{Registering and -

3454 Using Fields}{"field" mechanism} that allows you to register a -

3455 field (e.g., a QLineEdit) on a page and to access its value from -

3456 any page. Fields are global to the entire wizard and make it easy -

3457 for any single page to access information stored by another page, -

3458 without having to put all the logic in QWizard or having the -

3459 pages know explicitly about each other. Fields are registered -

3460 using registerField() and can be accessed at any time using -

3461 field() and setField(). -

3462 -

3463 \sa QWizard, {Class Wizard Example}, {License Wizard Example} -

3464 */ -

3465 -

3466 /*! -

3467 Constructs a wizard page with the given \a parent. -

3468 -

3469 When the page is inserted into a wizard using QWizard::addPage() -

3470 or QWizard::setPage(), the parent is automatically set to be the -

3471 wizard. -

3472 -

3473 \sa wizard() -

3474 */ -

3475 QWizardPage::QWizardPage(QWidget *parent) -

3476 : QWidget(*new QWizardPagePrivate, parent, 0) -

3477 { -

3478 connect(this, SIGNAL(completeChanged()), this, SLOT(_q_updateCachedCompleteState())); -

3479

}

never executed: end of block

3480 -

3481 /*! -

3482 Destructor. -

3483 */ -

3484 QWizardPage::~QWizardPage() -

3485 { -

3486 } -

3487 -

3488 /*! -

3489 \property QWizardPage::title -

3490 \brief the title of the page -

3491 -

3492 The title is shown by the QWizard, above the actual page. All -

3493 pages should have a title. -

3494 -

3495 The title may be plain text or HTML, depending on the value of the -

3496 \l{QWizard::titleFormat} property. -

3497 -

3498 By default, this property contains an empty string. -

3499 -

3500 \sa subTitle, {Elements of a Wizard Page} -

3501 */ -

3502 void QWizardPage::setTitle(const QString &title) -

3503 { -

3504 Q_D(QWizardPage); -

3505 d->title = title; -

3506

if (d->wizard && d->wizard->currentPage() == this)

d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

d->wizard->cur...Page() == this	Description
TRUE	never evaluated
FALSE	never evaluated

3507

d->wizard->d_func()->updateLayout();

never executed: d->wizard->d_func()->updateLayout();

3508

}

never executed: end of block

3509 -

3510 QString QWizardPage::title() const -

3511 { -

3512 Q_D(const QWizardPage); -

3513

return d->title;

never executed: return d->title;

3514 } -

3515 -

3516 /*! -

3517 \property QWizardPage::subTitle -

3518 \brief the subtitle of the page -

3519 -

3520 The subtitle is shown by the QWizard, between the title and the -

3521 actual page. Subtitles are optional. In -

3522 \l{QWizard::ClassicStyle}{ClassicStyle} and -

3523 \l{QWizard::ModernStyle}{ModernStyle}, using subtitles is -

3524 necessary to make the header appear. In -

3525 \l{QWizard::MacStyle}{MacStyle}, the subtitle is shown as a text -

3526 label just above the actual page. -

3527 -

3528 The subtitle may be plain text or HTML, depending on the value of -

3529 the \l{QWizard::subTitleFormat} property. -

3530 -

3531 By default, this property contains an empty string. -

3532 -

3533 \sa title, QWizard::IgnoreSubTitles, {Elements of a Wizard Page} -

3534 */ -

3535 void QWizardPage::setSubTitle(const QString &subTitle) -

3536 { -

3537 Q_D(QWizardPage); -

3538 d->subTitle = subTitle; -

3539

if (d->wizard && d->wizard->currentPage() == this)

d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

d->wizard->cur...Page() == this	Description
TRUE	never evaluated
FALSE	never evaluated

3540

d->wizard->d_func()->updateLayout();

never executed: d->wizard->d_func()->updateLayout();

3541

}

never executed: end of block

3542 -

3543 QString QWizardPage::subTitle() const -

3544 { -

3545 Q_D(const QWizardPage); -

3546

return d->subTitle;

never executed: return d->subTitle;

3547 } -

3548 -

3549 /*! -

3550 Sets the pixmap for role \a which to \a pixmap. -

3551 -

3552 The pixmaps are used by QWizard when displaying a page. Which -

3553 pixmaps are actually used depend on the \l{Wizard Look and -

3554 Feel}{wizard style}. -

3555 -

3556 Pixmaps can also be set for the entire wizard using -

3557 QWizard::setPixmap(), in which case they apply for all pages that -

3558 don't specify a pixmap. -

3559 -

3560 \sa QWizard::setPixmap(), {Elements of a Wizard Page} -

3561 */ -

3562 void QWizardPage::setPixmap(QWizard::WizardPixmap which, const QPixmap &pixmap) -

3563 { -

3564 Q_D(QWizardPage); -

3565 Q_ASSERT(uint(which) < QWizard::NPixmaps); -

3566 d->pixmaps[which] = pixmap; -

3567

if (d->wizard && d->wizard->currentPage() == this)

d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

d->wizard->cur...Page() == this	Description
TRUE	never evaluated
FALSE	never evaluated

3568

d->wizard->d_func()->updatePixmap(which);

never executed: d->wizard->d_func()->updatePixmap(which);

3569

}

never executed: end of block

3570 -

3571 /*! -

3572 Returns the pixmap set for role \a which. -

3573 -

3574 Pixmaps can also be set for the entire wizard using -

3575 QWizard::setPixmap(), in which case they apply for all pages that -

3576 don't specify a pixmap. -

3577 -

3578 \sa QWizard::pixmap(), {Elements of a Wizard Page} -

3579 */ -

3580 QPixmap QWizardPage::pixmap(QWizard::WizardPixmap which) const -

3581 { -

3582 Q_D(const QWizardPage); -

3583 Q_ASSERT(uint(which) < QWizard::NPixmaps); -

3584 -

3585 const QPixmap &pixmap = d->pixmaps[which]; -

3586

if (!pixmap.isNull())

!pixmap.isNull()	Description
TRUE	never evaluated
FALSE	never evaluated

3587

return pixmap;

never executed: return pixmap;

3588 -

3589

if (wizard())

wizard()	Description
TRUE	never evaluated
FALSE	never evaluated

3590

return wizard()->pixmap(which);

never executed: return wizard()->pixmap(which);

3591 -

3592

return pixmap;

never executed: return pixmap;

3593 } -

3594 -

3595 /*! -

3596 This virtual function is called by QWizard::initializePage() to -

3597 prepare the page just before it is shown either as a result of QWizard::restart() -

3598 being called, or as a result of the user clicking \uicontrol Next. -

3599 (However, if the \l QWizard::IndependentPages option is set, this function is only -

3600 called the first time the page is shown.) -

3601 -

3602 By reimplementing this function, you can ensure that the page's -

3603 fields are properly initialized based on fields from previous -

3604 pages. For example: -

3605 -

3606 \snippet dialogs/classwizard/classwizard.cpp 17 -

3607 -

3608 The default implementation does nothing. -

3609 -

3610 \sa QWizard::initializePage(), cleanupPage(), QWizard::IndependentPages -

3611 */ -

3612 void QWizardPage::initializePage() -

3613 { -

3614 } -

3615 -

3616 /*! -

3617 This virtual function is called by QWizard::cleanupPage() when -

3618 the user leaves the page by clicking \uicontrol Back (unless the \l QWizard::IndependentPages -

3619 option is set). -

3620 -

3621 The default implementation resets the page's fields to their -

3622 original values (the values they had before initializePage() was -

3623 called). -

3624 -

3625 \sa QWizard::cleanupPage(), initializePage(), QWizard::IndependentPages -

3626 */ -

3627 void QWizardPage::cleanupPage() -

3628 { -

3629 Q_D(QWizardPage); -

3630

if (d->wizard) {

d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

3631 const QVector<QWizardField> &fields = d->wizard->d_func()->fields; -

3632 for (const auto &field : fields) { -

3633

if (field.page == this)

field.page == this	Description
TRUE	never evaluated
FALSE	never evaluated

3634

field.object->setProperty(field.property, field.initialValue);

never executed: field.object->setProperty(field.property, field.initialValue);

3635

}

never executed: end of block

3636

}

never executed: end of block

3637

}

never executed: end of block

3638 -

3639 /*! -

3640 This virtual function is called by QWizard::validateCurrentPage() -

3641 when the user clicks \uicontrol Next or \uicontrol Finish to perform some -

3642 last-minute validation. If it returns \c true, the next page is shown -

3643 (or the wizard finishes); otherwise, the current page stays up. -

3644 -

3645 The default implementation returns \c true. -

3646 -

3647 When possible, it is usually better style to disable the \uicontrol -

3648 Next or \uicontrol Finish button (by specifying \l{mandatory fields} or -

3649 reimplementing isComplete()) than to reimplement validatePage(). -

3650 -

3651 \sa QWizard::validateCurrentPage(), isComplete() -

3652 */ -

3653 bool QWizardPage::validatePage() -

3654 { -

3655

return true;

never executed: return true;

3656 } -

3657 -

3658 /*! -

3659 This virtual function is called by QWizard to determine whether -

3660 the \uicontrol Next or \uicontrol Finish button should be enabled or -

3661 disabled. -

3662 -

3663 The default implementation returns \c true if all \l{mandatory -

3664 fields} are filled; otherwise, it returns \c false. -

3665 -

3666 If you reimplement this function, make sure to emit completeChanged(), -

3667 from the rest of your implementation, whenever the value of isComplete() -

3668 changes. This ensures that QWizard updates the enabled or disabled state of -

3669 its buttons. An example of the reimplementation is -

3670 available \l{http://doc.qt.io/archives/qq/qq22-qwizard.html#validatebeforeitstoolate} -

3671 {here}. -

3672 -

3673 \sa completeChanged(), isFinalPage() -

3674 */ -

3675 bool QWizardPage::isComplete() const -

3676 { -

3677 Q_D(const QWizardPage); -

3678 -

3679

if (!d->wizard)

!d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

3680

return true;

never executed: return true;

3681 -

3682 const QVector<QWizardField> &wizardFields = d->wizard->d_func()->fields; -

3683

for (int i = wizardFields.count() - 1; i >= 0; --i) {

i >= 0	Description
TRUE	never evaluated
FALSE	never evaluated

3684 const QWizardField &field = wizardFields.at(i); -

3685

if (field.page == this && field.mandatory) {

field.page == this	Description
TRUE	never evaluated
FALSE	never evaluated

field.mandatory	Description
TRUE	never evaluated
FALSE	never evaluated

3686 QVariant value = field.object->property(field.property); -

3687

if (value == field.initialValue)

value == field.initialValue	Description
TRUE	never evaluated
FALSE	never evaluated

3688

return false;

never executed: return false;

3689 -

3690 #ifndef QT_NO_LINEEDIT -

3691

if (QLineEdit *lineEdit = qobject_cast<QLineEdit *>(field.object)) {

QLineEdit *lin...(field.object)	Description
TRUE	never evaluated
FALSE	never evaluated

3692

if (!lineEdit->hasAcceptableInput())

!lineEdit->has...eptableInput()	Description
TRUE	never evaluated
FALSE	never evaluated

3693

return false;

never executed: return false;

3694

}

never executed: end of block

3695 #endif -

3696 #ifndef QT_NO_SPINBOX -

3697

if (QAbstractSpinBox *spinBox = qobject_cast<QAbstractSpinBox *>(field.object)) {

QAbstractSpinB...(field.object)	Description
TRUE	never evaluated
FALSE	never evaluated

3698

if (!spinBox->hasAcceptableInput())

!spinBox->hasAcceptableInput()	Description
TRUE	never evaluated
FALSE	never evaluated

3699

return false;

never executed: return false;

3700

}

never executed: end of block

3701 #endif -

3702

}

never executed: end of block

3703

}

never executed: end of block

3704

return true;

never executed: return true;

3705 } -

3706 -

3707 /*! -

3708 Explicitly sets this page to be final if \a finalPage is true. -

3709 -

3710 After calling setFinalPage(true), isFinalPage() returns \c true and the \uicontrol -

3711 Finish button is visible (and enabled if isComplete() returns -

3712 true). -

3713 -

3714 After calling setFinalPage(false), isFinalPage() returns \c true if -

3715 nextId() returns -1; otherwise, it returns \c false. -

3716 -

3717 \sa isComplete(), QWizard::HaveFinishButtonOnEarlyPages -

3718 */ -

3719 void QWizardPage::setFinalPage(bool finalPage) -

3720 { -

3721 Q_D(QWizardPage); -

3722 d->explicitlyFinal = finalPage; -

3723 QWizard *wizard = this->wizard(); -

3724

if (wizard && wizard->currentPage() == this)

wizard	Description
TRUE	never evaluated
FALSE	never evaluated

wizard->currentPage() == this	Description
TRUE	never evaluated
FALSE	never evaluated

3725

wizard->d_func()->updateCurrentPage();

never executed: wizard->d_func()->updateCurrentPage();

3726

}

never executed: end of block

3727 -

3728 /*! -

3729 This function is called by QWizard to determine whether the \uicontrol -

3730 Finish button should be shown for this page or not. -

3731 -

3732 By default, it returns \c true if there is no next page -

3733 (i.e., nextId() returns -1); otherwise, it returns \c false. -

3734 -

3735 By explicitly calling setFinalPage(true), you can let the user perform an -

3736 "early finish". -

3737 -

3738 \sa isComplete(), QWizard::HaveFinishButtonOnEarlyPages -

3739 */ -

3740 bool QWizardPage::isFinalPage() const -

3741 { -

3742 Q_D(const QWizardPage); -

3743

if (d->explicitlyFinal)

d->explicitlyFinal	Description
TRUE	never evaluated
FALSE	never evaluated

3744

return true;

never executed: return true;

3745 -

3746 QWizard *wizard = this->wizard(); -

3747

if (wizard && wizard->currentPage() == this) {

wizard	Description
TRUE	never evaluated
FALSE	never evaluated

wizard->currentPage() == this	Description
TRUE	never evaluated
FALSE	never evaluated

3748 // try to use the QWizard implementation if possible -

3749

return wizard->nextId() == -1;

never executed: return wizard->nextId() == -1;

3750 } else { -

3751

return nextId() == -1;

never executed: return nextId() == -1;

3752 } -

3753 } -

3754 -

3755 /*! -

3756 Sets this page to be a commit page if \a commitPage is true; otherwise, -

3757 sets it to be a normal page. -

3758 -

3759 A commit page is a page that represents an action which cannot be undone -

3760 by clicking \uicontrol Back or \uicontrol Cancel. -

3761 -

3762 A \uicontrol Commit button replaces the \uicontrol Next button on a commit page. Clicking this -

3763 button simply calls QWizard::next() just like clicking \uicontrol Next does. -

3764 -

3765 A page entered directly from a commit page has its \uicontrol Back button disabled. -

3766 -

3767 \sa isCommitPage() -

3768 */ -

3769 void QWizardPage::setCommitPage(bool commitPage) -

3770 { -

3771 Q_D(QWizardPage); -

3772 d->commit = commitPage; -

3773 QWizard *wizard = this->wizard(); -

3774

if (wizard && wizard->currentPage() == this)

wizard	Description
TRUE	never evaluated
FALSE	never evaluated

wizard->currentPage() == this	Description
TRUE	never evaluated
FALSE	never evaluated

3775

wizard->d_func()->updateCurrentPage();

never executed: wizard->d_func()->updateCurrentPage();

3776

}

never executed: end of block

3777 -

3778 /*! -

3779 Returns \c true if this page is a commit page; otherwise returns \c false. -

3780 -

3781 \sa setCommitPage() -

3782 */ -

3783 bool QWizardPage::isCommitPage() const -

3784 { -

3785 Q_D(const QWizardPage); -

3786

return d->commit;

never executed: return d->commit;

3787 } -

3788 -

3789 /*! -

3790 Sets the text on button \a which to be \a text on this page. -

3791 -

3792 By default, the text on buttons depends on the QWizard::wizardStyle, -

3793 but may be redefined for the wizard as a whole using QWizard::setButtonText(). -

3794 -

3795 \sa buttonText(), QWizard::setButtonText(), QWizard::buttonText() -

3796 */ -

3797 void QWizardPage::setButtonText(QWizard::WizardButton which, const QString &text) -

3798 { -

3799 Q_D(QWizardPage); -

3800 d->buttonCustomTexts.insert(which, text); -

3801

if (wizard() && wizard()->currentPage() == this && wizard()->d_func()->btns[which])

wizard()	Description
TRUE	never evaluated
FALSE	never evaluated

wizard()->curr...Page() == this	Description
TRUE	never evaluated
FALSE	never evaluated

wizard()->d_fu...)->btns[which]	Description
TRUE	never evaluated
FALSE	never evaluated

3802

wizard()->d_func()->btns[which]->setText(text);

never executed: wizard()->d_func()->btns[which]->setText(text);

3803

}

never executed: end of block

3804 -

3805 /*! -

3806 Returns the text on button \a which on this page. -

3807 -

3808 If a text has ben set using setButtonText(), this text is returned. -

3809 Otherwise, if a text has been set using QWizard::setButtonText(), -

3810 this text is returned. -

3811 -

3812 By default, the text on buttons depends on the QWizard::wizardStyle. -

3813 For example, on \macos, the \uicontrol Next button is called \uicontrol -

3814 Continue. -

3815 -

3816 \sa setButtonText(), QWizard::buttonText(), QWizard::setButtonText() -

3817 */ -

3818 QString QWizardPage::buttonText(QWizard::WizardButton which) const -

3819 { -

3820 Q_D(const QWizardPage); -

3821 -

3822

if (d->buttonCustomTexts.contains(which))

d->buttonCusto...ontains(which)	Description
TRUE	never evaluated
FALSE	never evaluated

3823

return d->buttonCustomTexts.value(which);

never executed: return d->buttonCustomTexts.value(which);

3824 -

3825

if (wizard())

wizard()	Description
TRUE	never evaluated
FALSE	never evaluated

3826

return wizard()->buttonText(which);

never executed: return wizard()->buttonText(which);

3827 -

3828

return QString();

never executed: return QString();

3829 } -

3830 -

3831 /*! -

3832 This virtual function is called by QWizard::nextId() to find -

3833 out which page to show when the user clicks the \uicontrol Next button. -

3834 -

3835 The return value is the ID of the next page, or -1 if no page follows. -

3836 -

3837 By default, this function returns the lowest ID greater than the ID -

3838 of the current page, or -1 if there is no such ID. -

3839 -

3840 By reimplementing this function, you can specify a dynamic page -

3841 order. For example: -

3842 -

3843 \snippet dialogs/licensewizard/licensewizard.cpp 18 -

3844 -

3845 \sa QWizard::nextId() -

3846 */ -

3847 int QWizardPage::nextId() const -

3848 { -

3849 Q_D(const QWizardPage); -

3850 -

3851

if (!d->wizard)

!d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

3852

return -1;

never executed: return -1;

3853 -

3854 bool foundCurrentPage = false; -

3855 -

3856 const QWizardPrivate::PageMap &pageMap = d->wizard->d_func()->pageMap; -

3857 QWizardPrivate::PageMap::const_iterator i = pageMap.constBegin(); -

3858 QWizardPrivate::PageMap::const_iterator end = pageMap.constEnd(); -

3859 -

3860

for (; i != end; ++i) {

i != end	Description
TRUE	never evaluated
FALSE	never evaluated

3861

if (i.value() == this) {

i.value() == this	Description
TRUE	never evaluated
FALSE	never evaluated

3862 foundCurrentPage = true; -

3863

} else if (foundCurrentPage) {

never executed: end of block

foundCurrentPage	Description
TRUE	never evaluated
FALSE	never evaluated

3864

return i.key();

never executed: return i.key();

3865 } -

3866

}

never executed: end of block

3867

return -1;

never executed: return -1;

3868 } -

3869 -

3870 /*! -

3871 \fn void QWizardPage::completeChanged() -

3872 -

3873 This signal is emitted whenever the complete state of the page -

3874 (i.e., the value of isComplete()) changes. -

3875 -

3876 If you reimplement isComplete(), make sure to emit -

3877 completeChanged() whenever the value of isComplete() changes, to -

3878 ensure that QWizard updates the enabled or disabled state of its -

3879 buttons. -

3880 -

3881 \sa isComplete() -

3882 */ -

3883 -

3884 /*! -

3885 Sets the value of the field called \a name to \a value. -

3886 -

3887 This function can be used to set fields on any page of the wizard. -

3888 It is equivalent to calling -

3889 wizard()->\l{QWizard::setField()}{setField(\a name, \a value)}. -

3890 -

3891 \sa QWizard::setField(), field(), registerField() -

3892 */ -

3893 void QWizardPage::setField(const QString &name, const QVariant &value) -

3894 { -

3895 Q_D(QWizardPage); -

3896

if (!d->wizard)

!d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

3897

return;

never executed: return;

3898 d->wizard->setField(name, value); -

3899

}

never executed: end of block

3900 -

3901 /*! -

3902 Returns the value of the field called \a name. -

3903 -

3904 This function can be used to access fields on any page of the -

3905 wizard. It is equivalent to calling -

3906 wizard()->\l{QWizard::field()}{field(\a name)}. -

3907 -

3908 Example: -

3909 -

3910 \snippet dialogs/classwizard/classwizard.cpp 17 -

3911 -

3912 \sa QWizard::field(), setField(), registerField() -

3913 */ -

3914 QVariant QWizardPage::field(const QString &name) const -

3915 { -

3916 Q_D(const QWizardPage); -

3917

if (!d->wizard)

!d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

3918

return QVariant();

never executed: return QVariant();

3919

return d->wizard->field(name);

never executed: return d->wizard->field(name);

3920 } -

3921 -

3922 /*! -

3923 Creates a field called \a name associated with the given \a -

3924 property of the given \a widget. From then on, that property -

3925 becomes accessible using field() and setField(). -

3926 -

3927 Fields are global to the entire wizard and make it easy for any -

3928 single page to access information stored by another page, without -

3929 having to put all the logic in QWizard or having the pages know -

3930 explicitly about each other. -

3931 -

3932 If \a name ends with an asterisk (\c *), the field is a mandatory -

3933 field. When a page has mandatory fields, the \uicontrol Next and/or -

3934 \uicontrol Finish buttons are enabled only when all mandatory fields -

3935 are filled. This requires a \a changedSignal to be specified, to -

3936 tell QWizard to recheck the value stored by the mandatory field. -

3937 -

3938 QWizard knows the most common Qt widgets. For these (or their -

3939 subclasses), you don't need to specify a \a property or a \a -

3940 changedSignal. The table below lists these widgets: -

3941 -

3942 \table -

3943 \header \li Widget \li Property \li Change Notification Signal -

3944 \row \li QAbstractButton \li bool \l{QAbstractButton::}{checked} \li \l{QAbstractButton::}{toggled()} -

3945 \row \li QAbstractSlider \li int \l{QAbstractSlider::}{value} \li \l{QAbstractSlider::}{valueChanged()} -

3946 \row \li QComboBox \li int \l{QComboBox::}{currentIndex} \li \l{QComboBox::}{currentIndexChanged()} -

3947 \row \li QDateTimeEdit \li QDateTime \l{QDateTimeEdit::}{dateTime} \li \l{QDateTimeEdit::}{dateTimeChanged()} -

3948 \row \li QLineEdit \li QString \l{QLineEdit::}{text} \li \l{QLineEdit::}{textChanged()} -

3949 \row \li QListWidget \li int \l{QListWidget::}{currentRow} \li \l{QListWidget::}{currentRowChanged()} -

3950 \row \li QSpinBox \li int \l{QSpinBox::}{value} \li \l{QSpinBox::}{valueChanged()} -

3951 \endtable -

3952 -

3953 You can use QWizard::setDefaultProperty() to add entries to this -

3954 table or to override existing entries. -

3955 -

3956 To consider a field "filled", QWizard simply checks that their -

3957 current value doesn't equal their original value (the value they -

3958 had before initializePage() was called). For QLineEdit, it also -

3959 checks that -

3960 \l{QLineEdit::hasAcceptableInput()}{hasAcceptableInput()} returns -

3961 true, to honor any validator or mask. -

3962 -

3963 QWizard's mandatory field mechanism is provided for convenience. -

3964 It can be bypassed by reimplementing QWizardPage::isComplete(). -

3965 -

3966 \sa field(), setField(), QWizard::setDefaultProperty() -

3967 */ -

3968 void QWizardPage::registerField(const QString &name, QWidget *widget, const char *property, -

3969 const char *changedSignal) -

3970 { -

3971 Q_D(QWizardPage); -

3972 QWizardField field(this, name, widget, property, changedSignal); -

3973

if (d->wizard) {

d->wizard	Description
TRUE	never evaluated
FALSE	never evaluated

3974 d->wizard->d_func()->addField(field); -

3975

} else {

never executed: end of block

3976 d->pendingFields += field; -

3977

}

never executed: end of block

3978 } -

3979 -

3980 /*! -

3981 Returns the wizard associated with this page, or 0 if this page -

3982 hasn't been inserted into a QWizard yet. -

3983 -

3984 \sa QWizard::addPage(), QWizard::setPage() -

3985 */ -

3986 QWizard *QWizardPage::wizard() const -

3987 { -

3988 Q_D(const QWizardPage); -

3989

return d->wizard;

never executed: return d->wizard;

3990 } -

3991 -

3992 QT_END_NAMESPACE -

3993 -

3994 #include "moc_qwizard.cpp" -

3995 -

3996 #endif // QT_NO_WIZARD -

Source code

Switch to Preprocessed file

Generated by Squish Coco Non-Commercial 4.3.0-BETA-master-30-08-2018-4cb69e9