77 lines
2.5 KiB
TeX
77 lines
2.5 KiB
TeX
|
\subsection{Cells and Containers}\label{cells}
|
||
|
|
|
||
|
|
This article describes mechanism used by
|
||
|
|
\helpref{wxHtmlWinParser}{wxhtmlwinparser} and
|
||
|
|
\helpref{wxHtmlWindow}{wxhtmlwindow}
|
||
|
|
to parse and display HTML documents.
|
||
|
|
|
||
|
|
\wxheading{Cells}
|
||
|
|
|
||
|
|
You can divide any text (or HTML) into small fragments. Let's call these
|
||
|
|
fragments {\bf cells}. Cell is for example one word, horizontal line, image
|
||
|
|
or any other part of document. Each cell has width and height (except special
|
||
|
|
"magic" cells with zero dimensions - e.g. color changers or font changers).
|
||
|
|
|
||
|
|
See \helpref{wxHtmlCell}{wxhtmlcell}.
|
||
|
|
|
||
|
|
\wxheading{Containers}
|
||
|
|
|
||
|
|
Container is kind of cell that may contain sub-cells. Its size depends
|
||
|
|
on number and sizes of its sub-cells (and also depends on width of window).
|
||
|
|
|
||
|
|
See \helpref{wxHtmlContainerCell}{wxhtmlcontainercell},
|
||
|
|
\helpref{wxHtmlCell::Layout}{wxhtmlcelllayout}.
|
||
|
|
|
||
|
|
This image shows you cells\ &\ containers:
|
||
|
|
|
||
|
|
\image{}{contbox.bmp}
|
||
|
|
|
||
|
|
\wxheading{Using Containers in Tag Handler}
|
||
|
|
|
||
|
|
\helpref{wxHtmlWinParser}{wxhtmlwinparser} provides user-friendly way
|
||
|
|
of managing containers. It's based on idea of opening and closing containers.
|
||
|
|
|
||
|
|
Use \helpref{OpenContainer}{wxhtmlwinparseropencontainer} to open new
|
||
|
|
container {\it within actually opened container}. This new container is
|
||
|
|
{\it sub-container} of the old one. (If you want to create new container with
|
||
|
|
same depth level you can call {\tt CloseContainer(); OpenContainer();}.)
|
||
|
|
|
||
|
|
Use \helpref{CloseContaier}{wxhtmlwinparserclosecontainer} to close the
|
||
|
|
container. This doesn't create new container with same depth level but
|
||
|
|
it returns "control" to the parent container.
|
||
|
|
|
||
|
|
See explanation:
|
||
|
|
|
||
|
|
\image{}{cont.bmp}
|
||
|
|
|
||
|
|
It's clear there must be same number of calls to
|
||
|
|
OpenContainer as to CloseContainer...
|
||
|
|
|
||
|
|
\wxheading{Example}
|
||
|
|
|
||
|
|
This code creates new paragraph (container at same depth level)
|
||
|
|
with "Hello, world!" :
|
||
|
|
|
||
|
|
\begin{verbatim}
|
||
|
|
m_WParser -> CloseContainer();
|
||
|
|
c = m_WParser -> OpenContainer();
|
||
|
|
|
||
|
|
m_WParser -> AddWord("Hello, ");
|
||
|
|
m_WParser -> AddWord("world!");
|
||
|
|
|
||
|
|
m_WParser -> CloseContainer();
|
||
|
|
m_WParser -> OpenContainer();
|
||
|
|
\end{verbatim}
|
||
|
|
|
||
|
|
and here is image of the situation:
|
||
|
|
|
||
|
|
\image{}{hello.bmp}
|
||
|
|
|
||
|
|
You can see that there was opened container before running the code. We closed
|
||
|
|
it, created our own container, then closed our container and opened
|
||
|
|
new container. The result was that we had {\it same depth level} after
|
||
|
|
executing. This is general rule that should be followed by tag handlers :
|
||
|
|
leave depth level of containers unmodified (in other words, number of
|
||
|
|
OpenContainer and CloseContainer calls should be same within \helpref{HandleTag}{wxhtmltaghandlerhandletag}'s body).
|
||
|
|
|