<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <!-- /tmp/qt-3.0-reggie-28534/qt-x11-free-3.0.2/examples/wizard/wizard.doc:4 --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Wizard</title> <style type="text/css"><!-- h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; } a:link { color: #004faf; text-decoration: none } a:visited { color: #672967; text-decoration: none } body { background: #ffffff; color: black; } --></style> </head> <body> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr bgcolor="#E5E5E5"> <td valign=center> <a href="index.html"> <font color="#004faf">Home</font></a> | <a href="classes.html"> <font color="#004faf">All Classes</font></a> | <a href="mainclasses.html"> <font color="#004faf">Main Classes</font></a> | <a href="annotated.html"> <font color="#004faf">Annotated</font></a> | <a href="groups.html"> <font color="#004faf">Grouped Classes</font></a> | <a href="functions.html"> <font color="#004faf">Functions</font></a> </td> <td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Wizard</h1> <p> This example shows the usage of Qt's wizard class. A wizard should be used to help a user with complicated actions. <p> <hr> <p> Header file: <p> <pre>/**************************************************************************** ** $Id: qt/wizard.h 3.0.2 edited Oct 12 12:18 $ ** ** Copyright (C) 1992-2000 Trolltech AS. All rights reserved. ** ** This file is part of an example program for Qt. This example ** program may be used, distributed and modified without limitation. ** *****************************************************************************/ #ifndef WIZARD_H #define WIZARD_H #include <<a href="qwizard-h.html">qwizard.h</a>> class QWidget; class QHBox; class QLineEdit; class QLabel; class Wizard : public <a href="qwizard.html">QWizard</a> { <a href="metaobjects.html#Q_OBJECT">Q_OBJECT</a> public: Wizard( <a href="qwidget.html">QWidget</a> *parent = 0, const char *name = 0 ); void showPage(QWidget* page); protected: void setupPage1(); void setupPage2(); void setupPage3(); <a href="qhbox.html">QHBox</a> *page1, *page2, *page3; <a href="qlineedit.html">QLineEdit</a> *key, *firstName, *lastName, *address, *phone, *email; <a href="qlabel.html">QLabel</a> *lKey, *lFirstName, *lLastName, *lAddress, *lPhone, *lEmail; protected slots: void keyChanged( const <a href="qstring.html">QString</a> & ); void dataChanged( const <a href="qstring.html">QString</a> & ); }; #endif </pre> <p> <hr> <p> Implementation: <p> <pre>/**************************************************************************** ** $Id$ ** ** Copyright (C) 1992-2000 Trolltech AS. All rights reserved. ** ** This file is part of an example program for Qt. This example ** program may be used, distributed and modified without limitation. ** *****************************************************************************/ #include "wizard.h" #include <<a href="qwidget-h.html">qwidget.h</a>> #include <<a href="qhbox-h.html">qhbox.h</a>> #include <<a href="qvbox-h.html">qvbox.h</a>> #include <<a href="qlabel-h.html">qlabel.h</a>> #include <<a href="qlineedit-h.html">qlineedit.h</a>> #include <<a href="qpushbutton-h.html">qpushbutton.h</a>> #include <<a href="qvalidator-h.html">qvalidator.h</a>> #include <<a href="qapplication-h.html">qapplication.h</a>> <a name="f169"></a>Wizard::Wizard( <a href="qwidget.html">QWidget</a> *parent, const char *name ) : <a href="qwizard.html">QWizard</a>( parent, name, TRUE ) { setupPage1(); setupPage2(); setupPage3(); <a name="x148"></a> key-><a href="qwidget.html#setFocus">setFocus</a>(); } void <a name="f170"></a>Wizard::setupPage1() { page1 = new <a href="qhbox.html">QHBox</a>( this ); <a name="x139"></a> page1-><a href="qhbox.html#setSpacing">setSpacing</a>(8); <a href="qlabel.html">QLabel</a> *info = new <a href="qlabel.html">QLabel</a>( page1 ); <a name="x151"></a> info-><a href="qwidget.html#setPalette">setPalette</a>( yellow ); <a name="x142"></a> info-><a href="qlabel.html#setText">setText</a>( "Enter your personal\n" "key here.\n\n" "Your personal key\n" "consists of 4 digits" ); <a name="x141"></a> info-><a href="qlabel.html#setIndent">setIndent</a>( 8 ); <a name="x152"></a><a name="x149"></a> info-><a href="qwidget.html#setMaximumWidth">setMaximumWidth</a>( info-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); <a href="qvbox.html">QVBox</a> *page = new <a href="qvbox.html">QVBox</a>( page1 ); <a href="qhbox.html">QHBox</a> *row1 = new <a href="qhbox.html">QHBox</a>( page ); (void)new <a href="qlabel.html">QLabel</a>( "Key:", row1 ); key = new <a href="qlineedit.html">QLineEdit</a>( row1 ); <a name="x143"></a> key-><a href="qlineedit.html#setMaxLength">setMaxLength</a>( 4 ); <a name="x144"></a> key-><a href="qlineedit.html#setValidator">setValidator</a>( new <a href="qintvalidator.html">QIntValidator</a>( 1000, 9999, key ) ); <a name="x146"></a> <a href="qobject.html#connect">connect</a>( key, SIGNAL( <a href="qlineedit.html#textChanged">textChanged</a>( const <a href="qstring.html">QString</a> & ) ), this, SLOT( keyChanged( const <a href="qstring.html">QString</a> & ) ) ); <a href="qwizard.html#addPage">addPage</a>( page1, "Personal Key" ); <a href="qwizard.html#setNextEnabled">setNextEnabled</a>( page1, FALSE ); <a href="qwizard.html#setHelpEnabled">setHelpEnabled</a>( page1, FALSE ); } void <a name="f171"></a>Wizard::setupPage2() { page2 = new <a href="qhbox.html">QHBox</a>( this ); page2-><a href="qhbox.html#setSpacing">setSpacing</a>(8); <a href="qlabel.html">QLabel</a> *info = new <a href="qlabel.html">QLabel</a>( page2 ); info-><a href="qwidget.html#setPalette">setPalette</a>( yellow ); info-><a href="qlabel.html#setText">setText</a>( "\n" " Enter your personal \n" " data here. \n\n" " The required fields are \n" " First Name, Last Name \n" " and E-Mail. \n" ); info-><a href="qlabel.html#setIndent">setIndent</a>(8); info-><a href="qwidget.html#setMaximumWidth">setMaximumWidth</a>( info-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); <a href="qvbox.html">QVBox</a> *page = new <a href="qvbox.html">QVBox</a>( page2 ); <a href="qhbox.html">QHBox</a> *row1 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row2 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row3 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row4 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row5 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qlabel.html">QLabel</a> *label1 = new <a href="qlabel.html">QLabel</a>( " First Name: ", row1 ); <a name="x140"></a> label1-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label2 = new <a href="qlabel.html">QLabel</a>( " Last Name: ", row2 ); label2-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label3 = new <a href="qlabel.html">QLabel</a>( " Address: ", row3 ); label3-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label4 = new <a href="qlabel.html">QLabel</a>( " Phone Number: ", row4 ); label4-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label5 = new <a href="qlabel.html">QLabel</a>( " E-Mail: ", row5 ); label5-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a name="x150"></a> label1-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label4-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label2-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label4-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label3-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label4-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label4-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label4-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label5-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label4-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); firstName = new <a href="qlineedit.html">QLineEdit</a>( row1 ); lastName = new <a href="qlineedit.html">QLineEdit</a>( row2 ); address = new <a href="qlineedit.html">QLineEdit</a>( row3 ); phone = new <a href="qlineedit.html">QLineEdit</a>( row4 ); email = new <a href="qlineedit.html">QLineEdit</a>( row5 ); <a href="qobject.html#connect">connect</a>( firstName, SIGNAL( <a href="qlineedit.html#textChanged">textChanged</a>( const <a href="qstring.html">QString</a> & ) ), this, SLOT( dataChanged( const <a href="qstring.html">QString</a> & ) ) ); <a href="qobject.html#connect">connect</a>( lastName, SIGNAL( <a href="qlineedit.html#textChanged">textChanged</a>( const <a href="qstring.html">QString</a> & ) ), this, SLOT( dataChanged( const <a href="qstring.html">QString</a> & ) ) ); <a href="qobject.html#connect">connect</a>( email, SIGNAL( <a href="qlineedit.html#textChanged">textChanged</a>( const <a href="qstring.html">QString</a> & ) ), this, SLOT( dataChanged( const <a href="qstring.html">QString</a> & ) ) ); <a href="qwizard.html#addPage">addPage</a>( page2, "Personal Data" ); <a href="qwizard.html#setHelpEnabled">setHelpEnabled</a>( page2, FALSE ); } void <a name="f172"></a>Wizard::setupPage3() { page3 = new <a href="qhbox.html">QHBox</a>( this ); page3-><a href="qhbox.html#setSpacing">setSpacing</a>(8); <a href="qlabel.html">QLabel</a> *info = new <a href="qlabel.html">QLabel</a>( page3 ); info-><a href="qwidget.html#setPalette">setPalette</a>( yellow ); info-><a href="qlabel.html#setText">setText</a>( "\n" " Look here to see of \n" " the data you entered \n" " is correct. To confirm, \n" " press the [Finish] button \n" " else go back to correct \n" " mistakes." ); info-><a href="qlabel.html#setIndent">setIndent</a>(8); info-><a href="qlabel.html#setAlignment">setAlignment</a>( AlignTop|AlignLeft ); info-><a href="qwidget.html#setMaximumWidth">setMaximumWidth</a>( info-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); <a href="qvbox.html">QVBox</a> *page = new <a href="qvbox.html">QVBox</a>( page3 ); <a href="qhbox.html">QHBox</a> *row1 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row2 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row3 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row4 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row5 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qhbox.html">QHBox</a> *row6 = new <a href="qhbox.html">QHBox</a>( page ); <a href="qlabel.html">QLabel</a> *label1 = new <a href="qlabel.html">QLabel</a>( " Personal Key: ", row1 ); label1-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label2 = new <a href="qlabel.html">QLabel</a>( " First Name: ", row2 ); label2-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label3 = new <a href="qlabel.html">QLabel</a>( " Last Name: ", row3 ); label3-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label4 = new <a href="qlabel.html">QLabel</a>( " Address: ", row4 ); label4-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label5 = new <a href="qlabel.html">QLabel</a>( " Phone Number: ", row5 ); label5-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); <a href="qlabel.html">QLabel</a> *label6 = new <a href="qlabel.html">QLabel</a>( " E-Mail: ", row6 ); label6-><a href="qlabel.html#setAlignment">setAlignment</a>( Qt::AlignVCenter ); label1-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label1-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label2-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label1-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label3-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label1-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label4-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label1-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label5-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label1-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); label6-><a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>( label1-><a href="qwidget.html#sizeHint">sizeHint</a>().width() ); lKey = new <a href="qlabel.html">QLabel</a>( row1 ); lFirstName = new <a href="qlabel.html">QLabel</a>( row2 ); lLastName = new <a href="qlabel.html">QLabel</a>( row3 ); lAddress = new <a href="qlabel.html">QLabel</a>( row4 ); lPhone = new <a href="qlabel.html">QLabel</a>( row5 ); lEmail = new <a href="qlabel.html">QLabel</a>( row6 ); <a href="qwizard.html#addPage">addPage</a>( page3, "Finish" ); <a href="qwizard.html#setFinish">setFinish</a>( page3, TRUE ); <a href="qwizard.html#setHelpEnabled">setHelpEnabled</a>( page3, FALSE ); } <a name="x153"></a>void Wizard::<a href="qwizard.html#showPage">showPage</a>( <a href="qwidget.html">QWidget</a>* page ) { if ( page == page1 ) { } else if ( page == page2 ) { } else if ( page == page3 ) { <a name="x145"></a> lKey-><a href="qlabel.html#setText">setText</a>( key-><a href="qlineedit.html#text">text</a>() ); lFirstName-><a href="qlabel.html#setText">setText</a>( firstName-><a href="qlineedit.html#text">text</a>() ); lLastName-><a href="qlabel.html#setText">setText</a>( lastName-><a href="qlineedit.html#text">text</a>() ); lAddress-><a href="qlabel.html#setText">setText</a>( address-><a href="qlineedit.html#text">text</a>() ); lPhone-><a href="qlabel.html#setText">setText</a>( phone-><a href="qlineedit.html#text">text</a>() ); lEmail-><a href="qlabel.html#setText">setText</a>( email-><a href="qlineedit.html#text">text</a>() ); } QWizard::<a href="qwizard.html#showPage">showPage</a>(page); if ( page == page1 ) { keyChanged( key-><a href="qlineedit.html#text">text</a>() ); key-><a href="qwidget.html#setFocus">setFocus</a>(); } else if ( page == page2 ) { dataChanged( firstName-><a href="qlineedit.html#text">text</a>() ); firstName-><a href="qwidget.html#setFocus">setFocus</a>(); } else if ( page == page3 ) { <a href="qwizard.html#finishButton">finishButton</a>()->setEnabled( TRUE ); <a href="qwizard.html#finishButton">finishButton</a>()->setFocus(); } } void <a name="f173"></a>Wizard::keyChanged( const <a href="qstring.html">QString</a> &text ) { <a href="qstring.html">QString</a> t = text; int p = 0; <a name="x147"></a> bool on = ( key-><a href="qlineedit.html#validator">validator</a>()->validate(t, p) == QValidator::Acceptable ); <a href="qwizard.html#nextButton">nextButton</a>()->setEnabled( on ); } void <a name="f174"></a>Wizard::dataChanged( const <a href="qstring.html">QString</a> & ) { if ( !firstName-><a href="qlineedit.html#text">text</a>().isEmpty() && !lastName-><a href="qlineedit.html#text">text</a>().isEmpty() && !email-><a href="qlineedit.html#text">text</a>().isEmpty() ) <a href="qwizard.html#nextButton">nextButton</a>()->setEnabled( TRUE ); else <a href="qwizard.html#nextButton">nextButton</a>()->setEnabled( FALSE ); } </pre> <p> <hr> <p> Main: <p> <pre>/**************************************************************************** ** $Id: qt/main.cpp 3.0.2 edited Oct 12 12:18 $ ** ** Copyright (C) 1992-2000 Trolltech AS. All rights reserved. ** ** This file is part of an example program for Qt. This example ** program may be used, distributed and modified without limitation. ** *****************************************************************************/ #include "wizard.h" #include <<a href="qapplication-h.html">qapplication.h</a>> int main(int argc,char **argv) { <a href="qapplication.html">QApplication</a> a(argc,argv); Wizard wizard; wizard.<a href="qwidget.html#setCaption">setCaption</a>("Qt Example - Wizard"); <a name="x154"></a> return wizard.<a href="qdialog.html#exec">exec</a>(); } </pre> <p>See also <a href="examples.html">Examples</a>. <!-- eof --> <p><address><hr><div align=center> <table width=100% cellspacing=0 border=0><tr> <td>Copyright © 2001 <a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a> <td align=right><div align=right>Qt version 3.0.2</div> </table></div></address></body> </html>