wxPython/src/htmlhelp.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        htmlhelp.i
   3 // Purpose:     SWIG definitions of html classes
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     25-nov-1998
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 1998 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13
  14 %module htmlhelp
  15
  16 %{
  17 #include "helpers.h"
  18 #include <wx/html/htmlwin.h>
  19 #include <wx/html/helpctrl.h>
  20 #include <wx/image.h>
  21 #include <wx/fs_zip.h>
  22 #include <wx/fs_inet.h>
  23 #include <wx/wfstream.h>
  24 %}
  25
  26 //---------------------------------------------------------------------------
  27
  28 %include typemaps.i
  29 %include my_typemaps.i
  30
  31 %extern wx.i
  32 %extern windows.i
  33 %extern frames.i
  34 %extern _defs.i
  35 %extern events.i
  36 %extern controls.i
  37 %extern controls2.i
  38
  39 %extern utils.i
  40
  41 %extern html.i
  42
  43 //---------------------------------------------------------------------------
  44
  45 enum {
  46     wxID_HTML_PANEL,
  47     wxID_HTML_BACK,
  48     wxID_HTML_FORWARD,
  49     wxID_HTML_TREECTRL,
  50     wxID_HTML_INDEXPAGE,
  51     wxID_HTML_INDEXLIST,
  52     wxID_HTML_NOTEBOOK,
  53     wxID_HTML_SEARCHPAGE,
  54     wxID_HTML_SEARCHTEXT,
  55     wxID_HTML_SEARCHLIST,
  56     wxID_HTML_SEARCHBUTTON,
  57     wxID_HTML_SEARCHCHOICE,
  58     wxID_HTML_HELPFRAME
  59
  60 };
  61
  62 //---------------------------------------------------------------------------
  63
  64 class  wxHtmlHelpFrameCfg
  65 {
  66 public:
  67     wxHtmlHelpFrameCfg();
  68
  69     long x, y, w, h;
  70     long sashpos;
  71     bool navig_on;
  72 };
  73
  74
  75 //---------------------------------------------------------------------------
  76
  77 class wxHtmlBookRecord  {
  78 public:
  79     wxHtmlBookRecord(const wxString& basepath, const wxString& title,
  80                      const wxString& start);
  81
  82     wxString GetTitle();
  83     wxString GetStart();
  84     wxString GetBasePath();
  85
  86     void SetContentsRange(int start, int end);
  87     int GetContentsStart();
  88     int GetContentsEnd();
  89 };
  90
  91 //---------------------------------------------------------------------------
  92
  93 typedef struct
  94 {
  95     short int m_Level;
  96     int m_ID;
  97     char* m_Name;
  98     char* m_Page;
  99     wxHtmlBookRecord *m_Book;
 100 } wxHtmlContentsItem;
 101
 102 //---------------------------------------------------------------------------
 103
 104 class wxHtmlSearchStatus
 105 {
 106 public:
 107     //wxHtmlSearchStatus(wxHtmlHelpData* base, const wxString& keyword,
 108     //                   const wxString& book = wxEmptyString);
 109     bool Search();
 110     bool IsActive();
 111     int GetCurIndex();
 112     int GetMaxIndex();
 113     const wxString& GetName();
 114     wxHtmlContentsItem* GetContentsItem();
 115 };
 116
 117 //---------------------------------------------------------------------------
 118
 119 class wxHtmlHelpData {
 120 public:
 121     wxHtmlHelpData();
 122     ~wxHtmlHelpData();
 123
 124     void SetTempDir(const wxString& path);
 125     bool AddBook(const wxString& book);
 126 //      bool AddBookParam(const wxString& title, const wxString& contfile,
 127 //                    const wxString& indexfile=wxEmptyString,
 128 //                    const wxString& deftopic=wxEmptyString,
 129 //                    const wxString& path=wxEmptyString);
 130
 131     wxString FindPageByName(const wxString& page);
 132     wxString FindPageById(int id);
 133
 134     // **** this one needs fixed...
 135     const wxHtmlBookRecArray& GetBookRecArray();
 136
 137     wxHtmlContentsItem* GetContents();
 138     int GetContentsCnt();
 139     wxHtmlContentsItem* GetIndex();
 140     int GetIndexCnt();
 141 };
 142
 143 //---------------------------------------------------------------------------
 144
 145 class wxHtmlHelpFrame : public wxFrame {
 146 public:
 147     wxHtmlHelpFrame(wxWindow* parent, int wxWindowID,
 148                     const wxString& title = wxEmptyString,
 149                     int style = wxHF_DEFAULTSTYLE, wxHtmlHelpData* data = NULL);
 150
 151     wxHtmlHelpData* GetData();
 152     void SetTitleFormat(const wxString& format);
 153     void Display(const wxString& x);
 154     %name(DisplayID) void Display(int id);
 155     void DisplayContents();
 156     void DisplayIndex();
 157     bool KeywordSearch(const wxString& keyword);
 158     void UseConfig(wxConfigBase *config, const wxString& rootpath = wxEmptyString);
 159     void ReadCustomization(wxConfigBase *cfg, wxString path = wxEmptyString);
 160     void WriteCustomization(wxConfigBase *cfg, wxString path = wxEmptyString);
 161 };
 162
 163
 164 //---------------------------------------------------------------------------
 165
 166 class wxHtmlHelpController : public wxEvtHandler {
 167 public:
 168     wxHtmlHelpController();
 169     ~wxHtmlHelpController();
 170
 171     void SetTitleFormat(const wxString& format);
 172     void SetTempDir(const wxString& path);
 173     bool AddBook(const wxString& book, int show_wait_msg = FALSE);
 174     void Display(const wxString& x);
 175     %name(DisplayID) void Display(int id);
 176     void DisplayContents();
 177     void DisplayIndex();
 178     bool KeywordSearch(const wxString& keyword);
 179     void UseConfig(wxConfigBase *config, const wxString& rootpath = wxEmptyString);
 180     void ReadCustomization(wxConfigBase *cfg, wxString path = wxEmptyString);
 181     void WriteCustomization(wxConfigBase *cfg, wxString path = wxEmptyString);
 182     wxHtmlHelpFrame* GetFrame();
 183 };
 184
 185 //---------------------------------------------------------------------------
 186 //---------------------------------------------------------------------------