revised st*.h headers
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56148 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
@@ -16,17 +16,16 @@
|
||||
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 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 prefix is only used under Unix and is @c /usr/local by
|
||||
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 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
|
||||
they don't exist, it's up to the caller to create them, wxStandardPaths doesn't
|
||||
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.
|
||||
|
||||
Finally note that these functions only work with standardly packaged
|
||||
@@ -37,15 +36,15 @@
|
||||
This class is MT-safe: its methods may be called concurrently from different
|
||||
threads without additional locking.
|
||||
|
||||
Note that you don't allocate an instance of class wxStandardPaths, but retrieve the
|
||||
global standard paths object using @c wxStandardPaths::Get on which you call the
|
||||
Note that you don't allocate an instance of class wxStandardPaths, but retrieve the
|
||||
global standard paths object using @c wxStandardPaths::Get on which you call the
|
||||
desired methods.
|
||||
|
||||
@library{wxbase}
|
||||
@category{file}
|
||||
|
||||
@see wxFileConfig
|
||||
*/
|
||||
*/
|
||||
class wxStandardPaths
|
||||
{
|
||||
public:
|
||||
@@ -57,9 +56,9 @@ public:
|
||||
/**
|
||||
Return the directory containing the system config files.
|
||||
Example return values:
|
||||
- Unix: @c /etc
|
||||
- Windows: @c C:\\Documents @c and @c Settings\\All @c Users\\Application Data
|
||||
- Mac: @c /Library/Preferences
|
||||
- Unix: @c /etc
|
||||
- Windows: @c "C:\Documents and Settings\All Users\Application Data"
|
||||
- Mac: @c /Library/Preferences
|
||||
|
||||
@see wxFileConfig
|
||||
*/
|
||||
@@ -69,9 +68,9 @@ public:
|
||||
Return the location of the applications global, i.e. not user-specific,
|
||||
data files.
|
||||
Example return values:
|
||||
- Unix: @c prefix/share/appname
|
||||
- Windows: the directory where the executable file is located
|
||||
- Mac: @c 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()
|
||||
*/
|
||||
@@ -80,9 +79,9 @@ public:
|
||||
/**
|
||||
Return the directory containing the current user's documents.
|
||||
Example return values:
|
||||
- Unix: @c ~ (the home directory)
|
||||
- Windows: @c C:\\Documents @c and @c Settings\\username\\My Documents
|
||||
- Mac: @c ~/Documents
|
||||
- Unix: @c ~ (the home directory)
|
||||
- Windows: @c "C:\Documents and Settings\username\My Documents"
|
||||
- Mac: @c ~/Documents
|
||||
|
||||
@since 2.7.0
|
||||
*/
|
||||
@@ -91,36 +90,38 @@ public:
|
||||
/**
|
||||
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
|
||||
*/
|
||||
virtual wxString GetExecutablePath() const;
|
||||
|
||||
/**
|
||||
@note This function is only available under Unix.
|
||||
Return the program installation prefix, e.g. @c /usr, @c /opt or
|
||||
@c /home/zeitlin.
|
||||
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
|
||||
value, otherwise tries to determine it automatically (Linux only right
|
||||
now) and finally returns the default @c /usr/local value if it failed.
|
||||
value, otherwise tries to determine it automatically (Linux only right now)
|
||||
and finally returns the default @c /usr/local value if it failed.
|
||||
|
||||
@note This function is only available under Unix.
|
||||
*/
|
||||
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/appname.
|
||||
|
||||
This is the same as GetDataDir() except under Unix where it returns @c /etc/appname.
|
||||
*/
|
||||
virtual 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 lang.lproj under Mac OS X) but is something quite
|
||||
different for message catalog category under Unix where it returns the standard
|
||||
|
||||
In general this is just the same as @a lang subdirectory of 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 prefix/share/locale/lang/LC_MESSAGES directory.
|
||||
|
||||
@since 2.7.0
|
||||
@@ -131,24 +132,25 @@ public:
|
||||
/**
|
||||
Return the directory where the loadable modules (plugins) live.
|
||||
Example return values:
|
||||
- Unix: @c prefix/lib/appname
|
||||
- Windows: the directory of the executable file
|
||||
- Mac: @c 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
|
||||
*/
|
||||
virtual wxString GetPluginsDir() const;
|
||||
|
||||
/**
|
||||
Return the directory where the application resource files are located. The
|
||||
resources are the auxiliary data files needed for the application to run and
|
||||
include, for example, image and sound files it might use.
|
||||
This function is the same as GetDataDir() for
|
||||
all platforms except Mac OS X.
|
||||
Return the directory where the application resource files are located.
|
||||
|
||||
The resources are the auxiliary data files needed for the application to run
|
||||
and include, for example, image and sound files it might use.
|
||||
|
||||
This function is the same as GetDataDir() for all platforms except Mac OS X.
|
||||
Example return values:
|
||||
- Unix: @c prefix/share/@e appname
|
||||
- Windows: the directory where the executable file is located
|
||||
- Mac: @c appname.app/Contents/Resources bundle subdirectory
|
||||
- Unix: @c prefix/share/appname
|
||||
- Windows: the directory where the executable file is located
|
||||
- Mac: @c appname.app/Contents/Resources bundle subdirectory
|
||||
|
||||
@since 2.7.0
|
||||
|
||||
@@ -157,10 +159,9 @@ public:
|
||||
virtual 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.
|
||||
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.
|
||||
|
||||
@since 2.7.2
|
||||
*/
|
||||
@@ -168,40 +169,42 @@ public:
|
||||
|
||||
/**
|
||||
Return the directory for the user config files:
|
||||
- Unix: @c ~ (the home directory)
|
||||
- Windows: @c C:\\Documents @c and @c Settings\\username\\Application Data
|
||||
- Mac: @c ~/Library/Preferences
|
||||
- Unix: @c ~ (the home directory)
|
||||
- Windows: @c "C:\Documents and 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.
|
||||
directory, otherwise GetUserDataDir() is more appropriate.
|
||||
*/
|
||||
virtual wxString GetUserConfigDir() const;
|
||||
|
||||
/**
|
||||
Return the directory for the user-dependent application data files:
|
||||
- Unix: @c ~/.appname
|
||||
- Windows: @c C:\\Documents @c and @c Settings\\username\\Application @c Data\\appname
|
||||
- Mac: @c ~/Library/Application @c Support/appname
|
||||
- Unix: @c ~/.appname
|
||||
- Windows: @c "C:\Documents and Settings\username\Application Data\appname"
|
||||
- Mac: @c "~/Library/Application Support/appname"
|
||||
*/
|
||||
virtual 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 @c and @c Settings\\username\\Local @c Settings\\Application @c Data\\appname
|
||||
@c "C:\Documents and Settings\username\Local Settings\Application Data\appname"
|
||||
*/
|
||||
virtual wxString GetUserLocalDataDir() const;
|
||||
|
||||
/**
|
||||
@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.
|
||||
system. By default, the value returned by GetInstallPrefix() is used.
|
||||
|
||||
Although under Linux systems the program prefix may usually be determined
|
||||
automatically, portable programs should call this function. Usually the prefix
|
||||
is set during program configuration if using GNU autotools and so it is enough
|
||||
to pass its value defined in @c config.h to this function.
|
||||
|
||||
@note This function is only available under Unix.
|
||||
*/
|
||||
void SetInstallPrefix(const wxString& prefix);
|
||||
|
||||
@@ -209,10 +212,11 @@ public:
|
||||
Controls what application information is used when constructing paths that
|
||||
should be unique to this program, such as the application data directory, the
|
||||
plugins directory on Unix, etc.
|
||||
Valid values for @a info are @c AppInfo_None and either one or
|
||||
combination of @c AppInfo_AppName and @c AppInfo_VendorName. The
|
||||
first one tells this class to not use neither application nor vendor name in
|
||||
the paths.
|
||||
|
||||
Valid values for @a info are @c AppInfo_None and either one or combination
|
||||
of @c AppInfo_AppName and @c AppInfo_VendorName. The first one tells this
|
||||
class to not use neither application nor vendor name in the paths.
|
||||
|
||||
By default, only the application name is used under Unix systems but both
|
||||
application and vendor names are used under Windows and Mac.
|
||||
*/
|
||||
|
||||
Reference in New Issue
Block a user