X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/22d6efa851642c6a69174278fc50f712f41e2271..dc484d491b15355285a89da275c58c2ef247d1f4:/docs/latex/wx/htmlhand.tex?ds=sidebyside diff --git a/docs/latex/wx/htmlhand.tex b/docs/latex/wx/htmlhand.tex index 1034c50246..de833c17d9 100644 --- a/docs/latex/wx/htmlhand.tex +++ b/docs/latex/wx/htmlhand.tex @@ -1,13 +1,13 @@ -\membersection{Tag Handlers}\label{handlers} +\subsection{Tag Handlers}\label{handlers} -wxHTML library provides architecture of pluginable {\it tag handlers}. +The wxHTML library provides architecture of pluggable {\it tag handlers}. Tag handler is class that understands particular HTML tag (or tags) and is able to interpret it. \helpref{wxHtmlWinParser}{wxhtmlwinparser} has static table of {\bf modules}. -Each module contains one or more tag handlers. Each time new wxHtmlWinParser +Each module contains one or more tag handlers. Each time a new wxHtmlWinParser object is constructed all modules are scanned and handlers are added -to wxHtmlParser's list of available handlers (note : wxHtmlParser's list +to wxHtmlParser's list of available handlers (note: wxHtmlParser's list is non-static). \wxheading{How it works} @@ -15,7 +15,7 @@ is non-static). Common tag handler's \helpref{HandleTag}{wxhtmltaghandlerhandletag} method works in four steps: -\begin{enumerate} +\begin{enumerate}\itemsep=0pt \item Save state of parent parser into local variables \item Change parser state according to tag's params \item Parse text between the tag and paired ending tag (if present) @@ -43,18 +43,18 @@ Then you must define handlers and one module. The handler is derived from \helpref{wxHtmlWinTagHandler}{wxhtmlwintaghandler} (or directly from \helpref{wxHtmlTagHandler}{wxhtmltaghandler}) -You can use set of macros to define the handler (see src/mod\_*.cpp files +You can use set of macros to define the handler (see src/html/m\_*.cpp files for details). Handler definition must start with {\bf TAG\_HANDLER\_BEGIN} macro and end with {\bf TAG\_HANDLER\_END} macro. I strongly recommend to have a look at {\it include/wxhtml/mod\_templ.h} file. Otherwise you won't understand -the structure of macros... See macros reference: +the structure of macros. See macros reference: {\bf TAG\_HANDLER\_BEGIN}({\it name}, {\it tags}) Starts handler definition. {\it name} is handler identifier (in fact part of class name), {\it tags} is string containing list of tags supported by this handler (in uppercase). This macro derives new class from -wxHtmlWinTagHandler and implements it's +wxHtmlWinTagHandler and implements it is \helpref{GetSupportedTags}{wxhtmltaghandlergetsupportedtags} method. Example: TAG\_HANDLER\_BEGIN(FONTS, "B,I,U,T") @@ -113,7 +113,6 @@ TAG_HANDLER_END(TITLE) Ends definition of tag handler {\it name}. - \wxheading{Tags Modules} You can use set of 3 macros TAGS\_MODULE\_BEGIN, TAGS\_MODULE\_ADD and