X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/e0b3b9d044746a258f93ae7c66550788d08d028e..a7689c49fe02c0c065facf736ab28b19f5997b7c:/include/wx/stdpaths.h?ds=inline diff --git a/include/wx/stdpaths.h b/include/wx/stdpaths.h index ca16733fe8..1bf5af0831 100644 --- a/include/wx/stdpaths.h +++ b/include/wx/stdpaths.h @@ -14,19 +14,21 @@ #include "wx/defs.h" -#if wxUSE_STDPATHS - #include "wx/string.h" #include "wx/filefn.h" +class WXDLLIMPEXP_FWD_BASE wxStandardPaths; + // ---------------------------------------------------------------------------- // wxStandardPaths returns the standard locations in the file system // ---------------------------------------------------------------------------- +// NB: This is always compiled in, wxUSE_STDPATHS=0 only disables native +// wxStandardPaths class, but a minimal version is always available class WXDLLIMPEXP_BASE wxStandardPathsBase { public: - // possible resources categorires + // possible resources categories enum ResourceCat { // no special category @@ -39,9 +41,18 @@ public: ResourceCat_Max }; + // what should we use to construct paths unique to this application: + // (AppInfo_AppName and AppInfo_VendorName can be combined together) + enum + { + AppInfo_None = 0, // nothing + AppInfo_AppName = 1, // the application name + AppInfo_VendorName = 2 // the vendor name + }; + // return the global standard paths object - static wxStandardPathsBase& Get(); + static wxStandardPaths& Get(); // return the path (directory+filename) of the running executable or // wxEmptyString if it couldn't be determined. @@ -118,40 +129,72 @@ public: // return the "Documents" directory for the current user // - // C:\Documents and Settings\username\Documents under Windows, + // C:\Documents and Settings\username\My Documents under Windows, // $HOME under Unix and ~/Documents under Mac virtual wxString GetDocumentsDir() const; + // return the directory for the documents files used by this application: + // it's a subdirectory of GetDocumentsDir() constructed using the + // application name/vendor if it exists or just GetDocumentsDir() otherwise + virtual wxString GetAppDocumentsDir() const; + // return the temporary directory for the current user virtual wxString GetTempDir() const; + // ctor for the base class + wxStandardPathsBase(); + // virtual dtor for the base class virtual ~wxStandardPathsBase(); + // Information used by AppendAppInfo + void UseAppInfo(int info) + { + m_usedAppInfo = info; + } + + bool UsesAppInfo(int info) const { return (m_usedAppInfo & info) != 0; } + + protected: - // append "/appname" suffix if the app name is set (doesn't append the - // slash if dir already ends with a slash or dot) - static wxString AppendAppName(const wxString& dir); + // append the path component, with a leading path separator if a + // path separator or dot (.) is not already at the end of dir + static wxString AppendPathComponent(const wxString& dir, const wxString& component); + + // append application information determined by m_usedAppInfo to dir + wxString AppendAppInfo(const wxString& dir) const; + + + // combination of AppInfo_XXX flags used by AppendAppInfo() + int m_usedAppInfo; }; -#if defined(__WXMSW__) - #include "wx/msw/stdpaths.h" -// We want CoreFoundation paths on both CarbonLib and Darwin (for all ports) -#elif defined(__WXMAC__) || defined(__DARWIN__) - #include "wx/mac/corefoundation/stdpaths.h" -#elif defined(__OS2__) - #include "wx/os2/stdpaths.h" -#elif defined(__UNIX__) - #include "wx/unix/stdpaths.h" -#elif defined(__PALMOS__) - #include "wx/palmos/stdpaths.h" -#else +#if wxUSE_STDPATHS + #if defined(__WINDOWS__) + #include "wx/msw/stdpaths.h" + #define wxHAS_NATIVE_STDPATHS + // We want CoreFoundation paths on both CarbonLib and Darwin (for all ports) + #elif defined(__WXMAC__) || defined(__DARWIN__) + #include "wx/osx/core/stdpaths.h" + #define wxHAS_NATIVE_STDPATHS + #elif defined(__OS2__) + #include "wx/os2/stdpaths.h" + #define wxHAS_NATIVE_STDPATHS + #elif defined(__UNIX__) + #include "wx/unix/stdpaths.h" + #define wxHAS_NATIVE_STDPATHS + #endif +#endif // ---------------------------------------------------------------------------- // Minimal generic implementation // ---------------------------------------------------------------------------- +// NB: Note that this minimal implementation is compiled in even if +// wxUSE_STDPATHS=0, so that our code can still use wxStandardPaths. + +#ifndef wxHAS_NATIVE_STDPATHS class WXDLLIMPEXP_BASE wxStandardPaths : public wxStandardPathsBase { public: @@ -170,10 +213,7 @@ public: private: wxString m_prefix; }; - -#endif - -#endif // wxUSE_STDPATHS +#endif // !wxHAS_NATIVE_STDPATHS #endif // _WX_STDPATHS_H_