/////////////////////////////////////////////////////////////////////////////
// Name: stdpaths.h
-// Purpose: documentation for wxStandardPaths class
+// Purpose: interface of wxStandardPaths
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
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 standard directories locations, i.e.
- the Windows directory may be named @c W:\Win2003 instead of
- the default @c C:\Windows.
+ the Windows directory may be named @c W:\\Win2003 instead of
+ the default @c C:\\Windows.
- The strings @c @e appname and @c @e username should be
+ The strings @c appname and @c username should be
replaced with the value returned by wxApp::GetAppName
and the name of the currently logged in user, respectively. The string
- @c @e prefix is only used under Unix and is @c /usr/local by
+ @c prefix is only used under Unix and is @c /usr/local by
default but may be changed using wxStandardPaths::SetInstallPrefix.
The directories returned by the methods of this class may or may not exist. If
@library{wxbase}
@category{file}
- @seealso
- wxFileConfig
-*/
+ @see wxFileConfig
+ */
class wxStandardPaths
{
public:
/**
Return the directory containing the system config files.
Example return values:
- Unix: @c /etc
- Windows: @c C:\Documents and Settings\All Users\Application Data
- Mac: @c /Library/Preferences
-
+ - Unix: @c /etc
+ - Windows: @c C:\\Documents @c and @c Settings\\All @c Users\\Application Data
+ - Mac: @c /Library/Preferences
+
@see wxFileConfig
*/
- wxString GetConfigDir();
+ wxString GetConfigDir() const;
/**
Return the location of the applications global, i.e. not user-specific,
data files.
Example return values:
- Unix: @c @e prefix/share/@e appname
- Windows: the directory where the executable file is located
- Mac: @c @e appname.app/Contents/SharedSupport bundle subdirectory
-
+ - Unix: @c prefix/share/appname
+ - Windows: the directory where the executable file is located
+ - Mac: @c appname.app/Contents/SharedSupport bundle subdirectory
+
@see GetLocalDataDir()
*/
- wxString GetDataDir();
+ wxString GetDataDir() const;
/**
Return the directory containing the current user's documents.
Example return values:
- Unix: @c ~ (the home directory)
- Windows: @c C:\Documents and Settings\@e username\Documents
- Mac: @c ~/Documents
- This function is new since wxWidgets version 2.7.0
+ - Unix: @c ~ (the home directory)
+ - Windows: @c C:\\Documents @c and @c Settings\\username\\Documents
+ - Mac: @c ~/Documents
+
+ @since 2.7.0
*/
- wxString GetDocumentsDir();
+ wxString GetDocumentsDir() const;
/**
Return the directory and the filename for the current executable.
Example return values:
- Unix: @c /usr/local/bin/exename
- Windows: @c C:\Programs\AppFolder\exename.exe
- Mac: @c /Programs/exename
+ - Unix: @c /usr/local/bin/exename
+ - Windows: @c C:\\Programs\\AppFolder\\exename.exe
+ - Mac: @c /Programs/exename
*/
- wxString GetExecutablePath();
+ wxString GetExecutablePath() const;
/**
- @b Note: This function is only available under Unix.
+ @note This function is only available under Unix.
Return the program installation prefix, e.g. @c /usr, @c /opt or
@c /home/zeitlin.
- If the prefix had been previously by
- SetInstallPrefix(), returns that
+ If the prefix had been previously by SetInstallPrefix(), returns that
value, otherwise tries to determine it automatically (Linux only right
now) and finally returns the default @c /usr/local value if it failed.
*/
- wxString GetInstallPrefix();
+ wxString GetInstallPrefix() const;
/**
Return the location for application data files which are host-specific and
can't, or shouldn't, be shared with the other machines.
This is the same as GetDataDir() except
- under Unix where it returns @c /etc/@e appname.
+ under Unix where it returns @c /etc/appname.
*/
- wxString GetLocalDataDir();
+ wxString GetLocalDataDir() const;
/**
Return the localized resources directory containing the resource files of the
specified category for the given language.
In general this is just the same as @a lang subdirectory of
- GetResourcesDir() (or
- @c @e lang.lproj under Mac OS X) but is something quite
+ GetResourcesDir() (or @c lang.lproj under Mac OS X) but is something quite
different for message catalog category under Unix where it returns the standard
- @c @e prefix/share/locale/@e lang/LC_MESSAGES directory.
- This function is new since wxWidgets version 2.7.0
+ @c prefix/share/locale/lang/LC_MESSAGES directory.
+
+ @since 2.7.0
*/
wxString GetLocalizedResourcesDir(const wxString& lang,
- ResourceCat category = ResourceCat_None);
+ ResourceCat category = ResourceCat_None) const;
/**
Return the directory where the loadable modules (plugins) live.
Example return values:
- Unix: @c @e prefix/lib/@e appname
- Windows: the directory of the executable file
- Mac: @c @e appname.app/Contents/PlugIns bundle subdirectory
-
+ - Unix: @c prefix/lib/appname
+ - Windows: the directory of the executable file
+ - Mac: @c appname.app/Contents/PlugIns bundle subdirectory
+
@see wxDynamicLibrary
*/
- wxString GetPluginsDir();
+ wxString GetPluginsDir() const;
/**
Return the directory where the application resource files are located. The
This function is the same as GetDataDir() for
all platforms except Mac OS X.
Example return values:
- Unix: @c @e prefix/share/@e appname
- Windows: the directory where the executable file is located
- Mac: @c @e appname.app/Contents/Resources bundle subdirectory
- This function is new since wxWidgets version 2.7.0
-
+ - Unix: @c prefix/share/@e appname
+ - Windows: the directory where the executable file is located
+ - Mac: @c appname.app/Contents/Resources bundle subdirectory
+
+ @since 2.7.0
+
@see GetLocalizedResourcesDir()
*/
- wxString GetResourcesDir();
+ wxString GetResourcesDir() const;
/**
Return the directory for storing temporary files. To create unique temporary
files,
it is best to use wxFileName::CreateTempFileName for correct behaviour when
multiple processes are attempting to create temporary files.
- This function is new since wxWidgets version 2.7.2
+
+ @since 2.7.2
*/
- wxString GetTempDir();
+ wxString GetTempDir() const;
/**
Return the directory for the user config files:
- Unix: @c ~ (the home directory)
- Windows: @c C:\Documents and Settings\@e username\Application Data
- Mac: @c ~/Library/Preferences
+ - Unix: @c ~ (the home directory)
+ - Windows: @c C:\\Documents @c and @c Settings\\username\\Application Data
+ - Mac: @c ~/Library/Preferences
Only use this method if you have a single configuration file to put in this
directory, otherwise GetUserDataDir() is
more appropriate.
*/
- wxString GetUserConfigDir();
+ wxString GetUserConfigDir() const;
/**
Return the directory for the user-dependent application data files:
- Unix: @c ~/.@e appname
- Windows: @c C:\Documents and Settings\@e username\Application Data\@e
- appname
- Mac: @c ~/Library/Application Support/@e appname
+ - Unix: @c ~/.appname
+ - Windows: @c C:\\Documents @c and @c Settings\\username\Application @c Data\appname
+ - Mac: @c ~/Library/Application @c Support/appname
*/
- wxString GetUserDataDir();
+ wxString GetUserDataDir() const;
/**
Return the directory for user data files which shouldn't be shared with
the other machines.
- This is the same as GetUserDataDir() for
- all platforms except Windows where it returns
- @c C:\Documents and Settings\@e username\Local Settings\Application Data\@e
- appname
+ This is the same as GetUserDataDir() for all platforms except Windows where it returns
+ @c C:\\Documents @c and @c Settings\\username\\Local @c Settings\\Application @c Data\appname
*/
- wxString GetUserLocalDataDir();
+ wxString GetUserLocalDataDir() const;
/**
- @b Note: This function is only available under Unix.
+ @note This function is only available under Unix.
Lets wxStandardPaths know about the real program installation prefix on a Unix
system. By default, the value returned by
GetInstallPrefix() is used.
*/
void UseAppInfo(int info);
};
+