X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/f6bcfd974ef26faf6f91a62cac09827e09463fd1..f02ff0a7bd90ab3288e7748ed0b84fa539a2efd9:/docs/latex/wx/wizard.tex diff --git a/docs/latex/wx/wizard.tex b/docs/latex/wx/wizard.tex index 10de3469b7..f3b09b3b31 100644 --- a/docs/latex/wx/wizard.tex +++ b/docs/latex/wx/wizard.tex @@ -14,7 +14,7 @@ wxWizard is the central class for implementing `wizard-like' dialogs. These dialogs are mostly familiar to Windows users and are nothing else but a sequence of `pages' each of them displayed inside a dialog which has the -buttons to pas to the next (and previous) pages. +buttons to pass to the next (and previous) pages. The wizards are typically used to decompose a complex dialog into several simple steps and are mainly useful to the novice users, hence it is important @@ -53,14 +53,59 @@ changed (this event can not be vetoed).} changed (this event can be vetoed).} \twocolitem{{\bf EVT\_WIZARD\_CANCEL(id, func)}}{The user attempted to cancel the wizard (this event may also be vetoed).} +\twocolitem{{\bf EVT\_WIZARD\_HELP(id, func)}}{The wizard help button was pressed.} \end{twocollist}% +\wxheading{Extended styles} + +Use the \helpref{wxWindow::SetExtraStyle}{wxwindowsetextrastyle} function to set the following +style. You will need to use two-step construction (use the default constructor, call {\bf SetExtraStyle}, then call {\bf Create}). + +\twocolwidtha{5cm}% +\begin{twocollist}\itemsep=0pt +\twocolitem{\windowstyle{wxWIZARD\_EX\_HELPBUTTON}}{Shows a Help button using wxID\_HELP.} +\end{twocollist} + +See also \helpref{wxDialog}{wxdialog} for other extended styles. + \wxheading{See also} \helpref{wxWizardEvent}{wxwizardevent}, \helpref{wxWizardPage}{wxwizardpage}, \helpref{wxWizard sample}{samplewizard} \latexignore{\rtfignore{\wxheading{Members}}} +\membersection{wxWizard::wxWizard}\label{wxwizardctor} + +\func{}{wxWizard}{\void} + +Default constructor. Use this if you wish to derive from wxWizard and then call {\bf Create}, for example +if you wish to set an extra style with \helpref{wxWindow::SetExtraStyle}{wxwindowsetextrastyle}. + +\func{}{wxWizard}{\param{wxWindow* }{parent}, \param{int }{id = -1}, \param{const wxString\& }{title = wxEmptyString}, \param{const wxBitmap\& }{bitmap = wxNullBitmap}, \param{const wxPoint\& }{pos = wxDefaultPosition}} + +Creates the wizard dialog. The wizard should not be deleted +directly, you should rather call {\tt Destroy()} on it and wxWindows will +delete it itself. + +Notice that unlike almost all other wxWindows classes, there is no {\it size} +parameter in wxWizard constructor because the wizard will have a predefined +default size by default. If you want to change this, you should use the +\helpref{SetPageSize}{wxwizardsetpagesize} function. + +\wxheading{Parameters} + +\docparam{parent}{The parent window, may be NULL.} + +\docparam{id}{The id of the dialog, will usually be just $-1$.} + +\docparam{title}{The title of the dialog.} + +\docparam{bitmap}{The default bitmap used in the left side of the wizard. See +also \helpref{GetBitmap}{wxwizardpagegetbitmap}.} + +\docparam{pos}{The position of the dialog, it will be centered on the screen +by default.} + \membersection{wxWizard::Create}\label{wxwizardcreate} \func{static wxWizard*}{Create}{\param{wxWindow* }{parent}, \param{int }{id = -1}, \param{const wxString\& }{title = wxEmptyString}, \param{const wxBitmap\& }{bitmap = wxNullBitmap}, \param{const wxPoint\& }{pos = wxDefaultPosition}} @@ -74,6 +119,10 @@ parameter in wxWizard constructor because the wizard will have a predefined default size by default. If you want to change this, you should use the \helpref{SetPageSize}{wxwizardsetpagesize} function. +\func{bool}{Create}{\param{wxWindow* }{parent}, \param{int }{id = -1}, \param{const wxString\& }{title = wxEmptyString}, \param{const wxBitmap\& }{bitmap = wxNullBitmap}, \param{const wxPoint\& }{pos = wxDefaultPosition}} + +Alternative, non-static constructor for two-step construction of a class derived from wxWizard. + \wxheading{Parameters} \docparam{parent}{The parent window, may be NULL.}