dcbd177f06
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@29489 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
86 lines
2.5 KiB
TeX
86 lines
2.5 KiB
TeX
\section{\class{wxPathList}}\label{wxpathlist}
|
|
|
|
The path list is a convenient way of storing a number of directories, and
|
|
when presented with a filename without a directory, searching for an existing file
|
|
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.
|
|
|
|
\wxheading{Derived from}
|
|
|
|
\helpref{wxList}{wxlist}\\
|
|
\helpref{wxObject}{wxobject}
|
|
|
|
\wxheading{Include files}
|
|
|
|
<wx/filefn.h>
|
|
|
|
\wxheading{See also}
|
|
|
|
\helpref{wxList}{wxlist}
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
|
|
\membersection{wxPathList::wxPathList}\label{wxpathlistctor}
|
|
|
|
\func{}{wxPathList}{\void}
|
|
|
|
Constructor.
|
|
|
|
|
|
\membersection{wxPathList::AddEnvList}\label{wxpathlistaddenvlist}
|
|
|
|
\func{void}{AddEnvList}{\param{const wxString\& }{env\_variable}}
|
|
|
|
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}\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
|
|
\helpref{wxPathList::Member()}{wxpathlistmember} for this).
|
|
|
|
|
|
\membersection{wxPathList::EnsureFileAccessible}\label{wxpathlistensurefileaccessible}
|
|
|
|
\func{void}{EnsureFileAccessible}{\param{const wxString\& }{filename}}
|
|
|
|
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}\label{wxpathlistfindabsolutepath}
|
|
|
|
\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 wasn't found, an empty
|
|
string is returned.
|
|
|
|
|
|
\membersection{wxPathList::FindValidPath}\label{wxpathlistfindvalidpath}
|
|
|
|
\func{wxString}{FindValidPath}{\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 wasn't found, an empty string
|
|
is returned. This path may be relative to the current working directory.
|
|
|
|
|
|
\membersection{wxPathList::Member}\label{wxpathlistmember}
|
|
|
|
\func{bool}{Member}{\param{const wxString\& }{file}}
|
|
|
|
true if the path is in the path list (ignoring case).
|
|
|