projects / wxWidgets.git / blame
| Commit | Line | Data |
|---|---|---|
| bd330a69 | 1 | \subsection{wxHTML quick start}\label{wxhtmlquickstart} |
| 704a4b75 | 2 | |
| 3980000c | 3 | \wxheading{Displaying HTML} |
| 704a4b75 VS |
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. | |
| 448af9a4 | 9 | It has two important methods: \helpref{LoadPage}{wxhtmlwindowloadpage} |
| 704a4b75 VS |
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>" | |
| f6bcfd97 | 18 | "Some error occurred :-H)" |
| 704a4b75 VS |
19 | "</body></hmtl>"); |
| 20 | \end{verbatim} | |
| 21 | ||
| 22d6efa8 | 22 | I think the difference is quite clear. |
| 704a4b75 VS |
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 | |
| 3980000c RR |
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. | |
| 704a4b75 | 34 | |
| 22d6efa8 | 35 | wxHtmlWindow provides 2 methods in order to handle this: |
| 704a4b75 VS |
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 | ||
| 3980000c RR |
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. | |
| 704a4b75 VS |
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 | ||
| 448af9a4 | 59 | \begin{itemize}\itemsep=0pt |
| 704a4b75 VS |
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 | |
| 36edded9 | 67 | (for example in the registry under Windows, or in a dotfile under Unix). |
| 704a4b75 | 68 |