added wxString::Clone() and made wxString(wxCStrData) ctor make deep copy too

[wxWidgets.git] / interface / dirdlg.h

diff --git a/interface/dirdlg.h b/interface/dirdlg.h
index 75e2cb902fc51ac9b3cca512f1679515a760372d..4d21deac8577d18008a59a56462bdd2f1e7d95a4 100644 (file)
--- a/interface/dirdlg.h
+++ b/interface/dirdlg.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        dirdlg.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        dirdlg.h

-// Purpose:     documentation for wxDirDialog class
+// Purpose:     interface of wxDirDialog

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


@@ -9,56 +9,51 @@
 /**
     @class wxDirDialog
     @wxheader{dirdlg.h}
 /**
     @class wxDirDialog
     @wxheader{dirdlg.h}

-    
+

     This class represents the directory chooser dialog.
     This class represents the directory chooser dialog.

-    
+

     @beginStyleTable
     @beginStyleTable

-    @style{wxDD_DEFAULT_STYLE}:
+    @style{wxDD_DEFAULT_STYLE}

            Equivalent to a combination of wxDEFAULT_DIALOG_STYLE and
            wxRESIZE_BORDER (the last one is not used under wxWinCE).
            Equivalent to a combination of wxDEFAULT_DIALOG_STYLE and
            wxRESIZE_BORDER (the last one is not used under wxWinCE).

-    @style{wxDD_DIR_MUST_EXIST}:
+    @style{wxDD_DIR_MUST_EXIST}

            The dialog will allow the user to choose only an existing folder.
            When this style is not given, a "Create new directory" button is
            added to the dialog (on Windows) or some other way is provided to
            the user to type the name of a new folder.
            The dialog will allow the user to choose only an existing folder.
            When this style is not given, a "Create new directory" button is
            added to the dialog (on Windows) or some other way is provided to
            the user to type the name of a new folder.

-    @style{wxDD_CHANGE_DIR}:
+    @style{wxDD_CHANGE_DIR}

            Change the current working directory to the directory chosen by the
            user.
     @endStyleTable
            Change the current working directory to the directory chosen by the
            user.
     @endStyleTable

-    
+
+    @note On Windows the new directory button is only available with recent
+          versions of the common dialogs.
+

     @library{wxcore}
     @category{cmndlg}
     @library{wxcore}
     @category{cmndlg}

-    
-    @seealso
-    @ref overview_wxdirdialogoverview "wxDirDialog overview", wxFileDialog
+
+    @see @ref overview_cmndlg_dir, wxFileDialog

 */
 class wxDirDialog : public wxDialog
 {
 public:
     /**
 */
 class wxDirDialog : public wxDialog
 {
 public:
     /**

-        Constructor. Use ShowModal() to show
-        the dialog.
-        
-        @param parent 
-        Parent window.
-        
-        @param message 
-        Message to show on the dialog.
-        
-        @param defaultPath 
-        The default path, or the empty string.
-        
-        @param style 
-        The dialog style. See wxDirDialog
-        
-        @param pos 
-        Dialog position. Ignored under Windows.
-        
-        @param size 
-        Dialog size. Ignored under Windows.
-        
-        @param name 
-        The dialog name, not used.
+        Constructor. Use ShowModal() to show the dialog.
+
+        @param parent
+            Parent window.
+        @param message
+            Message to show on the dialog.
+        @param defaultPath
+            The default path, or the empty string.
+        @param style
+            The dialog style. See wxDirDialog
+        @param pos
+            Dialog position. Ignored under Windows.
+        @param size
+            Dialog size. Ignored under Windows.
+        @param name
+            The dialog name, not used.

     */
     wxDirDialog(wxWindow* parent,
                 const wxString& message = "Choose a directory",
     */
     wxDirDialog(wxWindow* parent,
                 const wxString& message = "Choose a directory",


@@ -76,12 +71,12 @@ public:
     /**
         Returns the message that will be displayed on the dialog.
     */
     /**
         Returns the message that will be displayed on the dialog.
     */

-    wxString GetMessage();
+    wxString GetMessage() const;

 
     /**
         Returns the default or user-selected path.
     */
 
     /**
         Returns the default or user-selected path.
     */

-    wxString GetPath();
+    wxString GetPath() const;

 
     /**
         Sets the message that will be displayed on the dialog.
 
     /**
         Sets the message that will be displayed on the dialog.


@@ -94,35 +89,44 @@ public:
     void SetPath(const wxString& path);
 
     /**
     void SetPath(const wxString& path);
 
     /**

-        Shows the dialog, returning wxID_OK if the user pressed OK, and wxID_CANCEL
-        otherwise.
+        Shows the dialog, returning wxID_OK if the user pressed OK, and
+        wxID_CANCEL otherwise.

     */
     int ShowModal();
 };
 
 
     */
     int ShowModal();
 };
 
 

+

 // ============================================================================
 // Global functions/macros
 // ============================================================================
 
 // ============================================================================
 // Global functions/macros
 // ============================================================================
 

+/** @ingroup group_funcmacro_dialog */
+//@{
+

 /**
 /**

-    Pops up a directory selector dialog. The arguments have the same meaning as
-    those of wxDirDialog::wxDirDialog(). The message is displayed at the top,
-    and the default_path, if specified, is set as the initial selection.
-    
+    Pops up a directory selector dialog. The arguments have the same meaning
+    as those of wxDirDialog::wxDirDialog(). The message is displayed at the
+    top, and the default_path, if specified, is set as the initial selection.
+

     The application must check for an empty return value (if the user pressed
     Cancel). For example:
     The application must check for an empty return value (if the user pressed
     Cancel). For example:

+

     @code
     const wxString& dir = wxDirSelector("Choose a folder");
     if ( !dir.empty() )
     {
     @code
     const wxString& dir = wxDirSelector("Choose a folder");
     if ( !dir.empty() )
     {

-      ...
+        ...

     }
     @endcode
     }
     @endcode

+
+    @header{wx/dirdlg.h}

 */
 wxString wxDirSelector(const wxString& message = wxDirSelectorPromptStr,
                        const wxString& default_path = "",
                        long style = 0,
                        const wxPoint& pos = wxDefaultPosition,
 */
 wxString wxDirSelector(const wxString& message = wxDirSelectorPromptStr,
                        const wxString& default_path = "",
                        long style = 0,
                        const wxPoint& pos = wxDefaultPosition,

-                       wxWindow * parent = @NULL);
+                       wxWindow* parent = NULL);
+
+//@}