X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/0d2b62c57b32dce7e47d2810c85c524a22bd1796..65baafba0e8cd74f2264b7e2f7625ff5bea84864:/docs/latex/wx/stdpaths.tex?ds=sidebyside diff --git a/docs/latex/wx/stdpaths.tex b/docs/latex/wx/stdpaths.tex index a4252831c3..8e1817a43c 100644 --- a/docs/latex/wx/stdpaths.tex +++ b/docs/latex/wx/stdpaths.tex @@ -6,17 +6,13 @@ %% Created: 2004-10-17 %% RCS-ID: $Id$ %% Copyright: (c) 2004 Vadim Zeitlin -%% License: wxWidgets license +%% License: wxWindows license %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{\class{wxStandardPaths}}\label{wxstandardpaths} wxStandardPaths returns the standard locations in the file system and should be -used by the programs to find their data files in a portable way. - -Please note that this is not a real class because object of this type are never -created but more a namespace containing the class methods which are all static, -so to use wxStandardPaths simply call its methods directly. +used by applications 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 @@ -49,15 +45,22 @@ No base class \wxheading{Include files} - + \latexignore{\rtfignore{\wxheading{Members}}} +\membersection{wxStandardPaths::Get}\label{wxstandardpathsget} + +\func{static wxStandardPathsBase\&}{Get}{\void} + +Returns reference to the unique global standard paths object. + + \membersection{wxStandardPaths::GetConfigDir}\label{wxstandardpathsgetconfigdir} -\func{static wxString}{GetConfigDir}{\void} +\func{wxString}{GetConfigDir}{\void} Return the directory containing the system config files. @@ -75,7 +78,7 @@ Example return values: \membersection{wxStandardPaths::GetDataDir}\label{wxstandardpathsgetdatadir} -\func{static wxString}{GetDataDir}{\void} +\func{wxString}{GetDataDir}{\void} Return the location of the applications global, i.e. not user-specific, data files. @@ -83,7 +86,7 @@ data files. Example return values: \begin{itemize} \item Unix: \texttt{\textit{prefix}/share/\textit{appname}} - \item Windows: \texttt{C:$\backslash$Program Files$\backslash$\textit{appname}} + \item Windows: the directory where the executable file is located \item Mac: \texttt{\textit{appname}.app/Contents/SharedSupport} bundle subdirectory \end{itemize} @@ -94,7 +97,7 @@ Example return values: \membersection{wxStandardPaths::GetInstallPrefix}\label{wxstandardpathsgetinstallprefix} -\func{static wxString}{GetInstallPrefix}{\void} +\func{wxString}{GetInstallPrefix}{\void} \textbf{Note: } This function is only available under Unix. @@ -109,7 +112,7 @@ now) and finally returns the default \texttt{/usr/local} value if it failed. \membersection{wxStandardPaths::GetLocalDataDir}\label{wxstandardpathsgetlocaldatadir} -\func{static wxString}{GetLocalDataDir}{\void} +\func{wxString}{GetLocalDataDir}{\void} Return the location for application data files which are host-specific and can't, or shouldn't, be shared with the other machines. @@ -120,7 +123,7 @@ under Unix where it returns \texttt{/etc/\textit{appname}}. \membersection{wxStandardPaths::GetPluginsDir}\label{wxstandardpathsgetpluginsdir} -\func{static wxString}{GetPluginsDir}{\void} +\func{wxString}{GetPluginsDir}{\void} Return the directory where the loadable modules (plugins) live. @@ -138,12 +141,12 @@ Example return values: \membersection{wxStandardPaths::GetUserConfigDir}\label{wxstandardpathsgetuserconfigdir} -\func{static wxString}{GetUserConfigDir}{\void} +\func{wxString}{GetUserConfigDir}{\void} Return the directory for the user config files: \begin{itemize} \item Unix: \tt{~} (the home directory) - \item Windows: \tt{C:\\Documents and Settings\\\textit{username}} + \item Windows: \tt{C:$\backslash$Documents and Settings$\backslash$\textit{username}} \item Mac: \tt{~/Library/Preferences} \end{itemize} @@ -154,19 +157,19 @@ more appropriate. \membersection{wxStandardPaths::GetUserDataDir}\label{wxstandardpathsgetuserdatadir} -\func{static wxString}{GetUserDataDir}{\void} +\func{wxString}{GetUserDataDir}{\void} Return the directory for the user-dependent application data files: \begin{itemize} \item Unix: \tt{~/.\textit{appname}} - \item Windows: \tt{C:\\Documents and Settings\\\textit{username}\\Application Data\\\textit{appname}} + \item Windows: \tt{C:$\backslash$Documents and Settings$\backslash$\textit{username}$\backslash$Application Data$\backslash$\textit{appname}} \item Mac: \tt{~/Library/Application Support/\textit{appname}} \end{itemize} \membersection{wxStandardPaths::GetUserLocalDataDir}\label{wxstandardpathsgetuserlocaldatadir} -\func{static wxString}{GetUserLocalDataDir}{\void} +\func{wxString}{GetUserLocalDataDir}{\void} Return the directory for user data files which shouldn't be shared with the other machines. @@ -178,9 +181,9 @@ all platforms except Windows where it returns \membersection{wxStandardPaths::SetInstallPrefix}\label{wxstandardpathssetinstallprefix} -\func{static void}{SetInstallPrefix}{\param{const wxString\& }{prefix}} +\func{void}{SetInstallPrefix}{\param{const wxString\& }{prefix}} -\textbf{Note: } This function is only available under Unix. +\textbf{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