%newgroup
DocStr(wxStandardPaths,
-"wx.StandardPaths returns the standard locations in the file system and
-should be used by the programs to find their data files in a portable
-way.
+"wx.StandardPaths returns standard locations in the file system and
+should be used by programs to find their data files in a portable way.
In the description of the methods below, the example return values are
given for the Unix, Windows and Mac OS X systems, however please note
-that these are just the examples and the actual values may differ. For
-example, under Windows: the system administrator may change the
+that these are just examples and the actual values may differ. For
+example, under Windows the system administrator may change the
standard directories locations, i.e. the Windows directory may be
named W:\Win2003 instead of the default C:\Windows.
The directories returned by the methods of this class may or may not
exist. If they don't exist, it's up to the caller to create them,
-wxStandardPaths doesn't do it.
+wx.StandardPaths doesn't do it.
Finally note that these functions only work with standardly packaged
applications. I.e. under Unix you should follow the standard
class wxStandardPaths
{
public:
-
- DocDeclStr(
- static wxStandardPaths& , Get(),
- "Return the global standard paths object", "");
+ // possible resources categorires
+ enum ResourceCat
+ {
+ // no special category
+ ResourceCat_None,
+
+ // message catalog resources
+ ResourceCat_Messages,
+
+ // end of enum marker
+ ResourceCat_Max
+ };
+
+ DocStr(
+ Get,
+ "Return the global standard paths singleton", "");
+ %extend {
+ static wxStandardPaths* Get() {
+ return (wxStandardPaths*) &wxStandardPaths::Get();
+ }
+ }
+
+
DocDeclStr(
virtual wxString , GetConfigDir() const,
"Return the directory with system config files: /etc under Unix,
-c:\Documents and Settings\All Users\Application Data under Windows,
+'c:\\Documents and Settings\\All Users\\Application Data' under Windows,
/Library/Preferences for Mac", "");
DocDeclStr(
virtual wxString , GetUserConfigDir() const,
"Return the directory for the user config files: $HOME under Unix,
-c:\Documents and Settings\username under Windows,
+'c:\\Documents and Settings\\username' under Windows, and
~/Library/Preferences under Mac
Only use this if you have a single file to put there, otherwise
virtual wxString , GetDataDir() const,
"Return the location of the application's global, (i.e. not
user-specific,) data files: prefix/share/appname under Unix,
-c:\Program Files\appname under Windows,
+'c:\\Program Files\\appname' under Windows,
appname.app/Contents/SharedSupport app bundle directory under Mac.", "");
DocDeclStr(
virtual wxString , GetUserDataDir() const,
"Return the directory for the user-dependent application data files:
-$HOME/.appname under Unix, c:\Documents and
-Settings\username\Application Data\appname under Windows and
+$HOME/.appname under Unix, c:\\Documents and
+Settings\\username\\Application Data\\appname under Windows and
~/Library/Application Support/appname under Mac", "");
with the other machines
Same as `GetUserDataDir` for all platforms except Windows where it is
-the 'Local Settings\Application Data\appname' directory.", "");
+the 'Local Settings\\Application Data\\appname' directory.", "");
DocDeclStr(
prefix/lib/appname under Unix, program directory under Windows and
Contents/Plugins app bundle subdirectory under Mac", "");
-
-#ifdef __WXGTK__
+
+ // get resources directory: resources are auxiliary files used by the
+ // application and include things like image and sound files
+ //
+ // same as GetDataDir() for all platforms except Mac where it returns
+ // Contents/Resources subdirectory of the app bundle
DocDeclStr(
- void , SetInstallPrefix(const wxString& prefix),
- "Set the program installation directory which is /usr/local by default.
-This value will be used by other methods such as `GetDataDir` and
-`GetPluginsDir` as the prefix for what they return. (Unix only.)", "");
+ virtual wxString , GetResourcesDir() const,
+ "Get resources directory. Resources are auxiliary files used by the
+application and include things like image and sound files.
+
+Same as `GetDataDir` for all platforms except Mac where it returns
+Contents/Resources subdirectory of the app bundle.", "");
DocDeclStr(
- wxString , GetInstallPrefix() const,
- "Get the program installation prefix. (Unix only.)", "");
+ virtual wxString ,
+ GetLocalizedResourcesDir(const wxString& lang,
+ ResourceCat category = ResourceCat_None) const,
+ "Get localized resources directory containing the resource files of the
+specified category for the given language.
+
+In general this is just GetResourcesDir()/lang under Windows and Unix
+and GetResourcesDir()/lang.lproj under Mac but is something quite
+different under Unix for the message catalog category (namely the
+standard prefix/share/locale/lang/LC_MESSAGES.)", "");
+
+ DocDeclStr(
+ virtual wxString , GetDocumentsDir() const,
+ "Return the Documents directory for the current user.
+
+C:\Documents and Settings\username\Documents under Windows,
+$HOME under Unix and ~/Documents under Mac", "");
+
+
+
+ DocStr(SetInstallPrefix,
+ "Set the program installation directory which is /usr/local by default.
+This value will be used by other methods such as `GetDataDir` and
+`GetPluginsDir` as the prefix for what they return. (This function
+only has meaning on Unix systems.)", "");
+
+ DocStr(GetInstallPrefix,
+ "Get the program installation prefix. The default is the prefix where
+Python is installed. (This function only has meaning on Unix systems.)", "");
+
+#ifdef __WXGTK__
+ void SetInstallPrefix(const wxString& prefix);
+ wxString GetInstallPrefix() const;
#else
%extend {
void SetInstallPrefix(const wxString& prefix) {}
projects / wxWidgets.git / blobdiff