[knotebk Index] [knotebk Hierarchy] [Headers]
KWizard More...
#include <kwizard.h>
Inherits: QWidget
KWizard is a multi-purpose dialog. It is very useful for:
- Configuration dialogs where the order in which the entries are filled is important.
- Tutorials. Just create some HTML-widgets and feed them to a KWizard and your done (almost).
- NoteBooks. KWizard is an integrated part of KNoteBook which provides a notebook dialog similar to the ones in OS/2 Warp 4.
- Propably many other things...
The dialog contains:
- A title at the top of the page.
- A separator.
- The userprovided page-widget.
- A separator.
- A label indicating the pagination.
- A Previous and a Next button.
- Optionally Ok, Cancel and Help buttons.
Constructor
Destructor
Adds a page to the wizard. The pages are numbered from 0-n where 0 is the page first added and n is the page last added.
p | KWizardPage containing the page data. |
En/disable a specified page. If a page is disable its content will be grayd out and it will not receive keyboard input.
state | If 'state' is false the page will be disabled, otherwise it will be enabled. |
page | The page to en/disable. |
Check the state of the page.
Adds a Cancel button to the bottom of the dialog. The text will be a translated version of the string '&Cancel' thereby giving it the shortcut key 'c'. If any buttons are added a space will be created at the bottom of the dialog to fit the buttons. When clicked the button will emit the cancelclicked signal.
Adds a Cancel button to the bottom of the dialog.
text | A user supplied text to write to the button. |
Adds a Default button to the bottom of the dialog. The text will be a translated version of the string '&Default' thereby giving it the shortcut key 'd'. If any buttons are added a space will be created at the bottom of the dialog to fit the buttons. When clicked the button will emit the defaultclicked signal.
Adds a Default button to the bottom of the dialog.
text | A user supplied text to write to the button. |
Adds a Help button to the bottom right of the dialog. The text will be a translated version of the string '&Help' thereby giving it the shortcut key 'h'. If any buttons are added a space will be created at the bottom of the dialog to fit the buttons. When clicked the button will emit the helpclicked signal.
Adds a Help button to the bottom of the dialog. This button will generate the signal helpclicked where the int is the page to which the help was requested.
text | A user supplied text to write to the button. |
Adds an Ok button to the bottom right of the dialog. The text will be a translated version of the string '&Ok' thereby giving it the shortcut key 'o'. If any buttons are added a space will be created at the bottom of the dialog to fit the buttons. When clicked the button will emit the okclicked signal.
Adds an Ok button to the bottom of the dialog. This button will generate the signal okclicked where the int is the page to which the help was requested.
text | A user supplied text to write to the button. |
getNextButton.
getPreviousButton
Let direction buttons reflect page.
state | If state is true the direction buttons (Previous and Next) will have the title of the corresponding page. |
En/Disable the popup menu.
state | If state is true a menu containing the pages in the wizard will popup when the user RMB-clicks on the page-title. |
getMenu
En/Disable the arrow buttons at the rightmost of the title.
state | If state is true two arrows will appear to the right of the pagination allowing the user to change pages by clicking on them. |
getTitle
page | The page to retrieve the title from. |
numPages
This signal is emitted when the user clicks on the Ok button.
This signal is emitted when the user clicks on the Cancel button.
This signal is emitted when the user clicks on the Default button. The int is the page which was showing when default settings was requested.
This signal is emitted when the user clicks on the Help button.
The int is the page which was showing when help was requested.
This signal is emitted when a page is selected. The int is the page number
This signal is emitted when the dialog is closed. Mainly usable if the dialog is a top level widget.
This signal is emitted when a popup menu is requested. This happens when the user RMB-clicks somewhere in the title (not the titlebar). This is used by KNoteBook.
This signal is used by KNoteBook.
| Kdoc |