]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/wx/stdpaths.h
Removing more CodeWarrior project files.
[wxWidgets.git] / interface / wx / stdpaths.h
index ee4c21030ef75535272a7c3b0579916215158652..af4dac1d2900045c87b09d15b47db1095f8f0e55 100644 (file)
@@ -51,7 +51,24 @@ public:
     /**
         Returns reference to the unique global standard paths object.
     */
-    static wxStandardPathsBase Get();
+    static wxStandardPathsBase& Get();
+
+    /**
+        Return the directory for the document files used by this application.
+
+        If the application-specific directory doesn't exist, this function
+        returns GetDocumentsDir().
+
+        Example return values:
+        - Unix: @c ~/appname
+        - Windows: @c "C:\Documents and Settings\username\My Documents\appname"
+        - Mac: @c ~/Documents/appname
+
+        @since 2.9.0
+
+        @see GetAppDocumentsDir()
+     */
+    virtual wxString GetAppDocumentsDir() const;
 
     /**
         Return the directory containing the system config files.
@@ -78,12 +95,15 @@ public:
 
     /**
         Return the directory containing the current user's documents.
+
         Example return values:
         - Unix: @c ~ (the home directory)
         - Windows: @c "C:\Documents and Settings\username\My Documents"
         - Mac: @c ~/Documents
 
         @since 2.7.0
+
+        @see GetAppDocumentsDir()
     */
     virtual wxString GetDocumentsDir() const;
 
@@ -126,8 +146,8 @@ public:
 
         @since 2.7.0
     */
-    wxString GetLocalizedResourcesDir(const wxString& lang,
-                                      ResourceCat category = ResourceCat_None) const;
+    virtual wxString GetLocalizedResourcesDir(const wxString& lang,
+                                              ResourceCat category) const;
 
     /**
         Return the directory where the loadable modules (plugins) live.