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

%
% automatically generated by HelpGen from
% htmltaghandler.tex at 18/Mar/99 19:20:29
%

\section{\class{wxHtmlTagHandler}}\label{wxhtmltaghandler}

\wxheading{Derived from}

wxObject

\wxheading{See Also}

\helpref{Overview}{handlers},
\helpref{wxHtmlTag}{wxhtmltag}

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

\membersection{wxHtmlTagHandler::m\_Parser}\label{wxhtmltaghandlermparser}

{\bf wxHtmlParser* m\_Parser}

This attribute is used to access parent parser. It is protected so that
it can't be accessed by user but can be accessed from derived classes.

\membersection{wxHtmlTagHandler::wxHtmlTagHandler}\label{wxhtmltaghandlerwxhtmltaghandler}

\func{}{wxHtmlTagHandler}{\void}

Constructor.

\membersection{wxHtmlTagHandler::SetParser}\label{wxhtmltaghandlersetparser}

\func{virtual void}{SetParser}{\param{wxHtmlParser }{*parser}}

Assigns {\it parser} to this handler. Each {\bf instance} of handler 
is guaranteed to be called only from the parser.

\membersection{wxHtmlTagHandler::GetSupportedTags}\label{wxhtmltaghandlergetsupportedtags}

\func{virtual wxString}{GetSupportedTags}{\void}

Returns list of supported tags. The list is in uppercase and tags
are delimited by ','. Example : {\tt "I,B,FONT,P" }

\membersection{wxHtmlTagHandler::HandleTag}\label{wxhtmltaghandlerhandletag}

\func{virtual bool}{HandleTag}{\param{const wxHtmlTag\& }{tag}}

This is the core method of each handler. It is called each time
one of supported tags is detected. {\it tag} contains all neccessary
info (see \helpref{wxHtmlTag}{wxhtmltag} for details).

\wxheading{Return value}

TRUE if \helpref{ParseInner}{wxhtmltaghandlerparseinner} was called,
FALSE otherwise.

\wxheading{Example}

\begin{verbatim}
bool MyHandler::HandleTag(const wxHtmlTag& tag)
{
    ...
    // change state of parser (e.g. set bold face)
    ParseInner(tag);
    ...
    // restore original state of parser
}
\end{verbatim}

You shouldn't call ParseInner if the tag is not paired with ending one.

\membersection{wxHtmlTagHandler::ParseInner}\label{wxhtmltaghandlerparseinner}

\func{void}{ParseInner}{\param{const wxHtmlTag\& }{tag}}

This method calls parser's \helpref{DoParsing}{wxhtmlparserdoparsing} method
for the string between this tag and paired ending tag:

\begin{verbatim}
...<A HREF="x.htm">Hello, world!</A>...
\end{verbatim}

In this example, a call to ParseInner (with {\it tag} pointing to A tag)
will parse 'Hello, world!'.
Commit	Line	Data
704a4b75 VS	1	%
	2	% automatically generated by HelpGen from
	3	% htmltaghandler.tex at 18/Mar/99 19:20:29
	4	%
	5
704a4b75 VS	6	\section{\class{wxHtmlTagHandler}}\label{wxhtmltaghandler}
	7
	8	\wxheading{Derived from}
	9
	10	wxObject
	11
	12	\wxheading{See Also}
	13
	14	\helpref{Overview}{handlers},
	15	\helpref{wxHtmlTag}{wxhtmltag}
	16
704a4b75 VS	17	\latexignore{\rtfignore{\wxheading{Members}}}
	18
	19	\membersection{wxHtmlTagHandler::m\_Parser}\label{wxhtmltaghandlermparser}
	20
	21	{\bf wxHtmlParser* m\_Parser}
	22
	23	This attribute is used to access parent parser. It is protected so that
	24	it can't be accessed by user but can be accessed from derived classes.
	25
	26	\membersection{wxHtmlTagHandler::wxHtmlTagHandler}\label{wxhtmltaghandlerwxhtmltaghandler}
	27
	28	\func{}{wxHtmlTagHandler}{\void}
	29
	30	Constructor.
	31
	32	\membersection{wxHtmlTagHandler::SetParser}\label{wxhtmltaghandlersetparser}
	33
	34	\func{virtual void}{SetParser}{\param{wxHtmlParser }{*parser}}
	35
	36	Assigns {\it parser} to this handler. Each {\bf instance} of handler
	37	is guaranteed to be called only from the parser.
	38
	39	\membersection{wxHtmlTagHandler::GetSupportedTags}\label{wxhtmltaghandlergetsupportedtags}
	40
	41	\func{virtual wxString}{GetSupportedTags}{\void}
	42
	43	Returns list of supported tags. The list is in uppercase and tags
	44	are delimited by ','. Example : {\tt "I,B,FONT,P" }
	45
704a4b75 VS	46	\membersection{wxHtmlTagHandler::HandleTag}\label{wxhtmltaghandlerhandletag}
	47
	48	\func{virtual bool}{HandleTag}{\param{const wxHtmlTag\& }{tag}}
	49
	50	This is the core method of each handler. It is called each time
	51	one of supported tags is detected. {\it tag} contains all neccessary
	52	info (see \helpref{wxHtmlTag}{wxhtmltag} for details).
	53
	54	\wxheading{Return value}
	55
	56	TRUE if \helpref{ParseInner}{wxhtmltaghandlerparseinner} was called,
	57	FALSE otherwise.
	58
	59	\wxheading{Example}
	60
	61	\begin{verbatim}
	62	bool MyHandler::HandleTag(const wxHtmlTag& tag)
	63	{
	64	...
	65	// change state of parser (e.g. set bold face)
	66	ParseInner(tag);
	67	...
	68	// restore original state of parser
	69	}
	70	\end{verbatim}
	71
	72	You shouldn't call ParseInner if the tag is not paired with ending one.
	73
704a4b75 VS	74	\membersection{wxHtmlTagHandler::ParseInner}\label{wxhtmltaghandlerparseinner}
	75
	76	\func{void}{ParseInner}{\param{const wxHtmlTag\& }{tag}}
	77
	78	This method calls parser's \helpref{DoParsing}{wxhtmlparserdoparsing} method
	79	for the string between this tag and paired ending tag:
	80
	81	\begin{verbatim}
	82	...<A HREF="x.htm">Hello, world!</A>...
	83	\end{verbatim}
	84
22d6efa8 JS	85	In this example, a call to ParseInner (with {\it tag} pointing to A tag)
	86	will parse 'Hello, world!'.
	87