X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/c914a1a2d2d099480663a78ee5f9409e48c4c4b7..d6c6a32321219a3a2961e7f1ee1a8d2d54dc5cdf:/docs/latex/wx/hthlpfrm.tex diff --git a/docs/latex/wx/hthlpfrm.tex b/docs/latex/wx/hthlpfrm.tex index db2596e1a6..324264b8a8 100644 --- a/docs/latex/wx/hthlpfrm.tex +++ b/docs/latex/wx/hthlpfrm.tex @@ -3,93 +3,97 @@ % helpfrm.h at 24/Oct/99 18:03:10 % - \section{\class{wxHtmlHelpFrame}}\label{wxhtmlhelpframe} -This class is used by \helpref{wxHtmlHelpController}{wxhtmlhelpcontroller} +This class is used by \helpref{wxHtmlHelpController}{wxhtmlhelpcontroller} to display help. -It is internal class and should not be used directly - except for the case -you're writing your own HTML help controller. - +It is an internal class and should not be used directly - except for the case +when you're writing your own HTML help controller. \wxheading{Derived from} \helpref{wxFrame}{wxframe} -\latexignore{\rtfignore{\wxheading{Members}}} +\wxheading{Include files} + +\latexignore{\rtfignore{\wxheading{Members}}} \membersection{wxHtmlHelpFrame::wxHtmlHelpFrame}\label{wxhtmlhelpframewxhtmlhelpframe} \func{}{wxHtmlHelpFrame}{\param{wxHtmlHelpData* }{data = NULL}} -\func{}{wxHtmlHelpFrame}{\param{wxWindow* }{parent}, \param{int }{wxWindowID}, \param{const wxString\& }{title = wxEmptyString}, \param{int }{style = wxHF\_DEFAULTSTYLE}, \param{wxHtmlHelpData* }{data = NULL}} +\func{}{wxHtmlHelpFrame}{\param{wxWindow* }{parent}, \param{int }{wxWindowID}, \param{const wxString\& }{title = wxEmptyString}, \param{int }{style = wxHF\_DEFAULT\_STYLE}, \param{wxHtmlHelpData* }{data = NULL}} Constructor. {\it style} is combination of these flags: -\begin{twocollist} +\begin{twocollist}\itemsep=0pt \twocolitem{\windowstyle{wxHF\_TOOLBAR}}{Help frame has toolbar.} +\twocolitem{\windowstyle{wxHF\_FLAT\_TOOLBAR}}{Help frame has toolbar with flat buttons (aka coolbar).} \twocolitem{\windowstyle{wxHF\_CONTENTS}}{Help frame has contents panel.} \twocolitem{\windowstyle{wxHF\_INDEX}}{Help frame has index panel.} \twocolitem{\windowstyle{wxHF\_SEARCH}}{Help frame has search panel.} \twocolitem{\windowstyle{wxHF\_BOOKMARKS}}{Help frame has bookmarks controls.} +\twocolitem{\windowstyle{wxHF\_OPEN\_FILES}}{Allow user to open arbitrary HTML document.} +\twocolitem{\windowstyle{wxHF\_PRINT}}{Toolbar contains "print" button.} +\twocolitem{\windowstyle{wxHF\_MERGE\_BOOKS}}{Contents pane does not show +book nodes. All books are merged together and appear as single book to the +user.} +\twocolitem{\windowstyle{wxHF\_ICONS\_BOOK}}{All nodes in contents pane +have a book icon. This is how Microsoft's HTML help viewer behaves.} +\twocolitem{\windowstyle{wxHF\_ICONS\_FOLDER}}{Book nodes in contents pane have +a book icon, book's sections have a folder icon. This is the default.} +\twocolitem{\windowstyle{wxHF\_ICONS\_BOOK\_CHAPTER}}{Both book nodes and +nodes of top-level sections of a book (i.e. chapters) have a book icon, +all other sections (sections, subsections, ...) have a folder icon.} +\twocolitem{\windowstyle{wxHF\_DEFAULT\_STYLE}}{{\tt wxHF\_TOOLBAR | wxHF\_CONTENTS +| wxHF\_INDEX | wxHF\_SEARCH | wxHF\_BOOKMARKS | wxHF\_PRINT}} \end{twocollist} - \membersection{wxHtmlHelpFrame::Create}\label{wxhtmlhelpframecreate} -\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id}, \param{const wxString\& }{title = wxEmptyString}, \param{int }{style = wxHF\_DEFAULTSTYLE}} - -Creates the frame. - -{\it style} is combination of these flags: - -\begin{twocollist} -\twocolitem{\windowstyle{wxHF\_TOOLBAR}}{Help frame has toolbar.} -\twocolitem{\windowstyle{wxHF\_CONTENTS}}{Help frame has contents panel.} -\twocolitem{\windowstyle{wxHF\_INDEX}}{Help frame has index panel.} -\twocolitem{\windowstyle{wxHF\_SEARCH}}{Help frame has search panel.} -\end{twocollist} - +\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID }{id}, \param{const wxString\& }{title = wxEmptyString}, \param{int }{style = wxHF\_DEFAULT\_STYLE}} +Creates the frame. See \helpref{the constructor}{wxhtmlhelpframewxhtmlhelpframe} +for parameters description. \membersection{wxHtmlHelpFrame::CreateContents}\label{wxhtmlhelpframecreatecontents} -\func{void}{CreateContents}{\param{bool }{show\_progress = FALSE}} +\func{void}{CreateContents}{\param{bool }{show\_progress = false}} Creates contents panel. (May take some time.) - \membersection{wxHtmlHelpFrame::CreateIndex}\label{wxhtmlhelpframecreateindex} -\func{void}{CreateIndex}{\param{bool }{show\_progress = FALSE}} +\func{void}{CreateIndex}{\param{bool }{show\_progress = false}} Creates index panel. (May take some time.) - \membersection{wxHtmlHelpFrame::CreateSearch}\label{wxhtmlhelpframecreatesearch} \func{void}{CreateSearch}{\void} Creates search panel. - \membersection{wxHtmlHelpFrame::Display}\label{wxhtmlhelpframedisplay} \func{bool}{Display}{\param{const wxString\& }{x}} \func{bool}{Display}{\param{const int }{id}} -Displays page x. If not found it will offect the user a choice of +Displays page x. If not found it will give the user the choice of searching books. Looking for the page runs in these steps: -1. try to locate file named x (if x is for example "doc/howto.htm") -2. try to open starting page of book x -3. try to find x in contents (if x is for example "How To ...") -4. try to find x in index (if x is for example "How To ...") + +\begin{enumerate}\itemsep=0pt +\item try to locate file named x (if x is for example "doc/howto.htm") +\item try to open starting page of book x +\item try to find x in contents (if x is for example "How To ...") +\item try to find x in index (if x is for example "How To ...") +\end{enumerate} The second form takes numeric ID as the parameter. (uses extension to MS format, ) @@ -109,7 +113,6 @@ Displays contents panel. Displays index panel. - \membersection{wxHtmlHelpFrame::GetData}\label{wxhtmlhelpframegetdata} \func{wxHtmlHelpData*}{GetData}{\void} @@ -122,7 +125,6 @@ Return wxHtmlHelpData object. Search for given keyword. - \membersection{wxHtmlHelpFrame::ReadCustomization}\label{wxhtmlhelpframereadcustomization} \func{void}{ReadCustomization}{\param{wxConfigBase* }{cfg}, \param{const wxString\& }{path = wxEmptyString}} @@ -131,28 +133,38 @@ Reads user's settings for this frame (see \helpref{wxHtmlHelpController::ReadCus \membersection{wxHtmlHelpFrame::RefreshLists}\label{wxhtmlhelpframerefreshlists} -\func{void}{RefreshLists}{\param{bool }{show\_progress = FALSE}} +\func{void}{RefreshLists}{\param{bool }{show\_progress = false}} -Refresh all panels. This is neccessary if new book was added. +Refresh all panels. This is necessary if a new book was added. \membersection{wxHtmlHelpFrame::SetTitleFormat}\label{wxhtmlhelpframesettitleformat} \func{void}{SetTitleFormat}{\param{const wxString\& }{format}} -Sets frame's title format. {\it format} must contain exactly one "\%s" -(it will be replaced by page's title). +Sets the frame's title format. {\it format} must contain exactly one "\%s" +(it will be replaced by the page title). \membersection{wxHtmlHelpFrame::UseConfig}\label{wxhtmlhelpframeuseconfig} \func{void}{UseConfig}{\param{wxConfigBase* }{config}, \param{const wxString\& }{rootpath = wxEmptyString}} -Add books to search choice panel - +Add books to search choice panel. \membersection{wxHtmlHelpFrame::WriteCustomization}\label{wxhtmlhelpframewritecustomization} \func{void}{WriteCustomization}{\param{wxConfigBase* }{cfg}, \param{const wxString\& }{path = wxEmptyString}} -Saves user's settings for this frame (see \helpref{wxHtmlHelpController::WriteCustomization}{wxhtmlhelpcontrollerwritecustomization}) +Saves user's settings for this frame (see \helpref{wxHtmlHelpController::WriteCustomization}{wxhtmlhelpcontrollerwritecustomization}). + +\membersection{wxHtmlHelpFrame::AddToolbarButtons}\label{wxhtmlhelpframeaddtoolbarbuttons} + +\func{virtual void}{AddToolbarButtons}{\param{wxToolBar *}{toolBar}, \param{int }{style}} + +You may override this virtual method to add more buttons into help frame's +toolbar. {\it toolBar} is a pointer to the toolbar and {\it style} is the style +flag as passed to Create method. + +wxToolBar::Realize is called immediately after returning from this function. +See {\it samples/html/helpview} for an example.