]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/pathlist.tex
wxPlatformInfo::IsUsingUniversalWidgets() was broken by design, it couldn't work...
[wxWidgets.git] / docs / latex / wx / pathlist.tex
index 82fdc7c662c9fc6934a5afbfdc817b55d1d18a2e..b74547fea16b9608aa761c082ae72bd70e455c93 100644 (file)
@@ -6,13 +6,12 @@ in those directories.  Storing the filename only in an application's files and
 using a locally-defined list of directories makes the application and its files more
 portable.
 
-Use the {\it wxFileNameFromPath} global function to extract the filename
-from the path.
+Use the \helpref{wxFileName::SplitPath}{wxfilenamesplitpath} global function 
+to extract the filename from the path.
 
 \wxheading{Derived from}
 
-\helpref{wxList}{wxlist}\\
-\helpref{wxObject}{wxobject}
+\helpref{wxArrayString}{wxarraystring}
 
 \wxheading{Include files}
 
@@ -20,17 +19,23 @@ from the path.
 
 \wxheading{See also}
 
-\helpref{wxList}{wxlist}
+\helpref{wxArrayString}{wxarraystring}
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxPathList::wxPathList}
+
+\membersection{wxPathList::wxPathList}\label{wxpathlistctor}
 
 \func{}{wxPathList}{\void}
 
-Constructor.
+Empty constructor.
+
+\func{}{wxPathList}{\param{const wxArrayString\& }{arr}}
+
+Constructs the object calling the \helpref{Add}{wxpathlistadd} function.
+
 
-\membersection{wxPathList::AddEnvList}
+\membersection{wxPathList::AddEnvList}\label{wxpathlistaddenvlist}
 
 \func{void}{AddEnvList}{\param{const wxString\& }{env\_variable}}
 
@@ -38,15 +43,20 @@ Finds the value of the given environment variable, and adds all paths
 to the path list. Useful for finding files in the PATH variable, for
 example.
 
-\membersection{wxPathList::Add}
+
+\membersection{wxPathList::Add}\label{wxpathlistadd}
 
 \func{void}{Add}{\param{const wxString\& }{path}}
 
-Adds the given directory to the path list, but does not
-check if the path was already on the list (use wxPathList::Member)
-for this).
+\func{void}{Add}{\param{const wxArrayString\& }{arr}}
+
+The first form adds the given directory (the filename if present is removed)
+to the path list, if the path is not already in the list.
+
+The second form just calls the first form on all elements of the given array.
 
-\membersection{wxPathList::EnsureFileAccessible}
+
+\membersection{wxPathList::EnsureFileAccessible}\label{wxpathlistensurefileaccessible}
 
 \func{void}{EnsureFileAccessible}{\param{const wxString\& }{filename}}
 
@@ -54,26 +64,21 @@ Given a full filename (with path), ensures that files in the same path
 can be accessed using the pathlist. It does this by stripping the
 filename and adding the path to the list if not already there.
 
-\membersection{wxPathList::FindAbsoluteValidPath}
-
-\func{wxString}{FindAbsoluteValidPath}{\param{const wxString\& }{file}}
-
-Searches for a full path for an existing file by appending {\it file} to
-successive members of the path list.  If the file exists, a temporary
-pointer to the absolute path is returned.
 
-\membersection{wxPathList::FindValidPath}
+\membersection{wxPathList::FindAbsoluteValidPath}\label{wxpathlistfindabsolutepath}
 
-\func{wxString}{FindValidPath}{\param{const wxString\& }{file}}
+\constfunc{wxString}{FindAbsoluteValidPath}{\param{const wxString\& }{file}}
 
 Searches for a full path for an existing file by appending {\it file} to
-successive members of the path list.  If the file exists, a temporary
-pointer to the full path is returned. This path may be relative to the current
-working directory.
+successive members of the path list.  If the file wasn't found, an empty
+string is returned.
+
 
-\membersection{wxPathList::Member}
+\membersection{wxPathList::FindValidPath}\label{wxpathlistfindvalidpath}
 
-\func{bool}{Member}{\param{const wxString\& }{file}}
+\constfunc{wxString}{FindValidPath}{\param{const wxString\& }{file}}
 
-TRUE if the path is in the path list (ignoring case).
+Searches for a full path for an existing file by appending {\it file} to
+successive members of the path list.  If the file wasn't found, an empty string
+is returned. This path may be relative to the current working directory.