Added wxSizer::GetItemCount()

[wxWidgets.git] / interface / wx / dirdlg.h

diff --git a/interface/wx/dirdlg.h b/interface/wx/dirdlg.h
index 4d21deac8577d18008a59a56462bdd2f1e7d95a4..23d7285ee07d82d0340031c2faf7f442b62b2906 100644 (file)
--- a/interface/wx/dirdlg.h
+++ b/interface/wx/dirdlg.h
@@ -8,7 +8,6 @@
 
 /**
     @class wxDirDialog
-    @wxheader{dirdlg.h}
 
     This class represents the directory chooser dialog.
 
@@ -26,8 +25,20 @@
            user.
     @endStyleTable
 
-    @note On Windows the new directory button is only available with recent
-          versions of the common dialogs.
+    Notice that @c wxRESIZE_BORDER has special side effect under recent (i.e.
+    later than Win9x) Windows where two different directory selection dialogs
+    are available and this style also implicitly selects the new version as the
+    old one always has fixed size. As the new version is almost always
+    preferable, it is recommended that @c wxRESIZE_BORDER style be always used.
+    This is the case if the dialog is created with the default style value but
+    if you need to use any additional styles you should still specify @c
+    wxDD_DEFAULT_STYLE unless you explicitly need to use the old dialog version
+    under Windows. E.g. do
+    @code
+        wxDirDialog dlg(NULL, "Choose input directory", "",
+                        wxDD_DEFAULT_STYLE | wxDD_DIR_MUST_EXIST);
+    @endcode
+    instead of just using @c wxDD_DIR_MUST_EXIST style alone.
 
     @library{wxcore}
     @category{cmndlg}
@@ -56,37 +67,37 @@ public:
             The dialog name, not used.
     */
     wxDirDialog(wxWindow* parent,
-                const wxString& message = "Choose a directory",
-                const wxString& defaultPath = "",
+                const wxString& message = wxDirSelectorPromptStr,
+                const wxString& defaultPath = wxEmptyString,
                 long style = wxDD_DEFAULT_STYLE,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
-                const wxString& name = "wxDirCtrl");
+                const wxString& name = wxDirDialogNameStr);
 
     /**
         Destructor.
     */
-    ~wxDirDialog();
+    virtual ~wxDirDialog();
 
     /**
         Returns the message that will be displayed on the dialog.
     */
-    wxString GetMessage() const;
+    virtual wxString GetMessage() const;
 
     /**
         Returns the default or user-selected path.
     */
-    wxString GetPath() const;
+    virtual wxString GetPath() const;
 
     /**
         Sets the message that will be displayed on the dialog.
     */
-    void SetMessage(const wxString& message);
+    virtual void SetMessage(const wxString& message);
 
     /**
         Sets the default path.
     */
-    void SetPath(const wxString& path);
+    virtual void SetPath(const wxString& path);
 
     /**
         Shows the dialog, returning wxID_OK if the user pressed OK, and