]> git.saurik.com Git - wxWidgets.git/blame - src/generic/helpwxht.cpp
Various fixes for wxMotif
[wxWidgets.git] / src / generic / helpwxht.cpp
CommitLineData
29ea4a29 1/////////////////////////////////////////////////////////////////////////////
6adaedf0
JS
2// Name: helpwxht.cpp
3// Purpose: A help controller using the wxHTML classes
29ea4a29
KB
4// Author: Karsten Ballueder
5// Modified by:
6// Created: 04/01/98
7// RCS-ID: $Id$
8// Copyright: (c) Karsten Ballueder
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12#ifdef __GNUG__
13# pragma implementation "helpwxht.h"
14#endif
15
16#include "wx/wxprec.h"
17
18#ifdef __BORLANDC__
19# pragma hdrstop
20#endif
21
3a8c693a 22#if wxUSE_WXHTML_HELP
4f84c635 23
29ea4a29 24#ifndef WX_PRECOMP
f6bcfd97
BP
25 #include "wx/string.h"
26 #include "wx/utils.h"
27 #include "wx/list.h"
28 #include "wx/intl.h"
29 #include "wx/layout.h"
30 #include "wx/combobox.h"
31 #include "wx/button.h"
29ea4a29
KB
32#endif
33
34#include "wx/helpbase.h"
35#include "wx/generic/helpwxht.h"
36#include "wx/html/htmlwin.h"
37
38#include <stdio.h>
39#include <ctype.h>
585ae8cb 40#ifndef __MWERKS__
29ea4a29 41#include <sys/stat.h>
585ae8cb 42#endif
29ea4a29 43
004fd0c8 44#if !defined(__WINDOWS__) && !defined(__OS2__)
29ea4a29
KB
45# include <unistd.h>
46#endif
47
48IMPLEMENT_CLASS(wxHelpControllerHtml, wxHTMLHelpControllerBase)
4f84c635 49
29ea4a29 50/**
8dd71e2b 51 This class implements help via wxHTML.
29ea4a29
KB
52 It requires the name of a directory containing the documentation
53 and a file mapping numerical Section numbers to relative URLS.
54*/
55
8dd71e2b
KB
56class wxForceHtmlFilter : public wxHtmlFilter
57{
58public:
420ec58a 59 virtual wxString ReadFile(const wxFSFile& file) const
8dd71e2b
KB
60 {
61 wxInputStream *s = file.GetStream();
62 char *src;
63 wxString doc;
64
65 if (s == NULL) return wxEmptyString;
4ba80ec7
KB
66 src = new char[s -> GetSize()+1];
67 src[s -> GetSize()] = 0;
68 s -> Read(src, s -> GetSize());
8dd71e2b
KB
69 doc = src;
70 delete [] src;
71 return doc;
72 }
004fd0c8 73
420ec58a 74 virtual bool CanRead(const wxFSFile& file) const
8dd71e2b
KB
75 {
76 wxString filename = file.GetLocation();
77 if(filename.Length() >= 5 &&
78 (
79 filename.Right(4).MakeUpper() == ".HTM" ||
80 filename.Right(5).MakeUpper() == ".HTML"))
81 return TRUE;
82 else
83 return FALSE;
84 }
85};
86
87#define FRAME_WIDTH 500
4f84c635 88#define FRAME_HEIGHT 400
29ea4a29
KB
89#define LAYOUT_X_MARGIN 2
90#define LAYOUT_Y_MARGIN 2
91#define OFFSET 10
8dd71e2b
KB
92#define BUTTON_WIDTH 70
93#define MAX_COMBO_ENTRIES 25
4f84c635 94
29ea4a29
KB
95class wxHelpFrame : public wxFrame
96{
97public:
98 wxHelpFrame(wxWindow *parent, int id, const wxString &title,
99 const wxPoint &pos, const wxSize &size,
100 wxHelpControllerHtml *controller);
101 ~wxHelpFrame();
102 void OnClose(wxCloseEvent &ev);
8dd71e2b 103 void OnButton(wxCommandEvent &ev);
29ea4a29
KB
104 bool LoadPage(const wxString &url) { return m_htmlwin->LoadPage(url); }
105private:
106 wxHelpControllerHtml *m_controller;
107 wxHtmlWindow *m_htmlwin;
8dd71e2b
KB
108 wxHtmlFilter *m_filter;
109 wxComboBox *m_combo;
110 long m_IdBack, m_IdFwd, m_IdContents, m_IdCombo, m_IdSearch;
29ea4a29
KB
111 DECLARE_EVENT_TABLE()
112};
113
114BEGIN_EVENT_TABLE(wxHelpFrame, wxFrame)
115 EVT_CLOSE(wxHelpFrame::OnClose)
8dd71e2b 116 EVT_BUTTON(-1, wxHelpFrame::OnButton)
29ea4a29
KB
117END_EVENT_TABLE()
118
8dd71e2b
KB
119
120void
121wxHelpFrame::OnButton(wxCommandEvent &ev)
122{
123 long id =ev.GetId();
124
125 if(id == m_IdBack)
126 m_htmlwin->HistoryBack();
127 else if(id == m_IdFwd)
128 m_htmlwin->HistoryForward();
129 else if(id == m_IdContents)
130 m_controller->DisplayContents();
131 else if(id == m_IdSearch)
132 {
133 wxString str = m_combo->GetValue();
ff8b6290 134 if(m_combo->FindString(str) == -1 && m_combo->GetCount() < MAX_COMBO_ENTRIES)
8dd71e2b
KB
135 m_combo->Append(str);
136 m_controller->KeywordSearch(str);
137 }
138}
139
29ea4a29
KB
140wxHelpFrame::wxHelpFrame(wxWindow *parent, int id,
141 const wxString &title,
142 const wxPoint &pos, const wxSize &size,
143 wxHelpControllerHtml *controller)
144 : wxFrame(parent, id, title, pos, size)
145{
146
147 m_controller = controller;
4f84c635 148 m_htmlwin = new wxHtmlWindow(this,-1,wxDefaultPosition,wxSize(FRAME_WIDTH,
29ea4a29 149 FRAME_HEIGHT));
4f84c635 150
8dd71e2b
KB
151 m_IdBack = wxWindow::NewControlId();
152 m_IdFwd = wxWindow::NewControlId();
153 m_IdContents = wxWindow::NewControlId();
154 m_IdCombo = wxWindow::NewControlId();
155 m_IdSearch = wxWindow::NewControlId();
156
157 wxButton *btn_back = new wxButton(this, m_IdBack, _("Back"));
158 wxButton *btn_fwd = new wxButton(this, m_IdFwd, _("Forward"));
159 wxButton *btn_contents = new wxButton(this, m_IdContents, _("Contents"));
160 m_combo = new wxComboBox(this, m_IdCombo);
161 wxButton *btn_search = new wxButton(this, m_IdSearch, _("Search"));
004fd0c8 162
8dd71e2b
KB
163 m_filter = new wxForceHtmlFilter;
164
29ea4a29
KB
165 wxLayoutConstraints *c;
166
167 c = new wxLayoutConstraints;
168 c->left.SameAs(this, wxLeft, 2*LAYOUT_X_MARGIN);
8dd71e2b 169 c->width.Absolute(BUTTON_WIDTH);
29ea4a29 170 c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
8dd71e2b
KB
171 c->height.AsIs();
172 btn_back->SetConstraints(c);
173
174 c = new wxLayoutConstraints;
175 c->left.SameAs(btn_back, wxRight, 2*LAYOUT_X_MARGIN);
176 c->width.Absolute(BUTTON_WIDTH);
177 c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
178 c->height.AsIs();
179 btn_fwd->SetConstraints(c);
004fd0c8 180
8dd71e2b
KB
181 c = new wxLayoutConstraints;
182 c->left.SameAs(btn_fwd, wxRight, 2*LAYOUT_X_MARGIN);
183 c->width.Absolute(BUTTON_WIDTH);
184 c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
185 c->height.AsIs();
186 btn_contents->SetConstraints(c);
187
188 c = new wxLayoutConstraints;
189 c->left.SameAs(btn_contents, wxRight, 2*LAYOUT_X_MARGIN);
190 c->width.Absolute(3*BUTTON_WIDTH);
191 c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
192 c->height.AsIs();
193 m_combo->SetConstraints(c);
194
195 c = new wxLayoutConstraints;
196 c->left.SameAs(m_combo, wxRight, 2*LAYOUT_X_MARGIN);
197 c->width.Absolute(BUTTON_WIDTH);
198 c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
199 c->height.AsIs();
200 btn_search->SetConstraints(c);
201
202
203 c = new wxLayoutConstraints;
204 c->left.SameAs(this, wxLeft, 2*LAYOUT_X_MARGIN);
205 c->right.SameAs(this, wxRight, 2*LAYOUT_X_MARGIN);
206 c->top.SameAs(btn_back, wxBottom, 2*LAYOUT_Y_MARGIN);
29ea4a29
KB
207 c->bottom.SameAs(this, wxBottom, 2*LAYOUT_Y_MARGIN);
208 m_htmlwin->SetConstraints(c);
209 SetAutoLayout(TRUE);
8dd71e2b 210 CreateStatusBar();
004fd0c8 211
8dd71e2b
KB
212 m_htmlwin->SetRelatedFrame(this, title);
213 m_htmlwin->SetRelatedStatusBar(0);
214 m_htmlwin->AddFilter(m_filter);
215
7b28757f
JS
216#ifdef __WXMOTIF__
217 // Motif needs a nudge to get it to resize properly
218 // when shown
219 wxSizeEvent event(size, GetId());
220 GetEventHandler()->ProcessEvent(event);
221#endif
222
29ea4a29
KB
223 Show(TRUE);
224}
225
226wxHelpFrame::~wxHelpFrame()
227{
228}
229
230void
5e0201ea 231wxHelpFrame::OnClose(wxCloseEvent &WXUNUSED(ev))
29ea4a29
KB
232{
233 wxASSERT(m_controller);
234 m_controller->m_Frame = NULL;
235 bool newFrame;
236 int x,y;
237 GetPosition(&x,&y);
238
239 m_controller->GetFrameParameters(NULL, NULL, &newFrame);
240 m_controller->SetFrameParameters(GetTitle(), GetSize(),
241 wxPoint(x,y),
242 newFrame);
243 Destroy();
244}
245
246wxHelpControllerHtml::wxHelpControllerHtml(void)
247{
248 m_Frame = NULL;
249 m_offset = 0;
4f84c635 250
8dd71e2b 251 SetFrameParameters(_("Help: %s"),
29ea4a29
KB
252 wxSize(FRAME_WIDTH, FRAME_HEIGHT),
253 wxDefaultPosition);
254}
255
256wxHelpControllerHtml::~wxHelpControllerHtml(void)
257{
258 if(m_Frame && ! m_NewFrameEachTime)
259 m_Frame->Close();
260}
261
262
263#ifdef __WXMSW__
264# define SEP '\\'
265#else
266# define SEP '/'
267#endif
268
269bool
f6bcfd97 270wxHelpControllerHtml::DisplayHelp(const wxString &relativeURL)
29ea4a29
KB
271{
272 wxBusyCursor b; // display a busy cursor
273
274 wxString url;
275 url << m_MapFile << SEP<< relativeURL;
276 if(! m_Frame || m_NewFrameEachTime)
277 {
278 m_Frame = new wxHelpFrame(NULL, -1, m_FrameTitle,
279 m_FramePosition+wxPoint(m_offset,m_offset),
280 m_FrameSize,
281 this);
282 if(m_NewFrameEachTime)
283 {
284 m_offset += OFFSET;
285 if(m_offset > 200)
286 m_offset = 0;
287 }
4f84c635 288
29ea4a29 289 }
8dd71e2b 290 m_Frame->Raise();
29ea4a29
KB
291 return m_Frame->LoadPage(url);
292}
293
294
295void
296wxHelpControllerHtml::SetFrameParameters(const wxString &title,
297 const wxSize &size,
298 const wxPoint &pos,
299 bool newFrame)
300{
301 m_FrameTitle = title;
302 m_FrameSize = size;
303 m_FramePosition = pos;
304 m_NewFrameEachTime = newFrame;
305}
306
4ba80ec7 307wxFrame *
259d1674
VZ
308wxHelpControllerHtml::GetFrameParameters(wxSize *size,
309 wxPoint *pos,
310 bool *newframe)
29ea4a29
KB
311{
312 if(size) *size = m_FrameSize;
313 if(pos) *pos = m_FramePosition;
314 if(newframe) *newframe = m_NewFrameEachTime;
4ba80ec7 315 return m_Frame;
29ea4a29 316}
4f84c635 317
3a8c693a
VZ
318#endif // wxUSE_WXHTML_HELP
319