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