]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/progdlg.h
Correct wxString:Append docs
[wxWidgets.git] / interface / progdlg.h
index 64bcabd946e333289285e872bcbd622f14eb3f4e..45af3f8e818f6194378250bd0c272af1e04a6cab 100644 (file)
     the elapsed, remaining and estimated time for the end of the progress.
 
     @beginStyleTable
-    @style{wxPD_APP_MODAL}:
+    @style{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.
-    @style{wxPD_AUTO_HIDE}:
+    @style{wxPD_AUTO_HIDE}
            Causes the progress dialog to disappear from screen as soon as the
            maximum value of the progress meter has been reached.
-    @style{wxPD_SMOOTH}:
+    @style{wxPD_SMOOTH}
            Causes smooth progress of the gauge control.
-    @style{wxPD_CAN_ABORT}:
+    @style{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
            Update() will return @false.
-    @style{wxPD_CAN_SKIP}:
+    @style{wxPD_CAN_SKIP}
            This flag tells the dialog that it should have a "Skip" button
            which the user may press. If this happens, the next call to
            Update() will return @true in its skip parameter.
-    @style{wxPD_ELAPSED_TIME}:
+    @style{wxPD_ELAPSED_TIME}
            This flag tells the dialog that it should show elapsed time (since
            creating the dialog).
-    @style{wxPD_ESTIMATED_TIME}:
+    @style{wxPD_ESTIMATED_TIME}
            This flag tells the dialog that it should show estimated time.
-    @style{wxPD_REMAINING_TIME}:
+    @style{wxPD_REMAINING_TIME}
            This flag tells the dialog that it should show remaining time.
     @endStyleTable
 
@@ -49,8 +49,8 @@ class wxProgressDialog : public wxDialog
 public:
     /**
         Constructor. Creates the dialog, displays it and disables user input
-        for other windows, or, if wxPD_APP_MODAL flag is not given, for its parent
-        window only.
+        for other windows, or, if @c wxPD_APP_MODAL flag is not given, for its
+        parent window only.
 
         @param title
             Dialog title to show in titlebar.
@@ -74,41 +74,38 @@ public:
     ~wxProgressDialog();
 
     /**
-        Just like Update() but makes
-        the gauge control run in indeterminate mode (see wxGauge documentation),
-        sets the remaining and the estimated time labels (if present) to @c Unknown and
-        moves
-        the progress bar a bit to indicate that some progress was done.
+        Works like Update() but makes the gauge control run in indeterminate mode
+        (see wxGauge documentation); sets the remaining and the estimated time labels
+        (if present) to "Unknown" or to @a newmsg (if it's non-empty); moves the progress
+        bar a bit to indicate that some progress was done.
     */
     virtual bool Pulse(const wxString& newmsg = "",
                        bool* skip = NULL);
 
     /**
-        Can be used to continue with the dialog, after the user had chosen
-        ABORT.
+        Can be used to continue with the dialog, after the user had clicked the "Abort" button.
     */
     void Resume();
 
     /**
         Updates the dialog, setting the progress bar to the new value and, if
-        given changes the message above it. Returns @true unless the Cancel button
+        given changes the message above it. Returns @true unless the "Cancel" button
         has 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 Resume() function.
+        dialog or ask the user for the confirmation and if the abort is not confirmed
+        the dialog may be resumed with Resume() function.
 
         @param value
-            The new value of the progress meter. It should be less than or
-            equal to the maximum value given to the constructor and the dialog is
-        closed if
+            The new value of the progress meter. It should be less than or equal to
+            the maximum value given to the constructor and the dialog is closed if
             it is equal to the maximum.
         @param newmsg
             The new messages for the progress dialog text, if it is
             empty (which is the default) the message is not changed.
         @param skip
-            If "Skip" button was pressed since last
-            Update call, this is set to @true.
+            If "Skip" button was pressed since last Update() call,
+            this is set to @true.
     */
     virtual bool Update(int value, const wxString& newmsg = "",
                         bool* skip = NULL);