X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/11b63f34f8c2a08e9b5246f7239792fb22048d97..db23ced86782a4323272cea8bd499d2e4aeabfce:/docs/latex/wx/fsfile.tex diff --git a/docs/latex/wx/fsfile.tex b/docs/latex/wx/fsfile.tex index 0fcebe2c44..0f24e1a37b 100644 --- a/docs/latex/wx/fsfile.tex +++ b/docs/latex/wx/fsfile.tex @@ -3,34 +3,37 @@ % fsfile.tex at 21/Mar/99 23:00:52 % - \section{\class{wxFSFile}}\label{wxfsfile} -This class represents single file opened by \helpref{wxFileSystem}{wxfilesystem}. -It provides more information than wx's input stream +This class represents a single file opened by \helpref{wxFileSystem}{wxfilesystem}. +It provides more information than wxWindow's input stream (stream, filename, mime type, anchor). -{\bf Note:} Any pointer returned by wxFSFile's member is valid -only as long as wxFSFile object exits. For example call to GetStream() +{\bf Note:} Any pointer returned by a method of wxFSFile is valid +only as long as the wxFSFile object exists. For example a call to GetStream() doesn't {\it create} the stream but only returns the pointer to it. In -other words after 10 calls to GetStream() you'll obtain ten identical +other words after 10 calls to GetStream() you will have obtained ten identical pointers. \wxheading{Derived from} -wxObject +\helpref{wxObject}{wxobject} + +\wxheading{Include files} + + \wxheading{See Also} \helpref{wxFileSystemHandler}{wxfilesystemhandler}, -\helpref{wxFileSystem}{wxfilesystem}, +\helpref{wxFileSystem}{wxfilesystem}, \helpref{Overview}{fs} \latexignore{\rtfignore{\wxheading{Members}}} \membersection{wxFSFile::wxFSFile}\label{wxfsfilewxfsfile} -\func{}{wxFSFile}{\param{wxInputStream }{*stream}, \param{const wxString\& }{loc}, \param{const wxString\& }{mimetype}, \param{const wxString\& }{anchor}} +\func{}{wxFSFile}{\param{wxInputStream }{*stream}, \param{const wxString\& }{loc}, \param{const wxString\& }{mimetype}, \param{const wxString\& }{anchor}, \param{wxDateTime }{modif}} Constructor. You probably won't use it. See Notes for details. @@ -40,21 +43,23 @@ Constructor. You probably won't use it. See Notes for details. \docparam{location}{The full location (aka filename) of the file} -\docparam{mimetype}{MIME type of this file. Mime type is either extension-based or HTTP Content-Type} +\docparam{mimetype}{MIME type of this file. It may be left empty, in which +case the type will be determined from file's extension (\arg{location} must +not be empty in this case).} \docparam{anchor}{Anchor. See \helpref{GetAnchor()}{wxfsfilegetanchor} for details.} -If you aren't sure what do these params mean see description of GetXXXX() +If you are not sure of the meaning of these params, see the description of the GetXXXX() functions. \wxheading{Notes} -It is never used by end user but you'll need it if -you're writing own virtual FS. For example you may need something -similar to wxMemoryInputStream but because wxMemoryInputStream -doesn't free the memory when destroyed and thus passing memory stream +It is seldom used by the application programmer but you will need it if +you are writing your own virtual FS. For example you may need something +similar to wxMemoryInputStream, but because wxMemoryInputStream +doesn't free the memory when destroyed and thus passing a memory stream pointer into wxFSFile constructor would lead to memory leaks, you -can write your own class derived from wxFSFile : +can write your own class derived from wxFSFile: \begin{verbatim} class wxMyFSFile : public wxFSFile @@ -68,24 +73,33 @@ class wxMyFSFile : public wxFSFile }; \end{verbatim} -\membersection{wxFSFile::GetStream}\label{wxfsfilegetstream} +\membersection{wxFSFile::DetachStream}\label{wxfsfiledetachstream} -\constfunc{wxInputStream*}{GetStream}{\void} +\func{void}{DetachStream}{\void} -Returns pointer to the stream. You can use the returned -stream to directly access data. You may suppose -that the stream provide Seek and GetSize functionality -(even in case of HTTP protocol which doesn't provide -this by default. wxHtml is using local cache to workaround -this and to speed up connection) +Detaches the stream from the wxFSFile object. That is, the +stream obtained with {\tt GetStream()} will continue its existance +after the wxFSFile object is deleted. You will have to delete +the stream yourself. -\membersection{wxFSFile::GetMimeType}\label{wxfsfilegetmimetype} +\membersection{wxFSFile::GetAnchor}\label{wxfsfilegetanchor} -\constfunc{const wxString\&}{GetMimeType}{\void} +\constfunc{const wxString\&}{GetAnchor}{\void} -Returns MIME type of the content of this file. It is either -extension-based (see wxMimeTypesManager) or extracted from -HTTP protocol Content-Type header. +Returns anchor (if present). The term of {\bf anchor} can be easily +explained using few examples: + +\begin{verbatim} +index.htm#anchor /* 'anchor' is anchor */ +index/wx001.htm /* NO anchor here! */ +archive/main.zip#zip:index.htm#global /* 'global' */ +archive/main.zip#zip:index.htm /* NO anchor here! */ +\end{verbatim} + +Usually an anchor is presented only if the MIME type is 'text/html'. +But it may have some meaning with other files; +for example myanim.avi\#200 may refer to position in animation +or reality.wrl\#MyView may refer to a predefined view in VRML. \membersection{wxFSFile::GetLocation}\label{wxfsfilegetlocation} @@ -95,28 +109,34 @@ Returns full location of the file, including path and protocol. Examples : \begin{verbatim} -http://www.wxwindows.org +http://www.wxwidgets.org http://www.ms.mff.cuni.cz/~vsla8348/wxhtml/archive.zip#zip:info.txt file:/home/vasek/index.htm relative-file.htm \end{verbatim} +\membersection{wxFSFile::GetMimeType}\label{wxfsfilegetmimetype} -\membersection{wxFSFile::GetAnchor}\label{wxfsfilegetanchor} +\constfunc{const wxString\&}{GetMimeType}{\void} -\constfunc{const wxString\&}{GetAnchor}{\void} +Returns the MIME type of the content of this file. It is either +extension-based (see wxMimeTypesManager) or extracted from +HTTP protocol Content-Type header. -Returns anchor (if present). The term of {\bf anchor} can be easily -explained using few examples: +\membersection{wxFSFile::GetModificationTime}\label{wxfsfilegetmodificationtime} -\begin{verbatim} -index.htm#anchor /* 'anchor' is anchor */ -index/wx001.htm /* NO anchor here! */ -archive/main.zip#zip:index.htm#global /* 'global' */ -archive/main.zip#zip:index.htm /* NO anchor here! */ -\end{verbatim} +\constfunc{wxDateTime}{GetModificationTime}{\void} + +Returns time when this file was modified. + +\membersection{wxFSFile::GetStream}\label{wxfsfilegetstream} + +\constfunc{wxInputStream*}{GetStream}{\void} + +Returns pointer to the stream. You can use the returned +stream to directly access data. You may suppose +that the stream provide Seek and GetSize functionality +(even in the case of the HTTP protocol which doesn't provide +this by default. wxHtml uses local cache to work around +this and to speed up the connection). -Usually anchor is presented only if mime type is 'text/html'. -But it may have some meaning with other files -(for example myanim.avi\#200 may refer to position in animation -or reality.wrl\#MyView may refer to predefined view in VRML)