X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/704a4b7524e05d7bf4d208eb1b30be9989abef4c..7b4b24bca94555afc29762acfc5b100009bb29ff:/docs/latex/wx/httag.tex diff --git a/docs/latex/wx/httag.tex b/docs/latex/wx/httag.tex index 40b1da9983..c919c4011d 100644 --- a/docs/latex/wx/httag.tex +++ b/docs/latex/wx/httag.tex @@ -3,121 +3,143 @@ % htmltag.tex at 14/Mar/99 20:13:37 % - \section{\class{wxHtmlTag}}\label{wxhtmltag} -This class represents single HTML tag. +This class represents a single HTML tag. It is used by \helpref{tag handlers}{handlers}. - \wxheading{Derived from} wxObject -\latexignore{\rtfignore{\wxheading{Members}}} +\wxheading{Include files} + + +\latexignore{\rtfignore{\wxheading{Members}}} \membersection{wxHtmlTag::wxHtmlTag}\label{wxhtmltagwxhtmltag} -\func{}{wxHtmlTag}{\param{const wxString\& }{source}, \param{int }{pos}, \param{int }{end\_pos}, \param{wxHtmlTagsCache* }{cache}} +\func{}{wxHtmlTag}{\param{wxHtmlTag *}{parent}, \param{const wxString\& }{source}, +\param{int }{pos}, \param{int }{end\_pos}, +\param{wxHtmlTagsCache* }{cache}, \param{wxHtmlEntitiesParser *}{entParser}} -Constructor. You'll probably never have to construct wxHtmlTag object -yourself. Feel free to ignore the constructor parameters... -(have a look at lib/htmlparser.cpp if you're interested in creating it) +Constructor. You will probably never have to construct a wxHtmlTag object +yourself. Feel free to ignore the constructor parameters. +Have a look at src/html/htmlpars.cpp if you're interested in creating it. -\membersection{wxHtmlTag::GetName}\label{wxhtmltaggetname} +\membersection{wxHtmlTag::GetAllParams}\label{wxhtmltaggetallparams} -\constfunc{wxString}{GetName}{\void} +\constfunc{const wxString\&}{GetAllParams}{\void} -Returns tag's name. The name is always in uppercase and it doesn't contain -'<' or '/' characters. (So the name of {\tt } tag is "FONT" -and name of {\tt } is "TABLE") +Returns a string containing all parameters. +Example : tag contains {\tt }. Call to +tag.GetAllParams() would return {\tt SIZE=+2 COLOR="\#000000"}. -\membersection{wxHtmlTag::HasParam}\label{wxhtmltaghasparam} -\constfunc{bool}{HasParam}{\param{const wxString\& }{par}} +\membersection{wxHtmlTag::GetBeginPos}\label{wxhtmltaggetbeginpos} -Returns TRUE if the tag has parameter of the given name. -Example : {\tt } has two parameters named -"SIZE" and "COLOR". +\constfunc{int}{GetBeginPos}{\void} -\wxheading{Parameters} +Returns beginning position of the text {\it between} this tag and paired +ending tag. +See explanation (returned position is marked with `|'): + +\begin{verbatim} +bla bla bla bla bla internal text bla bla + | +\end{verbatim} -\docparam{par}{the parameter you're looking for. It must {\it always} be in uppercase!} -\membersection{wxHtmlTag::GetParam}\label{wxhtmltaggetparam} +\membersection{wxHtmlTag::GetEndPos1}\label{wxhtmltaggetendpos1} -\constfunc{wxString}{GetParam}{\param{const wxString\& }{par}, \param{bool }{with\_commas = FALSE}} +\constfunc{int}{GetEndPos1}{\void} -Retuns the value of the parameter. You should check whether the -param exists or not (use \helpref{HasParam}{wxhtmltaghasparam}) first. +Returns ending position of the text {\it between} this tag and paired +ending tag. +See explanation (returned position is marked with `|'): -\wxheading{Parameters} +\begin{verbatim} +bla bla bla bla bla internal text bla bla + | +\end{verbatim} -\docparam{par}{The parameter's name in uppercase} -\docparam{with\_commas}{TRUE if you want to get commas as well. See example.} +\membersection{wxHtmlTag::GetEndPos2}\label{wxhtmltaggetendpos2} -\wxheading{Example} +\constfunc{int}{GetEndPos2}{\void} + +Returns ending position 2 of the text {\it between} this tag and paired +ending tag. +See explanation (returned position is marked with `|'): \begin{verbatim} -... -/* you have wxHtmlTag variable tag which is equal to - HTML tag */ -dummy = tag.GetParam("SIZE"); - // dummy == "+2" -dummy = tag.GetParam("COLOR"); - // dummy == "#0000FF" -dummy = tag.GetParam("COLOR", TRUE); - // dummy == "\"#0000FF\"" -- see the difference!! +bla bla bla bla bla internal text bla bla + | \end{verbatim} +\membersection{wxHtmlTag::GetName}\label{wxhtmltaggetname} +\constfunc{wxString}{GetName}{\void} -\membersection{wxHtmlTag::ScanParam}\label{wxhtmltagscanparam} +Returns tag's name. The name is always in uppercase and it doesn't contain +'<' or '/' characters. (So the name of {\tt } tag is "FONT" +and name of {\tt } is "TABLE") + + +\membersection{wxHtmlTag::GetParam}\label{wxhtmltaggetparam} -\constfunc{wxString}{ScanParam}{\param{const wxString\& }{par}, \param{const char *}{format}, fuck} +\constfunc{wxString}{GetParam}{\param{const wxString\& }{par}, \param{bool }{with\_commas = false}} -This method scans given parameter. Usage is exatly the same as sscanf's -usage except that you don't pass string but param name as the first parameter. +Returns the value of the parameter. You should check whether the +parameter exists or not (use \helpref{HasParam}{wxhtmltaghasparam}) first. \wxheading{Parameters} -\docparam{par}{The name of tag you wanna query (in uppercase)} +\docparam{par}{The parameter's name.} -\docparam{format}{scanf()-like format string.} +\docparam{with\_commas}{true if you want to get commas as well. See example.} -\wxheading{Cygwin and Mingw32} +\wxheading{Example} -If you're using Cygwin beta 20 or Mingw32 compiler please remember -that ScanParam() is only partially implemented!! The problem is -that under Cygnus' GCC vsscanf() function is not implemented. I workarounded -this in a way which causes that you can use only one parameter in ... -(and only one \% in {\it format}) +\begin{verbatim} +... +/* you have wxHtmlTag variable tag which is equal to + HTML tag */ +dummy = tag.GetParam("SIZE"); + // dummy == "+2" +dummy = tag.GetParam("COLOR"); + // dummy == "#0000FF" +dummy = tag.GetParam("COLOR", true); + // dummy == "\"#0000FF\"" -- see the difference!! +\end{verbatim} -\membersection{wxHtmlTag::GetAllParams}\label{wxhtmltaggetallparams} +\membersection{wxHtmlTag::GetParamAsColour}\label{wxhtmltaggetparamascolour} -\constfunc{const wxString\&}{GetAllParams}{\void} +\constfunc{bool}{GetParamAsColour}{\param{const wxString\& }{par}, \param{wxColour *}{clr}} -Returns string with all params. +Interprets tag parameter {\it par} as colour specification and saves its value +into wxColour variable pointed by {\it clr}. -Example : tag contains {\tt }. Call to -tag.GetAllParams() would return {\tt SIZE=+2 COLOR="\#000000"}. +Returns true on success and false if {\it par} is not colour specification or +if the tag has no such parameter. -\membersection{wxHtmlTag::IsEnding}\label{wxhtmltagisending} +\membersection{wxHtmlTag::GetParamAsInt}\label{wxhtmltaggetparamasint} -\constfunc{bool}{IsEnding}{\void} +\constfunc{bool}{GetParamAsInt}{\param{const wxString\& }{par}, \param{int *}{value}} -Returns TRUE if this tag is ending one. -({\tt } is ending tag, {\tt } is not) +Interprets tag parameter {\it par} as an integer and saves its value +into int variable pointed by {\it value}. +Returns true on success and false if {\it par} is not an integer or +if the tag has no such parameter. \membersection{wxHtmlTag::HasEnding}\label{wxhtmltaghasending} \constfunc{bool}{HasEnding}{\void} -Returns TRUE if this tag is paired with ending tag, FALSE otherwise. +Returns true if this tag is paired with ending tag, false otherwise. See the example of HTML document: @@ -134,43 +156,34 @@ In this example tags HTML and BODY have ending tags, first P and BR doesn't have ending tag while the second P has. The third P tag (which is ending itself) of course doesn't have ending tag. -\membersection{wxHtmlTag::GetBeginPos}\label{wxhtmltaggetbeginpos} +\membersection{wxHtmlTag::HasParam}\label{wxhtmltaghasparam} -\constfunc{int}{GetBeginPos}{\void} +\constfunc{bool}{HasParam}{\param{const wxString\& }{par}} -Returns beginning position of the text {\it between} this tag and paired -ending tag. -See explanation (returned position is marked with '^'): +Returns true if the tag has a parameter of the given name. +Example : {\tt } has two parameters named +"SIZE" and "COLOR". -\begin{verbatim} -bla bla bla bla bla intenal text bla bla - ^ -\end{verbatim} +\wxheading{Parameters} -\membersection{wxHtmlTag::GetEndPos1}\label{wxhtmltaggetendpos1} +\docparam{par}{the parameter you're looking for.} -\constfunc{int}{GetEndPos1}{\void} +\membersection{wxHtmlTag::ScanParam}\label{wxhtmltagscanparam} -Returns ending position of the text {\it between} this tag and paired -ending tag. -See explanation (returned position is marked with '^'): +\constfunc{wxString}{ScanParam}{\param{const wxString\& }{par}, \param{const wxChar *}{format}, \param{void *}{value}} -\begin{verbatim} -bla bla bla bla bla intenal text bla bla - ^ -\end{verbatim} +This method scans the given parameter. Usage is exactly the same as sscanf's +usage except that you don't pass a string but a parameter name as the first +argument +and you can only retrieve one value (i.e. you can use only one "\%" element +in {\it format}). -\membersection{wxHtmlTag::GetEndPos2}\label{wxhtmltaggetendpos2} +\wxheading{Parameters} -\constfunc{int}{GetEndPos2}{\void} +\docparam{par}{The name of the tag you want to query} -Returns ending position 2 of the text {\it between} this tag and paired -ending tag. -See explanation (returned position is marked with '^'): +\docparam{format}{scanf()-like format string.} -\begin{verbatim} -bla bla bla bla bla intenal text bla bla - ^ -\end{verbatim} +\docparam{value}{pointer to a variable to store the value in }