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