]> git.saurik.com Git - wxWidgets.git/blob - src/html/htmlhelp.cpp
changed version number
[wxWidgets.git] / src / html / htmlhelp.cpp
1 // Name: htmlhelp.cpp
2 // Purpose: Help controller
3 // Author: Vaclav Slavik
4 // Copyright: (c) 1999 Vaclav Slavik
5 // Licence: wxWindows Licence
6 /////////////////////////////////////////////////////////////////////////////
7
8 #error This file should not be compiled! Update your build system! \
9 (configure users, rerun configure to get a new Makefile) \
10 Instead of htmlhelp[_io], use helpdata, helpfrm and helpctrl. This \
11 file is only left to point out the problem and will be removed r.s.n.
12
13 #ifdef __GNUG__
14 #pragma implementation "htmlhelp.h"
15 #endif
16
17 #include "wx/wxprec.h"
18
19 #if wxUSE_HTML
20
21 #ifdef __BORDLANDC__
22 #pragma hdrstop
23 #endif
24
25 #ifndef WXPRECOMP
26 #include <wx/wx.h>
27 #endif
28
29
30 #include <wx/notebook.h>
31 #include <wx/imaglist.h>
32 #include <wx/treectrl.h>
33 #include <wx/tokenzr.h>
34 #include <wx/wfstream.h>
35 #include <wx/html/htmlwin.h>
36 #include <wx/html/htmlhelp.h>
37 #include <wx/busyinfo.h>
38
39 #if !((wxVERSION_NUMBER < 2100) || ((wxVERSION_NUMBER == 2100) && (wxBETA_NUMBER < 7)))
40 #include <wx/progdlg.h>
41 #endif
42
43
44 // Bitmaps:
45
46 #ifndef __WXMSW__
47 #include "bitmaps/panel.xpm"
48 #include "bitmaps/back.xpm"
49 #include "bitmaps/forward.xpm"
50 #include "bitmaps/book.xpm"
51 #include "bitmaps/folder.xpm"
52 #include "bitmaps/page.xpm"
53 #endif
54
55 #include "search.h"
56
57
58
59
60 #include <wx/arrimpl.cpp>
61 WX_DEFINE_OBJARRAY(HtmlBookRecArray)
62
63
64
65
66
67
68
69
70
71 //-----------------------------------------------------------------------------
72 // wxHtmlHelpController
73 //-----------------------------------------------------------------------------
74
75
76 IMPLEMENT_DYNAMIC_CLASS(wxHtmlHelpController, wxEvtHandler)
77
78
79 wxHtmlHelpController::wxHtmlHelpController() : wxEvtHandler()
80 {
81 m_Frame = NULL;
82 m_Config = NULL;
83 m_ConfigRoot = wxEmptyString;
84 m_TitleFormat = _("Help : %s");
85 m_TempPath = wxEmptyString;
86
87 m_Cfg.x = m_Cfg.y = 0;
88 m_Cfg.w = 700; m_Cfg.h = 480;
89 m_Cfg.sashpos = 240;
90 m_Cfg.navig_on = TRUE;
91
92 m_ContentsImageList = new wxImageList(12, 12);
93 m_ContentsImageList -> Add(wxICON(book));
94 m_ContentsImageList -> Add(wxICON(folder));
95 m_ContentsImageList -> Add(wxICON(page));
96
97 m_Contents = NULL;
98 m_ContentsCnt = 0;
99 m_Index = NULL;
100 m_IndexCnt = 0;
101
102 m_IndexBox = NULL;
103 m_ContentsBox = NULL;
104 m_SearchList = NULL;
105 m_SearchText = NULL;
106 m_SearchButton = NULL;
107 m_HtmlWin = NULL;
108 m_Splitter = NULL;
109 m_NavigPan = NULL;
110 }
111
112
113
114 wxHtmlHelpController::~wxHtmlHelpController()
115 {
116 int i;
117
118 m_BookRecords.Empty();
119 delete m_ContentsImageList;
120 if (m_Contents) {
121 for (i = 0; i < m_ContentsCnt; i++) {
122 delete[] m_Contents[i].m_Page;
123 delete[] m_Contents[i].m_Name;
124 }
125 free(m_Contents);
126 }
127 if (m_Index) {
128 for (i = 0; i < m_IndexCnt; i++) {
129 delete[] m_Index[i].m_Page;
130 delete[] m_Index[i].m_Name;
131 }
132 free(m_Index);
133 }
134 }
135
136
137
138 void wxHtmlHelpController::SetTempDir(const wxString& path)
139 {
140 if (path == wxEmptyString) m_TempPath = path;
141 else {
142 if (wxIsAbsolutePath(path)) m_TempPath = path;
143 else m_TempPath = wxGetCwd() + "/" + path;
144
145 if (m_TempPath[m_TempPath.Length() - 1] != '/')
146 m_TempPath << "/";
147 }
148 }
149
150
151
152
153 // Reads one line, stores it into buf and returns pointer to new line or NULL.
154 static char* ReadLine(char *line, char *buf)
155 {
156 char *writeptr = buf, *readptr = line;
157
158 while (*readptr != 0 && *readptr != '\r' && *readptr != '\n') *(writeptr++) = *(readptr++);
159 *writeptr = 0;
160 while (*readptr == '\r' || *readptr == '\n') readptr++;
161 if (*readptr == 0) return NULL;
162 else return readptr;
163 }
164
165
166 static wxString SafeFileName(const wxString& s)
167 {
168 wxString res = s;
169 res.Replace(_T(":"), _T("_"), TRUE);
170 res.Replace(_T(" "), _T("_"), TRUE);
171 res.Replace(_T("/"), _T("_"), TRUE);
172 res.Replace(_T("\\"), _T("_"), TRUE);
173 res.Replace(_T("#"), _T("_"), TRUE);
174 res.Replace(_T("."), _T("_"), TRUE);
175 return res;
176 }
177
178
179 static int IndexCompareFunc(const void *a, const void *b)
180 {
181 return strcmp(((HtmlContentsItem*)a) -> m_Name, ((HtmlContentsItem*)b) -> m_Name);
182 }
183
184
185
186 bool wxHtmlHelpController::AddBook(const wxString& book, bool show_wait_msg)
187 {
188 wxFSFile *fi;
189 wxFileSystem fsys;
190 wxInputStream *s;
191 HtmlBookRecord *bookr;
192 wxString bookFull;
193
194 int sz;
195 char *buff, *lineptr;
196 char linebuf[300];
197
198 wxString title = _("noname"),
199 safetitle,
200 start = wxEmptyString,
201 contents = wxEmptyString, index = wxEmptyString;
202
203 if (wxIsAbsolutePath(book)) bookFull = book;
204 else bookFull = wxGetCwd() + "/" + book;
205
206 fi = fsys.OpenFile(bookFull);
207 if (fi == NULL) return FALSE;
208 fsys.ChangePathTo(bookFull);
209 s = fi -> GetStream();
210 sz = s -> GetSize();
211 buff = new char[sz+1];
212 buff[sz] = 0;
213 s -> Read(buff, sz);
214 lineptr = buff;
215 delete fi;
216
217 while ((lineptr = ReadLine(lineptr, linebuf)) != NULL) {
218 if (strstr(linebuf, "Title=") == linebuf)
219 title = linebuf + strlen("Title=");
220 if (strstr(linebuf, "Default topic=") == linebuf)
221 start = linebuf + strlen("Default topic=");
222 if (strstr(linebuf, "Index file=") == linebuf)
223 index = linebuf + strlen("Index file=");
224 if (strstr(linebuf, "Contents file=") == linebuf)
225 contents = linebuf + strlen("Contents file=");
226 }
227 delete[] buff;
228
229 bookr = new HtmlBookRecord(fsys.GetPath(), title, start);
230
231 if (m_ContentsCnt % HTML_REALLOC_STEP == 0)
232 m_Contents = (HtmlContentsItem*) realloc(m_Contents, (m_ContentsCnt + HTML_REALLOC_STEP) * sizeof(HtmlContentsItem));
233 m_Contents[m_ContentsCnt].m_Level = 0;
234 m_Contents[m_ContentsCnt].m_ID = 0;
235 m_Contents[m_ContentsCnt].m_Page = new char[start.Length() + 1];
236 strcpy(m_Contents[m_ContentsCnt].m_Page, start.c_str());
237 m_Contents[m_ContentsCnt].m_Name = new char [title.Length() + 1];
238 strcpy(m_Contents[m_ContentsCnt].m_Name, title.c_str());
239 m_Contents[m_ContentsCnt].m_Book = bookr;
240 m_ContentsCnt++;
241
242 // Try to find cached binary versions:
243 safetitle = SafeFileName(title);
244 fi = fsys.OpenFile(safetitle + ".cached");
245 if (fi == NULL) fi = fsys.OpenFile(m_TempPath + safetitle + ".cached");
246 if ((fi == NULL) || (m_TempPath == wxEmptyString)) {
247 LoadMSProject(bookr, fsys, index, contents, show_wait_msg);
248 if (m_TempPath != wxEmptyString) {
249 wxFileOutputStream *outs = new wxFileOutputStream(m_TempPath + safetitle + ".cached");
250 SaveCachedBook(bookr, outs);
251 delete outs;
252 }
253 }
254 else {
255 LoadCachedBook(bookr, fi -> GetStream());
256 delete fi;
257 }
258
259 m_BookRecords.Add(bookr);
260 if (m_IndexCnt > 0)
261 qsort(m_Index, m_IndexCnt, sizeof(HtmlContentsItem), IndexCompareFunc);
262
263 return TRUE;
264 }
265
266
267
268
269 void wxHtmlHelpController::Display(const wxString& x)
270 {
271 int cnt;
272 int i;
273 wxFileSystem fsys;
274 wxFSFile *f;
275
276 CreateHelpWindow();
277
278 /* 1. try to open given file: */
279
280 cnt = m_BookRecords.GetCount();
281 for (i = 0; i < cnt; i++) {
282 f = fsys.OpenFile(m_BookRecords[i].GetBasePath() + x);
283 if (f) {
284 m_HtmlWin -> LoadPage(m_BookRecords[i].GetBasePath() + x);
285 delete f;
286 return;
287 }
288 }
289
290
291 /* 2. try to find a book: */
292
293 for (i = 0; i < cnt; i++) {
294 if (m_BookRecords[i].GetTitle() == x) {
295 m_HtmlWin -> LoadPage(m_BookRecords[i].GetBasePath() + m_BookRecords[i].GetStart());
296 return;
297 }
298 }
299
300 /* 3. try to find in contents: */
301
302 cnt = m_ContentsCnt;
303 for (i = 0; i < cnt; i++) {
304 if (strcmp(m_Contents[i].m_Name, x) == 0) {
305 m_HtmlWin -> LoadPage(m_Contents[i].m_Book -> GetBasePath() + m_Contents[i].m_Page);
306 return;
307 }
308 }
309
310
311 /* 4. try to find in index: */
312
313 cnt = m_IndexCnt;
314 for (i = 0; i < cnt; i++) {
315 if (strcmp(m_Index[i].m_Name, x) == 0) {
316 m_HtmlWin -> LoadPage(m_Index[i].m_Book -> GetBasePath() + m_Index[i].m_Page);
317 return;
318 }
319 }
320
321
322 /* 5. if everything failed, search the documents: */
323
324 KeywordSearch(x);
325 }
326
327
328
329 void wxHtmlHelpController::Display(const int id)
330 {
331 CreateHelpWindow();
332
333 for (int i = 0; i < m_ContentsCnt; i++) {
334 if (m_Contents[i].m_ID == id) {
335 m_HtmlWin -> LoadPage(m_Contents[i].m_Book -> GetBasePath() + m_Contents[i].m_Page);
336 return;
337 }
338 }
339 }
340
341
342
343 void wxHtmlHelpController::DisplayContents()
344 {
345 CreateHelpWindow();
346 m_Frame -> Raise();
347 if (!m_Splitter -> IsSplit()) {
348 m_NavigPan -> Show(TRUE);
349 m_HtmlWin -> Show(TRUE);
350 m_Splitter -> SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
351 }
352 m_NavigPan -> SetSelection(0);
353 }
354
355
356
357 void wxHtmlHelpController::DisplayIndex()
358 {
359 CreateHelpWindow();
360 m_Frame -> Raise();
361 if (!m_Splitter -> IsSplit()) {
362 m_NavigPan -> Show(TRUE);
363 m_HtmlWin -> Show(TRUE);
364 m_Splitter -> SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
365 }
366 m_NavigPan -> SetSelection(1);
367 }
368
369
370
371
372 #if (wxVERSION_NUMBER < 2100) || ((wxVERSION_NUMBER == 2100) && (wxBETA_NUMBER < 7))
373
374 class MyProgressDlg : public wxDialog
375 {
376 public:
377 bool m_Canceled;
378
379 MyProgressDlg(wxWindow *parent) : wxDialog(parent, -1,
380 _("Searching..."),
381 wxPoint(0, 0),
382 #ifdef __WXGTK__
383 wxSize(300, 110))
384 #else
385 wxSize(300, 130))
386 #endif
387 {m_Canceled = FALSE;}
388 void OnCancel(wxCommandEvent& event) {m_Canceled = TRUE;}
389 DECLARE_EVENT_TABLE()
390 };
391 BEGIN_EVENT_TABLE(MyProgressDlg, wxDialog)
392 EVT_BUTTON(wxID_CANCEL, MyProgressDlg::OnCancel)
393 END_EVENT_TABLE()
394
395 #endif
396
397
398 bool wxHtmlHelpController::KeywordSearch(const wxString& keyword)
399 {
400 int foundcnt = 0;
401 CreateHelpWindow();
402 // if these are not set, we can't continue
403 if (! (m_SearchList && m_HtmlWin))
404 return FALSE;
405 m_Frame -> Raise();
406 if (m_Splitter && m_NavigPan && m_SearchButton) {
407 if (!m_Splitter -> IsSplit()) {
408 m_NavigPan -> Show(TRUE);
409 m_HtmlWin -> Show(TRUE);
410 m_Splitter -> SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
411 }
412 m_NavigPan -> SetSelection(2);
413 m_SearchList -> Clear();
414 m_SearchText -> SetValue(keyword);
415 m_SearchButton -> Enable(FALSE);
416 }
417 {
418 int cnt = m_ContentsCnt;
419 wxSearchEngine engine;
420 wxFileSystem fsys;
421 wxFSFile *file;
422 wxString lastpage = wxEmptyString;
423 wxString foundstr;
424
425 #if (wxVERSION_NUMBER < 2100) || ((wxVERSION_NUMBER == 2100) && (wxBETA_NUMBER < 7))
426 MyProgressDlg progress(m_Frame);
427
428 wxStaticText *prompt = new wxStaticText(&progress, -1, "", wxPoint(20, 50), wxSize(260, 25), wxALIGN_CENTER);
429 wxGauge *gauge = new wxGauge(&progress, -1, cnt, wxPoint(20, 20), wxSize(260, 25));
430 wxButton *btn = new wxButton(&progress, wxID_CANCEL, _("Cancel"), wxPoint(110, 70), wxSize(80, 25));
431 btn = btn; /* fool compiler :-) */
432 prompt -> SetLabel(_("No matching page found yet"));
433
434 progress.Centre(wxBOTH);
435 progress.Show(TRUE);
436 #else
437 wxProgressDialog progress(_("Searching..."), _("No matching page found yet"), cnt, m_Frame, wxPD_APP_MODAL | wxPD_CAN_ABORT | wxPD_AUTO_HIDE);
438 #endif
439
440 engine.LookFor(keyword);
441
442 for (int i = 0; i < cnt; i++) {
443 #if (wxVERSION_NUMBER < 2100) || ((wxVERSION_NUMBER == 2100) && (wxBETA_NUMBER < 7))
444 gauge -> SetValue(i);
445 if (progress.m_Canceled) break;
446 #else
447 if (progress.Update(i) == FALSE) break;
448 #endif
449 wxYield();
450
451 file = fsys.OpenFile(m_Contents[i].m_Book -> GetBasePath() + m_Contents[i].m_Page);
452 if (file) {
453 if (lastpage != file -> GetLocation()) {
454 lastpage = file -> GetLocation();
455 if (engine.Scan(file -> GetStream())) {
456 foundstr.Printf(_("Found %i matches"), ++foundcnt);
457 #if (wxVERSION_NUMBER < 2100) || ((wxVERSION_NUMBER == 2100) && (wxBETA_NUMBER < 7))
458 prompt -> SetLabel(foundstr);
459 #else
460 progress.Update(i, foundstr);
461 #endif
462 wxYield();
463 m_SearchList -> Append(m_Contents[i].m_Name, (char*)(m_Contents + i));
464 }
465 }
466 delete file;
467 }
468 }
469
470 #if (wxVERSION_NUMBER < 2100) || ((wxVERSION_NUMBER == 2100) && (wxBETA_NUMBER < 7))
471 progress.Close(TRUE);
472 #endif
473 }
474 if (m_SearchButton)
475 m_SearchButton -> Enable(TRUE);
476 if (m_SearchText) {
477 m_SearchText -> SetSelection(0, keyword.Length());
478 m_SearchText -> SetFocus();
479 }
480 if (foundcnt) {
481 HtmlContentsItem *it = (HtmlContentsItem*) m_SearchList -> GetClientData(0);
482 if (it) m_HtmlWin -> LoadPage(it -> m_Book -> GetBasePath() + it -> m_Page);
483 }
484 return (foundcnt > 0);
485 }
486
487
488
489
490
491
492 void wxHtmlHelpController::CreateHelpWindow()
493 {
494 wxBusyCursor cur;
495 wxString oldpath;
496 wxStatusBar *sbar;
497
498 if (m_Frame) {
499 m_Frame -> Raise();
500 m_Frame -> Show(TRUE);
501 return;
502 }
503
504 #if wxUSE_BUSYINFO
505 wxBusyInfo busyinfo(_("Preparing help window..."));
506 #endif
507
508 if (m_Config) ReadCustomization(m_Config, m_ConfigRoot);
509
510 m_Frame = new wxFrame(NULL, -1, "", wxPoint(m_Cfg.x, m_Cfg.y), wxSize(m_Cfg.w, m_Cfg.h));
511 m_Frame -> PushEventHandler(this);
512 sbar = m_Frame -> CreateStatusBar();
513
514 {
515 wxToolBar *toolBar;
516 toolBar = m_Frame -> CreateToolBar(wxNO_BORDER | wxTB_HORIZONTAL | wxTB_FLAT | wxTB_DOCKABLE);
517 toolBar -> SetMargins(2, 2);
518 wxBitmap* toolBarBitmaps[3];
519
520 #ifdef __WXMSW__
521 toolBarBitmaps[0] = new wxBitmap("panel");
522 toolBarBitmaps[1] = new wxBitmap("back");
523 toolBarBitmaps[2] = new wxBitmap("forward");
524 int width = 24;
525 #else
526 toolBarBitmaps[0] = new wxBitmap(panel_xpm);
527 toolBarBitmaps[1] = new wxBitmap(back_xpm);
528 toolBarBitmaps[2] = new wxBitmap(forward_xpm);
529 int width = 16;
530 #endif
531
532 int currentX = 5;
533
534 toolBar -> AddTool(wxID_HTML_PANEL, *(toolBarBitmaps[0]), wxNullBitmap, FALSE, currentX, -1, (wxObject *) NULL, _("Show/hide navigation panel"));
535 currentX += width + 5;
536 toolBar -> AddSeparator();
537 toolBar -> AddTool(wxID_HTML_BACK, *(toolBarBitmaps[1]), wxNullBitmap, FALSE, currentX, -1, (wxObject *) NULL, _("Go back to the previous HTML page"));
538 currentX += width + 5;
539 toolBar -> AddTool(wxID_HTML_FORWARD, *(toolBarBitmaps[2]), wxNullBitmap, FALSE, currentX, -1, (wxObject *) NULL, _("Go forward to the next HTML page"));
540 currentX += width + 5;
541
542 toolBar -> Realize();
543
544 // Can delete the bitmaps since they're reference counted
545 for (int i = 0; i < 3; i++) delete toolBarBitmaps[i];
546 }
547
548
549 {
550 m_Splitter = new wxSplitterWindow(m_Frame);
551
552 m_HtmlWin = new wxHtmlWindow(m_Splitter);
553 m_HtmlWin -> SetRelatedFrame(m_Frame, m_TitleFormat);
554 m_HtmlWin -> SetRelatedStatusBar(0);
555 if (m_Config) m_HtmlWin -> ReadCustomization(m_Config, m_ConfigRoot);
556
557 m_NavigPan = new wxNotebook(m_Splitter, wxID_HTML_NOTEBOOK, wxDefaultPosition, wxDefaultSize);
558 {
559 m_ContentsBox = new wxTreeCtrl(m_NavigPan, wxID_HTML_TREECTRL, wxDefaultPosition, wxDefaultSize, wxTR_HAS_BUTTONS | wxSUNKEN_BORDER);
560 m_ContentsBox -> SetImageList(m_ContentsImageList);
561 m_NavigPan -> AddPage(m_ContentsBox, _("Contents"));
562 }
563
564 {
565 wxWindow *dummy = new wxPanel(m_NavigPan, wxID_HTML_INDEXPAGE);
566 wxLayoutConstraints *b1 = new wxLayoutConstraints;
567 b1 -> top.SameAs (dummy, wxTop, 0);
568 b1 -> left.SameAs (dummy, wxLeft, 0);
569 b1 -> width.PercentOf (dummy, wxWidth, 100);
570 b1 -> bottom.SameAs (dummy, wxBottom, 0);
571 m_IndexBox = new wxListBox(dummy, wxID_HTML_INDEXLIST, wxDefaultPosition, wxDefaultSize, 0);
572 m_IndexBox -> SetConstraints(b1);
573 dummy -> SetAutoLayout(TRUE);
574 m_NavigPan -> AddPage(dummy, _("Index"));
575 }
576
577 {
578 wxWindow *dummy = new wxPanel(m_NavigPan, wxID_HTML_SEARCHPAGE);
579
580 wxLayoutConstraints *b1 = new wxLayoutConstraints;
581 m_SearchText = new wxTextCtrl(dummy, wxID_HTML_SEARCHTEXT);
582 b1 -> top.SameAs (dummy, wxTop, 0);
583 b1 -> left.SameAs (dummy, wxLeft, 0);
584 b1 -> right.SameAs (dummy, wxRight, 0);
585 b1 -> height.AsIs();
586 m_SearchText -> SetConstraints(b1);
587
588 wxLayoutConstraints *b2 = new wxLayoutConstraints;
589 m_SearchButton = new wxButton(dummy, wxID_HTML_SEARCHBUTTON, _("Search!"));
590 b2 -> top.Below (m_SearchText, 10);
591 b2 -> right.SameAs (dummy, wxRight, 10);
592 b2 -> width.AsIs();
593 b2 -> height.AsIs();
594 m_SearchButton -> SetConstraints(b2);
595
596 wxLayoutConstraints *b3 = new wxLayoutConstraints;
597 m_SearchList = new wxListBox(dummy, wxID_HTML_SEARCHLIST, wxDefaultPosition, wxDefaultSize, 0);
598 b3 -> top.Below (m_SearchButton, 10);
599 b3 -> left.SameAs (dummy, wxLeft, 0);
600 b3 -> right.SameAs (dummy, wxRight, 0);
601 b3 -> bottom.SameAs (dummy, wxBottom, 0);
602 m_SearchList -> SetConstraints(b3);
603
604 dummy -> SetAutoLayout(TRUE);
605 dummy -> Layout();
606 m_NavigPan -> AddPage(dummy, _("Search"));
607 }
608
609 RefreshLists();
610 m_NavigPan -> Show(TRUE);
611 m_HtmlWin -> Show(TRUE);
612 m_Splitter -> SetMinimumPaneSize(20);
613 m_Splitter -> SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
614 if (!m_Cfg.navig_on) m_Splitter -> Unsplit(m_NavigPan);
615 wxYield();
616 }
617
618 m_Frame -> Show(TRUE);
619 wxYield();
620 }
621
622
623
624 #define MAX_ROOTS 64
625
626 void wxHtmlHelpController::CreateContents()
627 {
628 HtmlContentsItem *it;
629 wxTreeItemId roots[MAX_ROOTS];
630 bool imaged[MAX_ROOTS];
631 int count = m_ContentsCnt;
632
633 m_ContentsBox -> DeleteAllItems();
634 roots[0] = m_ContentsBox -> AddRoot(_("(Help)"));
635 imaged[0] = TRUE;
636
637 for (int i = 0; i < count; i++) {
638 it = m_Contents + i;
639 roots[it -> m_Level + 1] = m_ContentsBox -> AppendItem(roots[it -> m_Level], it -> m_Name, IMG_Page, -1, new wxHtmlHelpTreeItemData(it));
640 if (it -> m_Level == 0) {
641 m_ContentsBox -> SetItemBold(roots[1], TRUE);
642 m_ContentsBox -> SetItemImage(roots[1], IMG_Book);
643 m_ContentsBox -> SetItemSelectedImage(roots[1], IMG_Book);
644 imaged[1] = TRUE;
645 }
646 else imaged[it -> m_Level + 1] = FALSE;
647
648 if (!imaged[it -> m_Level]) {
649 m_ContentsBox -> SetItemImage(roots[it -> m_Level], IMG_Folder);
650 m_ContentsBox -> SetItemSelectedImage(roots[it -> m_Level], IMG_Folder);
651 imaged[it -> m_Level] = TRUE;
652 }
653 }
654
655 m_ContentsBox -> Expand(roots[0]);
656 }
657
658
659
660
661 void wxHtmlHelpController::CreateIndex()
662 {
663 m_IndexBox -> Clear();
664
665 for (int i = 0; i < m_IndexCnt; i++)
666 m_IndexBox -> Append(m_Index[i].m_Name, (char*)(m_Index + i));
667 }
668
669
670
671 void wxHtmlHelpController::RefreshLists()
672 {
673 if (m_Frame) {
674 CreateContents();
675 CreateIndex();
676 m_SearchList -> Clear();
677 }
678 }
679
680
681
682
683
684
685
686 void wxHtmlHelpController::ReadCustomization(wxConfigBase *cfg, wxString path)
687 {
688 wxString oldpath;
689 wxString tmp;
690
691 if (path != wxEmptyString) {
692 oldpath = cfg -> GetPath();
693 cfg -> SetPath(path);
694 }
695
696 m_Cfg.navig_on = cfg -> Read("hcNavigPanel", m_Cfg.navig_on) != 0;
697 m_Cfg.sashpos = cfg -> Read("hcSashPos", m_Cfg.sashpos);
698 m_Cfg.x = cfg -> Read("hcX", m_Cfg.x);
699 m_Cfg.y = cfg -> Read("hcY", m_Cfg.y);
700 m_Cfg.w = cfg -> Read("hcW", m_Cfg.w);
701 m_Cfg.h = cfg -> Read("hcH", m_Cfg.h);
702
703 if (path != wxEmptyString)
704 cfg -> SetPath(oldpath);
705 }
706
707
708
709 void wxHtmlHelpController::WriteCustomization(wxConfigBase *cfg, wxString path)
710 {
711 wxString oldpath;
712 wxString tmp;
713
714 if (path != wxEmptyString) {
715 oldpath = cfg -> GetPath();
716 cfg -> SetPath(path);
717 }
718
719 cfg -> Write("hcNavigPanel", m_Cfg.navig_on);
720 cfg -> Write("hcSashPos", (long)m_Cfg.sashpos);
721 cfg -> Write("hcX", (long)m_Cfg.x);
722 cfg -> Write("hcY", (long)m_Cfg.y);
723 cfg -> Write("hcW", (long)m_Cfg.w);
724 cfg -> Write("hcH", (long)m_Cfg.h);
725
726 if (path != wxEmptyString)
727 cfg -> SetPath(oldpath);
728 }
729
730
731
732
733
734 /*
735 EVENT HANDLING :
736 */
737
738
739 void wxHtmlHelpController::OnToolbar(wxCommandEvent& event)
740 {
741 switch (event.GetId()) {
742 case wxID_HTML_BACK :
743 m_HtmlWin -> HistoryBack();
744 break;
745 case wxID_HTML_FORWARD :
746 m_HtmlWin -> HistoryForward();
747 break;
748 case wxID_HTML_PANEL :
749 if (m_Splitter -> IsSplit()) {
750 m_Cfg.sashpos = m_Splitter -> GetSashPosition();
751 m_Splitter -> Unsplit(m_NavigPan);
752 }
753 else {
754 m_NavigPan -> Show(TRUE);
755 m_HtmlWin -> Show(TRUE);
756 m_Splitter -> SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
757 }
758 break;
759 }
760 }
761
762
763
764 void wxHtmlHelpController::OnContentsSel(wxTreeEvent& event)
765 {
766 wxHtmlHelpTreeItemData *pg;
767
768 pg = (wxHtmlHelpTreeItemData*) m_ContentsBox -> GetItemData(event.GetItem());
769 if (pg) m_HtmlWin -> LoadPage(pg -> GetPage());
770 }
771
772
773
774 void wxHtmlHelpController::OnIndexSel(wxCommandEvent& event)
775 {
776 HtmlContentsItem *it = (HtmlContentsItem*) m_IndexBox -> GetClientData(m_IndexBox -> GetSelection());
777 if (it) m_HtmlWin -> LoadPage(it -> m_Book -> GetBasePath() + it -> m_Page);
778 }
779
780
781
782 void wxHtmlHelpController::OnSearchSel(wxCommandEvent& event)
783 {
784 HtmlContentsItem *it = (HtmlContentsItem*) m_SearchList -> GetClientData(m_SearchList -> GetSelection());
785 if (it) m_HtmlWin -> LoadPage(it -> m_Book -> GetBasePath() + it -> m_Page);
786 }
787
788
789
790 void wxHtmlHelpController::OnCloseWindow(wxCloseEvent& event)
791 {
792 int a, b;
793
794 m_Cfg.navig_on = m_Splitter -> IsSplit();
795 if (m_Cfg.navig_on)
796 m_Cfg.sashpos = m_Splitter -> GetSashPosition();
797 m_Frame -> GetPosition(&a, &b);
798 m_Cfg.x = a, m_Cfg.y = b;
799 m_Frame -> GetSize(&a, &b);
800 m_Cfg.w = a, m_Cfg.h = b;
801
802 if (m_Config) {
803 WriteCustomization(m_Config, m_ConfigRoot);
804 m_HtmlWin -> WriteCustomization(m_Config, m_ConfigRoot);
805 }
806 m_Frame = NULL;
807
808 event.Skip();
809 }
810
811
812
813 void wxHtmlHelpController::OnSearch(wxCommandEvent& event)
814 {
815 wxString sr = m_SearchText -> GetLineText(0);
816
817 if (sr != wxEmptyString) KeywordSearch(sr);
818 }
819
820
821
822 BEGIN_EVENT_TABLE(wxHtmlHelpController, wxEvtHandler)
823 EVT_TOOL_RANGE(wxID_HTML_PANEL, wxID_HTML_FORWARD, wxHtmlHelpController::OnToolbar)
824 EVT_TREE_SEL_CHANGED(wxID_HTML_TREECTRL, wxHtmlHelpController::OnContentsSel)
825 EVT_LISTBOX(wxID_HTML_INDEXLIST, wxHtmlHelpController::OnIndexSel)
826 EVT_LISTBOX(wxID_HTML_SEARCHLIST, wxHtmlHelpController::OnSearchSel)
827 EVT_CLOSE(wxHtmlHelpController::OnCloseWindow)
828 EVT_BUTTON(wxID_HTML_SEARCHBUTTON, wxHtmlHelpController::OnSearch)
829 EVT_TEXT_ENTER(wxID_HTML_SEARCHTEXT, wxHtmlHelpController::OnSearch)
830 END_EVENT_TABLE()
831
832
833
834 #endif
835