Better conversion functions for integral and floating point types,

[wxWidgets.git] / wxPython / src / _cmndlgs.i

diff --git a/wxPython/src/_cmndlgs.i b/wxPython/src/_cmndlgs.i
index 745d15f1e89ff1b2ab8bc362668f2c9d0b50e4f7..967fb587d17319cceb9a4bb5cdc5a9f44a7fc568 100644 (file)
--- a/wxPython/src/_cmndlgs.i
+++ b/wxPython/src/_cmndlgs.i
@@ -26,86 +26,253 @@ MAKE_CONST_WXSTRING(MessageBoxCaptionStr);
 //---------------------------------------------------------------------------
 
 
 //---------------------------------------------------------------------------
 
 

+DocStr(wxColourData,
+       "This class holds a variety of information related to colour dialogs.");
+    

 class wxColourData : public wxObject {
 public:
 class wxColourData : public wxObject {
 public:

-    wxColourData();
+    DocCtorStr(
+        wxColourData(),
+        "Constructor, sets default values.");
+    

     ~wxColourData();
 
     ~wxColourData();
 

-    bool GetChooseFull();
-    wxColour GetColour();
-    wxColour GetCustomColour(int i);
-    void SetChooseFull(int flag);
-    void SetColour(const wxColour& colour);
-    void SetCustomColour(int i, const wxColour& colour);
+    
+    DocDeclStr(
+        bool , GetChooseFull(),
+        "Under Windows, determines whether the Windows colour dialog will display\n"
+        "the full dialog with custom colour selection controls. Has no meaning\n"
+        "under other platforms.  The default value is true.");
+    
+    DocDeclStr(
+        wxColour , GetColour(),
+        "Gets the colour (pre)selected by the dialog.");
+    
+    DocDeclStr(
+        wxColour , GetCustomColour(int i),
+        "Gets the i'th custom colour associated with the colour dialog. i should\n"
+        "be an integer between 0 and 15. The default custom colours are all white.");
+    
+    DocDeclStr(
+        void , SetChooseFull(int flag),
+        "Under Windows, tells the Windows colour dialog to display the full dialog\n"
+        "with custom colour selection controls. Under other platforms, has no effect.\n"
+        "The default value is true.");
+    
+    DocDeclStr(
+        void , SetColour(const wxColour& colour),
+        "Sets the default colour for the colour dialog.  The default colour is black.");
+    
+    DocDeclStr(
+        void , SetCustomColour(int i, const wxColour& colour),
+        "Sets the i'th custom colour for the colour dialog. i should be an integer\n"
+        "between 0 and 15. The default custom colours are all white.");
+    

 };
 
 
 };
 
 

+DocStr(wxColourDialog,
+       "This class represents the colour chooser dialog.");
+

 class wxColourDialog : public wxDialog {
 public:
     %pythonAppend wxColourDialog   "self._setOORInfo(self)"
 
 class wxColourDialog : public wxDialog {
 public:
     %pythonAppend wxColourDialog   "self._setOORInfo(self)"
 

-    wxColourDialog(wxWindow* parent, wxColourData* data = NULL);
+   DocCtorStr(
+       wxColourDialog(wxWindow* parent, wxColourData* data = NULL),
+       "Constructor. Pass a parent window, and optionally a ColourData, which\n"
+       "will be copied to the colour dialog's internal ColourData instance.");

 
 

-    wxColourData& GetColourData();
-    int ShowModal();
+    DocDeclStr(
+        wxColourData& , GetColourData(),
+        "Returns a reference to the ColourData used by the dialog.");

 };
 
 
 //--------------------------------------------------------------------------------
 
 };
 
 
 //--------------------------------------------------------------------------------
 

+
+DocStr(wxDirDialog,
+       "This class represents the directory chooser dialog.");
+
+RefDoc(wxDirDialog, "
+ Styles
+    wxDD_NEW_DIR_BUTTON     Add \"Create new directory\" button and allow
+                            directory names to be editable. On Windows the new
+                            directory button is only available with recent
+                            versions of the common dialogs.");
+

 class wxDirDialog : public wxDialog {
 public:
     %pythonAppend wxDirDialog   "self._setOORInfo(self)"
     
 class wxDirDialog : public wxDialog {
 public:
     %pythonAppend wxDirDialog   "self._setOORInfo(self)"
     

-    wxDirDialog(wxWindow* parent,
-                const wxString& message = wxPyDirSelectorPromptStr,
-                const wxString& defaultPath = wxPyEmptyString,
-                long style = 0,
-                const wxPoint& pos = wxDefaultPosition,
-                const wxSize& size = wxDefaultSize,
-                const wxString& name = wxPyDirDialogNameStr);
-
-
-    wxString GetPath();
-    wxString GetMessage();
-    long GetStyle();
-    void SetMessage(const wxString& message);
-    void SetPath(const wxString& path);
-    int ShowModal();
+    RefDoc(wxDirDialog, ""); // turn it off for the ctors
+    
+    DocCtorStr(
+        wxDirDialog(wxWindow* parent,
+                    const wxString& message = wxPyDirSelectorPromptStr,
+                    const wxString& defaultPath = wxPyEmptyString,
+                    long style = 0,
+                    const wxPoint& pos = wxDefaultPosition,
+                    const wxSize& size = wxDefaultSize,
+                    const wxString& name = wxPyDirDialogNameStr),
+        "Constructor.  Use ShowModal method to show the dialog.");
+
+
+    DocDeclStr(
+        wxString , GetPath(),
+        "Returns the default or user-selected path.");
+    
+    DocDeclStr(
+        wxString , GetMessage(),
+        "Returns the message that will be displayed on the dialog.");
+    
+    DocDeclStr(
+        long , GetStyle(),
+        "Returns the dialog style.");
+    
+    DocDeclStr(
+        void , SetMessage(const wxString& message),
+        "Sets the message that will be displayed on the dialog.");
+    
+    DocDeclStr(
+        void , SetPath(const wxString& path),
+        "Sets the default path.");
+    

 };
 
 
 //---------------------------------------------------------------------------
 
 };
 
 
 //---------------------------------------------------------------------------
 

+DocStr(wxFileDialog,
+       "This class represents the file chooser dialog.");
+
+RefDoc(wxFileDialog, "
+In Windows, this is the common file selector dialog. In X, this is a file
+selector box with somewhat less functionality. The path and filename are
+distinct elements of a full file pathname. If path is \"\", the current
+directory will be used. If filename is \"\", no default filename will be
+supplied. The wildcard determines what files are displayed in the file
+selector, and file extension supplies a type extension for the required
+filename.
+
+Both the X and Windows versions implement a wildcard filter. Typing a filename
+containing wildcards (*, ?) in the filename text item, and clicking on Ok,
+will result in only those files matching the pattern being displayed. The
+wildcard may be a specification for multiple types of file with a description
+for each, such as:
+
+   \"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif\"
+
+ Styles
+    wx.OPEN              This is an open dialog.
+
+    wx.SAVE              This is a save dialog.
+
+    wx.HIDE_READONLY     For open dialog only: hide the checkbox allowing to
+                         open the file in read-only mode.
+
+    wx.OVERWRITE_PROMPT  For save dialog only: prompt for a confirmation if a
+                         file will be overwritten.
+
+    wx.MULTIPLE          For open dialog only: allows selecting multiple files.
+
+    wx.CHANGE_DIR        Change the current working directory to the directory
+                         where the file(s) chosen by the user are.
+");
+
+
+

 class wxFileDialog : public wxDialog {
 public:
     %pythonAppend wxFileDialog   "self._setOORInfo(self)"
 class wxFileDialog : public wxDialog {
 public:
     %pythonAppend wxFileDialog   "self._setOORInfo(self)"

+
+    RefDoc(wxFileDialog, ""); // turn it off for the ctors
+    
+    DocCtorStr(
+        wxFileDialog(wxWindow* parent,
+                     const wxString& message = wxPyFileSelectorPromptStr,
+                     const wxString& defaultDir = wxPyEmptyString,
+                     const wxString& defaultFile = wxPyEmptyString,
+                     const wxString& wildcard = wxPyFileSelectorDefaultWildcardStr,
+                     long style = 0,
+                     const wxPoint& pos = wxDefaultPosition),
+        "Constructor.  Use ShowModal method to show the dialog.");
+
+
+    DocDeclStr(
+        void , SetMessage(const wxString& message),
+        "Sets the message that will be displayed on the dialog.");
+    
+    DocDeclStr(
+        void , SetPath(const wxString& path),
+        "Sets the path (the combined directory and filename that will\n"
+        "be returned when the dialog is dismissed).");
+    
+    DocDeclStr(
+        void , SetDirectory(const wxString& dir),
+        "Sets the default directory.");
+    
+    DocDeclStr(
+        void , SetFilename(const wxString& name),
+        "Sets the default filename.");
+    
+    DocDeclStr(
+        void , SetWildcard(const wxString& wildCard),
+        "Sets the wildcard, which can contain multiple file types, for example:\n"
+        "    \"BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif\"");
+    
+    DocDeclStr(
+        void , SetStyle(long style),
+        "Sets the dialog style.");
+    
+    DocDeclStr(
+        void , SetFilterIndex(int filterIndex),
+        "Sets the default filter index, starting from zero.");

     
     

-    wxFileDialog(wxWindow* parent,
-                 const wxString& message = wxPyFileSelectorPromptStr,
-                 const wxString& defaultDir = wxPyEmptyString,
-                 const wxString& defaultFile = wxPyEmptyString,
-                 const wxString& wildcard = wxPyFileSelectorDefaultWildcardStr,
-                 long style = 0,
-                 const wxPoint& pos = wxDefaultPosition);
-
-
-    void SetMessage(const wxString& message);
-    void SetPath(const wxString& path);
-    void SetDirectory(const wxString& dir);
-    void SetFilename(const wxString& name);
-    void SetWildcard(const wxString& wildCard);
-    void SetStyle(long style);
-    void SetFilterIndex(int filterIndex);
-
-    wxString GetMessage() const;
-    wxString GetPath() const;
-    wxString GetDirectory() const;
-    wxString GetFilename() const;
-    wxString GetWildcard() const;
-    long GetStyle() const;
-    int GetFilterIndex() const;

 
 

+    DocDeclStr(
+        wxString , GetMessage() const,
+        "Returns the message that will be displayed on the dialog.");
+    
+    DocDeclStr(
+        wxString , GetPath() const,
+        "Returns the full path (directory and filename) of the selected file.");
+    
+    DocDeclStr(
+        wxString , GetDirectory() const,
+        "Returns the default directory.");
+    
+    DocDeclStr(
+        wxString , GetFilename() const,
+        "Returns the default filename.");
+    
+    DocDeclStr(
+        wxString , GetWildcard() const,
+        "Returns the file dialog wildcard.");
+    
+    DocDeclStr(
+        long , GetStyle() const,
+        "Returns the dialog style.");
+    
+    DocDeclStr(
+        int , GetFilterIndex() const,
+        "Returns the index into the list of filters supplied, optionally, in\n"
+        "the wildcard parameter. Before the dialog is shown, this is the index\n"
+        "which will be used when the dialog is first displayed. After the dialog\n"
+        "is shown, this is the index selected by the user.");
+
+
+    DocStr(GetFilenames,
+        "Returns a list of filenames chosen in the dialog.  This function should\n"
+        "only be used with the dialogs which have wx.MULTIPLE style, use\n"
+        "GetFilename for the others.");
+
+    DocStr(GetPaths,
+        "Fills the array paths with the full paths of the files chosen. This\n"
+        "function should only be used with the dialogs which have wx.MULTIPLE style,\n"
+        "use GetPath for the others.");   
+    

     %extend {
         PyObject* GetFilenames() {
             wxArrayString arr;
     %extend {
         PyObject* GetFilenames() {
             wxArrayString arr;


@@ -147,21 +314,36 @@ public:
 
 enum { wxCHOICEDLG_STYLE };
 
 
 enum { wxCHOICEDLG_STYLE };
 

+
+DocStr(wxMultiChoiceDialog,
+       "A simple dialog with a multi selection listbox.");
+

 class wxMultiChoiceDialog : public wxDialog
 {
 public:
     %pythonAppend wxMultiChoiceDialog   "self._setOORInfo(self)"
 class wxMultiChoiceDialog : public wxDialog
 {
 public:
     %pythonAppend wxMultiChoiceDialog   "self._setOORInfo(self)"

-    
-    wxMultiChoiceDialog(wxWindow *parent,
-                        const wxString& message,
-                        const wxString& caption,
-                        int choices=0, wxString* choices_array,
-                        long style = wxCHOICEDLG_STYLE,
-                        const wxPoint& pos = wxDefaultPosition);

 
 

-    void SetSelections(const wxArrayInt& selections);
+    DocCtorAStr(
+        wxMultiChoiceDialog(wxWindow *parent,
+                            const wxString& message,
+                            const wxString& caption,
+                            int choices=0, wxString* choices_array,
+                            long style = wxCHOICEDLG_STYLE,
+                            const wxPoint& pos = wxDefaultPosition),
+        "__init__(Window parent, String message, String caption,\n"
+        "    List choices=[], long style=CHOICEDLG_STYLE,\n"
+        "    Point pos=DefaultPosition) -> MultiChoiceDialog",
+        "Constructor.  Use ShowModal method to show the dialog.");

 
 

-    // wxArrayInt GetSelections() const;
+    
+    DocDeclAStr(
+        void, SetSelections(const wxArrayInt& selections),
+        "SetSelections(List selections)",
+        "Specify the items in the list that shoudl be selected, using a list of integers.");
+
+    DocAStr(GetSelections,
+            "GetSelections() -> [selections]",
+            "Returns a list of integers representing the items that are selected.");

     %extend {
         PyObject* GetSelections() {
             return wxArrayInt2PyList_helper(self->GetSelections());
     %extend {
         PyObject* GetSelections() {
             return wxArrayInt2PyList_helper(self->GetSelections());


@@ -172,10 +354,19 @@ public:
 
 //---------------------------------------------------------------------------
 
 
 //---------------------------------------------------------------------------
 

+DocStr(wxSingleChoiceDialog,
+       "A simple dialog with a single selection listbox.");
+

 class wxSingleChoiceDialog : public wxDialog {
 public:
     %pythonAppend wxSingleChoiceDialog   "self._setOORInfo(self)"
 class wxSingleChoiceDialog : public wxDialog {
 public:
     %pythonAppend wxSingleChoiceDialog   "self._setOORInfo(self)"

-    
+
+    DocAStr(wxSingleChoiceDialog,
+            "__init__(Window parent, String message, String caption,\n"
+            "    List choices=[], long style=CHOICEDLG_STYLE,\n"
+            "    Point pos=DefaultPosition) -> SingleChoiceDialog",
+            "Constructor.  Use ShowModal method to show the dialog.");
+

     %extend {
         // TODO: ignoring clientData for now...  FIX THIS
         //       SWIG is messing up the &/*'s for some reason.
     %extend {
         // TODO: ignoring clientData for now...  FIX THIS
         //       SWIG is messing up the &/*'s for some reason.


@@ -191,94 +382,254 @@ public:
         }
     }
 
         }
     }
 

-    int GetSelection();
-    wxString GetStringSelection();
-    void SetSelection(int sel);
-    int ShowModal();
+    DocDeclStr(
+        int , GetSelection(),
+        "Get the index of teh currently selected item.");
+    
+    DocDeclStr(
+        wxString , GetStringSelection(),
+        "Returns the string value of the currently selected item");
+    
+    DocDeclStr(
+        void , SetSelection(int sel),
+        "Set the current selected item to sel");

 };
 
 
 //---------------------------------------------------------------------------
 
 };
 
 
 //---------------------------------------------------------------------------
 

+DocStr(wxTextEntryDialog,
+       "A dialog with text control, [ok] and [cancel] buttons");
+

 class wxTextEntryDialog : public wxDialog {
 public:
     %pythonAppend wxTextEntryDialog   "self._setOORInfo(self)"
 class wxTextEntryDialog : public wxDialog {
 public:
     %pythonAppend wxTextEntryDialog   "self._setOORInfo(self)"

-    
-    wxTextEntryDialog(wxWindow* parent,
-                      const wxString& message,
-                      const wxString& caption = wxPyGetTextFromUserPromptStr,
-                      const wxString& defaultValue = wxPyEmptyString,
-                      long style = wxOK | wxCANCEL | wxCENTRE,
-                      const wxPoint& pos = wxDefaultPosition);

 
 

-    wxString GetValue();
-    void SetValue(const wxString& value);
-    int ShowModal();
+    DocCtorStr(
+        wxTextEntryDialog(wxWindow* parent,
+                          const wxString& message,
+                          const wxString& caption = wxPyGetTextFromUserPromptStr,
+                          const wxString& defaultValue = wxPyEmptyString,
+                          long style = wxOK | wxCANCEL | wxCENTRE,
+                          const wxPoint& pos = wxDefaultPosition),
+        "Constructor.  Use ShowModal method to show the dialog.");
+
+    DocDeclStr(
+        wxString , GetValue(),
+        "Returns the text that the user has entered if the user has pressed OK,\n"
+        "or the original value if the user has pressed Cancel.");
+    
+    DocDeclStr(
+        void , SetValue(const wxString& value),
+        "Sets the default text value.");

 };
 
 //---------------------------------------------------------------------------
 
 };
 
 //---------------------------------------------------------------------------
 

+
+DocStr(wxFontData,
+       "This class holds a variety of information related to font dialogs.");
+
+

 class wxFontData : public wxObject {
 public:
     wxFontData();
     ~wxFontData();
 
 class wxFontData : public wxObject {
 public:
     wxFontData();
     ~wxFontData();
 

-    void EnableEffects(bool enable);
-    bool GetAllowSymbols();
-    wxColour GetColour();
-    wxFont GetChosenFont();
-    bool GetEnableEffects();
-    wxFont GetInitialFont();
-    bool GetShowHelp();
-    void SetAllowSymbols(bool allowSymbols);
-    void SetChosenFont(const wxFont& font);
-    void SetColour(const wxColour& colour);
-    void SetInitialFont(const wxFont& font);
-    void SetRange(int min, int max);
-    void SetShowHelp(bool showHelp);
+    DocDeclStr(
+        void , EnableEffects(bool enable),
+        "Enables or disables 'effects' under MS Windows only. This refers\n"
+        "to the controls for manipulating colour, strikeout and underline\n"
+        "properties.  The default value is true.");
+    
+    DocDeclStr(
+        bool , GetAllowSymbols(),
+        "Under MS Windows, returns a flag determining whether symbol fonts can be\n"
+        "selected. Has no effect on other platforms. The default value is true.");
+    
+    DocDeclStr(
+        wxColour , GetColour(),
+        "Gets the colour associated with the font dialog. The default value is black.");
+    
+    DocDeclStr(
+        wxFont , GetChosenFont(),
+        "Gets the font chosen by the user.");
+    
+    DocDeclStr(
+        bool , GetEnableEffects(),
+        "Determines whether 'effects' are enabled under Windows.");
+    
+    DocDeclStr(
+        wxFont , GetInitialFont(),
+        "Gets the font that will be initially used by the font dialog. This should have\n"
+        "previously been set by the application.");
+    
+    DocDeclStr(
+        bool , GetShowHelp(),
+        "Returns true if the Help button will be shown (Windows only).  The default\n"
+        "value is false.");
+    
+    DocDeclStr(
+        void , SetAllowSymbols(bool allowSymbols),
+        "Under MS Windows, determines whether symbol fonts can be selected. Has no\n"
+        "effect on other platforms.  The default value is true.");
+    
+    DocDeclStr(
+        void , SetChosenFont(const wxFont& font),
+        "Sets the font that will be returned to the user (for internal use only).");
+    
+    DocDeclStr(
+        void , SetColour(const wxColour& colour),
+        "Sets the colour that will be used for the font foreground colour.  The default\n"
+        "colour is black.");
+    
+    DocDeclStr(
+        void , SetInitialFont(const wxFont& font),
+        "Sets the font that will be initially used by the font dialog.");
+    
+    DocDeclStr(
+        void , SetRange(int min, int max),
+        "Sets the valid range for the font point size (Windows only).  The default is\n"
+        "0, 0 (unrestricted range).");
+    
+    DocDeclStr(
+        void , SetShowHelp(bool showHelp),
+        "Determines whether the Help button will be displayed in the font dialog\n"
+        "(Windows only).  The default value is false.");

 };
 
 
 };
 
 

+
+
+DocStr(wxFontDialog,
+       "This class represents the font chooser dialog.");
+

 class wxFontDialog : public wxDialog {
 public:
     %pythonAppend wxFontDialog   "self._setOORInfo(self)"
 class wxFontDialog : public wxDialog {
 public:
     %pythonAppend wxFontDialog   "self._setOORInfo(self)"

-    
+
+    DocStr(wxFontDialog,
+           "Constructor. Pass a parent window and the FontData object to be\n"
+           "used to initialize the dialog controls.");

     wxFontDialog(wxWindow* parent, const wxFontData& data);
 
     wxFontDialog(wxWindow* parent, const wxFontData& data);
 

-    wxFontData& GetFontData();
-    int ShowModal();
+    
+    DocDeclStr(
+        wxFontData& , GetFontData(),
+        "Returns a reference to the internal FontData used by the FontDialog.");    

 };
 
 
 //---------------------------------------------------------------------------
 
 };
 
 
 //---------------------------------------------------------------------------
 

+
+DocStr(wxMessageDialog,
+       "This class provides a dialog that shows a single or multi-line message, with\n"
+       "a choice of OK, Yes, No and Cancel buttons.");
+
+RefDoc(wxMessageDialog, "
+  Styles
+    wx.OK:                Show an OK button.
+
+    wx.CANCEL:            Show a Cancel button.
+
+    wx.YES_NO:            Show Yes and No buttons.
+
+    wx.YES_DEFAULT:       Used with wxYES_NO, makes Yes button the default - which is the default behaviour.
+
+    wx.NO_DEFAULT:        Used with wxYES_NO, makes No button the default.
+
+    wx.ICON_EXCLAMATION:  Shows an exclamation mark icon.
+
+    wx.ICON_HAND:         Shows an error icon.
+
+    wx.ICON_ERROR:        Shows an error icon - the same as wxICON_HAND.
+
+    wx.ICON_QUESTION:     Shows a question mark icon.
+
+    wx.ICON_INFORMATION:  Shows an information (i) icon.
+
+    wx.STAY_ON_TOP:       The message box stays on top of all other window, even those of the other applications (Windows only).
+");
+
+

 class wxMessageDialog : public wxDialog {
 public:
     %pythonAppend wxMessageDialog   "self._setOORInfo(self)"
     
 class wxMessageDialog : public wxDialog {
 public:
     %pythonAppend wxMessageDialog   "self._setOORInfo(self)"
     

+    RefDoc(wxMessageDialog, ""); // turn it off for the ctors
+    

     wxMessageDialog(wxWindow* parent,
                     const wxString& message,
                     const wxString& caption = wxPyMessageBoxCaptionStr,
                     long style = wxOK | wxCANCEL | wxCENTRE,
                     const wxPoint& pos = wxDefaultPosition);
 
     wxMessageDialog(wxWindow* parent,
                     const wxString& message,
                     const wxString& caption = wxPyMessageBoxCaptionStr,
                     long style = wxOK | wxCANCEL | wxCENTRE,
                     const wxPoint& pos = wxDefaultPosition);
 

-    int ShowModal();

 };
 
 //---------------------------------------------------------------------------
 
 };
 
 //---------------------------------------------------------------------------
 

+
+DocStr(wxProgressDialog,
+       "A dialog that shows a short message and a progress bar. Optionally, it can\n"
+       "display an ABORT button.");
+
+RefDoc(wxProgressDialog, "
+  Styles
+
+    wx.PD_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.
+
+    wx.PD_AUTO_HIDE:            Causes the progress dialog to disappear from screen 
+                                as soon as the maximum value of the progress
+                                meter has been reached.
+
+    wx.PD_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.
+
+    wx.PD_ELAPSED_TIME:         This flag tells the dialog that it should show
+                                elapsed time (since creating the dialog).
+
+    wx.PD_ESTIMATED_TIME:      This flag tells the dialog that it should show
+                                estimated time.
+
+    wx.PD_REMAINING_TIME:      This flag tells the dialog that it should show
+                                remaining time.
+");
+
+

 class wxProgressDialog : public wxFrame {
 public:
     %pythonAppend wxProgressDialog   "self._setOORInfo(self)"
 class wxProgressDialog : public wxFrame {
 public:
     %pythonAppend wxProgressDialog   "self._setOORInfo(self)"

-    
-    wxProgressDialog(const wxString& title,
-                     const wxString& message,
-                     int maximum = 100,
-                     wxWindow* parent = NULL,
-                     int style = wxPD_AUTO_HIDE | wxPD_APP_MODAL );

 
 

-    bool Update(int value, const wxString& newmsg = wxPyEmptyString);
-    void Resume();
+    RefDoc(wxProgressDialog, ""); // turn it off for the ctors
+    
+    DocCtorStr(
+        wxProgressDialog(const wxString& title,
+                         const wxString& message,
+                         int maximum = 100,
+                         wxWindow* parent = NULL,
+                         int style = wxPD_AUTO_HIDE | wxPD_APP_MODAL ),
+        "Constructor. Creates the dialog, displays it and disables user input for other\n"
+        "windows, or, if wxPD_APP_MODAL flag is not given, for its parent window only.");
+
+    DocDeclStr(
+        bool , Update(int value, const wxString& newmsg = wxPyEmptyString),
+        "Updates the dialog, setting the progress bar to the new value and, if given\n"
+        "changes the message above it. Returns true unless the Cancel button has been\n"
+        "pressed.\n\n"
+        "If false is returned, the application can either immediately destroy the\n"
+        "dialog or ask the user for the confirmation and if the abort is not confirmed\n"
+        "the dialog may be resumed with Resume function.");
+    
+    DocDeclStr(
+        void , Resume(),
+        "Can be used to continue with the dialog, after the user had chosen to abort.");
+    

 };
 
 //---------------------------------------------------------------------------
 };
 
 //---------------------------------------------------------------------------


@@ -336,54 +687,165 @@ EVT_COMMAND_FIND_CLOSE       = EVT_FIND_CLOSE
 }
 
 
 }
 
 

+DocStr(wxFindDialogEvent,
+       "Events for the FindReplaceDialog");
+

 class wxFindDialogEvent : public wxCommandEvent
 {
 public:
     wxFindDialogEvent(wxEventType commandType = wxEVT_NULL, int id = 0);
 class wxFindDialogEvent : public wxCommandEvent
 {
 public:
     wxFindDialogEvent(wxEventType commandType = wxEVT_NULL, int id = 0);

-    int GetFlags();
-    const wxString& GetFindString();
-    const wxString& GetReplaceString();
-    wxFindReplaceDialog *GetDialog();
-    void SetFlags(int flags);
-    void SetFindString(const wxString& str);
-    void SetReplaceString(const wxString& str);
+    
+    DocDeclStr(
+        int , GetFlags(),
+        "Get the currently selected flags: this is the combination of\n"
+        "wx.FR_DOWN, wx.FR_WHOLEWORD and wx.FR_MATCHCASE flags.");
+    
+    DocDeclStr(
+        const wxString& , GetFindString(),
+        "Return the string to find (never empty).");
+    
+    DocDeclStr(
+        const wxString& , GetReplaceString(),
+        "Return the string to replace the search string with (only\n"
+        "for replace and replace all events).");
+    
+    DocDeclStr(
+        wxFindReplaceDialog *, GetDialog(),
+        "Return the pointer to the dialog which generated this event.");
+    
+    DocDeclStr(
+        void , SetFlags(int flags),
+        "");
+    
+    DocDeclStr(
+        void , SetFindString(const wxString& str),
+        "");
+    
+    DocDeclStr(
+        void , SetReplaceString(const wxString& str),
+        "");

 };
 
 
 
 };
 
 
 

+DocStr(wxFindReplaceData, 
+"FindReplaceData holds the data for FindReplaceDialog. It is used to initialize
+the dialog with the default values and will keep the last values from the
+dialog when it is closed. It is also updated each time a wxFindDialogEvent is
+generated so instead of using the wxFindDialogEvent methods you can also
+directly query this object.
+
+Note that all SetXXX() methods may only be called before showing the dialog
+and calling them has no effect later.
+
+ Flags
+    wxFR_DOWN:          downward search/replace selected (otherwise, upwards)
+
+    wxFR_WHOLEWORD:     whole word search/replace selected
+
+    wxFR_MATCHCASE:     case sensitive search/replace selected (otherwise,
+                        case insensitive)
+");
+
+
+
+

 class wxFindReplaceData : public wxObject
 {
 public:
 class wxFindReplaceData : public wxObject
 {
 public:

-    wxFindReplaceData(int flags=0);
+    DocCtorStr(
+        wxFindReplaceData(int flags=0),
+        "Constuctor initializes the flags to default value (0).");
+    

     ~wxFindReplaceData();
     ~wxFindReplaceData();

+    

 
 

-    const wxString& GetFindString();
-    const wxString& GetReplaceString();
-    int GetFlags();
-    void SetFlags(int flags);
-    void SetFindString(const wxString& str);
-    void SetReplaceString(const wxString& str);
+    DocDeclStr(
+        const wxString& , GetFindString(),
+        "Get the string to find.");
+    
+    DocDeclStr(
+        const wxString& , GetReplaceString(),
+        "Get the replacement string.");
+    
+    DocDeclStr(
+        int , GetFlags(),
+        "Get the combination of flag values.");
+    
+    DocDeclStr(
+        void , SetFlags(int flags),
+        "Set the flags to use to initialize the controls of the dialog.");
+    
+    DocDeclStr(
+        void , SetFindString(const wxString& str),
+        "Set the string to find (used as initial value by the dialog).");
+    
+    DocDeclStr(
+        void , SetReplaceString(const wxString& str),
+        "Set the replacement string (used as initial value by the dialog).");
+    

 };
 
 
 };
 
 

+
+
+DocStr(wxFindReplaceDialog,
+"FindReplaceDialog is a standard modeless dialog which is used to allow the
+user to search for some text (and possibly replace it with something
+else). The actual searching is supposed to be done in the owner window which
+is the parent of this dialog. Note that it means that unlike for the other
+standard dialogs this one must have a parent window. Also note that there is
+no way to use this dialog in a modal way; it is always, by design and
+implementation, modeless.");
+
+RefDoc(wxFindReplaceDialog, "
+ Styles
+    wx.FR_REPLACEDIALOG:        replace dialog (otherwise find dialog)
+
+    wx.FR_NOUPDOWN:             don't allow changing the search direction
+
+    wx.FR_NOMATCHCASE:          don't allow case sensitive searching
+
+    wx.FR_NOWHOLEWORD:          don't allow whole word searching
+");
+

 class wxFindReplaceDialog : public wxDialog {
 public:
     %pythonAppend wxFindReplaceDialog     "self._setOORInfo(self)"
     %pythonAppend wxFindReplaceDialog()   ""
 
 class wxFindReplaceDialog : public wxDialog {
 public:
     %pythonAppend wxFindReplaceDialog     "self._setOORInfo(self)"
     %pythonAppend wxFindReplaceDialog()   ""
 

-    wxFindReplaceDialog(wxWindow *parent,
-                        wxFindReplaceData *data,
-                        const wxString &title,
-                        int style = 0);
-    %name(PreFindReplaceDialog)wxFindReplaceDialog();
+    RefDoc(wxFindReplaceDialog, ""); // turn it off for the ctors
+    
+    DocCtorStr(
+        wxFindReplaceDialog(wxWindow *parent,
+                            wxFindReplaceData *data,
+                            const wxString &title,
+                            int style = 0),
+        "Create a FindReplaceDialog.  The parent and data parameters must be\n"
+        "non-None.  Use Show to display the dialog.");
+
+    DocCtorStrName(
+        wxFindReplaceDialog(),
+        "Precreate a FindReplaceDialog for 2-phase creation",
+        PreFindReplaceDialog);

 
 

-     bool Create(wxWindow *parent,
-                 wxFindReplaceData *data,
-                 const wxString &title,
-                 int style = 0);
+    
+    DocDeclStr(
+        bool , Create(wxWindow *parent,
+                      wxFindReplaceData *data,
+                      const wxString &title,
+                      int style = 0),
+        "Create the dialog, for 2-phase create.");
+    

 
 

-    const wxFindReplaceData *GetData();
-    void SetData(wxFindReplaceData *data);
+    DocDeclStr(
+        const wxFindReplaceData *, GetData(),
+        "Get the FindReplaceData object used by this dialog.");
+    
+    DocDeclStr(
+        void , SetData(wxFindReplaceData *data),
+        "Set the FindReplaceData object used by this dialog.");
+    

 };
 
 //---------------------------------------------------------------------------
 };
 
 //---------------------------------------------------------------------------