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                                 1, wxEXPAND | wxLEFT|wxTOP|wxRIGHT, 10);
1064
1065                 sizer = new wxBoxSizer(wxHORIZONTAL);
1066                 sizer->Add(new wxButton(this, wxID_OK, _("OK")), 0, wxALL, 10);
1067                 sizer->Add(new wxButton(this, wxID_CANCEL, _("Cancel")), 0, wxALL, 10);
1068                 topsizer->Add(sizer, 0, wxALIGN_RIGHT);
1069
1070                 SetAutoLayout(TRUE);
1071                 SetSizer(topsizer);
1072                 topsizer->Fit(this);
1073                 Centre(wxBOTH);
1074             }
1075
1076
1077         void UpdateTestWin()
1078             {
1079                 wxBusyCursor bcur;
1080                 SetFontsToHtmlWin(TestWin,
1081                                   NormalFont->GetStringSelection(),
1082                                   FixedFont->GetStringSelection(),
1083                                   RadioBox->GetSelection());
1084                 TestWin->SetPage(_(
1085 "<html><body>\
1086 Normal face<br>(and <u>underlined</u>. <i>Italic face.</i> \
1087 <b>Bold face.</b> <b><i>Bold italic face.</i></b><br>\
1088 <font size=-2>font size -2</font><br>\
1089 <font size=-1>font size -1</font><br>\
1090 <font size=+0>font size +0</font><br>\
1091 <font size=+1>font size +1</font><br>\
1092 <font size=+2>font size +2</font><br>\
1093 <font size=+3>font size +3</font><br>\
1094 <font size=+4>font size +4</font><br>\
1095 \
1096 <p><tt>Fixed size face.<br> <b>bold</b> <i>italic</i> \
1097 <b><i>bold italic <u>underlined</u></i></b><br>\
1098 <font size=-2>font size -2</font><br>\
1099 <font size=-1>font size -1</font><br>\
1100 <font size=+0>font size +0</font><br>\
1101 <font size=+1>font size +1</font><br>\
1102 <font size=+2>font size +2</font><br>\
1103 <font size=+3>font size +3</font><br>\
1104 <font size=+4>font size +4</font></tt>\
1105 </body></html>"
1106                                   ));
1107             }
1108
1109         void OnUpdate(wxCommandEvent& WXUNUSED(event))
1110             {
1111                 UpdateTestWin();
1112             }
1113
1114         DECLARE_EVENT_TABLE()
1115 };
1116
1117 BEGIN_EVENT_TABLE(wxHtmlHelpFrameOptionsDialog, wxDialog)
1118     EVT_COMBOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate)
1119     EVT_RADIOBOX(-1, wxHtmlHelpFrameOptionsDialog::OnUpdate)
1120 END_EVENT_TABLE()
1121
1122
1123 void wxHtmlHelpFrame::OptionsDialog()
1124 {
1125     wxHtmlHelpFrameOptionsDialog dlg(this);
1126     unsigned i;
1127
1128     if (m_NormalFonts == NULL)
1129     {
1130         wxFontEnumerator enu;
1131         enu.EnumerateFacenames();
1132         m_NormalFonts = new wxArrayString;
1133         *m_NormalFonts = *enu.GetFacenames();
1134         m_NormalFonts->Sort();
1135     }
1136     if (m_FixedFonts == NULL)
1137     {
1138         wxFontEnumerator enu;
1139         enu.EnumerateFacenames(wxFONTENCODING_SYSTEM, TRUE);
1140         m_FixedFonts = new wxArrayString;
1141         *m_FixedFonts = *enu.GetFacenames();
1142         m_FixedFonts->Sort();
1143     }
1144
1145     for (i = 0; i < m_NormalFonts->GetCount(); i++)
1146         dlg.NormalFont->Append((*m_NormalFonts)[i]);
1147     for (i = 0; i < m_FixedFonts->GetCount(); i++)
1148         dlg.FixedFont->Append((*m_FixedFonts)[i]);
1149     if (!m_NormalFace.IsEmpty()) dlg.NormalFont->SetStringSelection(m_NormalFace);
1150     else dlg.NormalFont->SetSelection(0);
1151     if (!m_FixedFace.IsEmpty()) dlg.FixedFont->SetStringSelection(m_FixedFace);
1152     else dlg.FixedFont->SetSelection(0);
1153     dlg.RadioBox->SetSelection(m_FontSize);
1154     dlg.UpdateTestWin();
1155
1156     if (dlg.ShowModal() == wxID_OK)
1157     {
1158         m_NormalFace = dlg.NormalFont->GetStringSelection();
1159         m_FixedFace = dlg.FixedFont->GetStringSelection();
1160         m_FontSize = dlg.RadioBox->GetSelection();
1161         SetFontsToHtmlWin(m_HtmlWin, m_NormalFace, m_FixedFace, m_FontSize);
1162     }
1163 }
1164
1165
1166
1167 void wxHtmlHelpFrame::NotifyPageChanged()
1168 {
1169     if (m_UpdateContents && m_PagesHash)
1170     {
1171         wxString an = m_HtmlWin->GetOpenedAnchor();
1172         wxHtmlHelpHashData *ha;
1173         if (an.IsEmpty())
1174             ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage());
1175         else
1176             ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage() + wxT("#") + an);
1177         if (ha)
1178         {
1179             bool olduc = m_UpdateContents;
1180             m_UpdateContents = FALSE;
1181             m_ContentsBox->SelectItem(ha->m_Id);
1182             m_ContentsBox->EnsureVisible(ha->m_Id);
1183             m_UpdateContents = olduc;
1184         }
1185     }
1186 }
1187
1188
1189
1190 /*
1191 EVENT HANDLING :
1192 */
1193
1194
1195 void wxHtmlHelpFrame::OnToolbar(wxCommandEvent& event)
1196 {
1197     switch (event.GetId())
1198     {
1199         case wxID_HTML_BACK :
1200             m_HtmlWin->HistoryBack();
1201             NotifyPageChanged();
1202             break;
1203
1204         case wxID_HTML_FORWARD :
1205             m_HtmlWin->HistoryForward();
1206             NotifyPageChanged();
1207             break;
1208
1209         case wxID_HTML_UP :
1210             if (m_PagesHash)
1211             {
1212                 wxString an = m_HtmlWin->GetOpenedAnchor();
1213                 wxHtmlHelpHashData *ha;
1214                 if (an.IsEmpty())
1215                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage());
1216                 else
1217                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage() + wxT("#") + an);
1218                 if (ha && ha->m_Index > 0)
1219                 {
1220                     wxHtmlContentsItem *it = m_Data->GetContents() + (ha->m_Index - 1);
1221                     if (it->m_Page[0] != 0)
1222                     {
1223                         m_HtmlWin->LoadPage(it->GetFullPath());
1224                         NotifyPageChanged();
1225                     }
1226                 }
1227             }
1228             break;
1229
1230         case wxID_HTML_UPNODE :
1231             if (m_PagesHash)
1232             {
1233                 wxString an = m_HtmlWin->GetOpenedAnchor();
1234                 wxHtmlHelpHashData *ha;
1235                 if (an.IsEmpty())
1236                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage());
1237                 else
1238                     ha = (wxHtmlHelpHashData*) m_PagesHash->Get(m_HtmlWin->GetOpenedPage() + wxT("#") + an);
1239                 if (ha && ha->m_Index > 0)
1240                 {
1241                     int level = m_Data->GetContents()[ha->m_Index].m_Level - 1;
1242                     wxHtmlContentsItem *it;
1243                     int ind = ha->m_Index - 1;
1244
1245                     it = m_Data->GetContents() + ind;
1246                     while (ind >= 0 && it->m_Level != level) ind--, it--;
1247                     if (ind >= 0)
1248                     {
1249                         if (it->m_Page[0] != 0)
1250                         {
1251                             m_HtmlWin->LoadPage(it->GetFullPath());
1252                             NotifyPageChanged();
1253                         }
1254                     }
1255                 }
1256             }
1257             break;
1258
1259         case wxID_HTML_DOWN :
1260             if (m_PagesHash)
1261             {
1262                 wxString an = m_HtmlWin->GetOpenedAnchor();
1263                 wxString adr;
1264                 wxHtmlHelpHashData *ha;
1265
1266                 if (an.IsEmpty()) adr = m_HtmlWin->GetOpenedPage();
1267                 else adr = m_HtmlWin->GetOpenedPage() + wxT("#") + an;
1268
1269                 ha = (wxHtmlHelpHashData*) m_PagesHash->Get(adr);
1270
1271                 if (ha && ha->m_Index < m_Data->GetContentsCnt() - 1)
1272                 {
1273                     wxHtmlContentsItem *it = m_Data->GetContents() + (ha->m_Index + 1);
1274
1275                     while (it->GetFullPath() == adr) it++;
1276
1277                     if (it->m_Page[0] != 0)
1278                     {
1279                         m_HtmlWin->LoadPage(it->GetFullPath());
1280                         NotifyPageChanged();
1281                     }
1282                 }
1283             }
1284             break;
1285
1286         case wxID_HTML_PANEL :
1287             {
1288                 if (! (m_Splitter && m_NavigPan))
1289                     return ;
1290                 if (m_Splitter->IsSplit())
1291                 {
1292                     m_Cfg.sashpos = m_Splitter->GetSashPosition();
1293                     m_Splitter->Unsplit(m_NavigPan);
1294                     m_Cfg.navig_on = FALSE;
1295                 }
1296                 else
1297                 {
1298                     m_NavigPan->Show(TRUE);
1299                     m_HtmlWin->Show(TRUE);
1300                     m_Splitter->SplitVertically(m_NavigPan, m_HtmlWin, m_Cfg.sashpos);
1301                     m_Cfg.navig_on = TRUE;
1302                 }
1303             }
1304             break;
1305
1306         case wxID_HTML_OPTIONS :
1307             OptionsDialog();
1308             break;
1309
1310         case wxID_HTML_BOOKMARKSADD :
1311             {
1312                 wxString item;
1313                 wxString url;
1314
1315                 item = m_HtmlWin->GetOpenedPageTitle();
1316                 url = m_HtmlWin->GetOpenedPage();
1317                 if (item == wxEmptyString)
1318                     item = url.AfterLast(wxT('/'));
1319                 if (m_BookmarksPages.Index(url) == wxNOT_FOUND)
1320                 {
1321                     m_Bookmarks->Append(item);
1322                     m_BookmarksNames.Add(item);
1323                     m_BookmarksPages.Add(url);
1324                 }
1325             }
1326             break;
1327
1328         case wxID_HTML_BOOKMARKSREMOVE :
1329             {
1330                 wxString item;
1331                 int pos;
1332
1333                 item = m_Bookmarks->GetStringSelection();
1334                 pos = m_BookmarksNames.Index(item);
1335                 if (pos != wxNOT_FOUND)
1336                 {
1337                     m_BookmarksNames.Remove(pos);
1338                     m_BookmarksPages.Remove(pos);
1339                     m_Bookmarks->Delete(m_Bookmarks->GetSelection());
1340                 }
1341             }
1342             break;
1343
1344 #if wxUSE_PRINTING_ARCHITECTURE
1345         case wxID_HTML_PRINT :
1346             {
1347                 if (m_Printer == NULL)
1348                     m_Printer = new wxHtmlEasyPrinting(_("Help Printing"), this);
1349                 if (!m_HtmlWin->GetOpenedPage())
1350                     wxLogWarning(_("Cannot print empty page."));
1351                 else
1352                     m_Printer->PrintFile(m_HtmlWin->GetOpenedPage());
1353             }
1354             break;
1355 #endif
1356
1357         case wxID_HTML_OPENFILE :
1358             {
1359                 wxString s = wxFileSelector(_("Open HTML document"),
1360                                             wxEmptyString,
1361                                             wxEmptyString,
1362                                             wxEmptyString,
1363                                             _(
1364 "HTML files (*.htm)|*.htm|HTML files (*.html)|*.html|\
1365 Help books (*.htb)|*.htb|Help books (*.zip)|*.zip|\
1366 HTML Help Project (*.hhp)|*.hhp|\
1367 All files (*.*)|*"
1368                                             ),
1369                                             wxOPEN | wxFILE_MUST_EXIST,
1370                                             this);
1371                 if (!s.IsEmpty())
1372                 {
1373                     wxString ext = s.Right(4).Lower();
1374                     if (ext == _T(".zip") || ext == _T(".htb") || ext == _T(".hhp"))
1375                     {
1376                         wxBusyCursor bcur;
1377                         m_Data->AddBook(s);
1378                         RefreshLists();
1379                     }
1380                     else
1381                         m_HtmlWin->LoadPage(s);
1382                 }
1383             }
1384             break;
1385     }
1386 }
1387
1388
1389
1390 void wxHtmlHelpFrame::OnContentsSel(wxTreeEvent& event)
1391 {
1392     wxHtmlHelpTreeItemData *pg;
1393     wxHtmlContentsItem *it;
1394
1395     pg = (wxHtmlHelpTreeItemData*) m_ContentsBox->GetItemData(event.GetItem());
1396
1397     if (pg && m_UpdateContents)
1398     {
1399         it = m_Data->GetContents() + (pg->m_Id);
1400         m_UpdateContents = FALSE;
1401         if (it->m_Page[0] != 0)
1402             m_HtmlWin->LoadPage(it->GetFullPath());
1403         m_UpdateContents = TRUE;
1404     }
1405 }
1406
1407
1408
1409 void wxHtmlHelpFrame::OnIndexSel(wxCommandEvent& WXUNUSED(event))
1410 {
1411     wxHtmlContentsItem *it = (wxHtmlContentsItem*) m_IndexList->GetClientData(m_IndexList->GetSelection());
1412     if (it->m_Page[0] != 0)
1413         m_HtmlWin->LoadPage(it->GetFullPath());
1414     NotifyPageChanged();
1415 }
1416
1417
1418 void wxHtmlHelpFrame::OnIndexFind(wxCommandEvent& event)
1419 {
1420     wxString sr = m_IndexText->GetLineText(0);
1421     sr.MakeLower();
1422     if (sr == wxEmptyString)
1423     {
1424         OnIndexAll(event);
1425     }
1426     else
1427     {
1428         wxBusyCursor bcur;
1429         const wxChar *cstr = sr.c_str();
1430         wxChar mybuff[512];
1431         wxChar *ptr;
1432         bool first = TRUE;
1433
1434         m_IndexList->Clear();
1435         int cnt = m_Data->GetIndexCnt();
1436         wxHtmlContentsItem* index = m_Data->GetIndex();
1437
1438         int displ = 0;
1439         for (int i = 0; i < cnt; i++)
1440         {
1441             wxStrncpy(mybuff, index[i].m_Name, 512);
1442             mybuff[511] = _T('\0');
1443             for (ptr = mybuff; *ptr != 0; ptr++)
1444                 if (*ptr >= _T('A') && *ptr <= _T('Z'))
1445                     *ptr -= (wxChar)(_T('A') - _T('a'));
1446             if (wxStrstr(mybuff, cstr) != NULL)
1447             {
1448                 m_IndexList->Append(index[i].m_Name, (char*)(index + i));
1449                 displ++;
1450                 if (first)
1451                 {
1452                     if (index[i].m_Page[0] != 0)
1453                         m_HtmlWin->LoadPage(index[i].GetFullPath());
1454                     NotifyPageChanged();
1455                     first = FALSE;
1456                 }
1457             }
1458         }
1459
1460         wxString cnttext;
1461         cnttext.Printf(_("%i of %i"), displ, cnt);
1462         m_IndexCountInfo->SetLabel(cnttext);
1463
1464         m_IndexText->SetSelection(0, sr.Length());
1465         m_IndexText->SetFocus();
1466     }
1467 }
1468
1469 void wxHtmlHelpFrame::OnIndexAll(wxCommandEvent& WXUNUSED(event))
1470 {
1471     wxBusyCursor bcur;
1472
1473     m_IndexList->Clear();
1474     int cnt = m_Data->GetIndexCnt();
1475     bool first = TRUE;
1476     wxHtmlContentsItem* index = m_Data->GetIndex();
1477
1478     for (int i = 0; i < cnt; i++)
1479     {
1480         m_IndexList->Append(index[i].m_Name, (char*)(index + i));
1481         if (first)
1482         {
1483             if (index[i].m_Page[0] != 0)
1484                 m_HtmlWin->LoadPage(index[i].GetFullPath());
1485             NotifyPageChanged();
1486             first = FALSE;
1487         }
1488     }
1489
1490     wxString cnttext;
1491     cnttext.Printf(_("%i of %i"), cnt, cnt);
1492     m_IndexCountInfo->SetLabel(cnttext);
1493 }
1494
1495
1496 void wxHtmlHelpFrame::OnSearchSel(wxCommandEvent& WXUNUSED(event))
1497 {
1498     wxHtmlContentsItem *it = (wxHtmlContentsItem*) m_SearchList->GetClientData(m_SearchList->GetSelection());
1499     if (it)
1500     {
1501         if (it->m_Page[0] != 0)
1502             m_HtmlWin->LoadPage(it->GetFullPath());
1503         NotifyPageChanged();
1504     }
1505 }
1506
1507 void wxHtmlHelpFrame::OnSearch(wxCommandEvent& WXUNUSED(event))
1508 {
1509     wxString sr = m_SearchText->GetLineText(0);
1510
1511     if (sr != wxEmptyString) KeywordSearch(sr);
1512 }
1513
1514 void wxHtmlHelpFrame::OnBookmarksSel(wxCommandEvent& WXUNUSED(event))
1515 {
1516     wxString sr = m_Bookmarks->GetStringSelection();
1517
1518     if (sr != wxEmptyString && sr != _("(bookmarks)"))
1519     {
1520        m_HtmlWin->LoadPage(m_BookmarksPages[m_BookmarksNames.Index(sr)]);
1521        NotifyPageChanged();
1522     }
1523 }
1524
1525 void wxHtmlHelpFrame::OnCloseWindow(wxCloseEvent& evt)
1526 {
1527     GetSize(&m_Cfg.w, &m_Cfg.h);
1528     GetPosition(&m_Cfg.x, &m_Cfg.y);
1529
1530     if (m_Splitter && m_Cfg.navig_on) m_Cfg.sashpos = m_Splitter->GetSashPosition();
1531
1532     if (m_Config)
1533         WriteCustomization(m_Config, m_ConfigRoot);
1534
1535     if (m_helpController && m_helpController->IsKindOf(CLASSINFO(wxHtmlHelpController)))
1536     {
1537         ((wxHtmlHelpController*) m_helpController)->OnCloseFrame(evt);
1538     }
1539
1540     evt.Skip();
1541 }
1542
1543 BEGIN_EVENT_TABLE(wxHtmlHelpFrame, wxFrame)
1544     EVT_TOOL_RANGE(wxID_HTML_PANEL, wxID_HTML_OPTIONS, wxHtmlHelpFrame::OnToolbar)
1545     EVT_BUTTON(wxID_HTML_BOOKMARKSREMOVE, wxHtmlHelpFrame::OnToolbar)
1546     EVT_BUTTON(wxID_HTML_BOOKMARKSADD, wxHtmlHelpFrame::OnToolbar)
1547     EVT_TREE_SEL_CHANGED(wxID_HTML_TREECTRL, wxHtmlHelpFrame::OnContentsSel)
1548     EVT_LISTBOX(wxID_HTML_INDEXLIST, wxHtmlHelpFrame::OnIndexSel)
1549     EVT_LISTBOX(wxID_HTML_SEARCHLIST, wxHtmlHelpFrame::OnSearchSel)
1550     EVT_BUTTON(wxID_HTML_SEARCHBUTTON, wxHtmlHelpFrame::OnSearch)
1551     EVT_TEXT_ENTER(wxID_HTML_SEARCHTEXT, wxHtmlHelpFrame::OnSearch)
1552     EVT_BUTTON(wxID_HTML_INDEXBUTTON, wxHtmlHelpFrame::OnIndexFind)
1553     EVT_TEXT_ENTER(wxID_HTML_INDEXTEXT, wxHtmlHelpFrame::OnIndexFind)
1554     EVT_BUTTON(wxID_HTML_INDEXBUTTONALL, wxHtmlHelpFrame::OnIndexAll)
1555     EVT_COMBOBOX(wxID_HTML_BOOKMARKSLIST, wxHtmlHelpFrame::OnBookmarksSel)
1556     EVT_CLOSE(wxHtmlHelpFrame::OnCloseWindow)
1557 END_EVENT_TABLE()
1558
1559 #endif // wxUSE_WXHTML_HELP
1560