X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ecacdf8fc543b9a109d77cc6d3088f42cf8c6069..d0c6b305af860aa4d8b3d16717e8855d0fd73b1f:/docs/latex/wx/hthelpct.tex diff --git a/docs/latex/wx/hthelpct.tex b/docs/latex/wx/hthelpct.tex index 6576ca1f3e..fdc46abd1a 100644 --- a/docs/latex/wx/hthelpct.tex +++ b/docs/latex/wx/hthelpct.tex @@ -5,11 +5,12 @@ \section{\class{wxHtmlHelpController}}\label{wxhtmlhelpcontroller} -{\bf WARNING! This help controller has an API incompatible with wxWindows -wxHelpController!} +{\bf WARNING!} Although this class has an API compatible with other wxWindows +help controllers as documented by \helpref{wxHelpController}{wxhelpcontroller}, it +is recommended that you use the enhanced capabilities of wxHtmlHelpController's API. This help controller provides an easy way of displaying HTML help in your -application (see {\it test} sample). The help system is based on {\bf books} +application (see {\it test} sample). The help system is based on {\bf books} (see \helpref{AddBook}{wxhtmlhelpcontrolleraddbook}). A book is a logical section of documentation (for example "User's Guide" or "Programmer's Guide" or "C++ Reference" or "wxWindows Reference"). The help controller can handle as @@ -33,14 +34,18 @@ have the following line in your .rc file: It is strongly recommended to use preprocessed {\bf .hhp.cached} version of projects. It can be either created on-the-fly (see -\helpref{SetTempDir}{wxhtmlhelpcontrollersettempdir}) or you can use +\helpref{SetTempDir}{wxhtmlhelpcontrollersettempdir}) or you can use {\bf hhp2cached} utility from {\it utils/hhp2cached} to create it and -distribute the cached version together with helpfiles. See {\it samples/html/help} +distribute the cached version together with helpfiles. See {\it samples/html/help} sample for demonstration of its use. \wxheading{Derived from} -\helpref{wxEvtHandler}{wxevthandler} +wxHelpControllerBase + +\wxheading{Include files} + + \latexignore{\rtfignore{\wxheading{Members}}} @@ -54,8 +59,9 @@ 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\_FLATTOOLBAR}}{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.} @@ -80,6 +86,13 @@ recommended way. If {\it show\_wait\_msg} is TRUE then a decorationless window with progress message is displayed. +\membersection{wxHtmlHelpController::CreateHelpFrame}\label{wxhtmlhelpcontrollercreatehelpframe} + +\func{virtual wxHtmlHelpFrame*}{CreateHelpFrame}{\param{wxHtmlHelpData * }{data}} + +This protected virtual method may be overridden so that the controller +uses slightly different frame. See {\it samples/html/helpview} sample for +an example. \membersection{wxHtmlHelpController::Display}\label{wxhtmlhelpcontrollerdisplay} \func{void}{Display}{\param{const wxString\& }{x}} @@ -132,7 +145,7 @@ Displays help window and focuses index panel. Displays help window, focuses search panel and starts searching. Returns TRUE if the keyword was found. -{\bf Important:} KeywordSearch searches only pages listed in .htc file(s). +{\bf Important:} KeywordSearch searches only pages listed in .hhc file(s). You should list all pages in the contents file. \membersection{wxHtmlHelpController::ReadCustomization}\label{wxhtmlhelpcontrollerreadcustomization} @@ -147,7 +160,7 @@ Reads the controller's setting (position of window, etc.) Sets the path for storing temporary files - cached binary versions of index and contents files. These binary forms are much faster to read. Default value is empty string (empty string means -that no cached data are stored). Note that these files are {\it not} +that no cached data are stored). Note that these files are {\it not} deleted when program exits. Once created these cached files will be used in all subsequent executions @@ -183,12 +196,3 @@ default wxConfig object if available (for details see Stores controllers setting (position of window etc.) -\membersection{wxHtmlHelpController::CreateHelpFrame}\label{wxhtmlhelpcontrollercreatehelpframe} - -\func{virtual wxHtmlHelpFrame*}{CreateHelpFrame}{\param{wxHtmlHelpData * }{data}} - -This protected virtual method may be overriden so that the controller -uses slightly different frame. See {\it samples/html/helpview} sample for -an example. - -