X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/f3845e889c7ccfe03d034a0aa79b4f4d19fbcb06..6b30a44ed0be21bd0cf26f609d4ca50fb8b965c0:/docs/latex/wx/dirtrav.tex diff --git a/docs/latex/wx/dirtrav.tex b/docs/latex/wx/dirtrav.tex index 6def4ad3c8..aaeac23c7a 100644 --- a/docs/latex/wx/dirtrav.tex +++ b/docs/latex/wx/dirtrav.tex @@ -6,7 +6,7 @@ %% Created: 14.01.02 (extracted from dir.tex) %% RCS-ID: $Id$ %% Copyright: (c) Vadim Zeitlin -%% License: wxWindows license +%% License: wxWidgets license %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{\class{wxDirTraverser}}\label{wxdirtraverser} @@ -71,21 +71,36 @@ enum wxDirTraverseResult \latexignore{\rtfignore{\wxheading{Members}}} +\membersection{wxDirTraverser::OnDir}\label{wxdirtraverserondir} + +\func{virtual wxDirTraverseResult}{OnDir}{\param{const wxString\& }{dirname}} + +This function is called for each directory. It may return {\tt wxSIR\_STOP} +to abort traversing completely, {\tt wxDIR\_IGNORE} to skip this directory but +continue with others or {\tt wxDIR\_CONTINUE} to enumerate all files and +subdirectories in this directory. + +This is a pure virtual function and must be implemented in the derived class. + \membersection{wxDirTraverser::OnFile}\label{wxdirtraverseronfile} -\func{virtual wxDirTraverseResult}{OnFile}{\param{const wxString& }{filename}} +\func{virtual wxDirTraverseResult}{OnFile}{\param{const wxString\& }{filename}} This function is called for each file. It may return {\tt wxDIR\_STOP} to abort traversing (for example, if the file being searched is found) or {\tt wxDIR\_CONTINUE} to proceed. -\membersection{wxDirTraverser::OnDir}\label{wxdirtraverserondir} +This is a pure virtual function and must be implemented in the derived class. -\func{virtual wxDirTraverseResult}{OnDir}{\param{const wxString& }{dirname}} +\membersection{wxOpenErrorTraverser::OnOpenError}\label{wxopenerrortraverseronopenerror} -This function is called for each directory. It may return {\tt wxSIR\_STOP} -to abort traversing completely, {\tt wxDIR\_IGNORE} to skip this directory but -continue with others or {\tt wxDIR\_CONTINUE} to enumerate all files and -subdirectories in this directory. +\func{virtual wxOpenErrorTraverseResult}{OnOpenError}{\param{const wxString\& }{openerrorname}} + +This function is called for each directory which we failed to open for +enumerating. It may return {\tt wxSIR\_STOP} to abort traversing completely, +{\tt wxDIR\_IGNORE} to skip this directory but continue with others or +{\tt wxDIR\_CONTINUE} to retry opening this directory once again. + +The base class version always returns {\tt wxDIR\_IGNORE}.