wxBORDER_THEME now means 'use an appropriate themed border' on all plaforms

[wxWidgets.git] / docs / latex / wx / filesysh.tex

diff --git a/docs/latex/wx/filesysh.tex b/docs/latex/wx/filesysh.tex
index 397cbd6ccd2ddd7866f614bf74456f8e0dd06c01..5e5dde0980d45ed9eccf1a46b64660b59d69a13d 100644 (file)
--- a/docs/latex/wx/filesysh.tex
+++ b/docs/latex/wx/filesysh.tex
@@ -5,38 +5,52 @@
 
 \section{\class{wxFileSystemHandler}}\label{wxfilesystemhandler}
 
 
 \section{\class{wxFileSystemHandler}}\label{wxfilesystemhandler}
 

-wxFileSystemHandler (or derived classes to be exact) is used
-to access virtual file systems. It's public interface consists
-from two methods: \helpref{CanOpen}{wxfilesystemhandlercanopen}
+Classes derived from wxFileSystemHandler are used
+to access virtual file systems. Its public interface consists
+of two methods: \helpref{CanOpen}{wxfilesystemhandlercanopen} 

 and \helpref{OpenFile}{wxfilesystemhandleropenfile}. 
 and \helpref{OpenFile}{wxfilesystemhandleropenfile}. 

-It provides additional protected methods to simplify process
-of opening the file : GetProtocol, GetLeftLocation, GetRightLocation,
+It provides additional protected methods to simplify the process
+of opening the file: GetProtocol, GetLeftLocation, GetRightLocation,

 GetAnchor, GetMimeTypeFromExt.
 
 Please have a look at \helpref{overview}{fs} if you don't know how locations
 are constructed.
 
 GetAnchor, GetMimeTypeFromExt.
 
 Please have a look at \helpref{overview}{fs} if you don't know how locations
 are constructed.
 

+Also consult \helpref{list of available handlers}{fs}.
+
+\perlnote{In wxPerl, you need to derive your file system handler class
+from Wx::PlFileSystemHandler.}
+

 \wxheading{Notes}
 
 \wxheading{Notes}
 

-\begin{itemize}
+\begin{itemize}\itemsep=0pt

 \item The handlers are shared by all instances of wxFileSystem.
 \item The handlers are shared by all instances of wxFileSystem.

-

 \item wxHTML library provides handlers for local files and HTTP or FTP protocol
 \item wxHTML library provides handlers for local files and HTTP or FTP protocol

-

 \item The {\it location} parameter passed to OpenFile or CanOpen methods
 \item The {\it location} parameter passed to OpenFile or CanOpen methods

-is always {\bf absolute} path. You don't need to check the FS's current path!
+is always an {\bf absolute} path. You don't need to check the FS's current path.

 \end{itemize}
 
 \wxheading{Derived from}
 
 \end{itemize}
 
 \wxheading{Derived from}
 

-wxObject
+\helpref{wxObject}{wxobject}
+
+\wxheading{Include files}
+
+<wx/filesys.h>
+
+\wxheading{Library}
+
+\helpref{wxBase}{librarieslist}

 
 \wxheading{See also}
 
 
 \wxheading{See also}
 

-\helpref{wxFileSystem}{wxfilesystem},
-\helpref{wxFSFile}{wxfsfile},
+\helpref{wxFileSystem}{wxfilesystem}, 
+\helpref{wxFSFile}{wxfsfile}, 

 \helpref{Overview}{fs}
 
 \helpref{Overview}{fs}
 

+\latexignore{\rtfignore{\wxheading{Members}}}
+
+

 \membersection{wxFileSystemHandler::wxFileSystemHandler}\label{wxfilesystemhandlerwxfilesystemhandler}
 
 \func{}{wxFileSystemHandler}{\void}
 \membersection{wxFileSystemHandler::wxFileSystemHandler}\label{wxfilesystemhandlerwxfilesystemhandler}
 
 \func{}{wxFileSystemHandler}{\void}


@@ -47,8 +61,8 @@ Constructor.
 
 \func{virtual bool}{CanOpen}{\param{const wxString\& }{location}}
 
 
 \func{virtual bool}{CanOpen}{\param{const wxString\& }{location}}
 

-Returns TRUE if the handler is able to open this file (this function doesn't
-check whether the file exists or not, it only checks if it knows the protocol).
+Returns true if the handler is able to open this file. This function doesn't
+check whether the file exists or not, it only checks if it knows the protocol.

 Example:
 
 \begin{verbatim}
 Example:
 
 \begin{verbatim}


@@ -58,24 +72,24 @@ bool MyHand::CanOpen(const wxString& location)
 }
 \end{verbatim}
 
 }
 \end{verbatim}
 

-Must be overwriten in derived handlers.
+Must be overridden in derived handlers.

 
 \membersection{wxFileSystemHandler::GetAnchor}\label{wxfilesystemhandlergetanchor}
 
 \constfunc{wxString}{GetAnchor}{\param{const wxString\& }{location}}
 
 
 \membersection{wxFileSystemHandler::GetAnchor}\label{wxfilesystemhandlergetanchor}
 
 \constfunc{wxString}{GetAnchor}{\param{const wxString\& }{location}}
 

-Returns anchor if present in the location.
+Returns the anchor if present in the location.

 See \helpref{wxFSFile}{wxfsfilegetanchor} for details.
 
 See \helpref{wxFSFile}{wxfsfilegetanchor} for details.
 

-Example : GetAnchor("index.htm\#chapter2") == "chapter2"
+Example: GetAnchor("index.htm\#chapter2") == "chapter2"

 
 

-{\bf Note:} anchor is NOT part of left location.
+{\bf Note:} the anchor is NOT part of the left location.

 
 \membersection{wxFileSystemHandler::GetLeftLocation}\label{wxfilesystemhandlergetleftlocation}
 
 \constfunc{wxString}{GetLeftLocation}{\param{const wxString\& }{location}}
 
 
 \membersection{wxFileSystemHandler::GetLeftLocation}\label{wxfilesystemhandlergetleftlocation}
 
 \constfunc{wxString}{GetLeftLocation}{\param{const wxString\& }{location}}
 

-Returns left location string extracted from {\it location}. 
+Returns the left location string extracted from {\it location}. 

 
 Example: GetLeftLocation("file:myzipfile.zip\#zip:index.htm") == "file:myzipfile.zip"
 
 
 Example: GetLeftLocation("file:myzipfile.zip\#zip:index.htm") == "file:myzipfile.zip"
 


@@ -83,8 +97,8 @@ Example: GetLeftLocation("file:myzipfile.zip\#zip:index.htm") == "file:myzipfile
 
 \func{wxString}{GetMimeTypeFromExt}{\param{const wxString\& }{location}}
 
 
 \func{wxString}{GetMimeTypeFromExt}{\param{const wxString\& }{location}}
 

-Returns MIME type based on {\bf extension} of {\it location}. (While wxFSFile::GetMimeType
-returns real MIME type - either extension-based or queried from HTTP)
+Returns the MIME type based on {\bf extension} of {\it location}. (While wxFSFile::GetMimeType
+returns real MIME type - either extension-based or queried from HTTP.)

 
 Example : GetMimeTypeFromExt("index.htm") == "text/html"
 
 
 Example : GetMimeTypeFromExt("index.htm") == "text/html"
 


@@ -92,7 +106,7 @@ Example : GetMimeTypeFromExt("index.htm") == "text/html"
 
 \constfunc{wxString}{GetProtocol}{\param{const wxString\& }{location}}
 
 
 \constfunc{wxString}{GetProtocol}{\param{const wxString\& }{location}}
 

-Returns protocol string extracted from {\it location}. 
+Returns the protocol string extracted from {\it location}. 

 
 Example: GetProtocol("file:myzipfile.zip\#zip:index.htm") == "zip"
 
 
 Example: GetProtocol("file:myzipfile.zip\#zip:index.htm") == "zip"
 


@@ -100,34 +114,28 @@ Example: GetProtocol("file:myzipfile.zip\#zip:index.htm") == "zip"
 
 \constfunc{wxString}{GetRightLocation}{\param{const wxString\& }{location}}
 
 
 \constfunc{wxString}{GetRightLocation}{\param{const wxString\& }{location}}
 

-Returns right location string extracted from {\it location}. 
+Returns the right location string extracted from {\it location}. 

 
 Example : GetRightLocation("file:myzipfile.zip\#zip:index.htm") == "index.htm"
 
 
 Example : GetRightLocation("file:myzipfile.zip\#zip:index.htm") == "index.htm"
 

-
-
-
-
-\membersection{wxFileSystemHandler::FindFirst}\label{wxfilesystemfindfirst}
+\membersection{wxFileSystemHandler::FindFirst}\label{wxfilesystemhandlerfindfirst}

 
 \func{virtual wxString}{FindFirst}{\param{const wxString\& }{wildcard}, \param{int }{flags = 0}}
 
 Works like \helpref{wxFindFirstFile}{wxfindfirstfile}. Returns name of the first
 
 \func{virtual wxString}{FindFirst}{\param{const wxString\& }{wildcard}, \param{int }{flags = 0}}
 
 Works like \helpref{wxFindFirstFile}{wxfindfirstfile}. Returns name of the first

-filename (withing filesystem's current path) that matches {\it wildcard}. {\it flags} may be one of
+filename (within filesystem's current path) that matches {\it wildcard}. {\it flags} may be one of

 wxFILE (only files), wxDIR (only directories) or 0 (both).
 
 wxFILE (only files), wxDIR (only directories) or 0 (both).
 

-This method is only called if \helpref{CanOpen}{wxfilesystemhandlercanopen} returns TRUE.
+This method is only called if \helpref{CanOpen}{wxfilesystemhandlercanopen} returns true.

 
 

-\membersection{wxFileSystemHandler::FindNext}\label{wxfilesystemfindnext}
+\membersection{wxFileSystemHandler::FindNext}\label{wxfilesystemhandlerfindnext}

 
 \func{virtual wxString}{FindNext}{\void}
 
 Returns next filename that matches parameters passed to \helpref{FindFirst}{wxfilesystemfindfirst}.
 
 
 \func{virtual wxString}{FindNext}{\void}
 
 Returns next filename that matches parameters passed to \helpref{FindFirst}{wxfilesystemfindfirst}.
 

-This method is only called if \helpref{CanRead}{wxfilesystemhandlercanread} returns TRUE and FindFirst
-returned non-empty string.
-
-
+This method is only called if \helpref{CanOpen}{wxfilesystemhandlercanopen} returns true and FindFirst
+returned a non-empty string.

 
 \membersection{wxFileSystemHandler::OpenFile}\label{wxfilesystemhandleropenfile}
 
 
 \membersection{wxFileSystemHandler::OpenFile}\label{wxfilesystemhandleropenfile}
 


@@ -135,12 +143,12 @@ returned non-empty string.
 
 Opens the file and returns wxFSFile pointer or NULL if failed.
 
 
 Opens the file and returns wxFSFile pointer or NULL if failed.
 

-Must be overwriten in derived handlers.
+Must be overridden in derived handlers.

 
 \wxheading{Parameters}
 
 \docparam{fs}{Parent FS (the FS from that OpenFile was called). See ZIP handler
 
 \wxheading{Parameters}
 
 \docparam{fs}{Parent FS (the FS from that OpenFile was called). See ZIP handler

-for details how to use it.}
+for details of how to use it.}

 
 \docparam{location}{The {\bf absolute} location of file.}
 
 
 \docparam{location}{The {\bf absolute} location of file.}