1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxHtmlHelpFrame
4 // Notes: Based on htmlhelp.cpp, implementing a monolithic
5 // HTML Help controller class, by Vaclav Slavik
6 // Author: Harm van der Heijden and Vaclav Slavik
8 // Copyright: (c) Harm van der Heijden and Vaclav Slavik
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
13 #pragma implementation
16 // For compilers that support precompilation, includes "wx.h"
18 #include "wx/wxprec.h"
31 #include "wx/html/helpfrm.h"
32 #include "wx/notebook.h"
33 #include "wx/imaglist.h"
34 #include "wx/treectrl.h"
35 #include "wx/tokenzr.h"
36 #include "wx/wfstream.h"
37 #include "wx/html/htmlwin.h"
38 #include "wx/busyinfo.h"
39 #include "wx/progdlg.h"
40 #include "wx/toolbar.h"
41 #include "wx/fontenum.h"
46 #include "bitmaps/wpanel.xpm"
47 #include "bitmaps/wback.xpm"
48 #include "bitmaps/wforward.xpm"
49 #include "bitmaps/wbook.xpm"
50 #include "bitmaps/woptions.xpm"
51 #include "bitmaps/wfolder.xpm"
52 #include "bitmaps/wpage.xpm"
53 #include "bitmaps/whelp.xpm"
54 #include "bitmaps/whlproot.xpm"
55 #include "bitmaps/wbkadd.xpm"
56 #include "bitmaps/wbkdel.xpm"
59 #include "wx/stream.h"
61 // number of times that the contents/index creation progress dialog
63 #define PROGRESS_STEP 40
65 // what is considered "small index"?
66 #define INDEX_IS_SMALL 100
69 //--------------------------------------------------------------------------
70 // wxHtmlHelpTreeItemData (private)
71 //--------------------------------------------------------------------------
73 class wxHtmlHelpTreeItemData
: public wxTreeItemData
79 wxHtmlHelpTreeItemData(wxHtmlContentsItem
*it
) : wxTreeItemData()
81 m_Page
= it
-> m_Book
-> GetBasePath() + it
-> m_Page
;
83 const wxString
& GetPage() { return m_Page
; }
89 //---------------------------------------------------------------------------
91 //---------------------------------------------------------------------------
93 IMPLEMENT_DYNAMIC_CLASS(wxHtmlHelpFrame
, wxFrame
)
95 wxHtmlHelpFrame::wxHtmlHelpFrame(wxWindow
* parent
, wxWindowID id
, const wxString
& title
,
96 int style
, wxHtmlHelpData
* data
)
99 Create(parent
, id
, title
, style
);
102 void wxHtmlHelpFrame::Init(wxHtmlHelpData
* data
)
106 m_DataCreated
= FALSE
;
108 m_Data
= new wxHtmlHelpData();
109 m_DataCreated
= TRUE
;
112 m_ContentsImageList
= new wxImageList(16, 16);
113 m_ContentsImageList
-> Add(wxICON(wbook
));
114 m_ContentsImageList
-> Add(wxICON(wfolder
));
115 m_ContentsImageList
-> Add(wxICON(wpage
));
116 m_ContentsImageList
-> Add(wxICON(whlproot
));
118 m_ContentsBox
= NULL
;
120 m_IndexButton
= NULL
;
121 m_IndexButtonAll
= NULL
;
124 m_SearchButton
= NULL
;
126 m_SearchChoice
= NULL
;
127 m_IndexCountInfo
= NULL
;
132 m_SearchCaseSensitive
= NULL
;
133 m_SearchWholeWords
= NULL
;
136 m_ConfigRoot
= wxEmptyString
;
138 m_Cfg
.x
= m_Cfg
.y
= 0;
142 m_Cfg
.navig_on
= TRUE
;
144 m_NormalFonts
= m_FixedFonts
= NULL
;
146 m_NormalFace
= m_FixedFace
= wxEmptyString
;
149 // Create: builds the GUI components.
150 // with the style flag it's possible to toggle the toolbar, contents, index and search
152 // m_HtmlWin will *always* be created, but it's important to realize that
153 // m_ContentsBox, m_IndexList, m_SearchList, m_SearchButton, m_SearchText and
154 // m_SearchButton may be NULL.
155 // moreover, if no contents, index or searchpage is needed, m_Splitter and
156 // m_NavigPan will be NULL too (with m_HtmlWin directly connected to the frame)
158 bool wxHtmlHelpFrame::Create(wxWindow
* parent
, wxWindowID id
, const wxString
& title
,
161 // Do the config in two steps. We read the HtmlWindow customization after we
162 // create the window.
164 ReadCustomization(m_Config
, m_ConfigRoot
);
166 wxFrame::Create(parent
, id
, _("Help"), wxPoint(m_Cfg
.x
, m_Cfg
.y
), wxSize(m_Cfg
.w
, m_Cfg
.h
), wxDEFAULT_FRAME_STYLE
, "wxHtmlHelp");
168 GetPosition(&m_Cfg
.x
, &m_Cfg
.y
);
170 SetIcon(wxICON(whelp
));
172 int notebook_page
= 0;
177 if (style
& wxHF_TOOLBAR
) {
178 wxToolBar
*toolBar
= CreateToolBar(wxNO_BORDER
| wxTB_HORIZONTAL
| wxTB_DOCKABLE
);
179 toolBar
->SetMargins( 2, 2 );
181 toolBar
-> AddTool(wxID_HTML_PANEL
, wxBITMAP(wpanel
), wxNullBitmap
,
182 FALSE
, -1, -1, (wxObject
*) NULL
,
183 _("Show/hide navigation panel"));
184 toolBar
-> AddSeparator();
185 toolBar
-> AddTool(wxID_HTML_BACK
, wxBITMAP(wback
), wxNullBitmap
,
186 FALSE
, -1, -1, (wxObject
*) NULL
,
187 _("Go back to the previous HTML page"));
188 toolBar
-> AddTool(wxID_HTML_FORWARD
, wxBITMAP(wforward
), wxNullBitmap
,
189 FALSE
, -1, -1, (wxObject
*) NULL
,
190 _("Go forward to the next HTML page"));
191 toolBar
-> AddSeparator();
193 if (style
& wxHF_BOOKMARKS
) {
194 m_Bookmarks
= new wxComboBox(toolBar
, wxID_HTML_BOOKMARKSLIST
, wxEmptyString
,
195 wxDefaultPosition
, wxSize(300,-1), 0, NULL
, wxCB_READONLY
| wxCB_SORT
);
196 m_Bookmarks
-> Append(_("<bookmarks>"));
197 for (unsigned i
= 0; i
< m_BookmarksNames
.GetCount(); i
++)
198 m_Bookmarks
-> Append(m_BookmarksNames
[i
]);
199 m_Bookmarks
-> SetSelection(0);
200 toolBar
-> AddControl(m_Bookmarks
);
202 toolBar
-> AddSeparator();
204 toolBar
-> AddTool(wxID_HTML_BOOKMARKSADD
, wxBITMAP(wbkadd
), wxNullBitmap
,
205 FALSE
, -1, -1, (wxObject
*) NULL
,
206 _("Add current page to bookmarks"));
207 toolBar
-> AddTool(wxID_HTML_BOOKMARKSREMOVE
, wxBITMAP(wbkdel
), wxNullBitmap
,
208 FALSE
, -1, -1, (wxObject
*) NULL
,
209 _("Remove current page from bookmarks"));
212 toolBar
-> AddSeparator();
213 toolBar
-> AddTool(wxID_HTML_OPTIONS
, wxBITMAP(woptions
), wxNullBitmap
,
214 FALSE
, -1, -1, (wxObject
*) NULL
,
215 _("Display options dialog"));
217 toolBar
-> Realize();
220 if (style
& (wxHF_CONTENTS
| wxHF_INDEX
| wxHF_SEARCH
)) {
221 // traditional help controller; splitter window with html page on the
222 // right and a notebook containing various pages on the left
223 m_Splitter
= new wxSplitterWindow(this);
225 m_HtmlWin
= new wxHtmlWindow(m_Splitter
);
226 m_NavigPan
= new wxNotebook(m_Splitter
, wxID_HTML_NOTEBOOK
,
227 wxDefaultPosition
, wxDefaultSize
);
228 } else { // only html window, no notebook with index,contents etc
229 m_HtmlWin
= new wxHtmlWindow(this);
232 m_HtmlWin
-> SetRelatedFrame(this, m_TitleFormat
);
233 m_HtmlWin
-> SetRelatedStatusBar(0);
235 m_HtmlWin
-> ReadCustomization(m_Config
, m_ConfigRoot
);
237 // contents tree panel?
238 if (style
& wxHF_CONTENTS
) {
239 m_ContentsBox
= new wxTreeCtrl(m_NavigPan
, wxID_HTML_TREECTRL
,
240 wxDefaultPosition
, wxDefaultSize
,
241 wxTR_HAS_BUTTONS
| wxSUNKEN_BORDER
);
242 m_ContentsBox
-> SetImageList(m_ContentsImageList
);
243 m_NavigPan
-> AddPage(m_ContentsBox
, _("Contents"));
244 m_ContentsPage
= notebook_page
++;
247 // index listbox panel?
248 if (style
& wxHF_INDEX
) {
249 wxWindow
*dummy
= new wxPanel(m_NavigPan
, wxID_HTML_INDEXPAGE
);
251 wxLayoutConstraints
*b1
= new wxLayoutConstraints
;
252 m_IndexText
= new wxTextCtrl(dummy
, wxID_HTML_INDEXTEXT
, wxEmptyString
, wxDefaultPosition
, wxDefaultSize
, wxTE_PROCESS_ENTER
);
253 b1
-> top
.SameAs (dummy
, wxTop
, 10);
254 b1
-> left
.SameAs (dummy
, wxLeft
, 10);
255 b1
-> right
.SameAs (dummy
, wxRight
, 10);
257 m_IndexText
-> SetConstraints(b1
);
259 wxLayoutConstraints
*b4
= new wxLayoutConstraints
;
260 m_IndexButtonAll
= new wxButton(dummy
, wxID_HTML_INDEXBUTTONALL
, _("Show all"));
262 b4
-> top
.Below (m_IndexText
, 10);
263 b4
-> right
.SameAs (dummy
, wxRight
, 10);
266 m_IndexButtonAll
-> SetConstraints(b4
);
268 wxLayoutConstraints
*b2
= new wxLayoutConstraints
;
269 m_IndexButton
= new wxButton(dummy
, wxID_HTML_INDEXBUTTON
, _("Find"));
270 b2
-> top
.Below (m_IndexText
, 10);
271 b2
-> right
.LeftOf (m_IndexButtonAll
, 10);
274 m_IndexButton
-> SetConstraints(b2
);
276 wxLayoutConstraints
*b5
= new wxLayoutConstraints
;
277 m_IndexCountInfo
= new wxStaticText(dummy
, wxID_HTML_COUNTINFO
, wxEmptyString
, wxDefaultPosition
, wxDefaultSize
, wxALIGN_RIGHT
| wxST_NO_AUTORESIZE
);
279 b5
-> top
.Below (m_IndexButton
, 5);
280 b5
-> right
.SameAs (dummy
, wxRight
, 10);
281 b5
-> left
.SameAs (dummy
, wxLeft
, 10);
283 m_IndexCountInfo
-> SetConstraints(b5
);
285 wxLayoutConstraints
*b3
= new wxLayoutConstraints
;
286 m_IndexList
= new wxListBox(dummy
, wxID_HTML_INDEXLIST
, wxDefaultPosition
, wxDefaultSize
, 0, NULL
, wxLB_SINGLE
| wxLB_ALWAYS_SB
);
287 b3
-> top
.Below (m_IndexCountInfo
, 5);
288 b3
-> left
.SameAs (dummy
, wxLeft
, 0);
289 b3
-> right
.SameAs (dummy
, wxRight
, 0);
290 b3
-> bottom
.SameAs (dummy
, wxBottom
, 0);
291 m_IndexList
-> SetConstraints(b3
);
294 m_IndexButtonAll
-> SetToolTip(_("Show all items in index"));
295 m_IndexButton
-> SetToolTip(_("Display all index items that contain given substring. Search is case insensitive."));
296 #endif //wxUSE_TOOLTIPS
298 dummy
-> SetAutoLayout(TRUE
);
301 m_NavigPan
-> AddPage(dummy
, _("Index"));
302 m_IndexPage
= notebook_page
++;
305 // search list panel?
306 if (style
& wxHF_SEARCH
) {
307 wxWindow
*dummy
= new wxPanel(m_NavigPan
, wxID_HTML_SEARCHPAGE
);
309 wxLayoutConstraints
*b1
= new wxLayoutConstraints
;
310 m_SearchText
= new wxTextCtrl(dummy
, wxID_HTML_SEARCHTEXT
, wxEmptyString
, wxDefaultPosition
, wxDefaultSize
, wxTE_PROCESS_ENTER
);
311 b1
-> top
.SameAs (dummy
, wxTop
, 10);
312 b1
-> left
.SameAs (dummy
, wxLeft
, 10);
313 b1
-> right
.SameAs (dummy
, wxRight
, 10);
315 m_SearchText
-> SetConstraints(b1
);
317 wxLayoutConstraints
*b2
= new wxLayoutConstraints
;
318 m_SearchButton
= new wxButton(dummy
, wxID_HTML_SEARCHBUTTON
, _("Search"));
320 m_SearchButton
-> SetToolTip(_("Search contents of help book(s) for all occurences of the text you typed above"));
321 #endif //wxUSE_TOOLTIPS
322 b2
-> top
.Below (m_SearchText
, 10);
323 b2
-> left
.SameAs (dummy
, wxLeft
, 10);
326 m_SearchButton
-> SetConstraints(b2
);
328 wxLayoutConstraints
*b4
= new wxLayoutConstraints
;
329 m_SearchChoice
= new wxChoice(dummy
, wxID_HTML_SEARCHCHOICE
, wxDefaultPosition
,
331 b4
-> top
.Below (m_SearchText
, 10);
332 b4
-> left
.SameAs (m_SearchButton
, wxRight
, 10);
333 b4
-> right
.SameAs (dummy
, wxRight
, 10);
335 m_SearchChoice
-> SetConstraints(b4
);
337 wxLayoutConstraints
*b5
= new wxLayoutConstraints
;
338 m_SearchCaseSensitive
= new wxCheckBox(dummy
, -1, _("Case sensitive"));
339 b5
-> top
.Below (m_SearchButton
, 10);
340 b5
-> left
.SameAs (dummy
, wxLeft
, 10);
341 b5
-> right
.SameAs (dummy
, wxRight
, 10);
342 b5
-> height
.AsIs ();
343 m_SearchCaseSensitive
-> SetConstraints(b5
);
345 wxLayoutConstraints
*b6
= new wxLayoutConstraints
;
346 m_SearchWholeWords
= new wxCheckBox(dummy
, -1, _("Whole words only"));
347 b6
-> top
.Below (m_SearchCaseSensitive
, 0);
348 b6
-> left
.SameAs (dummy
, wxLeft
, 10);
349 b6
-> right
.SameAs (dummy
, wxRight
, 10);
350 b6
-> height
.AsIs ();
351 m_SearchWholeWords
-> SetConstraints(b6
);
353 wxLayoutConstraints
*b3
= new wxLayoutConstraints
;
354 m_SearchList
= new wxListBox(dummy
, wxID_HTML_SEARCHLIST
, wxDefaultPosition
, wxDefaultSize
, 0, NULL
, wxLB_SINGLE
| wxLB_ALWAYS_SB
);
355 b3
-> top
.Below (m_SearchWholeWords
, 10);
356 b3
-> left
.SameAs (dummy
, wxLeft
, 0);
357 b3
-> right
.SameAs (dummy
, wxRight
, 0);
358 b3
-> bottom
.SameAs (dummy
, wxBottom
, 0);
359 m_SearchList
-> SetConstraints(b3
);
361 dummy
-> SetAutoLayout(TRUE
);
363 m_NavigPan
-> AddPage(dummy
, _("Search"));
364 m_SearchPage
= notebook_page
++;
366 m_HtmlWin
-> Show(TRUE
);
371 if (m_NavigPan
&& m_Splitter
) {
372 m_Splitter
-> SetMinimumPaneSize(20);
374 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
376 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
377 m_Splitter
-> Unsplit();
379 if (m_Cfg
.navig_on
) {
380 m_NavigPan
-> Show(TRUE
);
381 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
384 m_NavigPan
-> Show(FALSE
);
385 m_Splitter
-> Initialize(m_HtmlWin
);
391 wxHtmlHelpFrame::~wxHtmlHelpFrame()
393 delete m_ContentsImageList
;
396 if (m_NormalFonts
) delete m_NormalFonts
;
397 if (m_FixedFonts
) delete m_FixedFonts
;
400 bool wxHtmlHelpFrame::Display(const wxString
& x
)
402 wxString url
= m_Data
->FindPageByName(x
);
403 if (! url
.IsEmpty()) {
404 m_HtmlWin
->LoadPage(url
);
410 bool wxHtmlHelpFrame::Display(const int id
)
412 wxString url
= m_Data
->FindPageById(id
);
413 if (! url
.IsEmpty()) {
414 m_HtmlWin
->LoadPage(url
);
422 bool wxHtmlHelpFrame::DisplayContents()
426 if (!m_Splitter
-> IsSplit()) {
427 m_NavigPan
-> Show(TRUE
);
428 m_HtmlWin
-> Show(TRUE
);
429 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
430 m_Cfg
.navig_on
= TRUE
;
432 m_NavigPan
-> SetSelection(0);
438 bool wxHtmlHelpFrame::DisplayIndex()
442 if (!m_Splitter
-> IsSplit()) {
443 m_NavigPan
-> Show(TRUE
);
444 m_HtmlWin
-> Show(TRUE
);
445 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
447 m_NavigPan
-> SetSelection(1);
451 bool wxHtmlHelpFrame::KeywordSearch(const wxString
& keyword
)
453 if (! (m_SearchList
&& m_SearchButton
&& m_SearchText
&& m_SearchChoice
))
456 int foundcnt
= 0, curi
;
458 wxString book
= wxEmptyString
;
460 if (!m_Splitter
-> IsSplit()) {
461 m_NavigPan
-> Show(TRUE
);
462 m_HtmlWin
-> Show(TRUE
);
463 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
465 m_NavigPan
-> SetSelection(m_SearchPage
);
466 m_SearchList
-> Clear();
467 m_SearchText
-> SetValue(keyword
);
468 m_SearchButton
-> Enable(FALSE
);
470 if (m_SearchChoice
->GetSelection() != 0)
471 book
= m_SearchChoice
->GetStringSelection();
473 wxHtmlSearchStatus
status(m_Data
, keyword
,
474 m_SearchCaseSensitive
-> GetValue(), m_SearchWholeWords
-> GetValue(),
477 wxProgressDialog
progress(_("Searching..."), _("No matching page found yet"),
478 status
.GetMaxIndex(), this,
479 wxPD_APP_MODAL
| wxPD_CAN_ABORT
| wxPD_AUTO_HIDE
| wxGA_SMOOTH
);
481 while (status
.IsActive()) {
482 curi
= status
.GetCurIndex();
483 if (curi
% 10 == 0 && progress
.Update(curi
) == FALSE
)
485 if (status
.Search()) {
486 foundstr
.Printf(_("Found %i matches"), ++foundcnt
);
487 progress
.Update(status
.GetCurIndex(), foundstr
);
488 m_SearchList
-> Append(status
.GetName(), status
.GetContentsItem());
493 m_SearchButton
-> Enable(TRUE
);
494 m_SearchText
-> SetSelection(0, keyword
.Length());
495 m_SearchText
-> SetFocus();
497 wxHtmlContentsItem
*it
= (wxHtmlContentsItem
*) m_SearchList
-> GetClientData(0);
498 if (it
) m_HtmlWin
-> LoadPage(it
-> m_Book
-> GetBasePath() + it
-> m_Page
);
500 return (foundcnt
> 0);
505 void wxHtmlHelpFrame::CreateContents(bool show_progress
)
510 wxProgressDialog
*progress
= NULL
;
513 m_ContentsBox
->Clear();
515 int cnt
= m_Data
->GetContentsCnt();
516 int div
= (cnt
/ PROGRESS_STEP
) + 1;
519 wxHtmlContentsItem
*it
;
522 progress
= new wxProgressDialog(_("Building contents tree..."), wxEmptyString
,
523 cnt
, this, wxPD_APP_MODAL
| wxPD_CAN_ABORT
|
526 wxTreeItemId roots
[MAX_ROOTS
];
527 bool imaged
[MAX_ROOTS
];
529 m_ContentsBox
-> DeleteAllItems();
530 roots
[0] = m_ContentsBox
-> AddRoot(_("(Help)"));
531 m_ContentsBox
-> SetItemImage(roots
[0], IMG_RootFolder
);
532 m_ContentsBox
-> SetItemSelectedImage(roots
[0], IMG_RootFolder
);
535 for (it
= m_Data
->GetContents(), i
= 0; i
< cnt
; i
++, it
++) {
536 if (show_progress
&& ((i
% div
) == 0)) {
537 proginfo
.Printf(_("Added %d/%d items"), i
, cnt
);
538 if (! progress
->Update(i
, proginfo
))
542 roots
[it
-> m_Level
+ 1] = m_ContentsBox
-> AppendItem(
543 roots
[it
-> m_Level
], it
-> m_Name
, IMG_Page
, -1,
544 new wxHtmlHelpTreeItemData(it
));
546 if (it
-> m_Level
== 0) {
547 m_ContentsBox
-> SetItemBold(roots
[1], TRUE
);
548 m_ContentsBox
-> SetItemImage(roots
[1], IMG_Book
);
549 m_ContentsBox
-> SetItemSelectedImage(roots
[1], IMG_Book
);
551 } else imaged
[it
-> m_Level
+ 1] = FALSE
;
553 if (!imaged
[it
-> m_Level
]) {
554 m_ContentsBox
-> SetItemImage(roots
[it
-> m_Level
], IMG_Folder
);
555 m_ContentsBox
-> SetItemSelectedImage(roots
[it
-> m_Level
], IMG_Folder
);
556 imaged
[it
-> m_Level
] = TRUE
;
561 m_ContentsBox
-> Expand(roots
[0]);
565 void wxHtmlHelpFrame::CreateIndex(bool show_progress
)
570 wxProgressDialog
*progress
= NULL
;
573 m_IndexList
->Clear();
575 int cnt
= m_Data
->GetIndexCnt();
578 if (cnt
> INDEX_IS_SMALL
) cnttext
.Printf(_("%i of %i"), 0, cnt
);
579 else cnttext
.Printf(_("%i of %i"), cnt
, cnt
);
580 m_IndexCountInfo
-> SetLabel(cnttext
);
581 if (cnt
> INDEX_IS_SMALL
) return;
583 int div
= (cnt
/ PROGRESS_STEP
) + 1;
585 wxHtmlContentsItem
* index
= m_Data
->GetIndex();
588 progress
= new wxProgressDialog(_("Building index list..."), wxEmptyString
,
589 cnt
, this, wxPD_APP_MODAL
| wxPD_CAN_ABORT
|
591 for (int i
= 0; i
< cnt
; i
++) {
592 if (show_progress
&& ((i
% div
) == 0)) {
593 proginfo
.Printf(_("Added %d/%d items"), i
, cnt
);
594 if (! progress
->Update(i
, proginfo
))
598 m_IndexList
-> Append(index
[i
].m_Name
, (char*)(index
+ i
));
605 void wxHtmlHelpFrame::CreateSearch()
607 if (! (m_SearchList
&& m_SearchChoice
))
609 m_SearchList
-> Clear();
610 m_SearchChoice
-> Clear();
611 m_SearchChoice
-> Append(_("all books"));
612 const wxHtmlBookRecArray
& bookrec
= m_Data
->GetBookRecArray();
613 int i
, cnt
= bookrec
.GetCount();
614 for (i
= 0; i
< cnt
; i
++)
615 m_SearchChoice
->Append(bookrec
[i
].GetTitle());
616 m_SearchChoice
->SetSelection(0);
620 void wxHtmlHelpFrame::RefreshLists(bool show_progress
)
622 CreateContents(show_progress
);
623 CreateIndex(show_progress
);
627 void wxHtmlHelpFrame::ReadCustomization(wxConfigBase
*cfg
, const wxString
& path
)
632 if (path
!= wxEmptyString
) {
633 oldpath
= cfg
-> GetPath();
634 cfg
-> SetPath(_T("/") + path
);
637 m_Cfg
.navig_on
= cfg
-> Read("hcNavigPanel", m_Cfg
.navig_on
) != 0;
638 m_Cfg
.sashpos
= cfg
-> Read("hcSashPos", m_Cfg
.sashpos
);
639 m_Cfg
.x
= cfg
-> Read("hcX", m_Cfg
.x
);
640 m_Cfg
.y
= cfg
-> Read("hcY", m_Cfg
.y
);
641 m_Cfg
.w
= cfg
-> Read("hcW", m_Cfg
.w
);
642 m_Cfg
.h
= cfg
-> Read("hcH", m_Cfg
.h
);
644 m_FixedFace
= cfg
-> Read("hcFixedFace", m_FixedFace
);
645 m_NormalFace
= cfg
-> Read("hcNormalFace", m_NormalFace
);
646 m_FontSize
= cfg
-> Read("hcFontSize", m_FontSize
);
653 cnt
= cfg
-> Read("hcBookmarksCnt", 0L);
655 m_BookmarksNames
.Clear();
656 m_BookmarksPages
.Clear();
658 m_Bookmarks
-> Clear();
659 m_Bookmarks
-> Append(_("<bookmarks>"));
662 for (i
= 0; i
< cnt
; i
++) {
663 val
.Printf(wxT("hcBookmark_%i"), i
);
664 s
= cfg
-> Read(val
);
665 m_BookmarksNames
.Add(s
);
666 if (m_Bookmarks
) m_Bookmarks
-> Append(s
);
667 val
.Printf(wxT("hcBookmark_%i_url"), i
);
668 s
= cfg
-> Read(val
);
669 m_BookmarksPages
.Add(s
);
675 m_HtmlWin
->ReadCustomization(cfg
);
677 if (path
!= wxEmptyString
)
678 cfg
-> SetPath(oldpath
);
681 void wxHtmlHelpFrame::WriteCustomization(wxConfigBase
*cfg
, const wxString
& path
)
686 if (path
!= wxEmptyString
) {
687 oldpath
= cfg
-> GetPath();
688 cfg
-> SetPath(_T("/") + path
);
691 cfg
-> Write("hcNavigPanel", m_Cfg
.navig_on
);
692 cfg
-> Write("hcSashPos", (long)m_Cfg
.sashpos
);
693 cfg
-> Write("hcX", (long)m_Cfg
.x
);
694 cfg
-> Write("hcY", (long)m_Cfg
.y
);
695 cfg
-> Write("hcW", (long)m_Cfg
.w
);
696 cfg
-> Write("hcH", (long)m_Cfg
.h
);
697 cfg
-> Write("hcFixedFace", m_FixedFace
);
698 cfg
-> Write("hcNormalFace", m_NormalFace
);
699 cfg
-> Write("hcFontSize", (long)m_FontSize
);
703 int cnt
= m_BookmarksNames
.GetCount();
706 cfg
-> Write("hcBookmarksCnt", (long)cnt
);
707 for (i
= 0; i
< cnt
; i
++) {
708 val
.Printf(wxT("hcBookmark_%i"), i
);
709 cfg
-> Write(val
, m_BookmarksNames
[i
]);
710 val
.Printf(wxT("hcBookmark_%i_url"), i
);
711 cfg
-> Write(val
, m_BookmarksPages
[i
]);
716 m_HtmlWin
->WriteCustomization(cfg
);
718 if (path
!= wxEmptyString
)
719 cfg
-> SetPath(oldpath
);
726 static void SetFontsToHtmlWin(wxHtmlWindow
*win
, wxString scalf
, wxString fixf
, int size
)
728 static int f_sizes
[3][7] =
730 { 8, 9, 12, 14, 16, 19, 22},
731 {10, 12, 14, 16, 19, 24, 32},
732 {14, 16, 18, 24, 32, 38, 45}
735 win
-> SetFonts(scalf
, fixf
, f_sizes
[size
]);
739 class wxHtmlHelpFrameOptionsDialog
: public wxDialog
742 wxComboBox
*NormalFont
, *FixedFont
;
743 wxRadioBox
*RadioBox
;
744 wxHtmlWindow
*TestWin
;
746 wxHtmlHelpFrameOptionsDialog(wxWindow
*parent
) : wxDialog(parent
, -1, wxString(_("Help Browser Options")))
748 wxString choices
[3] = {_("small"), _("medium"), _("large")};
749 wxBoxSizer
*topsizer
, *sizer
, *sizer2
;
751 topsizer
= new wxBoxSizer(wxVERTICAL
);
753 sizer
= new wxBoxSizer(wxHORIZONTAL
);
755 sizer2
= new wxStaticBoxSizer( new wxStaticBox(this, -1, _("Normal font:")), wxVERTICAL
);
756 sizer2
-> Add(NormalFont
= new wxComboBox(this, -1, wxEmptyString
, wxDefaultPosition
,
758 0, NULL
, wxCB_DROPDOWN
| wxCB_READONLY
),
759 1, wxEXPAND
| wxLEFT
| wxRIGHT
, 10);
761 sizer
-> Add(sizer2
, 0, wxEXPAND
| wxLEFT
|wxRIGHT
|wxTOP
, 10);
763 sizer2
= new wxStaticBoxSizer( new wxStaticBox(this, -1, _("Fixed font:")), wxVERTICAL
);
764 sizer2
-> Add(FixedFont
= new wxComboBox(this, -1, wxEmptyString
, wxDefaultPosition
,
766 0, NULL
, wxCB_DROPDOWN
| wxCB_READONLY
),
767 1, wxEXPAND
| wxLEFT
| wxRIGHT
, 10);
769 sizer
-> Add(sizer2
, 0, wxEXPAND
| wxLEFT
|wxRIGHT
|wxTOP
, 10);
771 topsizer
-> Add(sizer
);
773 topsizer
-> Add(RadioBox
= new wxRadioBox(this, -1, _("Font size:"),
774 wxDefaultPosition
, wxDefaultSize
, 3, choices
, 3),
775 0, wxEXPAND
| wxLEFT
|wxRIGHT
|wxTOP
, 10);
777 topsizer
-> Add(new wxStaticText(this, -1, _("Preview:")),
778 0, wxLEFT
| wxTOP
, 10);
779 topsizer
-> Add(TestWin
= new wxHtmlWindow(this, -1, wxDefaultPosition
, wxSize(-1, 150)),
780 1, wxEXPAND
| wxLEFT
|wxTOP
|wxRIGHT
, 10);
782 sizer
= new wxBoxSizer(wxHORIZONTAL
);
783 sizer
-> Add(new wxButton(this, wxID_OK
, _("OK")), 0, wxALL
, 10);
784 sizer
-> Add(new wxButton(this, wxID_CANCEL
, _("Cancel")), 0, wxALL
, 10);
785 topsizer
-> Add(sizer
, 0, wxALIGN_RIGHT
);
789 topsizer
-> Fit(this);
797 SetFontsToHtmlWin(TestWin
,
798 NormalFont
-> GetStringSelection(),
799 FixedFont
-> GetStringSelection(),
800 RadioBox
-> GetSelection());
801 TestWin
-> SetPage(_("<html><body>"
802 "Normal face<br>(and <u>underlined</u>. <i>Italic face.</i> "
803 "<b>Bold face.</b> <b><i>Bold italic face.</i></b><br>"
804 "<font size=-2>font size -2</font><br>"
805 "<font size=-1>font size -1</font><br>"
806 "<font size=+0>font size +0</font><br>"
807 "<font size=+1>font size +1</font><br>"
808 "<font size=+2>font size +2</font><br>"
809 "<font size=+3>font size +3</font><br>"
810 "<font size=+4>font size +4</font><br>"
812 "<p><tt>Fixed size face.<br> <b>bold</b> <i>italic</i> "
813 "<b><i>bold italic <u>underlined</u></i></b><br>"
814 "<font size=-2>font size -2</font><br>"
815 "<font size=-1>font size -1</font><br>"
816 "<font size=+0>font size +0</font><br>"
817 "<font size=+1>font size +1</font><br>"
818 "<font size=+2>font size +2</font><br>"
819 "<font size=+3>font size +3</font><br>"
820 "<font size=+4>font size +4</font></tt>"
824 void OnUpdate(wxCloseEvent
& event
)
829 DECLARE_EVENT_TABLE()
832 BEGIN_EVENT_TABLE(wxHtmlHelpFrameOptionsDialog
, wxDialog
)
833 EVT_COMBOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate
)
834 EVT_RADIOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate
)
838 void wxHtmlHelpFrame::OptionsDialog()
840 wxHtmlHelpFrameOptionsDialog
dlg(this);
843 if (m_NormalFonts
== NULL
) {
844 wxFontEnumerator enu
;
845 enu
.EnumerateFacenames();
846 m_NormalFonts
= new wxArrayString
;
847 *m_NormalFonts
= *enu
.GetFacenames();
848 m_NormalFonts
-> Sort();
850 if (m_FixedFonts
== NULL
) {
851 wxFontEnumerator enu
;
852 enu
.EnumerateFacenames(wxFONTENCODING_SYSTEM
, TRUE
);
853 m_FixedFonts
= new wxArrayString
;
854 *m_FixedFonts
= *enu
.GetFacenames();
855 m_FixedFonts
-> Sort();
858 for (i
= 0; i
< m_NormalFonts
-> GetCount(); i
++)
859 dlg
.NormalFont
-> Append((*m_NormalFonts
)[i
]);
860 for (i
= 0; i
< m_FixedFonts
-> GetCount(); i
++)
861 dlg
.FixedFont
-> Append((*m_FixedFonts
)[i
]);
862 if (!m_NormalFace
.IsEmpty()) dlg
.NormalFont
-> SetStringSelection(m_NormalFace
);
863 else dlg
.NormalFont
-> SetSelection(0);
864 if (!m_FixedFace
.IsEmpty()) dlg
.FixedFont
-> SetStringSelection(m_FixedFace
);
865 else dlg
.FixedFont
-> SetSelection(0);
866 dlg
.RadioBox
-> SetSelection(m_FontSize
);
869 if (dlg
.ShowModal() == wxID_OK
) {
870 m_NormalFace
= dlg
.NormalFont
-> GetStringSelection();
871 m_FixedFace
= dlg
.FixedFont
-> GetStringSelection();
872 m_FontSize
= dlg
.RadioBox
-> GetSelection();
873 SetFontsToHtmlWin(m_HtmlWin
, m_NormalFace
, m_FixedFace
, m_FontSize
);
886 void wxHtmlHelpFrame::OnToolbar(wxCommandEvent
& event
)
888 switch (event
.GetId()) {
890 case wxID_HTML_BACK
:
891 m_HtmlWin
-> HistoryBack();
894 case wxID_HTML_FORWARD
:
895 m_HtmlWin
-> HistoryForward();
898 case wxID_HTML_PANEL
:
899 if (! (m_Splitter
&& m_NavigPan
))
901 if (m_Splitter
-> IsSplit()) {
902 m_Cfg
.sashpos
= m_Splitter
-> GetSashPosition();
903 m_Splitter
-> Unsplit(m_NavigPan
);
904 m_Cfg
.navig_on
= FALSE
;
906 m_NavigPan
-> Show(TRUE
);
907 m_HtmlWin
-> Show(TRUE
);
908 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
909 m_Cfg
.navig_on
= TRUE
;
913 case wxID_HTML_OPTIONS
:
917 case wxID_HTML_BOOKMARKSADD
:
922 item
= m_HtmlWin
-> GetOpenedPageTitle();
923 url
= m_HtmlWin
-> GetOpenedPage();
924 if (item
== wxEmptyString
) item
= url
.AfterLast(wxT('/'));
925 if (m_BookmarksPages
.Index(url
) == wxNOT_FOUND
) {
926 m_Bookmarks
-> Append(item
);
927 m_BookmarksNames
.Add(item
);
928 m_BookmarksPages
.Add(url
);
933 case wxID_HTML_BOOKMARKSREMOVE
:
938 item
= m_Bookmarks
-> GetStringSelection();
939 pos
= m_BookmarksNames
.Index(item
);
940 if (pos
!= wxNOT_FOUND
) {
941 m_BookmarksNames
.Remove(pos
);
942 m_BookmarksPages
.Remove(pos
);
943 m_Bookmarks
-> Delete(m_Bookmarks
-> GetSelection());
952 void wxHtmlHelpFrame::OnContentsSel(wxTreeEvent
& event
)
954 wxHtmlHelpTreeItemData
*pg
;
956 pg
= (wxHtmlHelpTreeItemData
*) m_ContentsBox
-> GetItemData(event
.GetItem());
957 if (pg
) m_HtmlWin
-> LoadPage(pg
-> GetPage());
962 void wxHtmlHelpFrame::OnIndexSel(wxCommandEvent
& WXUNUSED(event
))
964 wxHtmlContentsItem
*it
= (wxHtmlContentsItem
*) m_IndexList
-> GetClientData(m_IndexList
-> GetSelection());
965 m_HtmlWin
-> LoadPage(it
-> m_Book
-> GetBasePath() + it
-> m_Page
);
969 void wxHtmlHelpFrame::OnIndexFind(wxCommandEvent
& event
)
971 wxString sr
= m_IndexText
-> GetLineText(0);
973 if (sr
== wxEmptyString
)
978 const wxChar
*cstr
= sr
.c_str();
979 wxChar mybuff
[512], *ptr
;
982 m_IndexList
->Clear();
983 int cnt
= m_Data
->GetIndexCnt();
984 wxHtmlContentsItem
* index
= m_Data
->GetIndex();
987 for (int i
= 0; i
< cnt
; i
++)
989 wxStrncpy(mybuff
, index
[i
].m_Name
, 512);
991 for (ptr
= mybuff
; *ptr
!= 0; ptr
++)
992 if (*ptr
>= 'A' && *ptr
<= 'Z') *ptr
-= 'A' - 'a';
993 if (wxStrstr(mybuff
, cstr
) != NULL
) {
994 m_IndexList
-> Append(index
[i
].m_Name
, (char*)(index
+ i
));
997 m_HtmlWin
-> LoadPage(index
[i
].m_Book
-> GetBasePath() + index
[i
].m_Page
);
1004 cnttext
.Printf(_("%i of %i"), displ
, cnt
);
1005 m_IndexCountInfo
-> SetLabel(cnttext
);
1007 m_IndexText
-> SetSelection(0, sr
.Length());
1008 m_IndexText
-> SetFocus();
1012 void wxHtmlHelpFrame::OnIndexAll(wxCommandEvent
& WXUNUSED(event
))
1016 m_IndexList
->Clear();
1017 int cnt
= m_Data
->GetIndexCnt();
1019 wxHtmlContentsItem
* index
= m_Data
->GetIndex();
1021 for (int i
= 0; i
< cnt
; i
++) {
1022 m_IndexList
-> Append(index
[i
].m_Name
, (char*)(index
+ i
));
1024 m_HtmlWin
-> LoadPage(index
[i
].m_Book
-> GetBasePath() + index
[i
].m_Page
);
1030 cnttext
.Printf(_("%i of %i"), cnt
, cnt
);
1031 m_IndexCountInfo
-> SetLabel(cnttext
);
1035 void wxHtmlHelpFrame::OnSearchSel(wxCommandEvent
& WXUNUSED(event
))
1037 wxHtmlContentsItem
*it
= (wxHtmlContentsItem
*) m_SearchList
-> GetClientData(m_SearchList
-> GetSelection());
1038 if (it
) m_HtmlWin
-> LoadPage(it
-> m_Book
-> GetBasePath() + it
-> m_Page
);
1041 void wxHtmlHelpFrame::OnSearch(wxCommandEvent
& WXUNUSED(event
))
1043 wxString sr
= m_SearchText
-> GetLineText(0);
1045 if (sr
!= wxEmptyString
) KeywordSearch(sr
);
1048 void wxHtmlHelpFrame::OnBookmarksSel(wxCommandEvent
& WXUNUSED(event
))
1050 wxString sr
= m_Bookmarks
-> GetStringSelection();
1052 if (sr
!= wxEmptyString
&& sr
!= _("<bookmarks>"))
1053 m_HtmlWin
-> LoadPage(m_BookmarksPages
[m_BookmarksNames
.Index(sr
)]);
1056 void wxHtmlHelpFrame::OnCloseWindow(wxCloseEvent
& evt
)
1058 GetSize(&m_Cfg
.w
, &m_Cfg
.h
);
1059 GetPosition(&m_Cfg
.x
, &m_Cfg
.y
);
1061 if (m_Splitter
&& m_Cfg
.navig_on
) m_Cfg
.sashpos
= m_Splitter
-> GetSashPosition();
1064 WriteCustomization(m_Config
, m_ConfigRoot
);
1069 BEGIN_EVENT_TABLE(wxHtmlHelpFrame
, wxFrame
)
1070 EVT_TOOL_RANGE(wxID_HTML_PANEL
, wxID_HTML_BOOKMARKSREMOVE
, wxHtmlHelpFrame::OnToolbar
)
1071 EVT_TREE_SEL_CHANGED(wxID_HTML_TREECTRL
, wxHtmlHelpFrame::OnContentsSel
)
1072 EVT_LISTBOX(wxID_HTML_INDEXLIST
, wxHtmlHelpFrame::OnIndexSel
)
1073 EVT_LISTBOX(wxID_HTML_SEARCHLIST
, wxHtmlHelpFrame::OnSearchSel
)
1074 EVT_BUTTON(wxID_HTML_SEARCHBUTTON
, wxHtmlHelpFrame::OnSearch
)
1075 EVT_TEXT_ENTER(wxID_HTML_SEARCHTEXT
, wxHtmlHelpFrame::OnSearch
)
1076 EVT_BUTTON(wxID_HTML_INDEXBUTTON
, wxHtmlHelpFrame::OnIndexFind
)
1077 EVT_TEXT_ENTER(wxID_HTML_INDEXTEXT
, wxHtmlHelpFrame::OnIndexFind
)
1078 EVT_BUTTON(wxID_HTML_INDEXBUTTONALL
, wxHtmlHelpFrame::OnIndexAll
)
1079 EVT_COMBOBOX(wxID_HTML_BOOKMARKSLIST
, wxHtmlHelpFrame::OnBookmarksSel
)
1080 EVT_CLOSE(wxHtmlHelpFrame::OnCloseWindow
)