]>
Commit | Line | Data |
---|---|---|
1 | ||
2 | ///////////////////////////////////////////////////////////////////////////// | |
3 | // Name: test.cpp | |
4 | // Purpose: wxHtml testing example | |
5 | ///////////////////////////////////////////////////////////////////////////// | |
6 | ||
7 | #ifdef __GNUG__ | |
8 | #pragma implementation "help.cpp" | |
9 | #pragma interface "help.cpp" | |
10 | #endif | |
11 | ||
12 | // For compilers that support precompilation, includes "wx/wx.h". | |
13 | #include <wx/wxprec.h> | |
14 | ||
15 | #ifdef __BORLANDC__ | |
16 | #pragma hdrstop | |
17 | #endif | |
18 | ||
19 | // for all others, include the necessary headers (this file is usually all you | |
20 | // need because it includes almost all "standard" wxWindows headers | |
21 | #ifndef WX_PRECOMP | |
22 | #include <wx/wx.h> | |
23 | #endif | |
24 | ||
25 | #include <wx/image.h> | |
26 | #include <wx/wxhtml.h> | |
27 | ||
28 | // ---------------------------------------------------------------------------- | |
29 | // private classes | |
30 | // ---------------------------------------------------------------------------- | |
31 | ||
32 | ||
33 | // Define a new application type, each program should derive a class from wxApp | |
34 | class MyApp : public wxApp | |
35 | { | |
36 | public: | |
37 | // override base class virtuals | |
38 | // ---------------------------- | |
39 | ||
40 | // this one is called on application startup and is a good place for the app | |
41 | // initialization (doing it here and not in the ctor allows to have an error | |
42 | // return: if OnInit() returns false, the application terminates) | |
43 | virtual bool OnInit(); | |
44 | }; | |
45 | ||
46 | ||
47 | ||
48 | // Define a new frame type: this is going to be our main frame | |
49 | class MyFrame : public wxFrame | |
50 | { | |
51 | public: | |
52 | // ctor(s) | |
53 | MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size); | |
54 | ||
55 | // event handlers (these functions should _not_ be virtual) | |
56 | void OnQuit(wxCommandEvent& event); | |
57 | void OnHelp(wxCommandEvent& event); | |
58 | void OnClose(wxCloseEvent& event); | |
59 | private: | |
60 | wxHtmlHelpController help; | |
61 | ||
62 | // any class wishing to process wxWindows events must use this macro | |
63 | DECLARE_EVENT_TABLE() | |
64 | }; | |
65 | ||
66 | // ---------------------------------------------------------------------------- | |
67 | // constants | |
68 | // ---------------------------------------------------------------------------- | |
69 | ||
70 | // IDs for the controls and the menu commands | |
71 | enum | |
72 | { | |
73 | // menu items | |
74 | Minimal_Quit = 1, | |
75 | Minimal_Help | |
76 | }; | |
77 | ||
78 | // ---------------------------------------------------------------------------- | |
79 | // event tables and other macros for wxWindows | |
80 | // ---------------------------------------------------------------------------- | |
81 | ||
82 | // the event tables connect the wxWindows events with the functions (event | |
83 | // handlers) which process them. It can be also done at run-time, but for the | |
84 | // simple menu events like this the static method is much simpler. | |
85 | BEGIN_EVENT_TABLE(MyFrame, wxFrame) | |
86 | EVT_MENU(Minimal_Quit, MyFrame::OnQuit) | |
87 | EVT_MENU(Minimal_Help, MyFrame::OnHelp) | |
88 | EVT_CLOSE(MyFrame::OnClose) | |
89 | END_EVENT_TABLE() | |
90 | ||
91 | // Create a new application object: this macro will allow wxWindows to create | |
92 | // the application object during program execution (it's better than using a | |
93 | // static object for many reasons) and also declares the accessor function | |
94 | // wxGetApp() which will return the reference of the right type (i.e. MyApp and | |
95 | // not wxApp) | |
96 | IMPLEMENT_APP(MyApp) | |
97 | ||
98 | // ============================================================================ | |
99 | // implementation | |
100 | // ============================================================================ | |
101 | ||
102 | // ---------------------------------------------------------------------------- | |
103 | // the application class | |
104 | // ---------------------------------------------------------------------------- | |
105 | // `Main program' equivalent: the program execution "starts" here | |
106 | bool MyApp::OnInit() | |
107 | { | |
108 | wxInitAllImageHandlers(); | |
109 | ||
110 | SetVendorName("wxWindows"); | |
111 | SetAppName("wxHTMLHelp"); | |
112 | ||
113 | // Create the main application window | |
114 | MyFrame *frame = new MyFrame("HTML Help Sample", | |
115 | wxPoint(50, 50), wxSize(150, 50)); | |
116 | ||
117 | // Show it and tell the application that it's our main window | |
118 | // @@@ what does it do exactly, in fact? is it necessary here? | |
119 | frame->Show(TRUE); | |
120 | SetTopWindow(frame); | |
121 | ||
122 | ||
123 | // success: wxApp::OnRun() will be called which will enter the main message | |
124 | // loop and the application will run. If we returned FALSE here, the | |
125 | // application would exit immediately. | |
126 | return TRUE; | |
127 | } | |
128 | ||
129 | // ---------------------------------------------------------------------------- | |
130 | // main frame | |
131 | // ---------------------------------------------------------------------------- | |
132 | ||
133 | ||
134 | // frame constructor | |
135 | MyFrame::MyFrame(const wxString& title, const wxPoint& pos, const wxSize& size) | |
136 | : wxFrame((wxFrame *)NULL, -1, title, pos, size), help() | |
137 | { | |
138 | // create a menu bar | |
139 | wxMenu *menuFile = new wxMenu; | |
140 | ||
141 | menuFile->Append(Minimal_Help, "&Help"); | |
142 | menuFile->Append(Minimal_Quit, "E&xit"); | |
143 | ||
144 | // now append the freshly created menu to the menu bar... | |
145 | wxMenuBar *menuBar = new wxMenuBar; | |
146 | menuBar->Append(menuFile, "&File"); | |
147 | ||
148 | // ... and attach this menu bar to the frame | |
149 | SetMenuBar(menuBar); | |
150 | ||
151 | help.UseConfig(wxConfig::Get()); | |
152 | bool ret; | |
153 | help.SetTempDir("."); | |
154 | ret = help.AddBook("helpfiles/testing.hhp"); | |
155 | if (! ret) | |
156 | wxMessageBox("Failed adding book helpfiles/testing.hhp"); | |
157 | ret = help.AddBook("helpfiles/another.hhp"); | |
158 | if (! ret) | |
159 | wxMessageBox("Failed adding book helpfiles/another.hhp"); | |
160 | } | |
161 | ||
162 | ||
163 | // event handlers | |
164 | ||
165 | void MyFrame::OnQuit(wxCommandEvent& WXUNUSED(event)) | |
166 | { | |
167 | // TRUE is to force the frame to close | |
168 | Close(TRUE); | |
169 | } | |
170 | ||
171 | void MyFrame::OnHelp(wxCommandEvent& WXUNUSED(event)) | |
172 | { | |
173 | help.Display("Main page"); | |
174 | } | |
175 | ||
176 | void MyFrame::OnClose(wxCloseEvent& event) | |
177 | { | |
178 | // Close the help frame; this will cause the config data to | |
179 | // get written. | |
180 | if ( help.GetFrame() ) // returns NULL if no help frame active | |
181 | help.GetFrame()->Close(TRUE); | |
182 | // now we can safely delete the config pointer | |
183 | event.Skip(); | |
184 | delete wxConfig::Set(NULL); | |
185 | } | |
186 | ||
187 | ||
188 | ||
189 | ||
190 | ||
191 | ||
192 |