X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/559fe022dbd5d4d961402b5c973e5225fa91f17f..538f35ccf43be97a317a1a80ae4b5c1b29068b01:/docs/latex/wx/htcontnr.tex?ds=inline diff --git a/docs/latex/wx/htcontnr.tex b/docs/latex/wx/htcontnr.tex index 53cd3171c6..a723a4420d 100644 --- a/docs/latex/wx/htcontnr.tex +++ b/docs/latex/wx/htcontnr.tex @@ -5,13 +5,17 @@ \section{\class{wxHtmlContainerCell}}\label{wxhtmlcontainercell} -wxHtmlContainerCell class an implementation of a cell that may +The wxHtmlContainerCell class is an implementation of a cell that may contain more cells in it. It is heavily used in the wxHTML layout algorithm. \wxheading{Derived from} \helpref{wxHtmlCell}{wxhtmlcell} +\wxheading{Include files} + + + \wxheading{See Also} \helpref{Cells Overview}{cells} @@ -45,7 +49,7 @@ 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 +{\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. @@ -53,9 +57,9 @@ instead. \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! @@ -63,18 +67,8 @@ It is NOT always in pixels! \constfunc{int}{GetIndentUnits}{\param{int }{ind}} -Returns units of intentation value 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} +Returns the units of indentation for {\it ind} where {\it ind} is one +of the {\bf wxHTML\_INDENT\_*} constants. \membersection{wxHtmlContainerCell::InsertCell}\label{wxhtmlcontainercellinsertcell} @@ -86,149 +80,150 @@ Inserts new cell into the container. \func{void}{SetAlign}{\param{const wxHtmlTag\& }{tag}} -Sets container's alignment (both horizontal and vertical) according to +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 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} \docparam{al}{new horizontal alignment. May be one of these values: -\begin{twocollist} -\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} +\begin{twocollist}\itemsep=0pt +\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} } - \membersection{wxHtmlContainerCell::SetAlignVer}\label{wxhtmlcontainercellsetalignver} \func{void}{SetAlignVer}{\param{int }{al}} -Sets container's {\it vertical alignment}. This is per-line alignment! +Sets the container's {\it vertical alignment}. This is per-line alignment! \wxheading{Parameters} \docparam{al}{new vertical alignment. May be one of these values: -\begin{twocollist} -\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} +\begin{twocollist}\itemsep=0pt +\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 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 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 indentation (free space between borders of container and subcells). +Sets the indentation (free space between borders of container and subcells). \wxheading{Parameters} \docparam{i}{Indentation value.} -\docparam{what}{Determines which of the 4 borders we're setting. It is OR +\docparam{what}{Determines which of the four borders we're setting. It is OR combination of following constants: -\begin{twocollist} -\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} +\begin{twocollist}\itemsep=0pt +\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} -\twocolitem{{\bf HTML\_UNITS\_PIXELS}}{{\it i} is number of pixels} -\twocolitem{{\bf HTML\_UNITS\_PERCENT}}{{\it i} is interpreted as percents of width +\begin{twocollist}\itemsep=0pt +\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 +When container's \helpref{Layout}{wxhtmlcelllayout} is called, m\_Height is set depending on layout of subcells to the height of area covered -by layouted subcells. Call to this method guarantees you that the height +by layed-out subcells. Calling this method guarantees you that the height of container is never smaller than {\it h} - even if the subcells cover -much smaller area.) +much smaller area. \wxheading{Parameters} \docparam{h}{The minimal height.} -\docparam{align}{If height of the container is lower than min. 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!} +\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 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. -Normal behaviour of container is that it's width is same as 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 interpretation of {\it} value. +\docparam{units}{Units of {\it w} This parameter affects the interpretation of {\it} value. -\begin{twocollist} -\twocolitem{{\bf HTML\_UNITS\_PIXELS}}{{\it w} is number of pixels} -\twocolitem{{\bf HTML\_UNITS\_PERCENT}}{{\it w} is interpreted as percents of width +\begin{twocollist}\itemsep=0pt +\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} } @@ -236,4 +231,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.} + + + + + + +