src/html/helpfrm.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        helpfrm.cpp
   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
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Harm van der Heijden and Vaclav Slavik
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifdef __GNUG__
  13 #pragma implementation
  14 #endif
  15
  16 // For compilers that support precompilation, includes "wx.h"
  17
  18 #include "wx/wxprec.h"
  19
  20 #ifdef __BORLANDC__
  21 #pragma hdrstop
  22 #endif
  23
  24 #if wxUSE_WXHTML_HELP
  25
  26 #ifndef WXPRECOMP
  27     #include "wx/intl.h"
  28     #include "wx/log.h"
  29
  30     #include "wx/object.h"
  31     #include "wx/layout.h"
  32     #include "wx/sizer.h"
  33
  34     #include "wx/bmpbuttn.h"
  35     #include "wx/statbox.h"
  36     #include "wx/radiobox.h"
  37 #endif // WXPRECOMP
  38
  39 #include "wx/html/helpfrm.h"
  40 #include "wx/html/helpctrl.h"
  41 #include "wx/textctrl.h"
  42 #include "wx/notebook.h"
  43 #include "wx/imaglist.h"
  44 #include "wx/treectrl.h"
  45 #include "wx/tokenzr.h"
  46 #include "wx/wfstream.h"
  47 #include "wx/html/htmlwin.h"
  48 #include "wx/busyinfo.h"
  49 #include "wx/progdlg.h"
  50 #include "wx/toolbar.h"
  51 #include "wx/fontenum.h"
  52 #include "wx/stream.h"
  53 #include "wx/filedlg.h"
  54
  55 // Bitmaps:
  56
  57 #ifndef __WXMSW__
  58     // XPM hack: make the arrays const
  59     #define static static const
  60
  61     #include "bitmaps/wpanel.xpm"
  62     #include "bitmaps/wback.xpm"
  63     #include "bitmaps/wforward.xpm"
  64     #include "bitmaps/wbook.xpm"
  65     #include "bitmaps/woptions.xpm"
  66     #include "bitmaps/wfolder.xpm"
  67     #include "bitmaps/wpage.xpm"
  68     #include "bitmaps/whelp.xpm"
  69     #include "bitmaps/whlproot.xpm"
  70     #include "bitmaps/wbkadd.xpm"
  71     #include "bitmaps/wbkdel.xpm"
  72     #include "bitmaps/wup.xpm"
  73     #include "bitmaps/wupnode.xpm"
  74     #include "bitmaps/wdown.xpm"
  75     #include "bitmaps/wopen.xpm"
  76     #include "bitmaps/wprint.xpm"
  77
  78     #undef static
  79 #endif // __WXMSW__
  80
  81 // what is considered "small index"?
  82 #define INDEX_IS_SMALL 100
  83
  84 /* Motif defines this as a macro */
  85 #ifdef Below
  86 #undef Below
  87 #endif
  88
  89 //--------------------------------------------------------------------------
  90 // wxHtmlHelpTreeItemData (private)
  91 //--------------------------------------------------------------------------
  92
  93 class wxHtmlHelpTreeItemData : public wxTreeItemData
  94 {
  95     public:
  96 #if defined(__VISAGECPP__)
  97 //  VA needs a default ctor for some reason....
  98         wxHtmlHelpTreeItemData() : wxTreeItemData()
  99             { m_Id = 0; }
 100 #endif
 101         wxHtmlHelpTreeItemData(int id) : wxTreeItemData()
 102             { m_Id = id;}
 103
 104         int m_Id;
 105 };
 106
 107
 108 //--------------------------------------------------------------------------
 109 // wxHtmlHelpHashData (private)
 110 //--------------------------------------------------------------------------
 111
 112 class wxHtmlHelpHashData : public wxObject
 113 {
 114     public:
 115         wxHtmlHelpHashData(int index, wxTreeItemId id) : wxObject()
 116             { m_Index = index; m_Id = id;}
 117         ~wxHtmlHelpHashData() {}
 118
 119         int m_Index;
 120         wxTreeItemId m_Id;
 121 };
 122
 123
 124 //--------------------------------------------------------------------------
 125 // wxHtmlHelpHtmlWindow (private)
 126 //--------------------------------------------------------------------------
 127
 128 class wxHtmlHelpHtmlWindow : public wxHtmlWindow
 129 {
 130     public:
 131         wxHtmlHelpHtmlWindow(wxHtmlHelpFrame *fr, wxWindow *parent) : wxHtmlWindow(parent), m_Frame(fr) {}
 132
 133         virtual void OnLinkClicked(const wxHtmlLinkInfo& link)
 134         {
 135             wxHtmlWindow::OnLinkClicked(link);
 136             m_Frame->NotifyPageChanged();
 137         }
 138
 139     private:
 140         wxHtmlHelpFrame *m_Frame;
 141 };
 142
 143
 144
 145 //---------------------------------------------------------------------------
 146 // wxHtmlHelpFrame
 147 //---------------------------------------------------------------------------
 148
 149 // Command IDs :
 150 enum
 151 {
 152     //wxID_HTML_HELPFRAME = wxID_HIGHEST + 1,
 153     wxID_HTML_PANEL = wxID_HIGHEST + 2,
 154     wxID_HTML_BACK,
 155     wxID_HTML_FORWARD,
 156     wxID_HTML_UPNODE,
 157     wxID_HTML_UP,
 158     wxID_HTML_DOWN,
 159     wxID_HTML_PRINT,
 160     wxID_HTML_OPENFILE,
 161     wxID_HTML_OPTIONS,
 162     wxID_HTML_BOOKMARKSLIST,
 163     wxID_HTML_BOOKMARKSADD,
 164     wxID_HTML_BOOKMARKSREMOVE,
 165     wxID_HTML_TREECTRL,
 166     wxID_HTML_INDEXPAGE,
 167     wxID_HTML_INDEXLIST,
 168     wxID_HTML_INDEXTEXT,
 169     wxID_HTML_INDEXBUTTON,
 170     wxID_HTML_INDEXBUTTONALL,
 171     wxID_HTML_NOTEBOOK,
 172     wxID_HTML_SEARCHPAGE,
 173     wxID_HTML_SEARCHTEXT,
 174     wxID_HTML_SEARCHLIST,
 175     wxID_HTML_SEARCHBUTTON,
 176     wxID_HTML_SEARCHCHOICE,
 177     wxID_HTML_COUNTINFO
 178 };
 179
 180
 181 IMPLEMENT_DYNAMIC_CLASS(wxHtmlHelpFrame, wxFrame)
 182
 183 wxHtmlHelpFrame::wxHtmlHelpFrame(wxWindow* parent, wxWindowID id, const wxString& title,
 184                                  int style, wxHtmlHelpData* data)
 185 {
 186     Init(data);
 187     Create(parent, id, title, style);
 188 }
 189
 190 void wxHtmlHelpFrame::Init(wxHtmlHelpData* data)
 191 {
 192     if (data)
 193     {
 194         m_Data = data;
 195         m_DataCreated = FALSE;
 196     } else
 197     {
 198         m_Data = new wxHtmlHelpData();
 199         m_DataCreated = TRUE;
 200     }
 201
 202     m_ContentsBox = NULL;
 203     m_IndexList = NULL;
 204     m_IndexButton = NULL;
 205     m_IndexButtonAll = NULL;
 206     m_IndexText = NULL;
 207     m_SearchList = NULL;
 208     m_SearchButton = NULL;
 209     m_SearchText = NULL;
 210     m_SearchChoice = NULL;
 211     m_IndexCountInfo = NULL;
 212     m_Splitter = NULL;
 213     m_NavigPan = NULL;
 214     m_HtmlWin = NULL;
 215     m_Bookmarks = NULL;
 216     m_SearchCaseSensitive = NULL;
 217     m_SearchWholeWords = NULL;
 218
 219     m_Config = NULL;
 220     m_ConfigRoot = wxEmptyString;
 221
 222     m_Cfg.x = m_Cfg.y = 0;
 223     m_Cfg.w = 700;
 224     m_Cfg.h = 480;
 225     m_Cfg.sashpos = 240;
 226     m_Cfg.navig_on = TRUE;
 227
 228     m_NormalFonts = m_FixedFonts = NULL;
 229     m_NormalFace = m_FixedFace = wxEmptyString;
 230     m_FontSize = 1;
 231
 232 #if wxUSE_PRINTING_ARCHITECTURE
 233     m_Printer = NULL;
 234 #endif
 235
 236     m_PagesHash = NULL;
 237     m_UpdateContents = TRUE;
 238     m_helpController = (wxHelpControllerBase*) NULL;
 239 }
 240
 241 // Create: builds the GUI components.
 242 // with the style flag it's possible to toggle the toolbar, contents, index and search
 243 // controls.
 244 // m_HtmlWin will *always* be created, but it's important to realize that
 245 // m_ContentsBox, m_IndexList, m_SearchList, m_SearchButton, m_SearchText and
 246 // m_SearchButton may be NULL.
 247 // moreover, if no contents, index or searchpage is needed, m_Splitter and
 248 // m_NavigPan will be NULL too (with m_HtmlWin directly connected to the frame)
 249
 250 bool wxHtmlHelpFrame::Create(wxWindow* parent, wxWindowID id,
 251                              const wxString& WXUNUSED(title), int style)
 252 {
 253     m_hfStyle = style;
 254
 255     wxImageList *ContentsImageList = new wxImageList(16, 16);
 256     ContentsImageList->Add(wxICON(wbook));
 257     ContentsImageList->Add(wxICON(wfolder));
 258     ContentsImageList->Add(wxICON(wpage));
 259     ContentsImageList->Add(wxICON(whlproot));
 260
 261     // Do the config in two steps. We read the HtmlWindow customization after we
 262     // create the window.
 263     if (m_Config)
 264         ReadCustomization(m_Config, m_ConfigRoot);
 265
 266     wxFrame::Create(parent, id, _("Help"), wxPoint(m_Cfg.x, m_Cfg.y), wxSize(m_Cfg.w, m_Cfg.h), wxDEFAULT_FRAME_STYLE, "wxHtmlHelp");
 267
 268     GetPosition(&m_Cfg.x, &m_Cfg.y);
 269
 270     SetIcon(wxICON(whelp));
 271
 272     int notebook_page = 0;
 273
 274     CreateStatusBar();
 275
 276     // toolbar?
 277     if (style & (wxHF_TOOLBAR | wxHF_FLAT_TOOLBAR))
 278     {
 279         wxToolBar *toolBar = CreateToolBar(wxNO_BORDER | wxTB_HORIZONTAL |
 280                                            wxTB_DOCKABLE |
 281                                            (style & wxHF_FLAT_TOOLBAR ? wxTB_FLAT : 0));
 282         toolBar->SetMargins( 2, 2 );
 283         AddToolbarButtons(toolBar, style);
 284         toolBar->Realize();
 285     }
 286
 287     if (style & (wxHF_CONTENTS | wxHF_INDEX | wxHF_SEARCH))
 288     {
 289         // traditional help controller; splitter window with html page on the
 290         // right and a notebook containing various pages on the left
 291         m_Splitter = new wxSplitterWindow(this);
 292
 293         m_HtmlWin = new wxHtmlHelpHtmlWindow(this, m_Splitter);
 294         m_NavigPan = new wxNotebook(m_Splitter, wxID_HTML_NOTEBOOK,
 295                                     wxDefaultPosition, wxDefaultSize);
 296     }
 297     else
 298     { // only html window, no notebook with index,contents etc
 299         m_HtmlWin = new wxHtmlWindow(this);
 300     }
 301
 302     m_HtmlWin->SetRelatedFrame(this, m_TitleFormat);
 303     m_HtmlWin->SetRelatedStatusBar(0);
 304     if (m_Config)
 305         m_HtmlWin->ReadCustomization(m_Config, m_ConfigRoot);
 306
 307     // contents tree panel?
 308     if (style & wxHF_CONTENTS)
 309     {
 310         wxWindow *dummy = new wxPanel(m_NavigPan, wxID_HTML_INDEXPAGE);
 311
 312         long treeStyle = wxSUNKEN_BORDER | wxTR_HAS_BUTTONS;
 313         #ifndef __WXMSW__ // FIXME - temporary, till MSW supports wxTR_HIDE_ROOT
 314         treeStyle |= wxTR_HIDE_ROOT;
 315         #endif
 316
 317         if (style & wxHF_BOOKMARKS)
 318         {
 319             wxLayoutConstraints *b1 = new wxLayoutConstraints;
 320             wxBitmapButton *bmpbt = new wxBitmapButton(dummy, wxID_HTML_BOOKMARKSREMOVE, wxBITMAP(wbkdel), wxDefaultPosition, wxSize(20,20));
 321
 322             b1->top.SameAs (dummy, wxTop, 10);
 323             b1->right.SameAs (dummy, wxRight, 10);
 324             b1->height.AsIs();
 325             b1->width.AsIs();
 326             bmpbt->SetConstraints(b1);
 327
 328             wxLayoutConstraints *b2 = new wxLayoutConstraints;
 329             wxBitmapButton *bmpbt2 = new wxBitmapButton(dummy, wxID_HTML_BOOKMARKSADD, wxBITMAP(wbkadd), wxDefaultPosition, wxSize(20,20));
 330
 331             b2->top.SameAs (dummy, wxTop, 10);
 332             b2->right.LeftOf (bmpbt, 2);
 333             b2->height.AsIs();
 334             b2->width.AsIs();
 335             bmpbt2->SetConstraints(b2);
 336
 337 #if wxUSE_TOOLTIPS
 338             bmpbt->SetToolTip(_("Remove current page from bookmarks"));
 339             bmpbt2->SetToolTip(_("Add current page to bookmarks"));
 340 #endif //wxUSE_TOOLTIPS
 341
 342             wxLayoutConstraints *b3 = new wxLayoutConstraints;
 343             m_Bookmarks = new wxComboBox(dummy, wxID_HTML_BOOKMARKSLIST, wxEmptyString,
 344                                          wxDefaultPosition, wxDefaultSize, 0, NULL, wxCB_READONLY | wxCB_SORT);
 345             m_Bookmarks->Append(_("(bookmarks)"));
 346             for (unsigned i = 0; i < m_BookmarksNames.GetCount(); i++)
 347                 m_Bookmarks->Append(m_BookmarksNames[i]);
 348             m_Bookmarks->SetSelection(0);
 349
 350             b3->centreY.SameAs (bmpbt2, wxCentreY);
 351             b3->left.SameAs (dummy, wxLeft, 10);
 352             b3->right.LeftOf (bmpbt2, 5);
 353             b3->height.AsIs();
 354             m_Bookmarks->SetConstraints(b3);
 355
 356
 357             wxLayoutConstraints *b4 = new wxLayoutConstraints;
 358             m_ContentsBox = new wxTreeCtrl(dummy, wxID_HTML_TREECTRL,
 359                                            wxDefaultPosition, wxDefaultSize,
 360                                            treeStyle);
 361             m_ContentsBox->AssignImageList(ContentsImageList);
 362
 363             b4->top.Below (m_Bookmarks, 10);
 364             b4->left.SameAs (dummy, wxLeft, 0);
 365             b4->right.SameAs (dummy, wxRight, 0);
 366             b4->bottom.SameAs (dummy, wxBottom, 0);
 367             m_ContentsBox->SetConstraints(b4);
 368
 369             dummy->SetAutoLayout(TRUE);
 370             dummy->Layout();
 371
 372             m_NavigPan->AddPage(dummy, _("Contents"));
 373         }
 374
 375         else
 376         {
 377             m_ContentsBox = new wxTreeCtrl(m_NavigPan, wxID_HTML_TREECTRL,
 378                                            wxDefaultPosition, wxDefaultSize,
 379                                            treeStyle);
 380             m_ContentsBox->AssignImageList(ContentsImageList);
 381             m_NavigPan->AddPage(m_ContentsBox, _("Contents"));
 382         }
 383
 384         m_ContentsPage = notebook_page++;
 385     }
 386
 387     // index listbox panel?
 388     if (style & wxHF_INDEX)
 389     {
 390         wxWindow *dummy = new wxPanel(m_NavigPan, wxID_HTML_INDEXPAGE);
 391
 392         wxLayoutConstraints *b1 = new wxLayoutConstraints;
 393         m_IndexText = new wxTextCtrl(dummy, wxID_HTML_INDEXTEXT, wxEmptyString, wxDefaultPosition, wxDefaultSize, wxTE_PROCESS_ENTER);
 394         b1->top.SameAs (dummy, wxTop, 10);
 395         b1->left.SameAs (dummy, wxLeft, 10);
 396         b1->right.SameAs (dummy, wxRight, 10);
 397         b1->height.AsIs();
 398         m_IndexText->SetConstraints(b1);
 399
 400         wxLayoutConstraints *b4 = new wxLayoutConstraints;
 401         m_IndexButtonAll = new wxButton(dummy, wxID_HTML_INDEXBUTTONALL, _("Show all"));
 402
 403         b4->top.Below (m_IndexText, 10);
 404         b4->right.SameAs (dummy, wxRight, 10);
 405         b4->width.AsIs();
 406         b4->height.AsIs();
 407         m_IndexButtonAll->SetConstraints(b4);
 408
 409         wxLayoutConstraints *b2 = new wxLayoutConstraints;
 410         m_IndexButton = new wxButton(dummy, wxID_HTML_INDEXBUTTON, _("Find"));
 411         b2->top.Below (m_IndexText, 10);
 412         b2->right.LeftOf (m_IndexButtonAll, 10);
 413         b2->width.AsIs();
 414         b2->height.AsIs();
 415         m_IndexButton->SetConstraints(b2);
 416
 417         wxLayoutConstraints *b5 = new wxLayoutConstraints;
 418         m_IndexCountInfo = new wxStaticText(dummy, wxID_HTML_COUNTINFO, wxEmptyString, wxDefaultPosition, wxDefaultSize, wxALIGN_RIGHT | wxST_NO_AUTORESIZE);
 419
 420         b5->top.Below (m_IndexButton, 5);
 421         b5->right.SameAs (dummy, wxRight, 10);
 422         b5->left.SameAs (dummy, wxLeft, 10);
 423         b5->height.AsIs();
 424         m_IndexCountInfo->SetConstraints(b5);
 425
 426         wxLayoutConstraints *b3 = new wxLayoutConstraints;
 427         m_IndexList = new wxListBox(dummy, wxID_HTML_INDEXLIST, wxDefaultPosition, wxDefaultSize, 0, NULL, wxLB_SINGLE);
 428         b3->top.Below (m_IndexCountInfo, 5);
 429         b3->left.SameAs (dummy, wxLeft, 0);
 430         b3->right.SameAs (dummy, wxRight, 0);
 431         b3->bottom.SameAs (dummy, wxBottom, 0);
 432         m_IndexList->SetConstraints(b3);
 433
 434 #if wxUSE_TOOLTIPS
 435         m_IndexButtonAll->SetToolTip(_("Show all items in index"));
 436         m_IndexButton->SetToolTip(_("Display all index items that contain given substring. Search is case insensitive."));
 437 #endif //wxUSE_TOOLTIPS
 438
 439         dummy->SetAutoLayout(TRUE);
 440         dummy->Layout();
 441
 442         m_NavigPan->AddPage(dummy, _("Index"));
 443         m_IndexPage = notebook_page++;
 444     }
 445
 446     // search list panel?
 447     if (style & wxHF_SEARCH)
 448     {
 449         wxWindow *dummy = new wxPanel(m_NavigPan, wxID_HTML_SEARCHPAGE);
 450
 451         wxLayoutConstraints *b1 = new wxLayoutConstraints;
 452         m_SearchText = new wxTextCtrl(dummy, wxID_HTML_SEARCHTEXT, wxEmptyString, wxDefaultPosition, wxDefaultSize, wxTE_PROCESS_ENTER);
 453         b1->top.SameAs (dummy, wxTop, 10);
 454         b1->left.SameAs (dummy, wxLeft, 10);
 455         b1->right.SameAs (dummy, wxRight, 10);
 456         b1->height.AsIs();
 457         m_SearchText->SetConstraints(b1);
 458
 459         wxLayoutConstraints *b4 = new wxLayoutConstraints;
 460         m_SearchChoice = new wxChoice(dummy, wxID_HTML_SEARCHCHOICE, wxDefaultPosition,
 461                                       wxDefaultSize);
 462         b4->top.Below (m_SearchText, 10);
 463         b4->left.SameAs (dummy, wxLeft, 10);
 464         b4->right.SameAs (dummy, wxRight, 10);
 465         b4->height.AsIs();
 466         m_SearchChoice->SetConstraints(b4);
 467
 468         wxLayoutConstraints *b5 = new wxLayoutConstraints;
 469         m_SearchCaseSensitive = new wxCheckBox(dummy, -1, _("Case sensitive"));
 470         b5->top.Below (m_SearchChoice, 10);
 471         b5->left.SameAs (dummy, wxLeft, 10);
 472         b5->width.AsIs();
 473         b5->height.AsIs ();
 474         m_SearchCaseSensitive->SetConstraints(b5);
 475
 476         wxLayoutConstraints *b6 = new wxLayoutConstraints;
 477         m_SearchWholeWords = new wxCheckBox(dummy, -1, _("Whole words only"));
 478         b6->top.Below (m_SearchCaseSensitive, 0);
 479         b6->left.SameAs (dummy, wxLeft, 10);
 480         b6->width.AsIs();
 481         b6->height.AsIs ();
 482         m_SearchWholeWords->SetConstraints(b6);
 483
 484         wxLayoutConstraints *b2 = new wxLayoutConstraints;
 485         m_SearchButton = new wxButton(dummy, wxID_HTML_SEARCHBUTTON, _("Search"));
 486 #if wxUSE_TOOLTIPS
 487         m_SearchButton->SetToolTip(_("Search contents of help book(s) for all occurences of the text you typed above"));
 488 #endif //wxUSE_TOOLTIPS
 489         b2->top.Below (m_SearchWholeWords, 0);
 490         b2->right.SameAs (dummy, wxRight, 10);
 491         b2->width.AsIs();
 492         b2->height.AsIs();
 493         m_SearchButton->SetConstraints(b2);
 494
 495         wxLayoutConstraints *b3 = new wxLayoutConstraints;
 496         m_SearchList = new wxListBox(dummy, wxID_HTML_SEARCHLIST, wxDefaultPosition, wxDefaultSize, 0, NULL, wxLB_SINGLE);
 497         b3->top.Below (m_SearchButton, 10);
 498         b3->left.SameAs (dummy, wxLeft, 0);
 499         b3->right.SameAs (dummy, wxRight, 0);
 500         b3->bottom.SameAs (dummy, wxBottom, 0);
 501         m_SearchList->SetConstraints(b3);
 502
 503         dummy->SetAutoLayout(TRUE);
 504         dummy->Layout();
 505         m_NavigPan->AddPage(dummy, _("Search"));
 506         m_SearchPage = notebook_page++;
 507     }
 508     m_HtmlWin->Show(TRUE);
 509
 510     RefreshLists();
 511
 512     // showtime
 513     if (m_NavigPan && m_Splitter)
 514     {
 515         m_Splitter->SetMinimumPaneSize(20);
 516         if (m_Cfg.navig_on)
 517             m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
 518         else
 519         {
 520             m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
 521             m_Splitter->Unsplit();
 522         }
 523
 524         if (m_Cfg.navig_on)
 525         {
 526             m_NavigPan->Show(TRUE);
 527             m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
 528         }
 529         else
 530         {
 531             m_NavigPan->Show(FALSE);
 532             m_Splitter->Initialize(m_HtmlWin);
 533         }
 534     }
 535     return TRUE;
 536 }
 537
 538 wxHtmlHelpFrame::~wxHtmlHelpFrame()
 539 {
 540     // PopEventHandler(); // wxhtmlhelpcontroller (not any more!)
 541     if (m_DataCreated)
 542         delete m_Data;
 543     if (m_NormalFonts) delete m_NormalFonts;
 544     if (m_FixedFonts) delete m_FixedFonts;
 545     if (m_PagesHash) delete m_PagesHash;
 546 }
 547
 548
 549 void wxHtmlHelpFrame::AddToolbarButtons(wxToolBar *toolBar, int style)
 550 {
 551     wxBitmap wpanelBitmap = wxBITMAP(wpanel);
 552     wxBitmap wbackBitmap = wxBITMAP(wback);
 553     wxBitmap wforwardBitmap = wxBITMAP(wforward);
 554     wxBitmap wupnodeBitmap = wxBITMAP(wupnode);
 555     wxBitmap wupBitmap = wxBITMAP(wup);
 556     wxBitmap wdownBitmap = wxBITMAP(wdown);
 557     wxBitmap wopenBitmap = wxBITMAP(wopen);
 558     wxBitmap wprintBitmap = wxBITMAP(wprint);
 559     wxBitmap woptionsBitmap = wxBITMAP(woptions);
 560
 561     wxASSERT_MSG( (wpanelBitmap.Ok() && wbackBitmap.Ok() &&
 562                    wforwardBitmap.Ok() && wupnodeBitmap.Ok() &&
 563                    wupBitmap.Ok() && wdownBitmap.Ok() &&
 564                    wopenBitmap.Ok() && wprintBitmap.Ok() &&
 565                    woptionsBitmap.Ok()),
 566                   wxT("One or more HTML help frame toolbar bitmap could not be loaded.")) ;
 567
 568
 569     toolBar->AddTool(wxID_HTML_PANEL, wpanelBitmap, wxNullBitmap,
 570                        FALSE, -1, -1, (wxObject *) NULL,
 571                        _("Show/hide navigation panel"));
 572
 573     toolBar->AddSeparator();
 574     toolBar->AddTool(wxID_HTML_BACK, wbackBitmap, wxNullBitmap,
 575                        FALSE, -1, -1, (wxObject *) NULL,
 576                        _("Go back"));
 577     toolBar->AddTool(wxID_HTML_FORWARD, wforwardBitmap, wxNullBitmap,
 578                        FALSE, -1, -1, (wxObject *) NULL,
 579                        _("Go forward"));
 580     toolBar->AddSeparator();
 581
 582     toolBar->AddTool(wxID_HTML_UPNODE, wupnodeBitmap, wxNullBitmap,
 583                        FALSE, -1, -1, (wxObject *) NULL,
 584                        _("Go one level up in document hierarchy"));
 585     toolBar->AddTool(wxID_HTML_UP, wupBitmap, wxNullBitmap,
 586                        FALSE, -1, -1, (wxObject *) NULL,
 587                        _("Previous page"));
 588     toolBar->AddTool(wxID_HTML_DOWN, wdownBitmap, wxNullBitmap,
 589                        FALSE, -1, -1, (wxObject *) NULL,
 590                        _("Next page"));
 591
 592     if ((style & wxHF_PRINT) || (style & wxHF_OPEN_FILES))
 593         toolBar->AddSeparator();
 594
 595     if (style & wxHF_OPEN_FILES)
 596         toolBar->AddTool(wxID_HTML_OPENFILE, wopenBitmap, wxNullBitmap,
 597                            FALSE, -1, -1, (wxObject *) NULL,
 598                            _("Open HTML document"));
 599
 600 #if wxUSE_PRINTING_ARCHITECTURE
 601     if (style & wxHF_PRINT)
 602         toolBar->AddTool(wxID_HTML_PRINT, wprintBitmap, wxNullBitmap,
 603                            FALSE, -1, -1, (wxObject *) NULL,
 604                            _("Print this page"));
 605 #endif
 606
 607     toolBar->AddSeparator();
 608     toolBar->AddTool(wxID_HTML_OPTIONS, woptionsBitmap, wxNullBitmap,
 609                        FALSE, -1, -1, (wxObject *) NULL,
 610                        _("Display options dialog"));
 611 }
 612
 613
 614 void wxHtmlHelpFrame::SetTitleFormat(const wxString& format)
 615 {
 616     if (m_HtmlWin)
 617         m_HtmlWin->SetRelatedFrame(this, format);
 618     m_TitleFormat = format;
 619 }
 620
 621
 622 bool wxHtmlHelpFrame::Display(const wxString& x)
 623 {
 624     wxString url = m_Data->FindPageByName(x);
 625     if (!url.IsEmpty())
 626     {
 627         m_HtmlWin->LoadPage(url);
 628         NotifyPageChanged();
 629         return TRUE;
 630     }
 631     return FALSE;
 632 }
 633
 634 bool wxHtmlHelpFrame::Display(const int id)
 635 {
 636     wxString url = m_Data->FindPageById(id);
 637     if (!url.IsEmpty())
 638     {
 639         m_HtmlWin->LoadPage(url);
 640         NotifyPageChanged();
 641         return TRUE;
 642     }
 643     return FALSE;
 644 }
 645
 646
 647
 648 bool wxHtmlHelpFrame::DisplayContents()
 649 {
 650     if (! m_ContentsBox)
 651         return FALSE;
 652     if (!m_Splitter->IsSplit())
 653     {
 654         m_NavigPan->Show(TRUE);
 655         m_HtmlWin->Show(TRUE);
 656         m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
 657         m_Cfg.navig_on = TRUE;
 658     }
 659     m_NavigPan->SetSelection(0);
 660     if (m_Data->GetBookRecArray().GetCount() > 0)
 661     {
 662         wxHtmlBookRecord& book = m_Data->GetBookRecArray()[0];
 663         if (!book.GetStart().IsEmpty())
 664             m_HtmlWin->LoadPage(book.GetFullPath(book.GetStart()));
 665     }
 666     return TRUE;
 667 }
 668
 669
 670
 671 bool wxHtmlHelpFrame::DisplayIndex()
 672 {
 673     if (! m_IndexList)
 674         return FALSE;
 675     if (!m_Splitter->IsSplit())
 676     {
 677         m_NavigPan->Show(TRUE);
 678         m_HtmlWin->Show(TRUE);
 679         m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
 680     }
 681     m_NavigPan->SetSelection(1);
 682     if (m_Data->GetBookRecArray().GetCount() > 0)
 683     {
 684         wxHtmlBookRecord& book = m_Data->GetBookRecArray()[0];
 685         if (!book.GetStart().IsEmpty())
 686             m_HtmlWin->LoadPage(book.GetFullPath(book.GetStart()));
 687     }
 688     return TRUE;
 689 }
 690
 691
 692
 693 bool wxHtmlHelpFrame::KeywordSearch(const wxString& keyword)
 694 {
 695     if (! (m_SearchList && m_SearchButton && m_SearchText && m_SearchChoice))
 696         return FALSE;
 697
 698     int foundcnt = 0, curi;
 699     wxString foundstr;
 700     wxString book = wxEmptyString;
 701
 702     if (!m_Splitter->IsSplit())
 703     {
 704         m_NavigPan->Show(TRUE);
 705         m_HtmlWin->Show(TRUE);
 706         m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
 707     }
 708     m_NavigPan->SetSelection(m_SearchPage);
 709     m_SearchList->Clear();
 710     m_SearchText->SetValue(keyword);
 711     m_SearchButton->Enable(FALSE);
 712
 713     if (m_SearchChoice->GetSelection() != 0)
 714         book = m_SearchChoice->GetStringSelection();
 715
 716     wxHtmlSearchStatus status(m_Data, keyword,
 717                               m_SearchCaseSensitive->GetValue(), m_SearchWholeWords->GetValue(),
 718                               book);
 719
 720     wxProgressDialog progress(_("Searching..."), _("No matching page found yet"),
 721                               status.GetMaxIndex(), this,
 722                               wxPD_APP_MODAL | wxPD_CAN_ABORT | wxPD_AUTO_HIDE);
 723
 724     while (status.IsActive())
 725     {
 726         curi = status.GetCurIndex();
 727         if (curi % 32 == 0 && progress.Update(curi) == FALSE)
 728             break;
 729         if (status.Search())
 730         {
 731             foundstr.Printf(_("Found %i matches"), ++foundcnt);
 732             progress.Update(status.GetCurIndex(), foundstr);
 733             m_SearchList->Append(status.GetName(), status.GetContentsItem());
 734         }
 735     }
 736
 737     m_SearchButton->Enable(TRUE);
 738     m_SearchText->SetSelection(0, keyword.Length());
 739     m_SearchText->SetFocus();
 740     if (foundcnt)
 741     {
 742         wxHtmlContentsItem *it = (wxHtmlContentsItem*) m_SearchList->GetClientData(0);
 743         if (it)
 744         {
 745             m_HtmlWin->LoadPage(it->GetFullPath());
 746             NotifyPageChanged();
 747         }
 748     }
 749     return (foundcnt > 0);
 750 }
 751
 752 void wxHtmlHelpFrame::CreateContents()
 753 {
 754     if (! m_ContentsBox)
 755         return ;
 756
 757     m_ContentsBox->Clear();
 758
 759     if (m_PagesHash) delete m_PagesHash;
 760     m_PagesHash = new wxHashTable(wxKEY_STRING, 2 * m_Data->GetContentsCnt());
 761     m_PagesHash->DeleteContents(TRUE);
 762
 763     int cnt = m_Data->GetContentsCnt();
 764     int i;
 765     size_t booksCnt = m_Data->GetBookRecArray().GetCount();
 766
 767     wxHtmlContentsItem *it;
 768
 769     const int MAX_ROOTS = 64;
 770     wxTreeItemId roots[MAX_ROOTS];
 771     // VS: this array holds information about whether we've set item icon at
 772     //     given level. This is neccessary because m_Data has flat structure
 773     //     and there's no way of recognizing if some item has subitems or not.
 774     //     We set the icon later: when we find an item with level=n, we know
 775     //     that the last item with level=n-1 was folder with subitems, so we
 776     //     set its icon accordingly
 777     bool imaged[MAX_ROOTS];
 778     m_ContentsBox->DeleteAllItems();
 779
 780     // FIXME - will go away when wxMSW's wxTreeCtrl supports wxTR_HIDE_ROOT!
 781     bool hasSuperRoot = (booksCnt > 1) ||
 782                         (m_ContentsBox->GetWindowStyle() & wxTR_HIDE_ROOT);
 783
 784     // Don't show (Help) root if there's only one boook
 785     if (hasSuperRoot)
 786     {
 787         roots[0] = m_ContentsBox->AddRoot(_("(Help)"));
 788         m_ContentsBox->SetItemImage(roots[0], IMG_RootFolder);
 789         m_ContentsBox->SetItemSelectedImage(roots[0], IMG_RootFolder);
 790         imaged[0] = TRUE;
 791     }
 792
 793     for (it = m_Data->GetContents(), i = 0; i < cnt; i++, it++)
 794     {
 795         // Handle books:
 796         if (it->m_Level == 0)
 797         {
 798             // special case, only one book, make it tree's root:
 799             if (!hasSuperRoot)
 800             {
 801                 roots[0] = roots[1] = m_ContentsBox->AddRoot(
 802                                          it->m_Name, IMG_Book, -1,
 803                                          new wxHtmlHelpTreeItemData(i));
 804                 imaged[0] = imaged[1] = TRUE;
 805                 m_ContentsBox->SetItemBold(roots[1], TRUE);
 806             }
 807             // multiple books:
 808             else
 809             {
 810                 if (m_hfStyle & wxHF_MERGE_BOOKS)
 811                     // VS: we don't want book nodes, books' content should
 812                     //    appear under tree's root. This line will create "fake"
 813                     //    record about book node so that the rest of this look
 814                     //    will believe there really _is_ book node and will
 815                     //    behave correctly.
 816                     roots[1] = roots[0];
 817                 else
 818                 {
 819                     roots[1] = m_ContentsBox->AppendItem(roots[0],
 820                                              it->m_Name, IMG_Book, -1,
 821                                              new wxHtmlHelpTreeItemData(i));
 822                     m_ContentsBox->SetItemBold(roots[1], TRUE);
 823                 }
 824                 imaged[1] = TRUE;
 825             }
 826         }
 827         // ...and their contents:
 828         else
 829         {
 830             roots[it->m_Level + 1] = m_ContentsBox->AppendItem(
 831                                      roots[it->m_Level], it->m_Name, IMG_Page,
 832                                      -1, new wxHtmlHelpTreeItemData(i));
 833             imaged[it->m_Level + 1] = FALSE;
 834         }
 835
 836         m_PagesHash->Put(it->GetFullPath(),
 837                            new wxHtmlHelpHashData(i, roots[it->m_Level + 1]));
 838
 839         // Set the icon for the node one level up in the hiearachy,
 840         // unless already done (see comment above imaged[] declaration)
 841         if (!imaged[it->m_Level])
 842         {
 843             int image = IMG_Folder;
 844             if (m_hfStyle & wxHF_ICONS_BOOK)
 845                 image = IMG_Book;
 846             else if (m_hfStyle & wxHF_ICONS_BOOK_CHAPTER)
 847                 image = (it->m_Level == 1) ? IMG_Book : IMG_Folder;
 848             m_ContentsBox->SetItemImage(roots[it->m_Level], image);
 849             m_ContentsBox->SetItemSelectedImage(roots[it->m_Level], image);
 850             imaged[it->m_Level] = TRUE;
 851         }
 852     }
 853
 854     m_ContentsBox->Expand(roots[0]);
 855 }
 856
 857
 858 void wxHtmlHelpFrame::CreateIndex()
 859 {
 860     if (! m_IndexList)
 861         return ;
 862
 863     m_IndexList->Clear();
 864
 865     int cnt = m_Data->GetIndexCnt();
 866
 867     wxString cnttext;
 868     if (cnt > INDEX_IS_SMALL) cnttext.Printf(_("%i of %i"), 0, cnt);
 869     else cnttext.Printf(_("%i of %i"), cnt, cnt);
 870     m_IndexCountInfo->SetLabel(cnttext);
 871     if (cnt > INDEX_IS_SMALL) return;
 872
 873     wxHtmlContentsItem* index = m_Data->GetIndex();
 874
 875     for (int i = 0; i < cnt; i++)
 876         m_IndexList->Append(index[i].m_Name, (char*)(index + i));
 877 }
 878
 879 void wxHtmlHelpFrame::CreateSearch()
 880 {
 881     if (! (m_SearchList && m_SearchChoice))
 882         return ;
 883     m_SearchList->Clear();
 884     m_SearchChoice->Clear();
 885     m_SearchChoice->Append(_("Search in all books"));
 886     const wxHtmlBookRecArray& bookrec = m_Data->GetBookRecArray();
 887     int i, cnt = bookrec.GetCount();
 888     for (i = 0; i < cnt; i++)
 889         m_SearchChoice->Append(bookrec[i].GetTitle());
 890     m_SearchChoice->SetSelection(0);
 891 }
 892
 893
 894 void wxHtmlHelpFrame::RefreshLists()
 895 {
 896     CreateContents();
 897     CreateIndex();
 898     CreateSearch();
 899 }
 900
 901 void wxHtmlHelpFrame::ReadCustomization(wxConfigBase *cfg, const wxString& path)
 902 {
 903     wxString oldpath;
 904     wxString tmp;
 905
 906     if (path != wxEmptyString)
 907     {
 908         oldpath = cfg->GetPath();
 909         cfg->SetPath(_T("/") + path);
 910     }
 911
 912     m_Cfg.navig_on = cfg->Read(wxT("hcNavigPanel"), m_Cfg.navig_on) != 0;
 913     m_Cfg.sashpos = cfg->Read(wxT("hcSashPos"), m_Cfg.sashpos);
 914     m_Cfg.x = cfg->Read(wxT("hcX"), m_Cfg.x);
 915     m_Cfg.y = cfg->Read(wxT("hcY"), m_Cfg.y);
 916     m_Cfg.w = cfg->Read(wxT("hcW"), m_Cfg.w);
 917     m_Cfg.h = cfg->Read(wxT("hcH"), m_Cfg.h);
 918
 919     m_FixedFace = cfg->Read(wxT("hcFixedFace"), m_FixedFace);
 920     m_NormalFace = cfg->Read(wxT("hcNormalFace"), m_NormalFace);
 921     m_FontSize = cfg->Read(wxT("hcFontSize"), m_FontSize);
 922
 923     {
 924         int i;
 925         int cnt;
 926         wxString val, s;
 927
 928         cnt = cfg->Read(wxT("hcBookmarksCnt"), 0L);
 929         if (cnt != 0)
 930         {
 931             m_BookmarksNames.Clear();
 932             m_BookmarksPages.Clear();
 933             if (m_Bookmarks)
 934             {
 935                 m_Bookmarks->Clear();
 936                 m_Bookmarks->Append(_("(bookmarks)"));
 937             }
 938
 939             for (i = 0; i < cnt; i++)
 940             {
 941                 val.Printf(wxT("hcBookmark_%i"), i);
 942                 s = cfg->Read(val);
 943                 m_BookmarksNames.Add(s);
 944                 if (m_Bookmarks) m_Bookmarks->Append(s);
 945                 val.Printf(wxT("hcBookmark_%i_url"), i);
 946                 s = cfg->Read(val);
 947                 m_BookmarksPages.Add(s);
 948             }
 949         }
 950     }
 951
 952     if (m_HtmlWin)
 953         m_HtmlWin->ReadCustomization(cfg);
 954
 955     if (path != wxEmptyString)
 956         cfg->SetPath(oldpath);
 957 }
 958
 959 void wxHtmlHelpFrame::WriteCustomization(wxConfigBase *cfg, const wxString& path)
 960 {
 961     wxString oldpath;
 962     wxString tmp;
 963
 964     if (path != wxEmptyString)
 965     {
 966         oldpath = cfg->GetPath();
 967         cfg->SetPath(_T("/") + path);
 968     }
 969
 970     cfg->Write(wxT("hcNavigPanel"), m_Cfg.navig_on);
 971     cfg->Write(wxT("hcSashPos"), (long)m_Cfg.sashpos);
 972     cfg->Write(wxT("hcX"), (long)m_Cfg.x);
 973     cfg->Write(wxT("hcY"), (long)m_Cfg.y);
 974     cfg->Write(wxT("hcW"), (long)m_Cfg.w);
 975     cfg->Write(wxT("hcH"), (long)m_Cfg.h);
 976     cfg->Write(wxT("hcFixedFace"), m_FixedFace);
 977     cfg->Write(wxT("hcNormalFace"), m_NormalFace);
 978     cfg->Write(wxT("hcFontSize"), (long)m_FontSize);
 979
 980     if (m_Bookmarks)
 981     {
 982         int i;
 983         int cnt = m_BookmarksNames.GetCount();
 984         wxString val;
 985
 986         cfg->Write(wxT("hcBookmarksCnt"), (long)cnt);
 987         for (i = 0; i < cnt; i++)
 988         {
 989             val.Printf(wxT("hcBookmark_%i"), i);
 990             cfg->Write(val, m_BookmarksNames[i]);
 991             val.Printf(wxT("hcBookmark_%i_url"), i);
 992             cfg->Write(val, m_BookmarksPages[i]);
 993         }
 994     }
 995
 996     if (m_HtmlWin)
 997         m_HtmlWin->WriteCustomization(cfg);
 998
 999     if (path != wxEmptyString)
1000         cfg->SetPath(oldpath);
1001 }
1002
1003
1004
1005
1006
1007 static void SetFontsToHtmlWin(wxHtmlWindow *win, wxString scalf, wxString fixf, int size)
1008 {
1009     static int f_sizes[5][7] =
1010         {
1011             { 6,  7,  9, 12, 14, 16, 19},
1012             { 8,  9, 12, 14, 16, 19, 22},
1013             {10, 12, 14, 16, 19, 24, 32},
1014             {14, 16, 18, 24, 32, 38, 45},
1015             {16, 20, 24, 32, 38, 45, 50}
1016         };
1017
1018     win->SetFonts(scalf, fixf, f_sizes[size]);
1019 }
1020
1021
1022 class wxHtmlHelpFrameOptionsDialog : public wxDialog
1023 {
1024     public:
1025         wxComboBox *NormalFont, *FixedFont;
1026         wxRadioBox *RadioBox;
1027         wxHtmlWindow *TestWin;
1028
1029         wxHtmlHelpFrameOptionsDialog(wxWindow *parent) : wxDialog(parent, -1, wxString(_("Help Browser Options")))
1030             {
1031                 wxString choices[5] = {_("very small"), _("small"), _("medium"), _("large"), _("very large")};
1032                 wxBoxSizer *topsizer, *sizer, *sizer2;
1033
1034                 topsizer = new wxBoxSizer(wxVERTICAL);
1035
1036                 sizer = new wxBoxSizer(wxHORIZONTAL);
1037
1038                 sizer2 = new wxStaticBoxSizer( new wxStaticBox(this, -1, _("Normal font:")), wxVERTICAL);
1039                 sizer2->Add(NormalFont = new wxComboBox(this, -1, wxEmptyString, wxDefaultPosition,
1040                               wxSize(200, 200),
1041                               0, NULL, wxCB_DROPDOWN | wxCB_READONLY),
1042                               1, wxEXPAND | wxLEFT | wxRIGHT, 10);
1043
1044                 sizer->Add(sizer2, 0, wxEXPAND | wxLEFT|wxRIGHT|wxTOP, 10);
1045
1046                 sizer2 = new wxStaticBoxSizer( new wxStaticBox(this, -1, _("Fixed font:")), wxVERTICAL);
1047                 sizer2->Add(FixedFont = new wxComboBox(this, -1, wxEmptyString, wxDefaultPosition,
1048                               wxSize(200, 200),
1049                               0, NULL, wxCB_DROPDOWN | wxCB_READONLY),
1050                               1, wxEXPAND | wxLEFT | wxRIGHT, 10);
1051
1052                 sizer->Add(sizer2, 0, wxEXPAND | wxLEFT|wxRIGHT|wxTOP, 10);
1053
1054                 topsizer->Add(sizer);
1055
1056                 topsizer->Add(RadioBox = new wxRadioBox(this, -1, _("Font size:"),
1057                                                           wxDefaultPosition, wxDefaultSize, 5, choices, 5),
1058                                 0, wxEXPAND | wxLEFT|wxRIGHT|wxTOP, 10);
1059
1060                 topsizer->Add(new wxStaticText(this, -1, _("Preview:")),
1061                                 0, wxLEFT | wxTOP, 10);
1062                 topsizer->Add(TestWin = new wxHtmlWindow(this, -1, wxDefaultPosition, wxSize(-1, 150),
1063                                                          wxHW_SCROLLBAR_AUTO | wxSUNKEN_BORDER),
1064                                 1, wxEXPAND | wxLEFT|wxTOP|wxRIGHT, 10);
1065
1066                 sizer = new wxBoxSizer(wxHORIZONTAL);
1067                 sizer->Add(new wxButton(this, wxID_OK, _("OK")), 0, wxALL, 10);
1068                 sizer->Add(new wxButton(this, wxID_CANCEL, _("Cancel")), 0, wxALL, 10);
1069                 topsizer->Add(sizer, 0, wxALIGN_RIGHT);
1070
1071                 SetAutoLayout(TRUE);
1072                 SetSizer(topsizer);
1073                 topsizer->Fit(this);
1074                 Centre(wxBOTH);
1075             }
1076
1077
1078         void UpdateTestWin()
1079             {
1080                 wxBusyCursor bcur;
1081                 SetFontsToHtmlWin(TestWin,
1082                                   NormalFont->GetStringSelection(),
1083                                   FixedFont->GetStringSelection(),
1084                                   RadioBox->GetSelection());
1085                 TestWin->SetPage(_(
1086 "<html><body>\
1087 Normal face<br>(and <u>underlined</u>. <i>Italic face.</i> \
1088 <b>Bold face.</b> <b><i>Bold italic face.</i></b><br>\
1089 <font size=-2>font size -2</font><br>\
1090 <font size=-1>font size -1</font><br>\
1091 <font size=+0>font size +0</font><br>\
1092 <font size=+1>font size +1</font><br>\
1093 <font size=+2>font size +2</font><br>\
1094 <font size=+3>font size +3</font><br>\
1095 <font size=+4>font size +4</font><br>\
1096 \
1097 <p><tt>Fixed size face.<br> <b>bold</b> <i>italic</i> \
1098 <b><i>bold italic <u>underlined</u></i></b><br>\
1099 <font size=-2>font size -2</font><br>\
1100 <font size=-1>font size -1</font><br>\
1101 <font size=+0>font size +0</font><br>\
1102 <font size=+1>font size +1</font><br>\
1103 <font size=+2>font size +2</font><br>\
1104 <font size=+3>font size +3</font><br>\
1105 <font size=+4>font size +4</font></tt>\
1106 </body></html>"
1107                                   ));
1108             }
1109
1110         void OnUpdate(wxCommandEvent& WXUNUSED(event))
1111             {
1112                 UpdateTestWin();
1113             }
1114
1115         DECLARE_EVENT_TABLE()
1116 };
1117
1118 BEGIN_EVENT_TABLE(wxHtmlHelpFrameOptionsDialog, wxDialog)
1119     EVT_COMBOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate)
1120     EVT_RADIOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate)
1121 END_EVENT_TABLE()
1122
1123
1124 void wxHtmlHelpFrame::OptionsDialog()
1125 {
1126     wxHtmlHelpFrameOptionsDialog dlg(this);
1127     unsigned i;
1128
1129     if (m_NormalFonts == NULL)
1130     {
1131         wxFontEnumerator enu;
1132         enu.EnumerateFacenames();
1133         m_NormalFonts = new wxArrayString;
1134         *m_NormalFonts = *enu.GetFacenames();
1135         m_NormalFonts->Sort();
1136     }
1137     if (m_FixedFonts == NULL)
1138     {
1139         wxFontEnumerator enu;
1140         enu.EnumerateFacenames(wxFONTENCODING_SYSTEM, TRUE);
1141         m_FixedFonts = new wxArrayString;
1142         *m_FixedFonts = *enu.GetFacenames();
1143         m_FixedFonts->Sort();
1144     }
1145
1146     for (i = 0; i < m_NormalFonts->GetCount(); i++)
1147         dlg.NormalFont->Append((*m_NormalFonts)[i]);
1148     for (i = 0; i < m_FixedFonts->GetCount(); i++)
1149         dlg.FixedFont->Append((*m_FixedFonts)[i]);
1150     if (!m_NormalFace.IsEmpty()) dlg.NormalFont->SetStringSelection(m_NormalFace);
1151     else dlg.NormalFont->SetSelection(0);
1152     if (!m_FixedFace.IsEmpty()) dlg.FixedFont->SetStringSelection(m_FixedFace);
1153     else dlg.FixedFont->SetSelection(0);
1154     dlg.RadioBox->SetSelection(m_FontSize);
1155     dlg.UpdateTestWin();
1156
1157     if (dlg.ShowModal() == wxID_OK)
1158     {
1159         m_NormalFace = dlg.NormalFont->GetStringSelection();
1160         m_FixedFace = dlg.FixedFont->GetStringSelection();
1161         m_FontSize = dlg.RadioBox->GetSelection();
1162         SetFontsToHtmlWin(m_HtmlWin, m_NormalFace, m_FixedFace, m_FontSize);
1163     }
1164 }
1165
1166
1167
1168 void wxHtmlHelpFrame::NotifyPageChanged()
1169 {
1170     if (m_UpdateContents && m_PagesHash)
1171     {
1172         wxString an = m_HtmlWin->GetOpenedAnchor();
1173         wxHtmlHelpHashData *ha;
1174         if (an.IsEmpty())
1175             ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage());
1176         else
1177             ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage() + wxT("#") + an);
1178         if (ha)
1179         {
1180             bool olduc = m_UpdateContents;
1181             m_UpdateContents = FALSE;
1182             m_ContentsBox->SelectItem(ha->m_Id);
1183             m_ContentsBox->EnsureVisible(ha->m_Id);
1184             m_UpdateContents = olduc;
1185         }
1186     }
1187 }
1188
1189
1190
1191 /*
1192 EVENT HANDLING :
1193 */
1194
1195
1196 void wxHtmlHelpFrame::OnToolbar(wxCommandEvent& event)
1197 {
1198     switch (event.GetId())
1199     {
1200         case wxID_HTML_BACK :
1201             m_HtmlWin->HistoryBack();
1202             NotifyPageChanged();
1203             break;
1204
1205         case wxID_HTML_FORWARD :
1206             m_HtmlWin->HistoryForward();
1207             NotifyPageChanged();
1208             break;
1209
1210         case wxID_HTML_UP :
1211             if (m_PagesHash)
1212             {
1213                 wxString an = m_HtmlWin->GetOpenedAnchor();
1214                 wxHtmlHelpHashData *ha;
1215                 if (an.IsEmpty())
1216                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage());
1217                 else
1218                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage() + wxT("#") + an);
1219                 if (ha && ha->m_Index > 0)
1220                 {
1221                     wxHtmlContentsItem *it = m_Data->GetContents() + (ha->m_Index - 1);
1222                     if (it->m_Page[0] != 0)
1223                     {
1224                         m_HtmlWin->LoadPage(it->GetFullPath());
1225                         NotifyPageChanged();
1226                     }
1227                 }
1228             }
1229             break;
1230
1231         case wxID_HTML_UPNODE :
1232             if (m_PagesHash)
1233             {
1234                 wxString an = m_HtmlWin->GetOpenedAnchor();
1235                 wxHtmlHelpHashData *ha;
1236                 if (an.IsEmpty())
1237                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage());
1238                 else
1239                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage() + wxT("#") + an);
1240                 if (ha && ha->m_Index > 0)
1241                 {
1242                     int level = m_Data->GetContents()[ha->m_Index].m_Level - 1;
1243                     wxHtmlContentsItem *it;
1244                     int ind = ha->m_Index - 1;
1245
1246                     it = m_Data->GetContents() + ind;
1247                     while (ind >= 0 && it->m_Level != level) ind--, it--;
1248                     if (ind >= 0)
1249                     {
1250                         if (it->m_Page[0] != 0)
1251                         {
1252                             m_HtmlWin->LoadPage(it->GetFullPath());
1253                             NotifyPageChanged();
1254                         }
1255                     }
1256                 }
1257             }
1258             break;
1259
1260         case wxID_HTML_DOWN :
1261             if (m_PagesHash)
1262             {
1263                 wxString an = m_HtmlWin->GetOpenedAnchor();
1264                 wxString adr;
1265                 wxHtmlHelpHashData *ha;
1266
1267                 if (an.IsEmpty()) adr = m_HtmlWin->GetOpenedPage();
1268                 else adr = m_HtmlWin->GetOpenedPage() + wxT("#") + an;
1269
1270                 ha = (wxHtmlHelpHashData*) m_PagesHash->Get(adr);
1271
1272                 if (ha && ha->m_Index < m_Data->GetContentsCnt() - 1)
1273                 {
1274                     wxHtmlContentsItem *it = m_Data->GetContents() + (ha->m_Index + 1);
1275
1276                     while (it->GetFullPath() == adr) it++;
1277
1278                     if (it->m_Page[0] != 0)
1279                     {
1280                         m_HtmlWin->LoadPage(it->GetFullPath());
1281                         NotifyPageChanged();
1282                     }
1283                 }
1284             }
1285             break;
1286
1287         case wxID_HTML_PANEL :
1288             {
1289                 if (! (m_Splitter && m_NavigPan))
1290                     return ;
1291                 if (m_Splitter->IsSplit())
1292                 {
1293                     m_Cfg.sashpos = m_Splitter->GetSashPosition();
1294                     m_Splitter->Unsplit(m_NavigPan);
1295                     m_Cfg.navig_on = FALSE;
1296                 }
1297                 else
1298                 {
1299                     m_NavigPan->Show(TRUE);
1300                     m_HtmlWin->Show(TRUE);
1301                     m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
1302                     m_Cfg.navig_on = TRUE;
1303                 }
1304             }
1305             break;
1306
1307         case wxID_HTML_OPTIONS :
1308             OptionsDialog();
1309             break;
1310
1311         case wxID_HTML_BOOKMARKSADD :
1312             {
1313                 wxString item;
1314                 wxString url;
1315
1316                 item = m_HtmlWin->GetOpenedPageTitle();
1317                 url = m_HtmlWin->GetOpenedPage();
1318                 if (item == wxEmptyString)
1319                     item = url.AfterLast(wxT('/'));
1320                 if (m_BookmarksPages.Index(url) == wxNOT_FOUND)
1321                 {
1322                     m_Bookmarks->Append(item);
1323                     m_BookmarksNames.Add(item);
1324                     m_BookmarksPages.Add(url);
1325                 }
1326             }
1327             break;
1328
1329         case wxID_HTML_BOOKMARKSREMOVE :
1330             {
1331                 wxString item;
1332                 int pos;
1333
1334                 item = m_Bookmarks->GetStringSelection();
1335                 pos = m_BookmarksNames.Index(item);
1336                 if (pos != wxNOT_FOUND)
1337                 {
1338                     m_BookmarksNames.Remove(pos);
1339                     m_BookmarksPages.Remove(pos);
1340                     m_Bookmarks->Delete(m_Bookmarks->GetSelection());
1341                 }
1342             }
1343             break;
1344
1345 #if wxUSE_PRINTING_ARCHITECTURE
1346         case wxID_HTML_PRINT :
1347             {
1348                 if (m_Printer == NULL)
1349                     m_Printer = new wxHtmlEasyPrinting(_("Help Printing"), this);
1350                 if (!m_HtmlWin->GetOpenedPage())
1351                     wxLogWarning(_("Cannot print empty page."));
1352                 else
1353                     m_Printer->PrintFile(m_HtmlWin->GetOpenedPage());
1354             }
1355             break;
1356 #endif
1357
1358         case wxID_HTML_OPENFILE :
1359             {
1360                 wxString s = wxFileSelector(_("Open HTML document"),
1361                                             wxEmptyString,
1362                                             wxEmptyString,
1363                                             wxEmptyString,
1364                                             _(
1365 "HTML files (*.htm)|*.htm|HTML files (*.html)|*.html|\
1366 Help books (*.htb)|*.htb|Help books (*.zip)|*.zip|\
1367 HTML Help Project (*.hhp)|*.hhp|\
1368 All files (*.*)|*"
1369                                             ),
1370                                             wxOPEN | wxFILE_MUST_EXIST,
1371                                             this);
1372                 if (!s.IsEmpty())
1373                 {
1374                     wxString ext = s.Right(4).Lower();
1375                     if (ext == _T(".zip") || ext == _T(".htb") || ext == _T(".hhp"))
1376                     {
1377                         wxBusyCursor bcur;
1378                         m_Data->AddBook(s);
1379                         RefreshLists();
1380                     }
1381                     else
1382                         m_HtmlWin->LoadPage(s);
1383                 }
1384             }
1385             break;
1386     }
1387 }
1388
1389
1390
1391 void wxHtmlHelpFrame::OnContentsSel(wxTreeEvent& event)
1392 {
1393     wxHtmlHelpTreeItemData *pg;
1394     wxHtmlContentsItem *it;
1395
1396     pg = (wxHtmlHelpTreeItemData*) m_ContentsBox->GetItemData(event.GetItem());
1397
1398     if (pg && m_UpdateContents)
1399     {
1400         it = m_Data->GetContents() + (pg->m_Id);
1401         m_UpdateContents = FALSE;
1402         if (it->m_Page[0] != 0)
1403             m_HtmlWin->LoadPage(it->GetFullPath());
1404         m_UpdateContents = TRUE;
1405     }
1406 }
1407
1408
1409
1410 void wxHtmlHelpFrame::OnIndexSel(wxCommandEvent& WXUNUSED(event))
1411 {
1412     wxHtmlContentsItem *it = (wxHtmlContentsItem*) m_IndexList->GetClientData(m_IndexList->GetSelection());
1413     if (it->m_Page[0] != 0)
1414         m_HtmlWin->LoadPage(it->GetFullPath());
1415     NotifyPageChanged();
1416 }
1417
1418
1419 void wxHtmlHelpFrame::OnIndexFind(wxCommandEvent& event)
1420 {
1421     wxString sr = m_IndexText->GetLineText(0);
1422     sr.MakeLower();
1423     if (sr == wxEmptyString)
1424     {
1425         OnIndexAll(event);
1426     }
1427     else
1428     {
1429         wxBusyCursor bcur;
1430         const wxChar *cstr = sr.c_str();
1431         wxChar mybuff[512];
1432         wxChar *ptr;
1433         bool first = TRUE;
1434
1435         m_IndexList->Clear();
1436         int cnt = m_Data->GetIndexCnt();
1437         wxHtmlContentsItem* index = m_Data->GetIndex();
1438
1439         int displ = 0;
1440         for (int i = 0; i < cnt; i++)
1441         {
1442             wxStrncpy(mybuff, index[i].m_Name, 512);
1443             mybuff[511] = _T('\0');
1444             for (ptr = mybuff; *ptr != 0; ptr++)
1445                 if (*ptr >= _T('A') && *ptr <= _T('Z'))
1446                     *ptr -= (wxChar)(_T('A') - _T('a'));
1447             if (wxStrstr(mybuff, cstr) != NULL)
1448             {
1449                 m_IndexList->Append(index[i].m_Name, (char*)(index + i));
1450                 displ++;
1451                 if (first)
1452                 {
1453                     if (index[i].m_Page[0] != 0)
1454                         m_HtmlWin->LoadPage(index[i].GetFullPath());
1455                     NotifyPageChanged();
1456                     first = FALSE;
1457                 }
1458             }
1459         }
1460
1461         wxString cnttext;
1462         cnttext.Printf(_("%i of %i"), displ, cnt);
1463         m_IndexCountInfo->SetLabel(cnttext);
1464
1465         m_IndexText->SetSelection(0, sr.Length());
1466         m_IndexText->SetFocus();
1467     }
1468 }
1469
1470 void wxHtmlHelpFrame::OnIndexAll(wxCommandEvent& WXUNUSED(event))
1471 {
1472     wxBusyCursor bcur;
1473
1474     m_IndexList->Clear();
1475     int cnt = m_Data->GetIndexCnt();
1476     bool first = TRUE;
1477     wxHtmlContentsItem* index = m_Data->GetIndex();
1478
1479     for (int i = 0; i < cnt; i++)
1480     {
1481         m_IndexList->Append(index[i].m_Name, (char*)(index + i));
1482         if (first)
1483         {
1484             if (index[i].m_Page[0] != 0)
1485                 m_HtmlWin->LoadPage(index[i].GetFullPath());
1486             NotifyPageChanged();
1487             first = FALSE;
1488         }
1489     }
1490
1491     wxString cnttext;
1492     cnttext.Printf(_("%i of %i"), cnt, cnt);
1493     m_IndexCountInfo->SetLabel(cnttext);
1494 }
1495
1496
1497 void wxHtmlHelpFrame::OnSearchSel(wxCommandEvent& WXUNUSED(event))
1498 {
1499     wxHtmlContentsItem *it = (wxHtmlContentsItem*) m_SearchList->GetClientData(m_SearchList->GetSelection());
1500     if (it)
1501     {
1502         if (it->m_Page[0] != 0)
1503             m_HtmlWin->LoadPage(it->GetFullPath());
1504         NotifyPageChanged();
1505     }
1506 }
1507
1508 void wxHtmlHelpFrame::OnSearch(wxCommandEvent& WXUNUSED(event))
1509 {
1510     wxString sr = m_SearchText->GetLineText(0);
1511
1512     if (sr != wxEmptyString) KeywordSearch(sr);
1513 }
1514
1515 void wxHtmlHelpFrame::OnBookmarksSel(wxCommandEvent& WXUNUSED(event))
1516 {
1517     wxString sr = m_Bookmarks->GetStringSelection();
1518
1519     if (sr != wxEmptyString && sr != _("(bookmarks)"))
1520     {
1521        m_HtmlWin->LoadPage(m_BookmarksPages[m_BookmarksNames.Index(sr)]);
1522        NotifyPageChanged();
1523     }
1524 }
1525
1526 void wxHtmlHelpFrame::OnCloseWindow(wxCloseEvent& evt)
1527 {
1528     GetSize(&m_Cfg.w, &m_Cfg.h);
1529     GetPosition(&m_Cfg.x, &m_Cfg.y);
1530
1531     if (m_Splitter && m_Cfg.navig_on) m_Cfg.sashpos = m_Splitter->GetSashPosition();
1532
1533     if (m_Config)
1534         WriteCustomization(m_Config, m_ConfigRoot);
1535
1536     if (m_helpController && m_helpController->IsKindOf(CLASSINFO(wxHtmlHelpController)))
1537     {
1538         ((wxHtmlHelpController*) m_helpController)->OnCloseFrame(evt);
1539     }
1540
1541     evt.Skip();
1542 }
1543
1544 BEGIN_EVENT_TABLE(wxHtmlHelpFrame, wxFrame)
1545     EVT_TOOL_RANGE(wxID_HTML_PANEL, wxID_HTML_OPTIONS, wxHtmlHelpFrame::OnToolbar)
1546     EVT_BUTTON(wxID_HTML_BOOKMARKSREMOVE, wxHtmlHelpFrame::OnToolbar)
1547     EVT_BUTTON(wxID_HTML_BOOKMARKSADD, wxHtmlHelpFrame::OnToolbar)
1548     EVT_TREE_SEL_CHANGED(wxID_HTML_TREECTRL, wxHtmlHelpFrame::OnContentsSel)
1549     EVT_LISTBOX(wxID_HTML_INDEXLIST, wxHtmlHelpFrame::OnIndexSel)
1550     EVT_LISTBOX(wxID_HTML_SEARCHLIST, wxHtmlHelpFrame::OnSearchSel)
1551     EVT_BUTTON(wxID_HTML_SEARCHBUTTON, wxHtmlHelpFrame::OnSearch)
1552     EVT_TEXT_ENTER(wxID_HTML_SEARCHTEXT, wxHtmlHelpFrame::OnSearch)
1553     EVT_BUTTON(wxID_HTML_INDEXBUTTON, wxHtmlHelpFrame::OnIndexFind)
1554     EVT_TEXT_ENTER(wxID_HTML_INDEXTEXT, wxHtmlHelpFrame::OnIndexFind)
1555     EVT_BUTTON(wxID_HTML_INDEXBUTTONALL, wxHtmlHelpFrame::OnIndexAll)
1556     EVT_COMBOBOX(wxID_HTML_BOOKMARKSLIST, wxHtmlHelpFrame::OnBookmarksSel)
1557     EVT_CLOSE(wxHtmlHelpFrame::OnCloseWindow)
1558 END_EVENT_TABLE()
1559
1560 #endif // wxUSE_WXHTML_HELP
1561