docs/latex/wx/hthlpfrm.tex

   1 %
   2 % automatically generated by HelpGen from
   3 % helpfrm.h at 24/Oct/99 18:03:10
   4 %
   5
   6
   7 \section{\class{wxHtmlHelpFrame}}\label{wxhtmlhelpframe}
   8
   9 This class is used by \helpref{wxHtmlHelpController}{wxhtmlhelpcontroller}
  10 to display help.
  11 It is internal class and should not be used directly - except for the case
  12 you're writing your own HTML help controller.
  13
  14
  15 \wxheading{Derived from}
  16
  17 \helpref{wxFrame}{wxframe}
  18
  19 \latexignore{\rtfignore{\wxheading{Members}}}
  20
  21
  22
  23 \membersection{wxHtmlHelpFrame::wxHtmlHelpFrame}\label{wxhtmlhelpframewxhtmlhelpframe}
  24
  25 \func{}{wxHtmlHelpFrame}{\param{wxHtmlHelpData* }{data = NULL}}
  26
  27 \func{}{wxHtmlHelpFrame}{\param{wxWindow* }{parent}, \param{int }{wxWindowID}, \param{const wxString\& }{title = wxEmptyString}, \param{int }{style = wxHF\_DEFAULTSTYLE}, \param{wxHtmlHelpData* }{data = NULL}}
  28
  29 Constructor.
  30
  31 {\it style} is combination of these flags:
  32
  33 \begin{twocollist}
  34 \twocolitem{\windowstyle{wxHF\_TOOLBAR}}{Help frame has toolbar.}
  35 \twocolitem{\windowstyle{wxHF\_CONTENTS}}{Help frame has contents panel.}
  36 \twocolitem{\windowstyle{wxHF\_INDEX}}{Help frame has index panel.}
  37 \twocolitem{\windowstyle{wxHF\_SEARCH}}{Help frame has search panel.}
  38 \twocolitem{\windowstyle{wxHF\_BOOKMARKS}}{Help frame has bookmarks controls.}
  39 \twocolitem{\windowstyle{wxHF\_OPENFILES}}{Allow user to open arbitrary HTML document.}
  40 \twocolitem{\windowstyle{wxHF\_PRINT}}{Toolbar contains "print" button.}
  41 \end{twocollist}
  42
  43
  44 \membersection{wxHtmlHelpFrame::Create}\label{wxhtmlhelpframecreate}
  45
  46 \func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id}, \param{const wxString\& }{title = wxEmptyString}, \param{int }{style = wxHF\_DEFAULTSTYLE}}
  47
  48 Creates the frame.
  49
  50 {\it style} is combination of these flags:
  51
  52 \begin{twocollist}
  53 \twocolitem{\windowstyle{wxHF\_TOOLBAR}}{Help frame has toolbar.}
  54 \twocolitem{\windowstyle{wxHF\_CONTENTS}}{Help frame has contents panel.}
  55 \twocolitem{\windowstyle{wxHF\_INDEX}}{Help frame has index panel.}
  56 \twocolitem{\windowstyle{wxHF\_SEARCH}}{Help frame has search panel.}
  57 \end{twocollist}
  58
  59
  60
  61 \membersection{wxHtmlHelpFrame::CreateContents}\label{wxhtmlhelpframecreatecontents}
  62
  63 \func{void}{CreateContents}{\param{bool }{show\_progress = FALSE}}
  64
  65 Creates contents panel. (May take some time.)
  66
  67
  68 \membersection{wxHtmlHelpFrame::CreateIndex}\label{wxhtmlhelpframecreateindex}
  69
  70 \func{void}{CreateIndex}{\param{bool }{show\_progress = FALSE}}
  71
  72 Creates index panel. (May take some time.)
  73
  74
  75 \membersection{wxHtmlHelpFrame::CreateSearch}\label{wxhtmlhelpframecreatesearch}
  76
  77 \func{void}{CreateSearch}{\void}
  78
  79 Creates search panel.
  80
  81
  82 \membersection{wxHtmlHelpFrame::Display}\label{wxhtmlhelpframedisplay}
  83
  84 \func{bool}{Display}{\param{const wxString\& }{x}}
  85
  86 \func{bool}{Display}{\param{const int }{id}}
  87
  88 Displays page x. If not found it will offect the user a choice of
  89 searching books.
  90 Looking for the page runs in these steps:
  91 1. try to locate file named x (if x is for example "doc/howto.htm")
  92 2. try to open starting page of book x
  93 3. try to find x in contents (if x is for example "How To ...")
  94 4. try to find x in index (if x is for example "How To ...")
  95
  96 The second form takes numeric ID as the parameter.
  97 (uses extension to MS format, <param name="ID" value=id>)
  98
  99 \pythonnote{The second form of this method is named DisplayId in
 100 wxPython.}
 101
 102 \membersection{wxHtmlHelpFrame::DisplayContents}\label{wxhtmlhelpframedisplaycontents}
 103
 104 \func{bool}{DisplayContents}{\void}
 105
 106 Displays contents panel.
 107
 108 \membersection{wxHtmlHelpFrame::DisplayIndex}\label{wxhtmlhelpframedisplayindex}
 109
 110 \func{bool}{DisplayIndex}{\void}
 111
 112 Displays index panel.
 113
 114
 115 \membersection{wxHtmlHelpFrame::GetData}\label{wxhtmlhelpframegetdata}
 116
 117 \func{wxHtmlHelpData*}{GetData}{\void}
 118
 119 Return wxHtmlHelpData object.
 120
 121 \membersection{wxHtmlHelpFrame::KeywordSearch}\label{wxhtmlhelpframekeywordsearch}
 122
 123 \func{bool}{KeywordSearch}{\param{const wxString\& }{keyword}}
 124
 125 Search for given keyword.
 126
 127
 128 \membersection{wxHtmlHelpFrame::ReadCustomization}\label{wxhtmlhelpframereadcustomization}
 129
 130 \func{void}{ReadCustomization}{\param{wxConfigBase* }{cfg}, \param{const wxString\& }{path = wxEmptyString}}
 131
 132 Reads user's settings for this frame (see \helpref{wxHtmlHelpController::ReadCustomization}{wxhtmlhelpcontrollerreadcustomization})
 133
 134 \membersection{wxHtmlHelpFrame::RefreshLists}\label{wxhtmlhelpframerefreshlists}
 135
 136 \func{void}{RefreshLists}{\param{bool }{show\_progress = FALSE}}
 137
 138 Refresh all panels. This is neccessary if new book was added.
 139
 140 \membersection{wxHtmlHelpFrame::SetTitleFormat}\label{wxhtmlhelpframesettitleformat}
 141
 142 \func{void}{SetTitleFormat}{\param{const wxString\& }{format}}
 143
 144 Sets frame's title format. {\it format} must contain exactly one "\%s"
 145 (it will be replaced by page's title).
 146
 147 \membersection{wxHtmlHelpFrame::UseConfig}\label{wxhtmlhelpframeuseconfig}
 148
 149 \func{void}{UseConfig}{\param{wxConfigBase* }{config}, \param{const wxString\& }{rootpath = wxEmptyString}}
 150
 151 Add books to search choice panel
 152
 153
 154 \membersection{wxHtmlHelpFrame::WriteCustomization}\label{wxhtmlhelpframewritecustomization}
 155
 156 \func{void}{WriteCustomization}{\param{wxConfigBase* }{cfg}, \param{const wxString\& }{path = wxEmptyString}}
 157
 158 Saves user's settings for this frame (see \helpref{wxHtmlHelpController::WriteCustomization}{wxhtmlhelpcontrollerwritecustomization})
 159
 160
 161 \membersection{wxHtmlHelpFrame::AddToolbarButtons}\label{wxhtmlhelpframeaddtoolbarbuttons}
 162
 163 \func{virtual void}{AddToolbarButtons}{\param{wxToolBar *}{toolBar}, \param{int }{style}}
 164
 165 You may override this virtual method to add more buttons into help frame's
 166 toolbar. {\it toolBar} is pointer to the toolbar and {\it style} is style
 167 flag as passed to Create method.
 168
 169 wxToolBar::Realize is called immediately after returning from this function.
 170
 171 See {\it samples/html/helpview} for an example.