wxWINE things.

[wxWidgets.git] / docs / latex / wx / progdlg.tex

diff --git a/docs/latex/wx/progdlg.tex b/docs/latex/wx/progdlg.tex
index 2c243409d37aad119f4f103cecc64140f21e2a35..bf9d6c87a3c9a8e1661a8764cb4e6f506f567b4a 100644 (file)
--- a/docs/latex/wx/progdlg.tex
+++ b/docs/latex/wx/progdlg.tex
@@ -23,12 +23,11 @@ progress bar. Optionally, it can display an ABORT button.
   \param{const wxString\& }{message},\rtfsp
   \param{int }{maximum = 100},
   \param{wxWindow * }{parent = NULL},\rtfsp
-  \param{bool }{disableParentOnly = FALSE},\rtfsp
-  \param{bool }{abortButton = FALSE}
+  \param{int }{style = wxPD\_AUTO\_HIDE | wxPD\_APP\_MODAL}
   }
 
 Constructor. Creates the dialog, displays it and disables user input
-for other windows, or, if disableParentOnly = TRUE, for its parent
+for other windows, or, if wxPD\_APP\_MODAL flag is not given, for its parent
 window only.
 
 \wxheading{Parameters}
@@ -43,11 +42,23 @@ window only.
 
 \docparam{message}{Message to show on the dialog.}
 
-\docparam{disableParentOnly}{By default, the dialog disables user
-  input for all other top level windows. If this parameter is TRUE, it 
-  will only disable the window passes as parent.}
-
-\docparam{abortButton}{If TRUE, will display an ABORT button.}
+\docparam{style}{The dialog style. This is the combination of the following
+    bitmask constants defined in wx/defs.h:
+
+\twocolwidtha{7cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{wxPD\_APP\_MODAL}{Make the progress dialog modal. If this flag is
+    not given, it is only "locally" modal - that is the input to the parent
+    window is disabled, but not to the other ones.}
+\twocolitem{wxPD\_AUTO\_HIDE}{By default, the progress dialog will disappear
+    from screen as soon as the maximum value of the progress meter has been
+    reached. This flag prevents it from doing it - instead the dialog will wait
+    until the user closes it.}
+\twocolitem{wxPD\_CAN\_ABORT}{This flag tells the dialog that it should have a
+    "Cancel" button which the user may press. If this happens, the next call to 
+    \helpref{Update()}{wxprogressdialogupdate} will return FALSE.}
+\end{twocollist}%
+}
 
 \membersection{wxProgressDialog::\destruct{wxProgressDialog}}
 
@@ -62,13 +73,23 @@ Deletes the dialog and enables all top level windows.
   \param{const char * }{newmsg = NULL},  }
 
 Updates the dialog, setting the progress bar to the new value and, if
-given exchanges the message above it. Returns TRUE if the ABORT button 
+given changes the message above it. Returns TRUE if the ABORT button 
 has \emph{not} been pressed.
 
+If FALSE is returned, the application can either immediately destroy the dialog
+or ask the user for the confirmation and if the abort is not confirmed the
+dialog may be resumed with \helpref{Resume}{wxprogressdialogresume} function.
+
+\docparam{value}{The new value of the progress meter. It must be strictly less
+    than the maximum value given to the constructor (i.e., as usual in C, the
+    index runs from $0$ to $maximum-1$).}
+\docparam{newmsg}{The new messages for the progress dialog text, if none is
+    given the message is not changed.}
 
 \membersection{wxProgressDialog::Resume}\label{wxprogressdialogresume}
 
 \func{void}{Resume}{\void}
+
 Can be used to continue with the dialog, after the user had chosen
 ABORT.