Home · Overviews · Examples 

QWizardPage Class Reference
[com.trolltech.qt.gui module]

The QWizardPage class is the base class for wizard pages. More...

Inherits QWidget.


Detailed Description

The QWizardPage class is the base class for wizard pages.

QWizard represents a wizard. Each page is a QWizardPage. When you create your own wizards, you can use QWizardPage directly, or you can subclass it for more control.

A page has the following attributes, which are rendered by QWizard: a title, a subTitle, and a set of pixmaps. See Elements of a Wizard Page for details. Once a page is added to the wizard (using QWizard::addPage() or QWizard::setPage()), wizard returns a pointer to the associated QWizard object.

Page provides five virtual functions that can be reimplemented to provide custom behavior:

Normally, the Next button and the Finish button of a wizard are mutually exclusive. If isFinalPage returns true, Finish is available; otherwise, Next is available. By default, isFinalPage is true only when nextId returns -1. If you want to show Next and Final simultaneously for a page (letting the user perform an "early finish"), call setFinalPage(true) on that page. For wizards that support early finishes, you might also want to set the HaveNextButtonOnLastPage and HaveFinishButtonOnEarlyPages options on the wizard.

In many wizards, the contents of a page may affect the default values of the fields of a later page. To make it easy to communicate between pages, QWizard supports a "field" mechanism that allows you to register a field (e.g., a QLineEdit) on a page and to access its value from any page. Fields are global to the entire wizard and make it easy for any single page to access information stored by another page, without having to put all the logic in QWizard or having the pages know explicitly about each other. Fields are registered using registerField() and can be accessed at any time using field and setField.

See also QWizard, Class Wizard Example, and License Wizard Example.


Copyright © 2007 Trolltech Trademarks
Qt Jambi 4.3.2_01