src/generic/helpwxht.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        helpext.cpp
   3 // Purpose:     an external help controller for wxWindows
   4 // Author:      Karsten Ballueder
   5 // Modified by:
   6 // Created:     04/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Karsten Ballueder
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifdef __GNUG__
  13 #   pragma implementation "helpwxht.h"
  14 #endif
  15
  16 #include "wx/wxprec.h"
  17
  18 #ifdef __BORLANDC__
  19 #   pragma hdrstop
  20 #endif
  21
  22 #if wxUSE_HTML
  23
  24 #ifndef WX_PRECOMP
  25 #   include "wx/string.h"
  26 #   include "wx/utils.h"
  27 #   include "wx/list.h"
  28 #   include "wx/intl.h"
  29 #   include "wx/layout.h"
  30 #   include "wx/combobox.h"
  31 #endif
  32
  33 #include "wx/helpbase.h"
  34 #include "wx/generic/helpwxht.h"
  35 #include "wx/html/htmlwin.h"
  36
  37 #include <stdio.h>
  38 #include <ctype.h>
  39 #ifndef __MWERKS__
  40 #include <sys/stat.h>
  41 #endif
  42
  43 #if !defined(__WINDOWS__) && !defined(__OS2__)
  44 #   include   <unistd.h>
  45 #endif
  46
  47 IMPLEMENT_CLASS(wxHelpControllerHtml, wxHTMLHelpControllerBase)
  48
  49 /**
  50    This class implements help via wxHTML.
  51    It requires the name of a directory containing the documentation
  52    and a file mapping numerical Section numbers to relative URLS.
  53 */
  54
  55 class wxForceHtmlFilter : public wxHtmlFilter
  56 {
  57 public:
  58    virtual wxString ReadFile(const wxFSFile& file) const
  59       {
  60          wxInputStream *s = file.GetStream();
  61          char *src;
  62          wxString doc;
  63
  64          if (s == NULL) return wxEmptyString;
  65          src = new char[s -> GetSize()+1];
  66          src[s -> GetSize()] = 0;
  67          s -> Read(src, s -> GetSize());
  68          doc = src;
  69          delete [] src;
  70          return doc;
  71       }
  72
  73     virtual bool CanRead(const wxFSFile& file) const
  74       {
  75          wxString filename = file.GetLocation();
  76          if(filename.Length() >= 5 &&
  77             (
  78                filename.Right(4).MakeUpper() == ".HTM" ||
  79                filename.Right(5).MakeUpper() == ".HTML"))
  80             return TRUE;
  81          else
  82             return FALSE;
  83       }
  84 };
  85
  86 #define FRAME_WIDTH  500
  87 #define FRAME_HEIGHT 400
  88 #define LAYOUT_X_MARGIN 2
  89 #define LAYOUT_Y_MARGIN 2
  90 #define OFFSET 10
  91 #define BUTTON_WIDTH  70
  92 #define MAX_COMBO_ENTRIES   25
  93
  94 class wxHelpFrame : public wxFrame
  95 {
  96 public:
  97    wxHelpFrame(wxWindow *parent, int id, const wxString &title,
  98                const wxPoint &pos, const wxSize &size,
  99                wxHelpControllerHtml *controller);
 100    ~wxHelpFrame();
 101    void OnClose(wxCloseEvent &ev);
 102    void OnButton(wxCommandEvent &ev);
 103    bool LoadPage(const wxString &url) { return m_htmlwin->LoadPage(url); }
 104 private:
 105    wxHelpControllerHtml *m_controller;
 106    wxHtmlWindow         *m_htmlwin;
 107    wxHtmlFilter         *m_filter;
 108    wxComboBox           *m_combo;
 109    long m_IdBack, m_IdFwd, m_IdContents, m_IdCombo, m_IdSearch;
 110    DECLARE_EVENT_TABLE()
 111 };
 112
 113 BEGIN_EVENT_TABLE(wxHelpFrame, wxFrame)
 114    EVT_CLOSE(wxHelpFrame::OnClose)
 115    EVT_BUTTON(-1, wxHelpFrame::OnButton)
 116 END_EVENT_TABLE()
 117
 118
 119 void
 120 wxHelpFrame::OnButton(wxCommandEvent &ev)
 121 {
 122    long id =ev.GetId();
 123
 124    if(id == m_IdBack)
 125       m_htmlwin->HistoryBack();
 126    else if(id == m_IdFwd)
 127       m_htmlwin->HistoryForward();
 128    else if(id == m_IdContents)
 129       m_controller->DisplayContents();
 130    else if(id == m_IdSearch)
 131    {
 132       wxString str = m_combo->GetValue();
 133       if(m_combo->FindString(str) == -1 && m_combo->Number() < MAX_COMBO_ENTRIES)
 134          m_combo->Append(str);
 135       m_controller->KeywordSearch(str);
 136    }
 137 }
 138
 139 wxHelpFrame::wxHelpFrame(wxWindow *parent, int id,
 140                          const wxString &title,
 141                          const wxPoint &pos, const wxSize &size,
 142                          wxHelpControllerHtml *controller)
 143    : wxFrame(parent, id, title, pos, size)
 144 {
 145
 146    m_controller = controller;
 147    m_htmlwin = new wxHtmlWindow(this,-1,wxDefaultPosition,wxSize(FRAME_WIDTH,
 148                                                           FRAME_HEIGHT));
 149
 150    m_IdBack = wxWindow::NewControlId();
 151    m_IdFwd = wxWindow::NewControlId();
 152    m_IdContents = wxWindow::NewControlId();
 153    m_IdCombo = wxWindow::NewControlId();
 154    m_IdSearch = wxWindow::NewControlId();
 155
 156    wxButton *btn_back = new wxButton(this, m_IdBack, _("Back"));
 157    wxButton *btn_fwd = new wxButton(this, m_IdFwd, _("Forward"));
 158    wxButton *btn_contents = new wxButton(this, m_IdContents, _("Contents"));
 159    m_combo = new wxComboBox(this, m_IdCombo);
 160    wxButton *btn_search = new wxButton(this, m_IdSearch, _("Search"));
 161
 162    m_filter = new wxForceHtmlFilter;
 163
 164    wxLayoutConstraints *c;
 165
 166    c = new wxLayoutConstraints;
 167    c->left.SameAs(this, wxLeft, 2*LAYOUT_X_MARGIN);
 168    c->width.Absolute(BUTTON_WIDTH);
 169    c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
 170    c->height.AsIs();
 171    btn_back->SetConstraints(c);
 172
 173    c = new wxLayoutConstraints;
 174    c->left.SameAs(btn_back, wxRight, 2*LAYOUT_X_MARGIN);
 175    c->width.Absolute(BUTTON_WIDTH);
 176    c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
 177    c->height.AsIs();
 178    btn_fwd->SetConstraints(c);
 179
 180    c = new wxLayoutConstraints;
 181    c->left.SameAs(btn_fwd, wxRight, 2*LAYOUT_X_MARGIN);
 182    c->width.Absolute(BUTTON_WIDTH);
 183    c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
 184    c->height.AsIs();
 185    btn_contents->SetConstraints(c);
 186
 187    c = new wxLayoutConstraints;
 188    c->left.SameAs(btn_contents, wxRight, 2*LAYOUT_X_MARGIN);
 189    c->width.Absolute(3*BUTTON_WIDTH);
 190    c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
 191    c->height.AsIs();
 192    m_combo->SetConstraints(c);
 193
 194    c = new wxLayoutConstraints;
 195    c->left.SameAs(m_combo, wxRight, 2*LAYOUT_X_MARGIN);
 196    c->width.Absolute(BUTTON_WIDTH);
 197    c->top.SameAs(this, wxTop, 2*LAYOUT_Y_MARGIN);
 198    c->height.AsIs();
 199    btn_search->SetConstraints(c);
 200
 201
 202    c = new wxLayoutConstraints;
 203    c->left.SameAs(this, wxLeft, 2*LAYOUT_X_MARGIN);
 204    c->right.SameAs(this, wxRight, 2*LAYOUT_X_MARGIN);
 205    c->top.SameAs(btn_back, wxBottom, 2*LAYOUT_Y_MARGIN);
 206    c->bottom.SameAs(this, wxBottom, 2*LAYOUT_Y_MARGIN);
 207    m_htmlwin->SetConstraints(c);
 208    SetAutoLayout(TRUE);
 209    CreateStatusBar();
 210
 211    m_htmlwin->SetRelatedFrame(this, title);
 212    m_htmlwin->SetRelatedStatusBar(0);
 213    m_htmlwin->AddFilter(m_filter);
 214
 215    Show(TRUE);
 216 }
 217
 218 wxHelpFrame::~wxHelpFrame()
 219 {
 220 }
 221
 222 void
 223 wxHelpFrame::OnClose(wxCloseEvent &WXUNUSED(ev))
 224 {
 225    wxASSERT(m_controller);
 226    m_controller->m_Frame = NULL;
 227    bool newFrame;
 228    int x,y;
 229    GetPosition(&x,&y);
 230
 231    m_controller->GetFrameParameters(NULL, NULL, &newFrame);
 232    m_controller->SetFrameParameters(GetTitle(), GetSize(),
 233                                     wxPoint(x,y),
 234                                     newFrame);
 235    Destroy();
 236 }
 237
 238 wxHelpControllerHtml::wxHelpControllerHtml(void)
 239 {
 240    m_Frame = NULL;
 241    m_offset = 0;
 242
 243    SetFrameParameters(_("Help: %s"),
 244                       wxSize(FRAME_WIDTH, FRAME_HEIGHT),
 245                       wxDefaultPosition);
 246 }
 247
 248 wxHelpControllerHtml::~wxHelpControllerHtml(void)
 249 {
 250    if(m_Frame && ! m_NewFrameEachTime)
 251       m_Frame->Close();
 252 }
 253
 254
 255 #ifdef __WXMSW__
 256 #   define   SEP   '\\'
 257 #else
 258 #   define   SEP   '/'
 259 #endif
 260
 261 bool
 262 wxHelpControllerHtml::DisplayHelp(wxString const &relativeURL)
 263 {
 264    wxBusyCursor b; // display a busy cursor
 265
 266    wxString url;
 267    url << m_MapFile << SEP<< relativeURL;
 268    if(! m_Frame || m_NewFrameEachTime)
 269    {
 270       m_Frame = new wxHelpFrame(NULL, -1, m_FrameTitle,
 271                                 m_FramePosition+wxPoint(m_offset,m_offset),
 272                                 m_FrameSize,
 273                                 this);
 274       if(m_NewFrameEachTime)
 275       {
 276          m_offset += OFFSET;
 277          if(m_offset > 200)
 278             m_offset = 0;
 279       }
 280
 281    }
 282    m_Frame->Raise();
 283    return m_Frame->LoadPage(url);
 284 }
 285
 286
 287 void
 288 wxHelpControllerHtml::SetFrameParameters(const wxString &title,
 289                                          const wxSize &size,
 290                                          const wxPoint &pos,
 291                                          bool newFrame)
 292 {
 293    m_FrameTitle = title;
 294    m_FrameSize = size;
 295    m_FramePosition = pos;
 296    m_NewFrameEachTime = newFrame;
 297 }
 298
 299 wxFrame *
 300 wxHelpControllerHtml::GetFrameParameters(wxSize *size,
 301                                          wxPoint *pos,
 302                                          bool *newframe)
 303 {
 304    if(size) *size = m_FrameSize;
 305    if(pos) *pos = m_FramePosition;
 306    if(newframe) *newframe = m_NewFrameEachTime;
 307    return m_Frame;
 308 }
 309
 310 #endif // wxUSE_HTML