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
;
132 m_ConfigRoot
= wxEmptyString
;
134 m_Cfg
.x
= m_Cfg
.y
= 0;
138 m_Cfg
.navig_on
= TRUE
;
140 m_NormalFonts
= m_FixedFonts
= NULL
;
142 m_NormalFace
= m_FixedFace
= wxEmptyString
;
143 m_NormalItalic
= m_FixedItalic
= wxSLANT
;
146 // Create: builds the GUI components.
147 // with the style flag it's possible to toggle the toolbar, contents, index and search
149 // m_HtmlWin will *always* be created, but it's important to realize that
150 // m_ContentsBox, m_IndexList, m_SearchList, m_SearchButton, m_SearchText and
151 // m_SearchButton may be NULL.
152 // moreover, if no contents, index or searchpage is needed, m_Splitter and
153 // m_NavigPan will be NULL too (with m_HtmlWin directly connected to the frame)
155 bool wxHtmlHelpFrame::Create(wxWindow
* parent
, wxWindowID id
, const wxString
& title
,
158 // Do the config in two steps. We read the HtmlWindow customization after we
159 // create the window.
161 ReadCustomization(m_Config
, m_ConfigRoot
);
163 wxFrame::Create(parent
, id
, _("Help"), wxPoint(m_Cfg
.x
, m_Cfg
.y
), wxSize(m_Cfg
.w
, m_Cfg
.h
));
165 GetPosition(&m_Cfg
.x
, &m_Cfg
.y
);
167 SetIcon(wxICON(whelp
));
169 int notebook_page
= 0;
174 if (style
& wxHF_TOOLBAR
) {
175 wxToolBar
*toolBar
= CreateToolBar(wxNO_BORDER
| wxTB_HORIZONTAL
| wxTB_DOCKABLE
);
176 toolBar
->SetMargins( 2, 2 );
178 toolBar
-> AddTool(wxID_HTML_PANEL
, wxBITMAP(wpanel
), wxNullBitmap
,
179 FALSE
, -1, -1, (wxObject
*) NULL
,
180 _("Show/hide navigation panel"));
181 toolBar
-> AddSeparator();
182 toolBar
-> AddTool(wxID_HTML_BACK
, wxBITMAP(wback
), wxNullBitmap
,
183 FALSE
, -1, -1, (wxObject
*) NULL
,
184 _("Go back to the previous HTML page"));
185 toolBar
-> AddTool(wxID_HTML_FORWARD
, wxBITMAP(wforward
), wxNullBitmap
,
186 FALSE
, -1, -1, (wxObject
*) NULL
,
187 _("Go forward to the next HTML page"));
188 toolBar
-> AddSeparator();
190 if (style
& wxHF_BOOKMARKS
) {
191 m_Bookmarks
= new wxComboBox(toolBar
, wxID_HTML_BOOKMARKSLIST
, wxEmptyString
,
192 wxDefaultPosition
, wxSize(300,-1), 0, NULL
, wxCB_READONLY
| wxCB_SORT
);
193 m_Bookmarks
-> Append(_("<bookmarks>"));
194 for (unsigned i
= 0; i
< m_BookmarksNames
.GetCount(); i
++)
195 m_Bookmarks
-> Append(m_BookmarksNames
[i
]);
196 m_Bookmarks
-> SetSelection(0);
197 toolBar
-> AddControl(m_Bookmarks
);
199 toolBar
-> AddSeparator();
201 toolBar
-> AddTool(wxID_HTML_BOOKMARKSADD
, wxBITMAP(wbkadd
), wxNullBitmap
,
202 FALSE
, -1, -1, (wxObject
*) NULL
,
203 _("Add current page to bookmarks"));
204 toolBar
-> AddTool(wxID_HTML_BOOKMARKSREMOVE
, wxBITMAP(wbkdel
), wxNullBitmap
,
205 FALSE
, -1, -1, (wxObject
*) NULL
,
206 _("Remove current page from bookmarks"));
209 toolBar
-> AddSeparator();
210 toolBar
-> AddTool(wxID_HTML_OPTIONS
, wxBITMAP(woptions
), wxNullBitmap
,
211 FALSE
, -1, -1, (wxObject
*) NULL
,
212 _("Display options dialog"));
214 toolBar
-> Realize();
217 if (style
& (wxHF_CONTENTS
| wxHF_INDEX
| wxHF_SEARCH
)) {
218 // traditional help controller; splitter window with html page on the
219 // right and a notebook containing various pages on the left
220 m_Splitter
= new wxSplitterWindow(this);
222 m_HtmlWin
= new wxHtmlWindow(m_Splitter
);
223 m_NavigPan
= new wxNotebook(m_Splitter
, wxID_HTML_NOTEBOOK
,
224 wxDefaultPosition
, wxDefaultSize
);
225 } else { // only html window, no notebook with index,contents etc
226 m_HtmlWin
= new wxHtmlWindow(this);
229 m_HtmlWin
-> SetRelatedFrame(this, m_TitleFormat
);
230 m_HtmlWin
-> SetRelatedStatusBar(0);
232 m_HtmlWin
-> ReadCustomization(m_Config
, m_ConfigRoot
);
234 // contents tree panel?
235 if (style
& wxHF_CONTENTS
) {
236 m_ContentsBox
= new wxTreeCtrl(m_NavigPan
, wxID_HTML_TREECTRL
,
237 wxDefaultPosition
, wxDefaultSize
,
238 wxTR_HAS_BUTTONS
| wxSUNKEN_BORDER
);
239 m_ContentsBox
-> SetImageList(m_ContentsImageList
);
240 m_NavigPan
-> AddPage(m_ContentsBox
, _("Contents"));
241 m_ContentsPage
= notebook_page
++;
244 // index listbox panel?
245 if (style
& wxHF_INDEX
) {
246 wxWindow
*dummy
= new wxPanel(m_NavigPan
, wxID_HTML_INDEXPAGE
);
248 wxLayoutConstraints
*b1
= new wxLayoutConstraints
;
249 m_IndexText
= new wxTextCtrl(dummy
, wxID_HTML_INDEXTEXT
, wxEmptyString
, wxDefaultPosition
, wxDefaultSize
, wxTE_PROCESS_ENTER
);
250 b1
-> top
.SameAs (dummy
, wxTop
, 10);
251 b1
-> left
.SameAs (dummy
, wxLeft
, 10);
252 b1
-> right
.SameAs (dummy
, wxRight
, 10);
254 m_IndexText
-> SetConstraints(b1
);
256 wxLayoutConstraints
*b4
= new wxLayoutConstraints
;
257 m_IndexButtonAll
= new wxButton(dummy
, wxID_HTML_INDEXBUTTONALL
, _("Show all"));
259 b4
-> top
.Below (m_IndexText
, 10);
260 b4
-> right
.SameAs (dummy
, wxRight
, 10);
263 m_IndexButtonAll
-> SetConstraints(b4
);
265 wxLayoutConstraints
*b2
= new wxLayoutConstraints
;
266 m_IndexButton
= new wxButton(dummy
, wxID_HTML_INDEXBUTTON
, _("Find"));
267 b2
-> top
.Below (m_IndexText
, 10);
268 b2
-> right
.LeftOf (m_IndexButtonAll
, 10);
271 m_IndexButton
-> SetConstraints(b2
);
273 wxLayoutConstraints
*b3
= new wxLayoutConstraints
;
274 m_IndexList
= new wxListBox(dummy
, wxID_HTML_INDEXLIST
, wxDefaultPosition
, wxDefaultSize
, 0, NULL
, wxLB_SINGLE
| wxLB_ALWAYS_SB
);
275 b3
-> top
.Below (m_IndexButton
, 10);
276 b3
-> left
.SameAs (dummy
, wxLeft
, 0);
277 b3
-> right
.SameAs (dummy
, wxRight
, 0);
278 b3
-> bottom
.SameAs (dummy
, wxBottom
, 0);
279 m_IndexList
-> SetConstraints(b3
);
282 m_IndexButtonAll
-> SetToolTip(_("Show all items in index"));
283 m_IndexButton
-> SetToolTip(_("Display all index items that contain given substring. Note that this is case sensitive, so 'window' and 'Window' is something else!"));
284 #endif //wxUSE_TOOLTIPS
286 dummy
-> SetAutoLayout(TRUE
);
289 m_NavigPan
-> AddPage(dummy
, _("Index"));
290 m_IndexPage
= notebook_page
++;
293 // search list panel?
294 if (style
& wxHF_SEARCH
) {
295 wxWindow
*dummy
= new wxPanel(m_NavigPan
, wxID_HTML_SEARCHPAGE
);
297 wxLayoutConstraints
*b1
= new wxLayoutConstraints
;
298 m_SearchText
= new wxTextCtrl(dummy
, wxID_HTML_SEARCHTEXT
, wxEmptyString
, wxDefaultPosition
, wxDefaultSize
, wxTE_PROCESS_ENTER
);
299 b1
-> top
.SameAs (dummy
, wxTop
, 10);
300 b1
-> left
.SameAs (dummy
, wxLeft
, 10);
301 b1
-> right
.SameAs (dummy
, wxRight
, 10);
303 m_SearchText
-> SetConstraints(b1
);
305 wxLayoutConstraints
*b2
= new wxLayoutConstraints
;
306 m_SearchButton
= new wxButton(dummy
, wxID_HTML_SEARCHBUTTON
, _("Search"));
308 m_SearchButton
-> SetToolTip(_("Search contents of help book(s) for all occurences of the text you typed above"));
309 #endif //wxUSE_TOOLTIPS
310 b2
-> top
.Below (m_SearchText
, 10);
311 b2
-> left
.SameAs (dummy
, wxLeft
, 10);
314 m_SearchButton
-> SetConstraints(b2
);
316 wxLayoutConstraints
*b4
= new wxLayoutConstraints
;
317 m_SearchChoice
= new wxChoice(dummy
, wxID_HTML_SEARCHCHOICE
, wxDefaultPosition
,
319 b4
-> top
.Below (m_SearchText
, 10);
320 b4
-> left
.SameAs (m_SearchButton
, wxRight
, 10);
321 b4
-> right
.SameAs (dummy
, wxRight
, 10);
323 m_SearchChoice
-> SetConstraints(b4
);
325 wxLayoutConstraints
*b3
= new wxLayoutConstraints
;
326 m_SearchList
= new wxListBox(dummy
, wxID_HTML_SEARCHLIST
, wxDefaultPosition
, wxDefaultSize
, 0, NULL
, wxLB_SINGLE
| wxLB_ALWAYS_SB
);
327 b3
-> top
.Below (m_SearchButton
, 10);
328 b3
-> left
.SameAs (dummy
, wxLeft
, 0);
329 b3
-> right
.SameAs (dummy
, wxRight
, 0);
330 b3
-> bottom
.SameAs (dummy
, wxBottom
, 0);
331 m_SearchList
-> SetConstraints(b3
);
333 dummy
-> SetAutoLayout(TRUE
);
335 m_NavigPan
-> AddPage(dummy
, _("Search"));
336 m_SearchPage
= notebook_page
++;
338 m_HtmlWin
-> Show(TRUE
);
343 if (m_NavigPan
&& m_Splitter
) {
344 m_Splitter
-> SetMinimumPaneSize(20);
346 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
348 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
349 m_Splitter
-> Unsplit();
351 if (m_Cfg
.navig_on
) {
352 m_NavigPan
-> Show(TRUE
);
353 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
356 m_NavigPan
-> Show(FALSE
);
357 m_Splitter
-> Initialize(m_HtmlWin
);
363 wxHtmlHelpFrame::~wxHtmlHelpFrame()
365 delete m_ContentsImageList
;
368 if (m_NormalFonts
) delete m_NormalFonts
;
369 if (m_FixedFonts
) delete m_FixedFonts
;
372 bool wxHtmlHelpFrame::Display(const wxString
& x
)
374 wxString url
= m_Data
->FindPageByName(x
);
375 if (! url
.IsEmpty()) {
376 m_HtmlWin
->LoadPage(url
);
382 bool wxHtmlHelpFrame::Display(const int id
)
384 wxString url
= m_Data
->FindPageById(id
);
385 if (! url
.IsEmpty()) {
386 m_HtmlWin
->LoadPage(url
);
394 bool wxHtmlHelpFrame::DisplayContents()
398 if (!m_Splitter
-> IsSplit()) {
399 m_NavigPan
-> Show(TRUE
);
400 m_HtmlWin
-> Show(TRUE
);
401 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
402 m_Cfg
.navig_on
= TRUE
;
404 m_NavigPan
-> SetSelection(0);
410 bool wxHtmlHelpFrame::DisplayIndex()
414 if (!m_Splitter
-> IsSplit()) {
415 m_NavigPan
-> Show(TRUE
);
416 m_HtmlWin
-> Show(TRUE
);
417 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
419 m_NavigPan
-> SetSelection(1);
423 bool wxHtmlHelpFrame::KeywordSearch(const wxString
& keyword
)
425 if (! (m_SearchList
&& m_SearchButton
&& m_SearchText
&& m_SearchChoice
))
430 wxString book
= wxEmptyString
;
432 if (!m_Splitter
-> IsSplit()) {
433 m_NavigPan
-> Show(TRUE
);
434 m_HtmlWin
-> Show(TRUE
);
435 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
437 m_NavigPan
-> SetSelection(m_SearchPage
);
438 m_SearchList
-> Clear();
439 m_SearchText
-> SetValue(keyword
);
440 m_SearchButton
-> Enable(FALSE
);
442 if (m_SearchChoice
->GetSelection() != 0)
443 book
= m_SearchChoice
->GetStringSelection();
445 wxHtmlSearchStatus
status(m_Data
, keyword
, book
);
447 wxProgressDialog
progress(_("Searching..."), _("No matching page found yet"),
448 status
.GetMaxIndex(), this,
449 wxPD_APP_MODAL
| wxPD_CAN_ABORT
| wxPD_AUTO_HIDE
);
451 while (status
.IsActive()) {
452 if (progress
.Update(status
.GetCurIndex()) == FALSE
)
454 if (status
.Search()) {
455 foundstr
.Printf(_("Found %i matches"), ++foundcnt
);
456 progress
.Update(status
.GetCurIndex(), foundstr
);
457 m_SearchList
-> Append(status
.GetName(), status
.GetContentsItem());
462 m_SearchButton
-> Enable(TRUE
);
463 m_SearchText
-> SetSelection(0, keyword
.Length());
464 m_SearchText
-> SetFocus();
466 wxHtmlContentsItem
*it
= (wxHtmlContentsItem
*) m_SearchList
-> GetClientData(0);
467 if (it
) m_HtmlWin
-> LoadPage(it
-> m_Book
-> GetBasePath() + it
-> m_Page
);
469 return (foundcnt
> 0);
474 void wxHtmlHelpFrame::CreateContents(bool show_progress
)
479 wxProgressDialog
*progress
= NULL
;
482 m_ContentsBox
->Clear();
484 int cnt
= m_Data
->GetContentsCnt();
485 int div
= (cnt
/ PROGRESS_STEP
) + 1;
488 wxHtmlContentsItem
*it
;
491 progress
= new wxProgressDialog(_("Building contents tree..."), wxEmptyString
,
492 cnt
, this, wxPD_APP_MODAL
| wxPD_CAN_ABORT
|
495 wxTreeItemId roots
[MAX_ROOTS
];
496 bool imaged
[MAX_ROOTS
];
498 m_ContentsBox
-> DeleteAllItems();
499 roots
[0] = m_ContentsBox
-> AddRoot(_("(Help)"));
500 m_ContentsBox
-> SetItemImage(roots
[0], IMG_RootFolder
);
501 m_ContentsBox
-> SetItemSelectedImage(roots
[0], IMG_RootFolder
);
504 for (it
= m_Data
->GetContents(), i
= 0; i
< cnt
; i
++, it
++) {
505 if (show_progress
&& ((i
% div
) == 0)) {
506 proginfo
.Printf(_("Added %d/%d items"), i
, cnt
);
507 if (! progress
->Update(i
, proginfo
))
511 roots
[it
-> m_Level
+ 1] = m_ContentsBox
-> AppendItem(
512 roots
[it
-> m_Level
], it
-> m_Name
, IMG_Page
, -1,
513 new wxHtmlHelpTreeItemData(it
));
515 if (it
-> m_Level
== 0) {
516 m_ContentsBox
-> SetItemBold(roots
[1], TRUE
);
517 m_ContentsBox
-> SetItemImage(roots
[1], IMG_Book
);
518 m_ContentsBox
-> SetItemSelectedImage(roots
[1], IMG_Book
);
520 } else imaged
[it
-> m_Level
+ 1] = FALSE
;
522 if (!imaged
[it
-> m_Level
]) {
523 m_ContentsBox
-> SetItemImage(roots
[it
-> m_Level
], IMG_Folder
);
524 m_ContentsBox
-> SetItemSelectedImage(roots
[it
-> m_Level
], IMG_Folder
);
525 imaged
[it
-> m_Level
] = TRUE
;
530 m_ContentsBox
-> Expand(roots
[0]);
534 void wxHtmlHelpFrame::CreateIndex(bool show_progress
)
539 wxProgressDialog
*progress
= NULL
;
542 m_IndexList
->Clear();
544 int cnt
= m_Data
->GetIndexCnt();
546 if (cnt
> INDEX_IS_SMALL
) return;
548 int div
= (cnt
/ PROGRESS_STEP
) + 1;
550 wxHtmlContentsItem
* index
= m_Data
->GetIndex();
553 progress
= new wxProgressDialog(_("Building index list..."), wxEmptyString
,
554 cnt
, this, wxPD_APP_MODAL
| wxPD_CAN_ABORT
|
556 for (int i
= 0; i
< cnt
; i
++) {
557 if (show_progress
&& ((i
% div
) == 0)) {
558 proginfo
.Printf(_("Added %d/%d items"), i
, cnt
);
559 if (! progress
->Update(i
, proginfo
))
563 m_IndexList
-> Append(index
[i
].m_Name
, (char*)(index
+ i
));
570 void wxHtmlHelpFrame::CreateSearch()
572 if (! (m_SearchList
&& m_SearchChoice
))
574 m_SearchList
-> Clear();
575 m_SearchChoice
-> Clear();
576 m_SearchChoice
-> Append(_("all books"));
577 const wxHtmlBookRecArray
& bookrec
= m_Data
->GetBookRecArray();
578 int i
, cnt
= bookrec
.GetCount();
579 for (i
= 0; i
< cnt
; i
++)
580 m_SearchChoice
->Append(bookrec
[i
].GetTitle());
581 m_SearchChoice
->SetSelection(0);
585 void wxHtmlHelpFrame::RefreshLists(bool show_progress
)
587 CreateContents(show_progress
);
588 CreateIndex(show_progress
);
592 void wxHtmlHelpFrame::ReadCustomization(wxConfigBase
*cfg
, const wxString
& path
)
597 if (path
!= wxEmptyString
) {
598 oldpath
= cfg
-> GetPath();
599 cfg
-> SetPath(path
);
602 m_Cfg
.navig_on
= cfg
-> Read("hcNavigPanel", m_Cfg
.navig_on
) != 0;
603 m_Cfg
.sashpos
= cfg
-> Read("hcSashPos", m_Cfg
.sashpos
);
604 m_Cfg
.x
= cfg
-> Read("hcX", m_Cfg
.x
);
605 m_Cfg
.y
= cfg
-> Read("hcY", m_Cfg
.y
);
606 m_Cfg
.w
= cfg
-> Read("hcW", m_Cfg
.w
);
607 m_Cfg
.h
= cfg
-> Read("hcH", m_Cfg
.h
);
609 m_FixedFace
= cfg
-> Read("hcFixedFace", m_FixedFace
);
610 m_NormalFace
= cfg
-> Read("hcNormalFace", m_NormalFace
);
611 m_FontSize
= cfg
-> Read("hcFontSize", m_FontSize
);
612 m_NormalItalic
= cfg
-> Read("hcNormalItalic", m_NormalItalic
);
613 m_FixedItalic
= cfg
-> Read("hcFixedItalic", m_FixedItalic
);
620 cnt
= cfg
-> Read("hcBookmarksCnt", 0L);
622 m_BookmarksNames
.Clear();
623 m_BookmarksPages
.Clear();
625 m_Bookmarks
-> Clear();
626 m_Bookmarks
-> Append(_("<bookmarks>"));
629 for (i
= 0; i
< cnt
; i
++) {
630 val
.Printf("hcBookmark_%i", i
);
631 s
= cfg
-> Read(val
);
632 m_BookmarksNames
.Add(s
);
633 if (m_Bookmarks
) m_Bookmarks
-> Append(s
);
634 val
.Printf("hcBookmark_%i_url", i
);
635 s
= cfg
-> Read(val
);
636 m_BookmarksPages
.Add(s
);
642 m_HtmlWin
->ReadCustomization(cfg
, path
);
644 if (path
!= wxEmptyString
)
645 cfg
-> SetPath(oldpath
);
648 void wxHtmlHelpFrame::WriteCustomization(wxConfigBase
*cfg
, const wxString
& path
)
653 if (path
!= wxEmptyString
) {
654 oldpath
= cfg
-> GetPath();
655 cfg
-> SetPath(path
);
658 cfg
-> Write("hcNavigPanel", m_Cfg
.navig_on
);
659 cfg
-> Write("hcSashPos", (long)m_Cfg
.sashpos
);
660 cfg
-> Write("hcX", (long)m_Cfg
.x
);
661 cfg
-> Write("hcY", (long)m_Cfg
.y
);
662 cfg
-> Write("hcW", (long)m_Cfg
.w
);
663 cfg
-> Write("hcH", (long)m_Cfg
.h
);
664 cfg
-> Write("hcFixedFace", m_FixedFace
);
665 cfg
-> Write("hcNormalFace", m_NormalFace
);
666 cfg
-> Write("hcFontSize", (long)m_FontSize
);
667 cfg
-> Write("hcNormalItalic", (long)m_NormalItalic
);
668 cfg
-> Write("hcFixedItalic", (long)m_FixedItalic
);
672 int cnt
= m_BookmarksNames
.GetCount();
675 cfg
-> Write("hcBookmarksCnt", (long)cnt
);
676 for (i
= 0; i
< cnt
; i
++) {
677 val
.Printf("hcBookmark_%i", i
);
678 cfg
-> Write(val
, m_BookmarksNames
[i
]);
679 val
.Printf("hcBookmark_%i_url", i
);
680 cfg
-> Write(val
, m_BookmarksPages
[i
]);
685 m_HtmlWin
->WriteCustomization(cfg
, path
);
687 if (path
!= wxEmptyString
)
688 cfg
-> SetPath(oldpath
);
695 static void SetFontsToHtmlWin(wxHtmlWindow
*win
, wxString scalf
, int scalit
, wxString fixf
, int fixit
, int size
)
697 static int f_sizes
[3][7] =
699 { 8, 9, 12, 14, 16, 19, 22},
700 {10, 12, 14, 16, 19, 24, 32},
701 {14, 16, 18, 24, 32, 38, 45}
704 win
-> SetFonts(scalf
, scalit
, fixf
, fixit
, f_sizes
[size
]);
708 class wxHtmlHelpFrameOptionsDialog
: public wxDialog
711 wxComboBox
*NormalFont
, *FixedFont
;
712 wxRadioButton
*SFI_i
, *SFI_s
, *FFI_i
, *FFI_s
;
713 wxRadioBox
*RadioBox
;
714 wxHtmlWindow
*TestWin
;
716 wxHtmlHelpFrameOptionsDialog(wxWindow
*parent
) : wxDialog(parent
, -1, wxString(_("Help Browser Options")))
718 wxString choices
[3] = {_("small"), _("medium"), _("large")};
719 wxString choices2
[2] = {_("italic"), _("slant")};
720 wxBoxSizer
*topsizer
, *sizer
, *sizer2
, *sizer3
;
722 topsizer
= new wxBoxSizer(wxVERTICAL
);
724 sizer
= new wxBoxSizer(wxHORIZONTAL
);
726 sizer2
= new wxStaticBoxSizer( new wxStaticBox(this, -1, _("Normal font:")), wxVERTICAL
);
727 sizer2
-> Add(NormalFont
= new wxComboBox(this, -1, wxEmptyString
, wxDefaultPosition
,
729 0, NULL
, wxCB_DROPDOWN
| wxCB_READONLY
),
730 1, wxEXPAND
| wxLEFT
| wxRIGHT
, 10);
732 sizer3
= new wxBoxSizer(wxHORIZONTAL
);
733 sizer3
-> Add(SFI_i
= new wxRadioButton(this, -1, _("use italic"), wxDefaultPosition
, wxDefaultSize
, wxRB_GROUP
),
735 sizer3
-> Add(SFI_s
= new wxRadioButton(this, -1, _("use slant"), wxDefaultPosition
, wxDefaultSize
, 0),
737 sizer2
-> Add(sizer3
, 0, wxEXPAND
| wxLEFT
| wxRIGHT
, 10);
739 sizer
-> Add(sizer2
, 0, wxEXPAND
| wxLEFT
|wxRIGHT
|wxTOP
, 10);
741 sizer2
= new wxStaticBoxSizer( new wxStaticBox(this, -1, _("Fixed font:")), wxVERTICAL
);
742 sizer2
-> Add(FixedFont
= new wxComboBox(this, -1, wxEmptyString
, wxDefaultPosition
,
744 0, NULL
, wxCB_DROPDOWN
| wxCB_READONLY
),
745 1, wxEXPAND
| wxLEFT
| wxRIGHT
, 10);
747 sizer3
= new wxBoxSizer(wxHORIZONTAL
);
748 sizer3
-> Add(FFI_i
= new wxRadioButton(this, -1, _("use italic"), wxDefaultPosition
, wxDefaultSize
, wxRB_GROUP
),
750 sizer3
-> Add(FFI_s
= new wxRadioButton(this, -1, _("use slant"), wxDefaultPosition
, wxDefaultSize
, 0),
752 sizer2
-> Add(sizer3
, 0, wxEXPAND
| wxLEFT
| wxRIGHT
, 10);
754 sizer
-> Add(sizer2
, 0, wxEXPAND
| wxLEFT
|wxRIGHT
|wxTOP
, 10);
756 topsizer
-> Add(sizer
);
758 topsizer
-> Add(RadioBox
= new wxRadioBox(this, -1, _("Font size:"),
759 wxDefaultPosition
, wxDefaultSize
, 3, choices
, 3),
760 0, wxEXPAND
| wxLEFT
|wxRIGHT
|wxTOP
, 10);
762 topsizer
-> Add(new wxStaticText(this, -1, _("Preview:")),
763 0, wxLEFT
| wxTOP
, 10);
764 topsizer
-> Add(TestWin
= new wxHtmlWindow(this, -1, wxDefaultPosition
, wxSize(-1, 150)),
765 1, wxEXPAND
| wxLEFT
|wxTOP
|wxRIGHT
, 10);
767 sizer
= new wxBoxSizer(wxHORIZONTAL
);
768 sizer
-> Add(new wxButton(this, wxID_OK
, _("OK")), 0, wxALL
, 10);
769 sizer
-> Add(new wxButton(this, wxID_CANCEL
, _("Cancel")), 0, wxALL
, 10);
770 topsizer
-> Add(sizer
, 0, wxALIGN_RIGHT
);
774 topsizer
-> Fit(this);
782 SetFontsToHtmlWin(TestWin
,
783 NormalFont
-> GetStringSelection(), SFI_i
-> GetValue() ? wxITALIC
: wxSLANT
,
784 FixedFont
-> GetStringSelection(), FFI_i
-> GetValue() ? wxITALIC
: wxSLANT
,
785 RadioBox
-> GetSelection());
786 TestWin
-> SetPage(_("<html><body>"
787 "Normal face<br>(and <u>underlined</u>. <i>Italic face.</i> "
788 "<b>Bold face.</b> <b><i>Bold italic face.</i></b><br>"
789 "<font size=-2>font size -2</font><br>"
790 "<font size=-1>font size -1</font><br>"
791 "<font size=+0>font size +0</font><br>"
792 "<font size=+1>font size +1</font><br>"
793 "<font size=+2>font size +2</font><br>"
794 "<font size=+3>font size +3</font><br>"
795 "<font size=+4>font size +4</font><br>"
797 "<p><tt>Fixed size face.<br> <b>bold</b> <i>italic</i> "
798 "<b><i>bold italic <u>underlined</u></i></b><br>"
799 "<font size=-2>font size -2</font><br>"
800 "<font size=-1>font size -1</font><br>"
801 "<font size=+0>font size +0</font><br>"
802 "<font size=+1>font size +1</font><br>"
803 "<font size=+2>font size +2</font><br>"
804 "<font size=+3>font size +3</font><br>"
805 "<font size=+4>font size +4</font></tt>"
809 void OnUpdate(wxCloseEvent
& event
)
814 DECLARE_EVENT_TABLE()
817 BEGIN_EVENT_TABLE(wxHtmlHelpFrameOptionsDialog
, wxDialog
)
818 EVT_COMBOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate
)
819 EVT_RADIOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate
)
820 EVT_RADIOBUTTON(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate
)
824 void wxHtmlHelpFrame::OptionsDialog()
826 wxHtmlHelpFrameOptionsDialog
dlg(this);
829 if (m_NormalFonts
== NULL
) {
830 wxFontEnumerator enu
;
831 enu
.EnumerateFacenames();
832 m_NormalFonts
= new wxArrayString
;
833 *m_NormalFonts
= *enu
.GetFacenames();
834 m_NormalFonts
-> Sort();
836 if (m_FixedFonts
== NULL
) {
837 wxFontEnumerator enu
;
838 enu
.EnumerateFacenames(wxFONTENCODING_SYSTEM
, TRUE
);
839 m_FixedFonts
= new wxArrayString
;
840 *m_FixedFonts
= *enu
.GetFacenames();
841 m_FixedFonts
-> Sort();
844 for (i
= 0; i
< m_NormalFonts
-> GetCount(); i
++)
845 dlg
.NormalFont
-> Append((*m_NormalFonts
)[i
]);
846 for (i
= 0; i
< m_FixedFonts
-> GetCount(); i
++)
847 dlg
.FixedFont
-> Append((*m_FixedFonts
)[i
]);
848 if (!m_NormalFace
.IsEmpty()) dlg
.NormalFont
-> SetStringSelection(m_NormalFace
);
849 else dlg
.NormalFont
-> SetSelection(0);
850 if (!m_FixedFace
.IsEmpty()) dlg
.FixedFont
-> SetStringSelection(m_FixedFace
);
851 else dlg
.FixedFont
-> SetSelection(0);
852 dlg
.RadioBox
-> SetSelection(m_FontSize
);
853 dlg
.SFI_i
-> SetValue(m_NormalItalic
== wxITALIC
);
854 dlg
.SFI_s
-> SetValue(m_NormalItalic
== wxSLANT
);
855 dlg
.FFI_i
-> SetValue(m_FixedItalic
== wxITALIC
);
856 dlg
.FFI_s
-> SetValue(m_FixedItalic
== wxSLANT
);
859 if (dlg
.ShowModal() == wxID_OK
) {
860 m_NormalFace
= dlg
.NormalFont
-> GetStringSelection();
861 m_FixedFace
= dlg
.FixedFont
-> GetStringSelection();
862 m_FontSize
= dlg
.RadioBox
-> GetSelection();
863 m_NormalItalic
= dlg
.SFI_i
-> GetValue() ? wxITALIC
: wxSLANT
;
864 m_FixedItalic
= dlg
.FFI_i
-> GetValue() ? wxITALIC
: wxSLANT
;
865 SetFontsToHtmlWin(m_HtmlWin
, m_NormalFace
, m_NormalItalic
, m_FixedFace
, m_FixedItalic
, m_FontSize
);
878 void wxHtmlHelpFrame::OnToolbar(wxCommandEvent
& event
)
880 switch (event
.GetId()) {
882 case wxID_HTML_BACK
:
883 m_HtmlWin
-> HistoryBack();
886 case wxID_HTML_FORWARD
:
887 m_HtmlWin
-> HistoryForward();
890 case wxID_HTML_PANEL
:
891 if (! (m_Splitter
&& m_NavigPan
))
893 if (m_Splitter
-> IsSplit()) {
894 m_Cfg
.sashpos
= m_Splitter
-> GetSashPosition();
895 m_Splitter
-> Unsplit(m_NavigPan
);
896 m_Cfg
.navig_on
= FALSE
;
898 m_NavigPan
-> Show(TRUE
);
899 m_HtmlWin
-> Show(TRUE
);
900 m_Splitter
-> SplitVertically(m_NavigPan
, m_HtmlWin
, m_Cfg
.sashpos
);
901 m_Cfg
.navig_on
= TRUE
;
905 case wxID_HTML_OPTIONS
:
909 case wxID_HTML_BOOKMARKSADD
:
914 item
= m_HtmlWin
-> GetOpenedPageTitle();
915 url
= m_HtmlWin
-> GetOpenedPage();
916 if (item
== wxEmptyString
) item
= url
.AfterLast(wxT('/'));
917 if (m_BookmarksPages
.Index(url
) == wxNOT_FOUND
) {
918 m_Bookmarks
-> Append(item
);
919 m_BookmarksNames
.Add(item
);
920 m_BookmarksPages
.Add(url
);
925 case wxID_HTML_BOOKMARKSREMOVE
:
930 item
= m_Bookmarks
-> GetStringSelection();
931 pos
= m_BookmarksNames
.Index(item
);
932 if (pos
!= wxNOT_FOUND
) {
933 m_BookmarksNames
.Remove(pos
);
934 m_BookmarksPages
.Remove(pos
);
935 m_Bookmarks
-> Delete(m_Bookmarks
-> GetSelection());
944 void wxHtmlHelpFrame::OnContentsSel(wxTreeEvent
& event
)
946 wxHtmlHelpTreeItemData
*pg
;
948 pg
= (wxHtmlHelpTreeItemData
*) m_ContentsBox
-> GetItemData(event
.GetItem());
949 if (pg
) m_HtmlWin
-> LoadPage(pg
-> GetPage());
954 void wxHtmlHelpFrame::OnIndexSel(wxCommandEvent
& WXUNUSED(event
))
956 wxHtmlContentsItem
*it
= (wxHtmlContentsItem
*) m_IndexList
-> GetClientData(m_IndexList
-> GetSelection());
957 m_HtmlWin
-> LoadPage(it
-> m_Book
-> GetBasePath() + it
-> m_Page
);
961 void wxHtmlHelpFrame::OnIndexFind(wxCommandEvent
& event
)
963 wxString sr
= m_IndexText
-> GetLineText(0);
964 if (sr
== wxEmptyString
)
969 const wxChar
*cstr
= sr
.c_str();
972 m_IndexList
->Clear();
973 int cnt
= m_Data
->GetIndexCnt();
974 wxHtmlContentsItem
* index
= m_Data
->GetIndex();
976 for (int i
= 0; i
< cnt
; i
++)
977 if (wxStrstr(index
[i
].m_Name
, cstr
) != NULL
) {
978 m_IndexList
-> Append(index
[i
].m_Name
, (char*)(index
+ i
));
980 m_HtmlWin
-> LoadPage(index
[i
].m_Book
-> GetBasePath() + index
[i
].m_Page
);
985 m_IndexText
-> SetSelection(0, sr
.Length());
986 m_IndexText
-> SetFocus();
990 void wxHtmlHelpFrame::OnIndexAll(wxCommandEvent
& WXUNUSED(event
))
994 m_IndexList
->Clear();
995 int cnt
= m_Data
->GetIndexCnt();
997 wxHtmlContentsItem
* index
= m_Data
->GetIndex();
999 for (int i
= 0; i
< cnt
; i
++) {
1000 m_IndexList
-> Append(index
[i
].m_Name
, (char*)(index
+ i
));
1002 m_HtmlWin
-> LoadPage(index
[i
].m_Book
-> GetBasePath() + index
[i
].m_Page
);
1009 void wxHtmlHelpFrame::OnSearchSel(wxCommandEvent
& WXUNUSED(event
))
1011 wxHtmlContentsItem
*it
= (wxHtmlContentsItem
*) m_SearchList
-> GetClientData(m_SearchList
-> GetSelection());
1012 if (it
) m_HtmlWin
-> LoadPage(it
-> m_Book
-> GetBasePath() + it
-> m_Page
);
1015 void wxHtmlHelpFrame::OnSearch(wxCommandEvent
& WXUNUSED(event
))
1017 wxString sr
= m_SearchText
-> GetLineText(0);
1019 if (sr
!= wxEmptyString
) KeywordSearch(sr
);
1022 void wxHtmlHelpFrame::OnBookmarksSel(wxCommandEvent
& WXUNUSED(event
))
1024 wxString sr
= m_Bookmarks
-> GetStringSelection();
1026 if (sr
!= wxEmptyString
&& sr
!= _("<bookmarks>"))
1027 m_HtmlWin
-> LoadPage(m_BookmarksPages
[m_BookmarksNames
.Index(sr
)]);
1030 void wxHtmlHelpFrame::OnCloseWindow(wxCloseEvent
& evt
)
1032 GetSize(&m_Cfg
.w
, &m_Cfg
.h
);
1033 GetPosition(&m_Cfg
.x
, &m_Cfg
.y
);
1035 if (m_Splitter
&& m_Cfg
.navig_on
) m_Cfg
.sashpos
= m_Splitter
-> GetSashPosition();
1038 WriteCustomization(m_Config
, m_ConfigRoot
);
1043 BEGIN_EVENT_TABLE(wxHtmlHelpFrame
, wxFrame
)
1044 EVT_TOOL_RANGE(wxID_HTML_PANEL
, wxID_HTML_BOOKMARKSREMOVE
, wxHtmlHelpFrame::OnToolbar
)
1045 EVT_TREE_SEL_CHANGED(wxID_HTML_TREECTRL
, wxHtmlHelpFrame::OnContentsSel
)
1046 EVT_LISTBOX(wxID_HTML_INDEXLIST
, wxHtmlHelpFrame::OnIndexSel
)
1047 EVT_LISTBOX(wxID_HTML_SEARCHLIST
, wxHtmlHelpFrame::OnSearchSel
)
1048 EVT_BUTTON(wxID_HTML_SEARCHBUTTON
, wxHtmlHelpFrame::OnSearch
)
1049 EVT_TEXT_ENTER(wxID_HTML_SEARCHTEXT
, wxHtmlHelpFrame::OnSearch
)
1050 EVT_BUTTON(wxID_HTML_INDEXBUTTON
, wxHtmlHelpFrame::OnIndexFind
)
1051 EVT_TEXT_ENTER(wxID_HTML_INDEXTEXT
, wxHtmlHelpFrame::OnIndexFind
)
1052 EVT_BUTTON(wxID_HTML_INDEXBUTTONALL
, wxHtmlHelpFrame::OnIndexAll
)
1053 EVT_COMBOBOX(wxID_HTML_BOOKMARKSLIST
, wxHtmlHelpFrame::OnBookmarksSel
)
1054 EVT_CLOSE(wxHtmlHelpFrame::OnCloseWindow
)