wxwizardpage

wxwizardpage is one of the screens in wxwizard: it must know what are the following and preceding pages (which may be null for the first/last page). except for this extra knowledge, wxwizardpage is just a panel, so the controls may be placed directly on it in the usual way.

this class allows the programmer to decide the order of pages in the wizard dynamically (during run-time) and so provides maximal flexibility. usually, however, the order of pages is known in advance in which case wxwizardpagesimple class is enough and it is simpler to use.

virtual functions to override

to use this class, you must override getprev and getnext pure virtual functions (or you may use wxwizardpagesimple instead).

getbitmap can also be overridden, but this should be very rarely needed.

derived from

wxpanel
wxwindow
wxevthandler
wxobject

include files

<wx/wizard.h>

see also

wxwizard, wxwizard sample

members

wxwizardpage::wxwizardpage
wxwizardpage::getprev
wxwizardpage::getnext
wxwizardpage::getbitmap

wxwizardpage::wxwizardpage

wxwizardpage(wxwizard* parent, const wxbitmap& bitmap = wxnullbitmap, const wxchar *resource = null)

constructor accepts an optional bitmap which will be used for this page instead of the default one for this wizard (note that all bitmaps used should be of the same size). notice that no other parameters are needed because the wizard will resize and reposition the page anyhow.

parameters

parent

the parent wizard

bitmap

the page-specific bitmap if different from the global one

resource

load the page from the specified resource if non-null

wxwizardpage::getprev

wxwizardpage* getprev() const

get the page which should be shown when the user chooses the "back" button: if null is returned, this button will be disabled. the first page of the wizard will usually return null from here, but the others will not.

see also

getnext

wxwizardpage::getnext

wxwizardpage* getnext() const

get the page which should be shown when the user chooses the "next" button: if null is returned, this button will be disabled. the last page of the wizard will usually return null from here, but the others will not.

see also

getprev

wxwizardpage::getbitmap

wxbitmap getbitmap() const

this method is called by wxwizard to get the bitmap to display alongside the page. by default, m_bitmap member variable which was set in the constructor.

if the bitmap was not explicitly set (i.e. if wxnullbitmap is returned), the default bitmap for the wizard should be used.

the only cases when you would want to override this function is if the page bitmap depends dynamically on the user choices, i.e. almost never.