docs/latex/wx/htcell.tex

   1 %
   2 % automatically generated by HelpGen from
   3 % htmlcell.tex at 21/Mar/99 22:45:23
   4 %
   5
   6 \section{\class{wxHtmlCell}}\label{wxhtmlcell}
   7
   8 Internal data structure. It represents fragments of parsed HTML
   9 page, the so-called {\bf cell} - a word, picture, table, horizontal line and so on.
  10 It is used by \helpref{wxHtmlWindow}{wxhtmlwindow} and
  11 \helpref{wxHtmlWinParser}{wxhtmlwinparser} to represent HTML page in memory.
  12
  13 You can divide cells into two groups : {\it visible} cells with non-zero width and
  14 height and {\it helper} cells (usually with zero width and height) that
  15 perform special actions such as color or font change.
  16
  17 \wxheading{Derived from}
  18
  19 wxObject
  20
  21 \wxheading{See Also}
  22
  23 \helpref{Cells Overview}{cells},
  24 \helpref{wxHtmlContainerCell}{wxhtmlcontainercell}
  25
  26 \latexignore{\rtfignore{\wxheading{Members}}}
  27
  28 \membersection{wxHtmlCell::wxHtmlCell}\label{wxhtmlcellwxhtmlcell}
  29
  30 \func{}{wxHtmlCell}{\void}
  31
  32 Constructor.
  33
  34 \membersection{wxHtmlCell::AdjustPagebreak}\label{wxhtmlcelladjustpagebreak}
  35
  36 \func{virtual bool}{AdjustPagebreak}{\param{int * }{pagebreak}}
  37
  38 This method is used to adjust pagebreak position. The parameter is
  39 variable that contains y-coordinate of page break (= horizontal line that
  40 should not be crossed by words, images etc.). If this cell cannot be divided
  41 into two pieces (each one on another page) then it moves the pagebreak
  42 few pixels up.
  43
  44 Returns TRUE if pagebreak was modified, FALSE otherwise
  45
  46 Usage:
  47 \begin{verbatim}
  48 while (container->AdjustPagebreak(&p)) {}
  49 \end{verbatim}
  50
  51 \membersection{wxHtmlCell::Draw}\label{wxhtmlcelldraw}
  52
  53 \func{virtual void}{Draw}{\param{wxDC\& }{dc}, \param{int }{x}, \param{int }{y}, \param{int }{view\_y1}, \param{int }{view\_y2}}
  54
  55 Renders the cell.
  56
  57 \wxheading{Parameters}
  58
  59 \docparam{dc}{Device context to which the cell is to be drawn}
  60
  61 \docparam{x,y}{Coordinates of parent's upper left corner (origin). You must
  62 add this to m\_PosX,m\_PosY when passing coordinates to dc's methods
  63 Example : {\tt dc -> DrawText("hello", x + m\_PosX, y + m\_PosY)}}
  64
  65 \docparam{view\_y1}{y-coord of the first line visible in window. This is
  66 used to optimize rendering speed}
  67
  68 \docparam{view\_y2}{y-coord of the last line visible in window. This is
  69 used to optimize rendering speed}
  70
  71 \membersection{wxHtmlCell::DrawInvisible}\label{wxhtmlcelldrawinvisible}
  72
  73 \func{virtual void}{DrawInvisible}{\param{wxDC\& }{dc}, \param{int }{x}, \param{int }{y}}
  74
  75 This method is called instead of \helpref{Draw}{wxhtmlcelldraw} when the
  76 cell is certainly out of the screen (and thus invisible). This is not
  77 nonsense - some tags (like \helpref{wxHtmlColourCell}{wxhtmlcolourcell}
  78 or font setter) must be drawn even if they are invisible!
  79
  80 \wxheading{Parameters}
  81
  82 \docparam{dc}{Device context to which the cell is to be drawn}
  83
  84 \docparam{x,y}{Coordinates of parent's upper left corner. You must
  85 add this to m\_PosX,m\_PosY when passing coordinates to dc's methods
  86 Example : {\tt dc -> DrawText("hello", x + m\_PosX, y + m\_PosY)}}
  87
  88 \membersection{wxHtmlCell::Find}\label{wxhtmlcellfind}
  89
  90 \func{virtual const wxHtmlCell*}{Find}{\param{int }{condition}, \param{const void* }{param}}
  91
  92 Returns pointer to itself if this cell matches condition (or if any of the cells
  93 following in the list matches), NULL otherwise.
  94 (In other words if you call top-level container's Find it will
  95 return pointer to the first cell that matches the condition)
  96
  97 It is recommended way how to obtain pointer to particular cell or
  98 to cell of some type (e.g. wxHtmlAnchorCell reacts on
  99 HTML\_COND\_ISANCHOR condition)
 100
 101 \wxheading{Parameters}
 102
 103 \docparam{condition}{Unique integer identifier of condition}
 104
 105 \docparam{param}{Optional parameters}
 106
 107 \wxheading{Defined conditions}
 108
 109 \begin{twocollist}\itemsep=0pt
 110 \twocolitem{{\bf HTML\_COND\_ISANCHOR}}{Finds particular anchor.
 111 {\it param} is pointer to wxString with name of the anchor.}
 112 \twocolitem{{\bf HTML\_COND\_USER}}{User-defined conditions start
 113 from this number.}
 114 \end{twocollist}
 115
 116 \membersection{wxHtmlCell::GetDescent}\label{wxhtmlcellgetdescent}
 117
 118 \constfunc{int}{GetDescent}{\void}
 119
 120 Returns descent value of the cell (m\_Descent member).
 121 \helponly{See explanation:
 122
 123 \image{}{descent.bmp}
 124 }
 125
 126 \membersection{wxHtmlCell::GetHeight}\label{wxhtmlcellgetheight}
 127
 128 \constfunc{int}{GetHeight}{\void}
 129
 130 Returns height of the cell (m\_Height member).
 131
 132 \membersection{wxHtmlCell::GetLink}\label{wxhtmlcellgetlink}
 133
 134 \constfunc{virtual wxHtmlLinkInfo*}{GetLink}{\param{int }{x = 0}, \param{int }{y = 0}}
 135
 136 Returns hypertext link if associated with this cell or NULL otherwise.
 137 See \helpref{wxHtmlLinkInfo}{wxhtmllinkinfo}.
 138 (Note: this makes sense only for visible tags).
 139
 140 \wxheading{Parameters}
 141
 142 \docparam{x,y}{Coordinates of position where the user pressed mouse button.
 143 These coordinates are used e.g. by COLORMAP. Values are relative to the
 144 upper left corner of THIS cell (i.e. from 0 to m\_Width or m\_Height)}
 145
 146 \membersection{wxHtmlCell::GetNext}\label{wxhtmlcellgetnext}
 147
 148 \constfunc{wxHtmlCell*}{GetNext}{\void}
 149
 150 Returns pointer to the next cell in list (see htmlcell.h if you're
 151 interested in details).
 152
 153 \membersection{wxHtmlCell::GetParent}\label{wxhtmlcellgetparent}
 154
 155 \constfunc{wxHtmlContainerCell*}{GetParent}{\void}
 156
 157 Returns pointer to parent container.
 158
 159 \membersection{wxHtmlCell::GetPosX}\label{wxhtmlcellgetposx}
 160
 161 \constfunc{int}{GetPosX}{\void}
 162
 163 Returns X position within parent (the value is relative to parent's
 164 upper left corner). The returned value is meaningful only if
 165 parent's \helpref{Layout}{wxhtmlcelllayout} was called before!
 166
 167 \membersection{wxHtmlCell::GetPosY}\label{wxhtmlcellgetposy}
 168
 169 \constfunc{int}{GetPosY}{\void}
 170
 171 Returns Y position within parent (the value is relative to parent's
 172 upper left corner). The returned value is meaningful only if
 173 parent's \helpref{Layout}{wxhtmlcelllayout} was called before!
 174
 175 \membersection{wxHtmlCell::GetWidth}\label{wxhtmlcellgetwidth}
 176
 177 \constfunc{int}{GetWidth}{\void}
 178
 179 Returns width of the cell (m\_Width member).
 180
 181 \membersection{wxHtmlCell::Layout}\label{wxhtmlcelllayout}
 182
 183 \func{virtual void}{Layout}{\param{int }{w}}
 184
 185 This method performs 2 actions:
 186
 187 \begin{enumerate}\itemsep=0pt
 188 \item adjusts cell's width according to the fact that maximal possible width is {\it w}.
 189 (this has sense when working with horizontal lines, tables etc.)
 190 \item prepares layout (=fill-in m\_PosX, m\_PosY (and sometimes m\_Height) members)
 191 based on actual width {\it w}
 192 \end{enumerate}
 193
 194 It must be called before displaying cells structure because
 195 m\_PosX and m\_PosY are undefined (or invalid)
 196 before calling Layout.
 197
 198 \membersection{wxHtmlCell::OnMouseClick}\label{wxhtmlcellonmouseclick}
 199
 200 \func{virtual void}{OnMouseClick}{\param{wxWindow* }{parent}, \param{int }{x}, \param{int }{y}, \param{bool }{left}, \param{bool }{middle}, \param{bool }{right}}
 201
 202 This function is simple event handler. Each time user clicks mouse button over a cell
 203 within \helpref{wxHtmlWindow}{wxhtmlwindow} this method of that cell is called. Default behavior is
 204 that it calls \helpref{wxHtmlWindow::LoadPage}{wxhtmlwindowloadpage}.
 205
 206 \wxheading{Note}
 207
 208 If you need more "advanced" behaviour (for example you'd like to catch mouse movement events or
 209 key events or whatsoever) you should use wxHtmlBinderCell instead.
 210
 211 \wxheading{Parameters}
 212
 213 \docparam{parent}{parent window (always wxHtmlWindow!)}
 214
 215 \docparam{x, y}{coordinates of mouse click (this is relative to cell's origin}
 216
 217 \docparam{left, middle, right}{boolean flags for mouse buttons. TRUE if the left/middle/right
 218 button is pressed, FALSE otherwise}
 219
 220 \membersection{wxHtmlCell::SetLink}\label{wxhtmlcellsetlink}
 221
 222 \func{void}{SetLink}{\param{const wxHtmlLinkInfo\& }{link}}
 223
 224 Sets the hypertext link asocciated with this cell. (Default value
 225 is \helpref{wxHtmlLinkInfo}{wxhtmllinkinfo}("", "") (no link))
 226
 227 \membersection{wxHtmlCell::SetNext}\label{wxhtmlcellsetnext}
 228
 229 \func{void}{SetNext}{\param{wxHtmlCell }{*cell}}
 230
 231 Sets the next cell in the list. This shouldn't be called by user - it is
 232 to be used only by \helpref{wxHtmlContainerCell::InsertCell}{wxhtmlcontainercellinsertcell}
 233
 234 \membersection{wxHtmlCell::SetParent}\label{wxhtmlcellsetparent}
 235
 236 \func{void}{SetParent}{\param{wxHtmlContainerCell }{*p}}
 237
 238 Sets parent container of this cell. This is called from
 239 \helpref{wxHtmlContainerCell::InsertCell}{wxhtmlcontainercellinsertcell}.
 240
 241 \membersection{wxHtmlCell::SetPos}\label{wxhtmlcellsetpos}
 242
 243 \func{void}{SetPos}{\param{int }{x}, \param{int }{y}}
 244
 245 Sets the cell's position within parent container.
 246