1\subsection{wxHTML quick start}\label{wxhtmlquickstart}
2
3\wxheading{Displaying HTML}
4
5First of all, you must include <wx/wxhtml.h>.
6
7Class \helpref{wxHtmlWindow}{wxhtmlwindow} (derived from wxScrolledWindow)
8is used to display HTML documents.
9It has two important methods: \helpref{LoadPage}{wxhtmlwindowloadpage} 
10and \helpref{SetPage}{wxhtmlwindowsetpage}.
11LoadPage loads and displays HTML file while SetPage displays directly the
12passed {\bf string}. See the example:
13
14\begin{verbatim}
15    mywin -> LoadPage("test.htm");
16    mywin -> SetPage("<html><body>"
17                     "<h1>Error</h1>"
18		     "Some error occurred :-H)"
19		     "</body></hmtl>");
20\end{verbatim}
21
22I think the difference is quite clear.
23
24\wxheading{Displaying Help}
25
26See \helpref{wxHtmlHelpController}{wxhtmlhelpcontroller}.
27
28\wxheading{Setting up wxHtmlWindow}
29
30Because wxHtmlWindow is derived from wxScrolledWindow and not from
31wxFrame, it doesn't have visible frame. But the user usually wants to see
32the title of HTML page displayed somewhere and the frame's titlebar is 
33the ideal place for it.
34
35wxHtmlWindow provides 2 methods in order to handle this: 
36\helpref{SetRelatedFrame}{wxhtmlwindowsetrelatedframe} and 
37\helpref{SetRelatedStatusBar}{wxhtmlwindowsetrelatedstatusbar}. 
38See the example:
39
40\begin{verbatim}
41    html = new wxHtmlWindow(this);
42    html -> SetRelatedFrame(this, "HTML : %%s");
43    html -> SetRelatedStatusBar(0);
44\end{verbatim}
45
46The first command associates the HTML object with its parent frame
47(this points to wxFrame object there) and sets the format of the title.
48Page title "Hello, world!" will be displayed as "HTML : Hello, world!"
49in this example.
50
51The second command sets which frame's status bar should be used to display
52browser's messages (such as "Loading..." or "Done" or hypertext links).
53
54\wxheading{Customizing wxHtmlWindow}
55
56You can customize wxHtmlWindow by setting font size, font face and
57borders (space between border of window and displayed HTML). Related functions:
58
59\begin{itemize}\itemsep=0pt
60\item \helpref{SetFonts}{wxhtmlwindowsetfonts}
61\item \helpref{SetBorders}{wxhtmlwindowsetborders}
62\item \helpref{ReadCustomization}{wxhtmlwindowreadcustomization}
63\item \helpref{WriteCustomization}{wxhtmlwindowwritecustomization}
64\end{itemize}
65
66The last two functions are used to store user customization info wxConfig stuff
67(for example in the registry under Windows, or in a dotfile under Unix).
68
69