| 1 | /////////////////////////////////////////////////////////////////////////////// |
| 2 | // Name: wx/stdpaths.h |
| 3 | // Purpose: declaration of wxStandardPaths class |
| 4 | // Author: Vadim Zeitlin |
| 5 | // Modified by: |
| 6 | // Created: 2004-10-17 |
| 7 | // RCS-ID: $Id$ |
| 8 | // Copyright: (c) 2004 Vadim Zeitlin <vadim@wxwindows.org> |
| 9 | // Licence: wxWindows licence |
| 10 | /////////////////////////////////////////////////////////////////////////////// |
| 11 | |
| 12 | #ifndef _WX_STDPATHS_H_ |
| 13 | #define _WX_STDPATHS_H_ |
| 14 | |
| 15 | #include "wx/defs.h" |
| 16 | |
| 17 | #include "wx/string.h" |
| 18 | #include "wx/filefn.h" |
| 19 | |
| 20 | // ---------------------------------------------------------------------------- |
| 21 | // wxStandardPaths returns the standard locations in the file system |
| 22 | // ---------------------------------------------------------------------------- |
| 23 | |
| 24 | // NB: This is always compiled in, wxUSE_STDPATHS=0 only disables native |
| 25 | // wxStandardPaths class, but a minimal version is always available |
| 26 | class WXDLLIMPEXP_BASE wxStandardPathsBase |
| 27 | { |
| 28 | public: |
| 29 | // possible resources categorires |
| 30 | enum ResourceCat |
| 31 | { |
| 32 | // no special category |
| 33 | ResourceCat_None, |
| 34 | |
| 35 | // message catalog resources |
| 36 | ResourceCat_Messages, |
| 37 | |
| 38 | // end of enum marker |
| 39 | ResourceCat_Max |
| 40 | }; |
| 41 | |
| 42 | // what should we use to construct paths unique to this application: |
| 43 | // (AppInfo_AppName and AppInfo_VendorName can be combined together) |
| 44 | enum |
| 45 | { |
| 46 | AppInfo_None = 0, // nothing |
| 47 | AppInfo_AppName = 1, // the application name |
| 48 | AppInfo_VendorName = 2 // the vendor name |
| 49 | }; |
| 50 | |
| 51 | |
| 52 | // return the global standard paths object |
| 53 | static wxStandardPathsBase& Get(); |
| 54 | |
| 55 | // return the path (directory+filename) of the running executable or |
| 56 | // wxEmptyString if it couldn't be determined. |
| 57 | // The path is returned as an absolute path whenever possible. |
| 58 | // Default implementation only try to use wxApp->argv[0]. |
| 59 | virtual wxString GetExecutablePath() const; |
| 60 | |
| 61 | // return the directory with system config files: |
| 62 | // /etc under Unix, c:\Documents and Settings\All Users\Application Data |
| 63 | // under Windows, /Library/Preferences for Mac |
| 64 | virtual wxString GetConfigDir() const = 0; |
| 65 | |
| 66 | // return the directory for the user config files: |
| 67 | // $HOME under Unix, c:\Documents and Settings\username under Windows, |
| 68 | // ~/Library/Preferences under Mac |
| 69 | // |
| 70 | // only use this if you have a single file to put there, otherwise |
| 71 | // GetUserDataDir() is more appropriate |
| 72 | virtual wxString GetUserConfigDir() const = 0; |
| 73 | |
| 74 | // return the location of the applications global, i.e. not user-specific, |
| 75 | // data files |
| 76 | // |
| 77 | // prefix/share/appname under Unix, c:\Program Files\appname under Windows, |
| 78 | // appname.app/Contents/SharedSupport app bundle directory under Mac |
| 79 | virtual wxString GetDataDir() const = 0; |
| 80 | |
| 81 | // return the location for application data files which are host-specific |
| 82 | // |
| 83 | // same as GetDataDir() except under Unix where it is /etc/appname |
| 84 | virtual wxString GetLocalDataDir() const; |
| 85 | |
| 86 | // return the directory for the user-dependent application data files |
| 87 | // |
| 88 | // $HOME/.appname under Unix, |
| 89 | // c:\Documents and Settings\username\Application Data\appname under Windows |
| 90 | // and ~/Library/Application Support/appname under Mac |
| 91 | virtual wxString GetUserDataDir() const = 0; |
| 92 | |
| 93 | // return the directory for user data files which shouldn't be shared with |
| 94 | // the other machines |
| 95 | // |
| 96 | // same as GetUserDataDir() for all platforms except Windows where it is |
| 97 | // the "Local Settings\Application Data\appname" directory |
| 98 | virtual wxString GetUserLocalDataDir() const; |
| 99 | |
| 100 | // return the directory where the loadable modules (plugins) live |
| 101 | // |
| 102 | // prefix/lib/appname under Unix, program directory under Windows and |
| 103 | // Contents/Plugins app bundle subdirectory under Mac |
| 104 | virtual wxString GetPluginsDir() const = 0; |
| 105 | |
| 106 | // get resources directory: resources are auxiliary files used by the |
| 107 | // application and include things like image and sound files |
| 108 | // |
| 109 | // same as GetDataDir() for all platforms except Mac where it returns |
| 110 | // Contents/Resources subdirectory of the app bundle |
| 111 | virtual wxString GetResourcesDir() const { return GetDataDir(); } |
| 112 | |
| 113 | // get localized resources directory containing the resource files of the |
| 114 | // specified category for the given language |
| 115 | // |
| 116 | // in general this is just GetResourcesDir()/lang under Windows and Unix |
| 117 | // and GetResourcesDir()/lang.lproj under Mac but is something quite |
| 118 | // different under Unix for message catalog category (namely the standard |
| 119 | // prefix/share/locale/lang/LC_MESSAGES) |
| 120 | virtual wxString |
| 121 | GetLocalizedResourcesDir(const wxString& lang, |
| 122 | ResourceCat WXUNUSED(category) |
| 123 | = ResourceCat_None) const |
| 124 | { |
| 125 | return GetResourcesDir() + wxFILE_SEP_PATH + lang; |
| 126 | } |
| 127 | |
| 128 | // return the "Documents" directory for the current user |
| 129 | // |
| 130 | // C:\Documents and Settings\username\Documents under Windows, |
| 131 | // $HOME under Unix and ~/Documents under Mac |
| 132 | virtual wxString GetDocumentsDir() const; |
| 133 | |
| 134 | // return the temporary directory for the current user |
| 135 | virtual wxString GetTempDir() const; |
| 136 | |
| 137 | |
| 138 | // ctor for the base class |
| 139 | wxStandardPathsBase(); |
| 140 | |
| 141 | // virtual dtor for the base class |
| 142 | virtual ~wxStandardPathsBase(); |
| 143 | |
| 144 | // Information used by AppendAppInfo |
| 145 | void UseAppInfo(int info) |
| 146 | { |
| 147 | m_usedAppInfo = info; |
| 148 | } |
| 149 | |
| 150 | bool UsesAppInfo(int info) const { return (m_usedAppInfo & info) != 0; } |
| 151 | |
| 152 | |
| 153 | protected: |
| 154 | // append the path component, with a leading path seperator if a |
| 155 | // path seperator or dot (.) is not already at the end of dir |
| 156 | static wxString AppendPathComponent(const wxString& dir, const wxString& component); |
| 157 | |
| 158 | // append application information determined by m_usedAppInfo to dir |
| 159 | wxString AppendAppInfo(const wxString& dir) const; |
| 160 | |
| 161 | |
| 162 | // combination of AppInfo_XXX flags used by AppendAppInfo() |
| 163 | int m_usedAppInfo; |
| 164 | }; |
| 165 | |
| 166 | #if wxUSE_STDPATHS |
| 167 | #if defined(__WXMSW__) |
| 168 | #include "wx/msw/stdpaths.h" |
| 169 | #define wxHAS_NATIVE_STDPATHS |
| 170 | // We want CoreFoundation paths on both CarbonLib and Darwin (for all ports) |
| 171 | #elif defined(__WXMAC__) || defined(__DARWIN__) |
| 172 | #include "wx/mac/corefoundation/stdpaths.h" |
| 173 | #define wxHAS_NATIVE_STDPATHS |
| 174 | #elif defined(__OS2__) |
| 175 | #include "wx/os2/stdpaths.h" |
| 176 | #define wxHAS_NATIVE_STDPATHS |
| 177 | #elif defined(__UNIX__) |
| 178 | #include "wx/unix/stdpaths.h" |
| 179 | #define wxHAS_NATIVE_STDPATHS |
| 180 | #elif defined(__PALMOS__) |
| 181 | #include "wx/palmos/stdpaths.h" |
| 182 | #define wxHAS_NATIVE_STDPATHS |
| 183 | #endif |
| 184 | #endif |
| 185 | |
| 186 | // ---------------------------------------------------------------------------- |
| 187 | // Minimal generic implementation |
| 188 | // ---------------------------------------------------------------------------- |
| 189 | |
| 190 | // NB: Note that this minimal implementation is compiled in even if |
| 191 | // wxUSE_STDPATHS=0, so that our code can still use wxStandardPaths. |
| 192 | |
| 193 | #ifndef wxHAS_NATIVE_STDPATHS |
| 194 | class WXDLLIMPEXP_BASE wxStandardPaths : public wxStandardPathsBase |
| 195 | { |
| 196 | public: |
| 197 | void SetInstallPrefix(const wxString& prefix) { m_prefix = prefix; } |
| 198 | wxString GetInstallPrefix() const { return m_prefix; } |
| 199 | |
| 200 | virtual wxString GetExecutablePath() const { return m_prefix; } |
| 201 | virtual wxString GetConfigDir() const { return m_prefix; } |
| 202 | virtual wxString GetUserConfigDir() const { return m_prefix; } |
| 203 | virtual wxString GetDataDir() const { return m_prefix; } |
| 204 | virtual wxString GetLocalDataDir() const { return m_prefix; } |
| 205 | virtual wxString GetUserDataDir() const { return m_prefix; } |
| 206 | virtual wxString GetPluginsDir() const { return m_prefix; } |
| 207 | virtual wxString GetDocumentsDir() const { return m_prefix; } |
| 208 | |
| 209 | private: |
| 210 | wxString m_prefix; |
| 211 | }; |
| 212 | #endif // !wxHAS_NATIVE_STDPATHS |
| 213 | |
| 214 | #endif // _WX_STDPATHS_H_ |
| 215 | |