git.saurik.com Git - wxWidgets.git/blame_incremental

... / ...

Commit	Line	Data
	1	%
	2	% automatically generated by HelpGen from
	3	% htmprint.h at 17/Oct/99 12:48:02
	4	%
	5
	6	\section{\class{wxHtmlDCRenderer}}\label{wxhtmldcrenderer}
	7
	8	This class can render HTML document into a specified area of a DC. You can use it
	9	in your own printing code, although use of \helpref{wxHtmlEasyPrinting}{wxhtmleasyprinting}
	10	or \helpref{wxHtmlPrintout}{wxhtmlprintout} is strongly recommended.
	11
	12	\wxheading{Derived from}
	13
	14	\helpref{wxObject}{wxobject}
	15
	16	\wxheading{Include files}
	17
	18	<wx/html/htmprint.h>
	19
	20	\wxheading{Library}
	21
	22	\helpref{wxHtml}{librarieslist}
	23
	24	\latexignore{\rtfignore{\wxheading{Members}}}
	25
	26	\membersection{wxHtmlDCRenderer::wxHtmlDCRenderer}\label{wxhtmldcrendererwxhtmldcrenderer}
	27
	28	\func{}{wxHtmlDCRenderer}{\void}
	29
	30	Constructor.
	31
	32	\membersection{wxHtmlDCRenderer::SetDC}\label{wxhtmldcrenderersetdc}
	33
	34	\func{void}{SetDC}{\param{wxDC* }{dc}, \param{double }{pixel\_scale = 1.0}}
	35
	36	Assign DC instance to the renderer.
	37
	38	{\it pixel\_scale} can be used when rendering to high-resolution DCs (e.g. printer) to adjust size of pixel metrics.
	39	(Many dimensions in HTML are given in pixels -- e.g. image sizes. 300x300 image would be only one
	40	inch wide on typical printer. With pixel\_scale = 3.0 it would be 3 inches.)
	41
	42	\membersection{wxHtmlDCRenderer::SetFonts}\label{wxhtmldcrenderersetfonts}
	43
	44	\func{void}{SetFonts}{\param{const wxString\& }{normal\_face}, \param{const wxString\& }{fixed\_face}, \param{const int }{*sizes = NULL}}
	45
	46	Sets fonts. See \helpref{wxHtmlWindow::SetFonts}{wxhtmlwindowsetfonts} for
	47	detailed description.
	48
	49	See also \helpref{SetSize}{wxhtmldcrenderersetsize}.
	50
	51	\membersection{wxHtmlDCRenderer::SetSize}\label{wxhtmldcrenderersetsize}
	52
	53	\func{void}{SetSize}{\param{int }{width}, \param{int }{height}}
	54
	55	Set size of output rectangle, in pixels. Note that you {\bf can't} change
	56	width of the rectangle between calls to \helpref{Render}{wxhtmldcrendererrender}!
	57	(You can freely change height.)
	58
	59	\membersection{wxHtmlDCRenderer::SetHtmlText}\label{wxhtmldcrenderersethtmltext}
	60
	61	\func{void}{SetHtmlText}{\param{const wxString\& }{html}, \param{const wxString\& }{basepath = wxEmptyString}, \param{bool }{isdir = true}}
	62
	63	Assign text to the renderer. \helpref{Render}{wxhtmldcrendererrender} then draws
	64	the text onto DC.
	65
	66	\wxheading{Parameters}
	67
	68	\docparam{html}{HTML text. This is {\it not} a filename.}
	69
	70	\docparam{basepath}{base directory (html string would be stored there if it was in
	71	file). It is used to determine path for loading images, for example.}
	72
	73	\docparam{isdir}{false if basepath is filename, true if it is directory name
	74	(see \helpref{wxFileSystem}{wxfilesystem} for detailed explanation)}
	75
	76	\membersection{wxHtmlDCRenderer::Render}\label{wxhtmldcrendererrender}
	77
	78	\func{int}{Render}{\param{int }{x}, \param{int }{y}, \param{int }{from = 0}, \param{int }{dont\_render = false}}
	79
	80	Renders HTML text to the DC.
	81
	82	\wxheading{Parameters}
	83
	84	\docparam{x,y}{ position of upper-left corner of printing rectangle (see \helpref{SetSize}{wxhtmldcrenderersetsize})}
	85
	86	\docparam{from}{y-coordinate of the very first visible cell}
	87
	88	\docparam{dont\_render}{if true then this method only returns y coordinate of the next page
	89	and does not output anything}
	90
	91	Returned value is y coordinate of first cell than didn't fit onto page.
	92	Use this value as {\it from} in next call to Render in order to print multipages
	93	document.
	94
	95	\wxheading{Caution!}
	96
	97	The Following three methods {\bf must} always be called before any call to Render (preferably
	98	in this order):
	99
	100	\begin{itemize}\itemsep=0pt
	101	\item \helpref{SetDC}{wxhtmldcrenderersetdc}
	102	\item \helpref{SetSize}{wxhtmldcrenderersetsize}
	103	\item \helpref{SetHtmlText}{wxhtmldcrenderersethtmltext}
	104	\end{itemize}
	105
	106	{\bf Render() changes the DC's user scale and does NOT restore it.}
	107
	108	\membersection{wxHtmlDCRenderer::GetTotalHeight}\label{wxhtmldcrenderergettotalheight}
	109
	110	\func{int}{GetTotalHeight}{\void}
	111
	112	Returns the height of the HTML text. This is important if area height (see \helpref{SetSize}{wxhtmldcrenderersetsize})
	113	is smaller that total height and thus the page cannot fit into it. In that case you're supposed to
	114	call \helpref{Render}{wxhtmldcrendererrender} as long as its return value is smaller than GetTotalHeight's.
	115