[kio Index] [kio Hierarchy] [Headers]
KWizard More...
#include <kwizard.h>
Inherits: KDialog (kdeui)
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.
[public]
Constructor
[public]
Destructor
[public]
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. |
[public]
Changes the QWidget on the page with id "id" to "w".
[public]
Changes the title on the page with id "id" to "title".
[public]
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. |
[public]
Check the state of the page.
[public]
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.
[public]
Adds a Cancel button to the bottom of the dialog.
text | A user supplied text to write to the button. |
[public]
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.
[public]
Adds a Default button to the bottom of the dialog.
text | A user supplied text to write to the button. |
[public]
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.
[public]
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. |
[public]
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.
[public]
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. |
[public]
[public]
[public]
[public]
[public]
getNextButton.
[public]
getPreviousButton
[public]
[public]
[public]
Let direction buttons reflect page.
state | If state is true the direction buttons (Previous and Next) will have the title of the corresponding page. |
[public]
[public]
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. |
[public]
[public]
getMenu
[public]
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. |
[public]
[public]
getTitle
page | The page to retrieve the title from. |
[public]
numPages
[signal]
This signal is emitted when the user clicks on the Ok button.
[signal]
This signal is emitted when the user clicks on the Cancel button.
[signal]
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.
[signal]
This signal is emitted when the user clicks on the Help button.
The int is the page which was showing when help was requested.
[signal]
This signal is emitted when a page is selected. The int is the page number
[signal]
This signal is emitted when the dialog is closed. Mainly usable if the dialog is a top level widget.
[signal]
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.
[signal]
This signal is used by KNoteBook.
| Kdoc |