bc55e31bdc
2. used the above to implement clickable links support in wxHtmlListBox git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@38701 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
301 lines
10 KiB
TeX
301 lines
10 KiB
TeX
%
|
|
% automatically generated by HelpGen from
|
|
% htmlwinparser.tex at 14/Mar/99 20:13:37
|
|
%
|
|
|
|
\section{\class{wxHtmlWinParser}}\label{wxhtmlwinparser}
|
|
|
|
This class is derived from \helpref{wxHtmlParser}{wxhtmlparser} and
|
|
its main goal is to parse HTML input so that it can be displayed in
|
|
\helpref{wxHtmlWindow}{wxhtmlwindow}. It uses a special
|
|
\helpref{wxHtmlWinTagHandler}{wxhtmlwintaghandler}.
|
|
|
|
\wxheading{Notes}
|
|
|
|
The product of parsing is a wxHtmlCell (resp. wxHtmlContainer) object.
|
|
|
|
\wxheading{Derived from}
|
|
|
|
\helpref{wxHtmlParser}{wxhtmlparser}
|
|
|
|
\wxheading{Include files}
|
|
|
|
<wx/html/winpars.h>
|
|
|
|
\wxheading{See Also}
|
|
|
|
\helpref{Handlers overview}{handlers}
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
\membersection{wxHtmlWinParser::wxHtmlWinParser}\label{wxhtmlwinparserwxhtmlwinparser}
|
|
|
|
\func{}{wxHtmlWinParser}{\void}
|
|
|
|
\func{}{wxHtmlWinParser}{\param{wxHtmlWindowInterface }{*wndIface}}
|
|
|
|
Constructor. Don't use the default one, use constructor with
|
|
{\it wndIface} parameter ({\it wndIface} is a pointer to interface object for
|
|
the associated \helpref{wxHtmlWindow}{wxhtmlwindow} or other HTML rendering
|
|
window such as \helpref{wxHtmlListBox}{wxhtmllistbox}).
|
|
|
|
\membersection{wxHtmlWinParser::AddModule}\label{wxhtmlwinparseraddmodule}
|
|
|
|
\func{static void}{AddModule}{\param{wxHtmlTagsModule }{*module}}
|
|
|
|
Adds \helpref{module}{handlers} to the list of wxHtmlWinParser tag handler.
|
|
|
|
\membersection{wxHtmlWinParser::CloseContainer}\label{wxhtmlwinparserclosecontainer}
|
|
|
|
\func{wxHtmlContainerCell*}{CloseContainer}{\void}
|
|
|
|
Closes the container, sets actual container to the parent one
|
|
and returns pointer to it (see \helpref{Overview}{cells}).
|
|
|
|
\membersection{wxHtmlWinParser::CreateCurrentFont}\label{wxhtmlwinparsercreatecurrentfont}
|
|
|
|
\func{virtual wxFont*}{CreateCurrentFont}{\void}
|
|
|
|
Creates font based on current setting (see
|
|
\helpref{SetFontSize}{wxhtmlwinparsersetfontsize},
|
|
\helpref{SetFontBold}{wxhtmlwinparsersetfontbold},
|
|
\helpref{SetFontItalic}{wxhtmlwinparsersetfontitalic},
|
|
\helpref{SetFontFixed}{wxhtmlwinparsersetfontfixed},
|
|
\helpref{SetFontUnderlined}{wxhtmlwinparsersetfontunderlined})
|
|
and returns pointer to it.
|
|
If the font was already created only a pointer is returned.
|
|
|
|
|
|
\membersection{wxHtmlWinParser::GetActualColor}\label{wxhtmlwinparsergetactualcolor}
|
|
|
|
\constfunc{const wxColour\&}{GetActualColor}{\void}
|
|
|
|
Returns actual text colour.
|
|
|
|
\membersection{wxHtmlWinParser::GetAlign}\label{wxhtmlwinparsergetalign}
|
|
|
|
\constfunc{int}{GetAlign}{\void}
|
|
|
|
Returns default horizontal alignment.
|
|
|
|
\membersection{wxHtmlWinParser::GetCharHeight}\label{wxhtmlwinparsergetcharheight}
|
|
|
|
\constfunc{int}{GetCharHeight}{\void}
|
|
|
|
Returns (average) char height in standard font. It is used as DC-independent metrics.
|
|
|
|
{\bf Note:} This function doesn't return the {\it actual} height. If you want to
|
|
know the height of the current font, call {\tt GetDC -> GetCharHeight()}.
|
|
|
|
\membersection{wxHtmlWinParser::GetCharWidth}\label{wxhtmlwinparsergetcharwidth}
|
|
|
|
\constfunc{int}{GetCharWidth}{\void}
|
|
|
|
Returns average char width in standard font. It is used as DC-independent metrics.
|
|
|
|
{\bf Note:} This function doesn't return the {\it actual} width. If you want to
|
|
know the height of the current font, call {\tt GetDC -> GetCharWidth()}
|
|
|
|
\membersection{wxHtmlWinParser::GetContainer}\label{wxhtmlwinparsergetcontainer}
|
|
|
|
\constfunc{wxHtmlContainerCell*}{GetContainer}{\void}
|
|
|
|
Returns pointer to the currently opened container (see \helpref{Overview}{cells}).
|
|
Common use:
|
|
|
|
\begin{verbatim}
|
|
m_WParser -> GetContainer() -> InsertCell(new ...);
|
|
\end{verbatim}
|
|
|
|
\membersection{wxHtmlWinParser::GetDC}\label{wxhtmlwinparsergetdc}
|
|
|
|
\func{wxDC*}{GetDC}{\void}
|
|
|
|
Returns pointer to the DC used during parsing.
|
|
|
|
\membersection{wxHtmlWinParser::GetEncodingConverter}\label{wxhtmlwinparsergetencodingconverter}
|
|
|
|
\constfunc{wxEncodingConverter *}{GetEncodingConverter}{\void}
|
|
|
|
Returns \helpref{wxEncodingConverter}{wxencodingconverter} class used
|
|
to do conversion between \helpref{input encoding}{wxhtmlwinparsergetinputencoding}
|
|
and \helpref{output encoding}{wxhtmlwinparsergetoutputencoding}.
|
|
|
|
\membersection{wxHtmlWinParser::GetFontBold}\label{wxhtmlwinparsergetfontbold}
|
|
|
|
\constfunc{int}{GetFontBold}{\void}
|
|
|
|
Returns true if actual font is bold, false otherwise.
|
|
|
|
\membersection{wxHtmlWinParser::GetFontFace}\label{wxhtmlwinparsergetfontface}
|
|
|
|
\constfunc{wxString}{GetFontFace}{\void}
|
|
|
|
Returns actual font face name.
|
|
|
|
\membersection{wxHtmlWinParser::GetFontFixed}\label{wxhtmlwinparsergetfontfixed}
|
|
|
|
\constfunc{int}{GetFontFixed}{\void}
|
|
|
|
Returns true if actual font is fixed face, false otherwise.
|
|
|
|
\membersection{wxHtmlWinParser::GetFontItalic}\label{wxhtmlwinparsergetfontitalic}
|
|
|
|
\constfunc{int}{GetFontItalic}{\void}
|
|
|
|
Returns true if actual font is italic, false otherwise.
|
|
|
|
\membersection{wxHtmlWinParser::GetFontSize}\label{wxhtmlwinparsergetfontsize}
|
|
|
|
\constfunc{int}{GetFontSize}{\void}
|
|
|
|
Returns actual font size (HTML size varies from -2 to +4)
|
|
|
|
\membersection{wxHtmlWinParser::GetFontUnderlined}\label{wxhtmlwinparsergetfontunderlined}
|
|
|
|
\constfunc{int}{GetFontUnderlined}{\void}
|
|
|
|
Returns true if actual font is underlined, false otherwise.
|
|
|
|
\membersection{wxHtmlWinParser::GetInputEncoding}\label{wxhtmlwinparsergetinputencoding}
|
|
|
|
\constfunc{wxFontEncoding}{GetInputEncoding}{\void}
|
|
|
|
Returns input encoding.
|
|
|
|
\membersection{wxHtmlWinParser::GetLink}\label{wxhtmlwinparsergetlink}
|
|
|
|
\constfunc{const wxHtmlLinkInfo\&}{GetLink}{\void}
|
|
|
|
Returns actual hypertext link. (This value has a non-empty
|
|
\helpref{Href}{wxhtmllinkinfogethref} string
|
|
if the parser is between {\tt <A>} and {\tt </A>} tags,
|
|
wxEmptyString otherwise.)
|
|
|
|
\membersection{wxHtmlWinParser::GetLinkColor}\label{wxhtmlwinparsergetlinkcolor}
|
|
|
|
\constfunc{const wxColour\&}{GetLinkColor}{\void}
|
|
|
|
Returns the colour of hypertext link text.
|
|
|
|
\membersection{wxHtmlWinParser::GetOutputEncoding}\label{wxhtmlwinparsergetoutputencoding}
|
|
|
|
\constfunc{wxFontEncoding}{GetOutputEncoding}{\void}
|
|
|
|
Returns output encoding, i.e. closest match to document's input encoding
|
|
that is supported by operating system.
|
|
|
|
\membersection{wxHtmlWinParser::GetWindow}\label{wxhtmlwinparsergetwindow}
|
|
|
|
\func{wxHtmlWindow*}{GetWindow}{\void}
|
|
|
|
Returns associated window (wxHtmlWindow). This may be NULL! (You should always
|
|
test if it is non-NULL. For example {\tt TITLE} handler sets window
|
|
title only if some window is associated, otherwise it does nothing)
|
|
|
|
\membersection{wxHtmlWinParser::OpenContainer}\label{wxhtmlwinparseropencontainer}
|
|
|
|
\func{wxHtmlContainerCell*}{OpenContainer}{\void}
|
|
|
|
Opens new container and returns pointer to it (see \helpref{Overview}{cells}).
|
|
|
|
\membersection{wxHtmlWinParser::SetActualColor}\label{wxhtmlwinparsersetactualcolor}
|
|
|
|
\func{void}{SetActualColor}{\param{const wxColour\& }{clr}}
|
|
|
|
Sets actual text colour. Note: this DOESN'T change the colour!
|
|
You must create \helpref{wxHtmlColourCell}{wxhtmlcolourcell} yourself.
|
|
|
|
\membersection{wxHtmlWinParser::SetAlign}\label{wxhtmlwinparsersetalign}
|
|
|
|
\func{void}{SetAlign}{\param{int }{a}}
|
|
|
|
Sets default horizontal alignment (see
|
|
\helpref{wxHtmlContainerCell::SetAlignHor}{wxhtmlcontainercellsetalignhor}.)
|
|
Alignment of newly opened container is set to this value.
|
|
|
|
\membersection{wxHtmlWinParser::SetContainer}\label{wxhtmlwinparsersetcontainer}
|
|
|
|
\func{wxHtmlContainerCell*}{SetContainer}{\param{wxHtmlContainerCell *}{c}}
|
|
|
|
Allows you to directly set opened container. This is not recommended - you should use OpenContainer
|
|
wherever possible.
|
|
|
|
\membersection{wxHtmlWinParser::SetDC}\label{wxhtmlwinparsersetdc}
|
|
|
|
\func{virtual void}{SetDC}{\param{wxDC }{*dc}, \param{double }{pixel\_scale = 1.0}}
|
|
|
|
Sets the DC. This must be called before \helpref{Parse}{wxhtmlparserparse}!
|
|
{\it pixel\_scale} can be used when rendering to high-resolution
|
|
DCs (e.g. printer) to adjust size of pixel metrics. (Many dimensions in
|
|
HTML are given in pixels -- e.g. image sizes. 300x300 image would be only one
|
|
inch wide on typical printer. With pixel\_scale = 3.0 it would be 3 inches.)
|
|
|
|
\membersection{wxHtmlWinParser::SetFontBold}\label{wxhtmlwinparsersetfontbold}
|
|
|
|
\func{void}{SetFontBold}{\param{int }{x}}
|
|
|
|
Sets bold flag of actualfont. {\it x} is either true of false.
|
|
|
|
\membersection{wxHtmlWinParser::SetFontFace}\label{wxhtmlwinparsersetfontface}
|
|
|
|
\func{void}{SetFontFace}{\param{const wxString\& }{face}}
|
|
|
|
Sets current font face to {\it face}. This affects either fixed size
|
|
font or proportional, depending on context (whether the parser is
|
|
inside {\tt <TT>} tag or not).
|
|
|
|
\membersection{wxHtmlWinParser::SetFontFixed}\label{wxhtmlwinparsersetfontfixed}
|
|
|
|
\func{void}{SetFontFixed}{\param{int }{x}}
|
|
|
|
Sets fixed face flag of actualfont. {\it x} is either true of false.
|
|
|
|
\membersection{wxHtmlWinParser::SetFontItalic}\label{wxhtmlwinparsersetfontitalic}
|
|
|
|
\func{void}{SetFontItalic}{\param{int }{x}}
|
|
|
|
Sets italic flag of actualfont. {\it x} is either true of false.
|
|
|
|
\membersection{wxHtmlWinParser::SetFontSize}\label{wxhtmlwinparsersetfontsize}
|
|
|
|
\func{void}{SetFontSize}{\param{int }{s}}
|
|
|
|
Sets actual font size (HTML size varies from 1 to 7)
|
|
|
|
\membersection{wxHtmlWinParser::SetFontUnderlined}\label{wxhtmlwinparsersetfontunderlined}
|
|
|
|
\func{void}{SetFontUnderlined}{\param{int }{x}}
|
|
|
|
Sets underlined flag of actualfont. {\it x} is either true of false.
|
|
|
|
\membersection{wxHtmlWinParser::SetFonts}\label{wxhtmlwinparsersetfonts}
|
|
|
|
\func{void}{SetFonts}{\param{const wxString\& }{normal\_face}, \param{const wxString\& }{fixed\_face}, \param{const int }{*sizes = NULL}}
|
|
|
|
Sets fonts. See \helpref{wxHtmlWindow::SetFonts}{wxhtmlwindowsetfonts} for
|
|
detailed description.
|
|
|
|
\membersection{wxHtmlWinParser::SetInputEncoding}\label{wxhtmlwinparsersetinputencoding}
|
|
|
|
\func{void}{SetInputEncoding}{\param{wxFontEncoding }{enc}}
|
|
|
|
Sets input encoding. The parser uses this information to build conversion
|
|
tables from document's encoding to some encoding supported by operating
|
|
system.
|
|
|
|
\membersection{wxHtmlWinParser::SetLink}\label{wxhtmlwinparsersetlink}
|
|
|
|
\func{void}{SetLink}{\param{const wxHtmlLinkInfo\& }{link}}
|
|
|
|
Sets actual hypertext link. Empty link is represented
|
|
by \helpref{wxHtmlLinkInfo}{wxhtmllinkinfo} with {\it Href} equal
|
|
to wxEmptyString.
|
|
|
|
\membersection{wxHtmlWinParser::SetLinkColor}\label{wxhtmlwinparsersetlinkcolor}
|
|
|
|
\func{void}{SetLinkColor}{\param{const wxColour\& }{clr}}
|
|
|
|
Sets colour of hypertext link.
|
|
|