]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/latex/wx/htcontnr.tex
Support for automatic setup.h in OS/2 with OW builds. __WXOS2__ final removal. Source...
[wxWidgets.git] / docs / latex / wx / htcontnr.tex
index e43faa8409db67e60d89125f320e5ca13b2f69de..091c665b8f4804c51abfb911254197c1d409fdca 100644 (file)
@@ -1,7 +1,13 @@
-%
-% automatically generated by HelpGen from
-% htmlcontainercell.tex at 21/Mar/99 22:45:23
-%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Name:        htcontnr.tex
+%% Purpose:     wxHtmlContainerCell documentation
+%% Author:      wxWidgets Team
+%% Modified by:
+%% Created:     21/Mar/99 22:45:23
+%% RCS-ID:      $Id$
+%% Copyright:   (c) wxWidgets Team
+%% License:     wxWindows license
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \section{\class{wxHtmlContainerCell}}\label{wxhtmlcontainercell}
 
@@ -12,6 +18,10 @@ contain more cells in it. It is heavily used in the wxHTML layout algorithm.
 
 \helpref{wxHtmlCell}{wxhtmlcell}
 
+\wxheading{Include files}
+
+<wx/html/htmlcell.h>
+
 \wxheading{See Also}
 
 \helpref{Cells Overview}{cells}
@@ -37,25 +47,20 @@ Returns container's horizontal alignment.
 
 Returns container's vertical alignment.
 
-\membersection{wxHtmlContainerCell::GetFirstCell}\label{wxhtmlcontainercellgetfirstcell}
+\membersection{wxHtmlContainerCell::GetBackgroundColour}\label{wxhtmlcontainercellgetbackgroundcolour}
 
-\func{wxHtmlCell*}{GetFirstCell}{\void}
+\func{wxColour}{GetBackgroundColour}{\void}
 
-Returns pointer to the first cell in the list.
-You can then use wxHtmlCell's GetNext method to obtain pointer to the next
-cell in list.
-
-{\bf Note:} This shouldn't be used by the end user. If you need some way of
-finding particular cell in the list, try \helpref{Find}{wxhtmlcellfind} method
-instead.
+Returns the background colour of the container or {\tt wxNullColour} if no background
+colour is set.
 
 \membersection{wxHtmlContainerCell::GetIndent}\label{wxhtmlcontainercellgetindent}
 
 \constfunc{int}{GetIndent}{\param{int }{ind}}
 
-Returns the indentation. {\it ind} is one of the {\bf HTML\_INDENT\_*} constants.
+Returns the indentation. {\it ind} is one of the {\bf wxHTML\_INDENT\_*} constants.
 
-{\bf Note:} You must call \helpref{GetIndentUnits}{wxhtmlcontainercellgetindentunits}
+{\bf Note:} You must call \helpref{GetIndentUnits}{wxhtmlcontainercellgetindentunits} 
 with same {\it ind} parameter in order to correctly interpret the returned integer value.
 It is NOT always in pixels!
 
@@ -64,16 +69,7 @@ It is NOT always in pixels!
 \constfunc{int}{GetIndentUnits}{\param{int }{ind}}
 
 Returns the units of indentation for {\it ind} where {\it ind} is one
-of the {\bf HTML\_INDENT\_*} constants.
-
-\membersection{wxHtmlContainerCell::GetMaxLineWidth}\label{wxhtmlcontainercellgetmaxlinewidth}
-
-\constfunc{int}{GetMaxLineWidth}{\void}
-
-Returns width of widest line (note : this may be more than GetWidth()!!
-E.g. if you have 640x480 image and the wxHtmlWindow is only 100x100...)
-
-Call to this method is valid only after calling \helpref{Layout}{wxhtmlcelllayout}
+of the {\bf wxHTML\_INDENT\_*} constants.
 
 \membersection{wxHtmlContainerCell::InsertCell}\label{wxhtmlcontainercellinsertcell}
 
@@ -87,14 +83,14 @@ Inserts new cell into the container.
 
 Sets the container's alignment (both horizontal and vertical) according to
 the values stored in {\it tag}. (Tags {\tt ALIGN} parameter is extracted.) In fact
-it is only a front-end to \helpref{SetAlignHor}{wxhtmlcontainercellsetalignhor}
+it is only a front-end to \helpref{SetAlignHor}{wxhtmlcontainercellsetalignhor} 
 and \helpref{SetAlignVer}{wxhtmlcontainercellsetalignver}.
 
 \membersection{wxHtmlContainerCell::SetAlignHor}\label{wxhtmlcontainercellsetalignhor}
 
 \func{void}{SetAlignHor}{\param{int }{al}}
 
-Sets the container's {\it horizontal alignment}. During \helpref{Layout}{wxhtmlcelllayout}
+Sets the container's {\it horizontal alignment}. During \helpref{Layout}{wxhtmlcelllayout} 
 each line is aligned according to {\it al} value.
 
 \wxheading{Parameters}
@@ -102,9 +98,10 @@ each line is aligned according to {\it al} value.
 \docparam{al}{new horizontal alignment. May be one of these values:
 
 \begin{twocollist}\itemsep=0pt
-\twocolitem{{\bf HTML\_ALIGN\_LEFT}}{lines are left-aligned (default)}
-\twocolitem{{\bf HTML\_ALIGN\_CENTER\_H}}{lines are centered}
-\twocolitem{{\bf HTML\_ALIGN\_RIGHT}}{lines are right-aligned}
+\twocolitem{{\bf wxHTML\_ALIGN\_LEFT}}{lines are left-aligned (default)}
+\twocolitem{{\bf wxHTML\_ALIGN\_JUSTIFY}}{lines are justified}
+\twocolitem{{\bf wxHTML\_ALIGN\_CENTER}}{lines are centered}
+\twocolitem{{\bf wxHTML\_ALIGN\_RIGHT}}{lines are right-aligned}
 \end{twocollist}
 }
 
@@ -119,35 +116,35 @@ Sets the container's {\it vertical alignment}. This is per-line alignment!
 \docparam{al}{new vertical alignment. May be one of these values:
 
 \begin{twocollist}\itemsep=0pt
-\twocolitem{{\bf HTML\_ALIGN\_BOTTOM}}{cells are over the line (default)}
-\twocolitem{{\bf HTML\_ALIGN\_CENTER\_V}}{cells are centered on line}
-\twocolitem{{\bf HTML\_ALIGN\_TOP}}{cells are under the line}
+\twocolitem{{\bf wxHTML\_ALIGN\_BOTTOM}}{cells are over the line (default)}
+\twocolitem{{\bf wxHTML\_ALIGN\_CENTER}}{cells are centered on line}
+\twocolitem{{\bf wxHTML\_ALIGN\_TOP}}{cells are under the line}
 \end{twocollist}
 
-\image{}{alignv.bmp}
+\helponly{\image{}{alignv.bmp}}
 }
 
 \membersection{wxHtmlContainerCell::SetBackgroundColour}\label{wxhtmlcontainercellsetbackgroundcolour}
 
 \func{void}{SetBackgroundColour}{\param{const wxColour\& }{clr}}
 
-Sets the background color for this container.
+Sets the background colour for this container.
 
 \membersection{wxHtmlContainerCell::SetBorder}\label{wxhtmlcontainercellsetborder}
 
 \func{void}{SetBorder}{\param{const wxColour\& }{clr1}, \param{const wxColour\& }{clr2}}
 
-Sets the border (frame) colours. Border is rectangle around the container.
+Sets the border (frame) colours. A border is a rectangle around the container.
 
 \wxheading{Parameters}
 
-\docparam{clr1}{Color of top and left lines}
+\docparam{clr1}{Colour of top and left lines}
 
-\docparam{clr2}{Color of bottom and right lines}
+\docparam{clr2}{Colour of bottom and right lines}
 
 \membersection{wxHtmlContainerCell::SetIndent}\label{wxhtmlcontainercellsetindent}
 
-\func{void}{SetIndent}{\param{int }{i}, \param{int }{what}, \param{int }{units = HTML\_UNITS\_PIXELS}}
+\func{void}{SetIndent}{\param{int }{i}, \param{int }{what}, \param{int }{units = wxHTML\_UNITS\_PIXELS}}
 
 Sets the indentation (free space between borders of container and subcells).
 
@@ -159,32 +156,32 @@ Sets the indentation (free space between borders of container and subcells).
 combination of following constants:
 
 \begin{twocollist}\itemsep=0pt
-\twocolitem{{\bf HTML\_INDENT\_TOP}}{top border}
-\twocolitem{{\bf HTML\_INDENT\_BOTTOM}}{bottom}
-\twocolitem{{\bf HTML\_INDENT\_LEFT}}{left}
-\twocolitem{{\bf HTML\_INDENT\_RIGHT}}{right}
-\twocolitem{{\bf HTML\_INDENT\_HORIZONTAL}}{left and right}
-\twocolitem{{\bf HTML\_INDENT\_VERTICAL}}{top and bottom}
-\twocolitem{{\bf HTML\_INDENT\_ALL}}{all 4 borders}
+\twocolitem{{\bf wxHTML\_INDENT\_TOP}}{top border}
+\twocolitem{{\bf wxHTML\_INDENT\_BOTTOM}}{bottom}
+\twocolitem{{\bf wxHTML\_INDENT\_LEFT}}{left}
+\twocolitem{{\bf wxHTML\_INDENT\_RIGHT}}{right}
+\twocolitem{{\bf wxHTML\_INDENT\_HORIZONTAL}}{left and right}
+\twocolitem{{\bf wxHTML\_INDENT\_VERTICAL}}{top and bottom}
+\twocolitem{{\bf wxHTML\_INDENT\_ALL}}{all 4 borders}
 \end{twocollist}
 
-\image{}{indent.bmp}
+\helponly{\image{}{indent.bmp}}
 }
 
 \docparam{units}{Units of {\it i}. This parameter affects interpretation of {\it} value.
 
 \begin{twocollist}\itemsep=0pt
-\twocolitem{{\bf HTML\_UNITS\_PIXELS}}{{\it i} is number of pixels}
-\twocolitem{{\bf HTML\_UNITS\_PERCENT}}{{\it i} is interpreted as percents of width
+\twocolitem{{\bf wxHTML\_UNITS\_PIXELS}}{{\it i} is number of pixels}
+\twocolitem{{\bf wxHTML\_UNITS\_PERCENT}}{{\it i} is interpreted as percents of width
 of parent container}
 \end{twocollist}
 }
 
 \membersection{wxHtmlContainerCell::SetMinHeight}\label{wxhtmlcontainercellsetminheight}
 
-\func{void}{SetMinHeight}{\param{int }{h}, \param{int }{align = HTML_ALIGN_TOP}}
+\func{void}{SetMinHeight}{\param{int }{h}, \param{int }{align = wxHTML\_ALIGN\_TOP}}
 
-Sets minimal height of the container. 
+Sets minimal height of the container.
 
 When container's \helpref{Layout}{wxhtmlcelllayout} is called, m\_Height
 is set depending on layout of subcells to the height of area covered
@@ -197,35 +194,37 @@ much smaller area.
 \docparam{h}{The minimal height.}
 
 \docparam{align}{If height of the container is lower than the minimum height, empty space must be inserted
-somewhere in order to ensure minimal height. This parameter is one of {\bf HTML_ALIGN_TOP,
-HTML_ALIGN_BOTTOM, HTML_ALIGN_CENTER} constants. It refers to the {\it contents}, not to the
-empty place!}
+somewhere in order to ensure minimal height. This parameter is one of {\bf wxHTML\_ALIGN\_TOP,
+wxHTML\_ALIGN\_BOTTOM, wxHTML\_ALIGN\_CENTER}. It refers to the {\it contents}, not to the
+empty place.}
 
 \membersection{wxHtmlContainerCell::SetWidthFloat}\label{wxhtmlcontainercellsetwidthfloat}
 
 \func{void}{SetWidthFloat}{\param{int }{w}, \param{int }{units}}
 
-\func{void}{SetWidthFloat}{\param{const wxHtmlTag\& }{tag}}
+\func{void}{SetWidthFloat}{\param{const wxHtmlTag\& }{tag}, \param{double }{pixel\_scale = 1.0}}
 
-Sets floating width adjustment. 
+Sets floating width adjustment.
 
-The normal behaviour of container is that its width is the same as the width of 
+The normal behaviour of container is that its width is the same as the width of
 parent container (and thus you can have only one sub-container per line).
 You can change this by setting FWA.
 
+{\it pixel\_scale} is number of real pixels that equals to 1 HTML pixel.
+
 \wxheading{Parameters}
 
 \docparam{w}{Width of the container. If the value is negative it means
-complement to full width of parent container (e.g. 
-{\tt SetWidthFloat(-50, HTML\_UNITS\_PIXELS)} sets the width
+complement to full width of parent container (e.g.
+{\tt SetWidthFloat(-50, wxHTML\_UNITS\_PIXELS)} sets the width
 of container to parent's width minus 50 pixels. This is useful when
 creating tables - you can call SetWidthFloat(50) and SetWidthFloat(-50))}
 
 \docparam{units}{Units of {\it w} This parameter affects the interpretation of {\it} value.
 
 \begin{twocollist}\itemsep=0pt
-\twocolitem{{\bf HTML\_UNITS\_PIXELS}}{{\it w} is number of pixels}
-\twocolitem{{\bf HTML\_UNITS\_PERCENT}}{{\it w} is interpreted as percents of width
+\twocolitem{{\bf wxHTML\_UNITS\_PIXELS}}{{\it w} is number of pixels}
+\twocolitem{{\bf wxHTML\_UNITS\_PERCENT}}{{\it w} is interpreted as percents of width
 of parent container}
 \end{twocollist}
 }
@@ -233,3 +232,13 @@ of parent container}
 \docparam{tag}{In the second version of method, {\it w} and {\it units}
 info is extracted from tag's {\tt WIDTH} parameter.}
 
+\pythonnote{The second form of this method is named
+SetWidthFloatFromTag in wxPython.}
+
+
+
+
+
+
+
+