inspectorj - Java(TM) Profiler

Each page must be a QWidget or a subclass. Backward and Forward navigation controls must be a subclass of QAbstractButton. The controls will be wired up automatically to display the appropriate page. The back and forward buttons will be enabled or disabled based on whether there are more pages to display in either direction. If you want to add additional criteria for enabling the navigation buttons (such as validating that all required fields are completed) you can connect one or more of the available signals to a slot to perform validation. All signals are emitted after navigation is complete. This gives you the opportunity to override the default enable/disable behavior.

Usage: To use the WizardControl you only need to supply a list of pages and pointers to your backward and forward controls to the constructor.

 class MyDialog : public QDialog
 {
 
 .. SNIP ..

 public slots:
     void validatePage(int pageNum);
     void changeDialogTitle(int pageNum);
 
 private:
     // The wizard control
     WizardControl *wizard;
 
     // The pages
     QWidget *page1;
     QWidget *page2;
     QWidget *page3;
     
     // The navigation controls
     QPushButton *backBtn;
     QPushButton *nextBtn;
     
     // QList to hold the pages
     QList<QWidget*> pages;
 
 }
 
 
 //constructor
 MyDialog::MyDialog()
 {
     // initialize the gui first
     MyDialog::setupUi(this);
 
     // initialize the wizard control
     pages.append(page1);
     pages.append(page2);
     pages.append(page3);
     wizard = new WizardControl(&pages, backBtn, nextBtn);

     // change the dialog's title when the current page changes
     connect (wizard, SIGNAL(pageChanged(int)), this, SLOT (changeDialogTitle(int)));

     // perform validation when we reach the last page
     connect (wizard, SIGNAL(lastPage(int)), this, SLOT (validatePage(int)));
 }

Definition at line 108 of file wizardcontrol.h.


Signals
void	pageChanged (int pageNum)
	Signal emitted after a backward or forward navigation.
void	pageForward (int pageNum)
	Signal emitted after there is a forward navigation.
void	pageBackward (int pageNum)
	Signal emitted after there is a backward navigation.
void	firstPage ()
	Signal emitted when a navigation action results in the current page being the first page.
void	lastPage (int pageNum)
	Signal emitted when a navigation action results in the current page being the last page.
Public Member Functions
	WizardControl (QList< QWidget * > , QAbstractButton , QAbstractButton *)
	Constructor.
	~WizardControl ()
	Destructor.
int	getNumPages ()
	Return the number of pages for this wizard.
int	getCurrentPageNum ()
	Return the current page number for this wizard.
Private Slots
void	previousPage ()
	Switch to the previous page.
void	nextPage ()
	Switch to the next page.
Private Member Functions
void	updateNavigationBtns ()
	Update navigation Buttons.
Private Attributes
int	currentPage
	Page number of the currently displayed page.
QList< QWidget * > *	pages
	A list of pages.
QAbstractButton *	backNavCtrl
	Button Widget for backward navigation.
QAbstractButton *	nextNavCtrl
	Button Widget for forward navigation.

Constructor & Destructor Documentation