X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2edb0bdef6238c8c246b6978bc14828b7033d931..b534968dc31dc9a25aff117ba220be1378e50722:/docs/latex/wx/htmlcell.tex diff --git a/docs/latex/wx/htmlcell.tex b/docs/latex/wx/htmlcell.tex index fbf7777125..6b3696ecd6 100644 --- a/docs/latex/wx/htmlcell.tex +++ b/docs/latex/wx/htmlcell.tex @@ -21,12 +21,9 @@ on number and sizes of its sub-cells (and also depends on width of window). See \helpref{wxHtmlContainerCell}{wxhtmlcontainercell}, \helpref{wxHtmlCell::Layout}{wxhtmlcelllayout}. -\begin{comment} -% Bitmap is corrupt! -This image shows you cells and containers: - +This image shows the cells and containers: \helponly{\image{}{contbox.bmp}} -\end{comment} + \wxheading{Using Containers in Tag Handler} \helpref{wxHtmlWinParser}{wxhtmlwinparser} provides a user-friendly way @@ -41,14 +38,11 @@ Use \helpref{CloseContainer}{wxhtmlwinparserclosecontainer} to close the container. This doesn't create a new container with same depth level but it returns "control" to the parent container. -\begin{comment} -% Bitmap corrupt! See explanation: - \helponly{\image{}{cont.bmp}} -\end{comment} -It is clear there must be same number of calls to -OpenContainer as to CloseContainer... + +There clearly must be same number of calls to OpenContainer as to +CloseContainer. \wxheading{Example} @@ -59,24 +53,23 @@ with "Hello, world!": m_WParser -> CloseContainer(); c = m_WParser -> OpenContainer(); -m_WParser -> AddWord("Hello, "); -m_WParser -> AddWord("world!"); +m_WParser -> AddText("Hello, "); +m_WParser -> AddText("world!"); m_WParser -> CloseContainer(); m_WParser -> OpenContainer(); \end{verbatim} -\begin{comment} -% Bitmap corrupt! and here is image of the situation: - \helponly{\image{}{hello.bmp}} -\end{comment} -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 +You can see that there was an opened container before the code was executed. +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). +Notice that it would be usually better to use +\helpref{wxHtmlContainerCell::InsertCell}{wxhtmlcontainercellinsertcell} instead +of adding text to the parser directly.