// Purpose: interface of wxWizardPage, wxWizardEvent,
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
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.
*/
- wxBitmap GetBitmap() const;
+ virtual wxBitmap GetBitmap() const;
/**
Get the page which should be shown when the user chooses the @c "Next"
@see GetPrev()
*/
- wxWizardPage* GetNext() const;
+ virtual wxWizardPage* GetNext() const = 0;
/**
Get the page which should be shown when the user chooses the @c "Back"
@see GetNext()
*/
- wxWizardPage* GetPrev() const;
+ virtual wxWizardPage* GetPrev() const = 0;
};
The page has been just changed (this event can not be vetoed).
@event{EVT_WIZARD_PAGE_CHANGING(id, func)}
The page is being changed (this event can be vetoed).
+ @event{EVT_WIZARD_PAGE_SHOWN(id, func)}
+ The page was shown and laid out (this event cannot be vetoed).
@event{EVT_WIZARD_CANCEL(id, func)}
The user attempted to cancel the wizard (this event may also be vetoed).
@event{EVT_WIZARD_HELP(id, func)}
It is not normally used by the user code as the objects of this
type are constructed by wxWizard.
*/
- wxWizardEvent(wxEventType type = wxEVT_NULL, int id = -1,
- bool direction = true);
+ wxWizardEvent(wxEventType type = wxEVT_NULL, int id = wxID_ANY,
+ bool direction = true, wxWizardPage* page = 0);
/**
Return the direction in which the page is changing: for
Constructor takes the previous and next pages.
They may be modified later by SetPrev() or SetNext().
*/
- wxWizardPageSimple(wxWizard* parent = NULL,
+ wxWizardPageSimple(wxWizard* parent,
wxWizardPage* prev = NULL,
wxWizardPage* next = NULL,
const wxBitmap& bitmap = wxNullBitmap);
wxDialog::EnableLayoutAdaptation() or per dialog with wxDialog::SetLayoutAdaptationMode().
For more about layout adaptation, see @ref overview_dialog_autoscrolling.
- @beginEventTable{wxWizardEvent}
+ @beginEventEmissionTable{wxWizardEvent}
For some events, Veto() can be called to prevent the event from happening.
@event{EVT_WIZARD_PAGE_CHANGED(id, func)}
The page has just been changed (this event cannot be vetoed).
@event{EVT_WIZARD_PAGE_CHANGING(id, func)}
The page is being changed (this event can be vetoed).
+ @event{EVT_WIZARD_PAGE_SHOWN(id, func)}
+ The page was shown and laid out (this event cannot be vetoed).
@event{EVT_WIZARD_CANCEL(id, func)}
The user attempted to cancel the wizard (this event may also be vetoed).
@event{EVT_WIZARD_HELP(id, func)}
@param parent
The parent window, may be @NULL.
@param id
- The id of the dialog, will usually be just -1.
+ The id of the dialog, will usually be just wxID_ANY.
@param title
The title of the dialog.
@param bitmap
@param style
Window style is passed to wxDialog.
*/
- wxWizard(wxWindow* parent, int id = -1,
+ wxWizard(wxWindow* parent, int id = wxID_ANY,
const wxString& title = wxEmptyString,
const wxBitmap& bitmap = wxNullBitmap,
const wxPoint& pos = wxDefaultPosition,
@param style
Window style is passed to wxDialog.
*/
- bool Create(wxWindow* parent, int id = -1,
+ bool Create(wxWindow* parent, int id = wxID_ANY,
const wxString& title = wxEmptyString,
const wxBitmap& bitmap = wxNullBitmap,
- const wxPoint& pos = wxDefaultPosition,
- long style = wxDEFAULT_DIALOG_STYLE);
+ const wxPoint& pos = wxDefaultPosition, long style = 536877056);
/**
This method is obsolete, use GetPageAreaSizer() instead.
run-time, as in this case, the wizard won't be able to get to all pages starting
from a single one and you should call @e Fit separately for the others.
*/
- void FitToPage(const wxWizardPage* firstPage);
+ virtual void FitToPage(const wxWizardPage* firstPage);
/**
Returns the bitmap used for the wizard.
See also SetBitmapPlacement() for the possible values.
*/
- int GetBitmapPlacement();
+ int GetBitmapPlacement() const;
/**
Get the current page while the wizard is running.
@NULL is returned if RunWizard() is not being executed now.
*/
- wxWizardPage* GetCurrentPage() const;
+ virtual wxWizardPage* GetCurrentPage() const;
/**
Returns the minimum width for the bitmap that will be constructed to contain
/**
Returns the size available for the pages.
*/
- wxSize GetPageSize() const;
+ virtual wxSize GetPageSize() const;
/**
Return @true if this page is not the last one in the wizard.
successfully finished or @false if user cancelled it.
The @a firstPage can not be @NULL.
*/
- bool RunWizard(wxWizardPage* firstPage);
+ virtual bool RunWizard(wxWizardPage* firstPage);
/**
Sets the bitmap used for the wizard.
will be added to the control border in order to space page controls ten points
from the dialog border and non-page controls.
*/
- void SetBorder(int border);
+ virtual void SetBorder(int border);
/**
Sets the minimum width for the bitmap that will be constructed to contain the
using the sizers (even though the wizard is not resizeable) and then use
wxSizer::CalcMin() in a loop to calculate the maximum of minimal sizes of
the pages and pass it to SetPageSize().
-
- @deprecated
- This method is obsolete, use GetPageAreaSizer() instead.
*/
- void SetPageSize(const wxSize& sizePage);
+ virtual void SetPageSize(const wxSize& sizePage);
};