docs/latex/wx/htmlstrt.tex

   1 \subsection{wxHTML quick start}\label{wxhtmlquickstart}
   2
   3 \wxheading{Displaying HTML}
   4
   5 First of all, you must include <wx/wxhtml.h>.
   6
   7 Class \helpref{wxHtmlWindow}{wxhtmlwindow} (derived from wxScrolledWindow)
   8 is used to display HTML documents.
   9 It has two important methods: \helpref{LoadPage}{wxhtmlwindowloadpage}
  10 and \helpref{SetPage}{wxhtmlwindowsetpage}.
  11 LoadPage loads and displays HTML file while SetPage displays directly the
  12 passed {\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
  22 I think the difference is quite clear.
  23
  24 \wxheading{Displaying Help}
  25
  26 See \helpref{wxHtmlHelpController}{wxhtmlhelpcontroller}.
  27
  28 \wxheading{Setting up wxHtmlWindow}
  29
  30 Because wxHtmlWindow is derived from wxScrolledWindow and not from
  31 wxFrame, it doesn't have visible frame. But the user usually wants to see
  32 the title of HTML page displayed somewhere and the frame's titlebar is
  33 the ideal place for it.
  34
  35 wxHtmlWindow provides 2 methods in order to handle this:
  36 \helpref{SetRelatedFrame}{wxhtmlwindowsetrelatedframe} and
  37 \helpref{SetRelatedStatusBar}{wxhtmlwindowsetrelatedstatusbar}.
  38 See 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
  46 The first command associates the HTML object with its parent frame
  47 (this points to wxFrame object there) and sets the format of the title.
  48 Page title "Hello, world!" will be displayed as "HTML : Hello, world!"
  49 in this example.
  50
  51 The second command sets which frame's status bar should be used to display
  52 browser's messages (such as "Loading..." or "Done" or hypertext links).
  53
  54 \wxheading{Customizing wxHtmlWindow}
  55
  56 You can customize wxHtmlWindow by setting font size, font face and
  57 borders (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
  66 The 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