Notice that in the examples below the string @c appinfo may be either just
the application name (as returned by wxApp::GetAppName()) or a combination
of the vendor name (wxApp::GetVendorName()) and the application name, with
- a path separator between them. By default, the vendor name is used under
- Windows and OS X but not under other Unix systems, see UseAppInfo().
+ a path separator between them. By default, only the application name is
+ used, use UseAppInfo() to change this.
The other placeholders should be self-explanatory: the string @c username
should be replaced with the value the name of the currently logged in user.
/**
Return the location of the applications global, i.e. not user-specific,
data files.
+
Example return values:
- Unix: @c prefix/share/appinfo
- Windows: the directory where the executable file is located
- Mac: @c appinfo.app/Contents/SharedSupport bundle subdirectory
+ Under Unix (only) it is possible to override the default value returned
+ from this function by setting the value of @c WX_APPNAME_DATA_DIR
+ environment variable to the directory to use (where @c APPNAME is the
+ upper-cased value of wxApp::GetAppName()). This is useful in order to
+ be able to run applications using this function without installing them
+ as you can simply set this environment variable to the source directory
+ location to allow the application to find its files there.
+
@see GetLocalDataDir()
*/
virtual wxString GetDataDir() const;
used combined with AppInfo_AppName, i.e. as @code AppInfo_AppName |
AppInfo_VendorName @endcode
- By default, only the application name is used under Unix systems but both
- application and vendor names are used under Windows and Mac.
+ By default, only the application name is used.
@since 2.9.0
*/