move all appearace-related methods down to wxCalendarCtrlBase from wxGenericCalendarCtrl

[wxWidgets.git] / interface / fdrepdlg.h

diff --git a/interface/fdrepdlg.h b/interface/fdrepdlg.h
index 9e2ca39dd2b9ba677f9f6dd3e3b6fcfd89f13551..7696f782dcb08564b108abe3218af79e5b795f57 100644 (file)
--- a/interface/fdrepdlg.h
+++ b/interface/fdrepdlg.h
@@ -1,17 +1,66 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        fdrepdlg.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        fdrepdlg.h

-// Purpose:     documentation for wxFindDialogEvent class
+// Purpose:     interface of wxFindDialogEvent, wxFindReplaceDialog

 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 /////////////////////////////////////////////////////////////////////////////
 

+
+/**
+    See wxFindDialogEvent::GetFlags().
+*/
+enum wxFindReplaceFlags
+{
+    /** downward search/replace selected (otherwise - upwards) */
+    wxFR_DOWN       = 1,
+
+    /** whole word search/replace selected */
+    wxFR_WHOLEWORD  = 2,
+
+    /** case sensitive search/replace selected (otherwise - case insensitive) */
+    wxFR_MATCHCASE  = 4
+}
+
+
+/**
+    These flags can be specified in wxFindReplaceDialog ctor or Create():
+*/
+enum wxFindReplaceDialogStyles
+{
+    /** replace dialog (otherwise find dialog) */
+    wxFR_REPLACEDIALOG = 1,
+
+    /** don't allow changing the search direction */
+    wxFR_NOUPDOWN      = 2,
+
+    /** don't allow case sensitive searching */
+    wxFR_NOMATCHCASE   = 4,
+
+    /** don't allow whole word searching */
+    wxFR_NOWHOLEWORD   = 8
+}
+
+

 /**
     @class wxFindDialogEvent
     @wxheader{fdrepdlg.h}
 /**
     @class wxFindDialogEvent
     @wxheader{fdrepdlg.h}

-    
+

     wxFindReplaceDialog events
     wxFindReplaceDialog events

-    
+
+    @beginEventTable{wxFindDialogEvent}
+    @event{EVT_FIND(id, func)}:
+        Find button was pressed in the dialog.
+    @event{EVT_FIND_NEXT(id, func)}:
+        Find next button was pressed in the dialog.
+    @event{EVT_FIND_REPLACE(id, func)}:
+        Replace button was pressed in the dialog.
+    @event{EVT_FIND_REPLACE_ALL(id, func)}:
+        Replace all button was pressed in the dialog.
+    @event{EVT_FIND_CLOSE(id, func)}:
+        The dialog is being destroyed, any pointers to it cannot be used any longer.
+    @endEventTable
+

     @library{wxcore}
     @category{events}
 */
     @library{wxcore}
     @category{events}
 */


@@ -21,49 +70,50 @@ public:
     /**
         Constuctor used by wxWidgets only.
     */
     /**
         Constuctor used by wxWidgets only.
     */

-    wxFindDialogEvent(wxEventType commandType = wxEVT_@NULL,
+    wxFindDialogEvent(wxEventType commandType = wxEVT_NULL,

                       int id = 0);
 
     /**
         Return the pointer to the dialog which generated this event.
     */
                       int id = 0);
 
     /**
         Return the pointer to the dialog which generated this event.
     */

-    wxFindReplaceDialog* GetDialog();
+    wxFindReplaceDialog* GetDialog() const;

 
     /**
         Return the string to find (never empty).
     */
 
     /**
         Return the string to find (never empty).
     */

-    wxString GetFindString();
+    wxString GetFindString() const;

 
     /**
 
     /**

-        Get the currently selected flags: this is the combination of @c wxFR_DOWN,
-        @c wxFR_WHOLEWORD and @c wxFR_MATCHCASE flags.
+        Get the currently selected flags: this is the combination of
+        the ::wxFindReplaceFlags enumeration values.

     */
     */

-    int GetFlags();
+    int GetFlags() const;

 
     /**
         Return the string to replace the search string with (only for replace and
         replace all events).
     */
 
     /**
         Return the string to replace the search string with (only for replace and
         replace all events).
     */

-    const wxString GetReplaceString();
+    const wxString& GetReplaceString() const;

 };
 
 
 };
 
 

+

 /**
     @class wxFindReplaceData
     @wxheader{fdrepdlg.h}
 /**
     @class wxFindReplaceData
     @wxheader{fdrepdlg.h}

-    
-    wxFindReplaceData holds the data for 
-    wxFindReplaceDialog. 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.
-    
+
+    wxFindReplaceData holds the data for wxFindReplaceDialog.
+
+    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 @c SetXXX() methods may only be called before showing the
     dialog and calling them has no effect later.
     Note that all @c SetXXX() methods may only be called before showing the
     dialog and calling them has no effect later.

-    
+

     @library{wxcore}
     @library{wxcore}

-    @category{FIXME}
+    @category{data}

 */
 class wxFindReplaceData : public wxObject
 {
 */
 class wxFindReplaceData : public wxObject
 {


@@ -81,7 +131,7 @@ public:
     /**
         Get the combination of @c wxFindReplaceFlags values.
     */
     /**
         Get the combination of @c wxFindReplaceFlags values.
     */

-    int GetFlags();
+    int GetFlags() const;

 
     /**
         Get the replacement string.
 
     /**
         Get the replacement string.


@@ -105,39 +155,39 @@ public:
 };
 
 
 };
 
 

+

 /**
     @class wxFindReplaceDialog
     @wxheader{fdrepdlg.h}
 /**
     @class wxFindReplaceDialog
     @wxheader{fdrepdlg.h}

-    
+

     wxFindReplaceDialog is a standard modeless dialog which is used to allow the
     user to search for some text (and possibly replace it with something else).
     wxFindReplaceDialog 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 @b 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.
     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 @b 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.

-    
-    Please see the dialogs sample for an example of using it.
-    
+
+    Please see the @ref page_samples_dialogs sample for an example of using it.
+

     @library{wxcore}
     @category{cmndlg}
 */
 class wxFindReplaceDialog : public wxDialog
 {
 public:
     @library{wxcore}
     @category{cmndlg}
 */
 class wxFindReplaceDialog : public wxDialog
 {
 public:

-    //@{
+    wxFindReplaceDialog();
+

     /**
     /**

-        After using default constructor Create() 
-        must be called.
-        
-        The @e parent and @e data parameters must be non-@NULL.
+        After using default constructor Create() must be called.
+
+        The @a parent and @a data parameters must be non-@NULL.

     */
     */

-    wxFindReplaceDialog();
-        wxFindReplaceDialog(wxWindow * parent,
-                            wxFindReplaceData* data,
-                            const wxString& title,
-                            int style = 0);
-    //@}
+    wxFindReplaceDialog(wxWindow* parent,
+                        wxFindReplaceData* data,
+                        const wxString& title,
+                        int style = 0);

 
     /**
         Destructor.
 
     /**
         Destructor.


@@ -146,15 +196,15 @@ public:
 
     /**
         Creates the dialog; use wxWindow::Show to show it on screen.
 
     /**
         Creates the dialog; use wxWindow::Show to show it on screen.

-        
-        The @e parent and @e data parameters must be non-@NULL.
+
+        The @a parent and @a data parameters must be non-@NULL.

     */
     */

-    bool Create(wxWindow * parent, wxFindReplaceData* data,
+    bool Create(wxWindow* parent, wxFindReplaceData* data,

                 const wxString& title, int style = 0);
 
     /**
                 const wxString& title, int style = 0);
 
     /**

-        Get the wxFindReplaceData object used by this
-        dialog.
+        Get the wxFindReplaceData object used by this dialog.

     */
     */

-    const wxFindReplaceData* GetData();
+    const wxFindReplaceData* GetData() const;

 };
 };

+