X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/605d715ddd84ddc3e78423e3f3ae5c27c8ff4d43..9329312b60229511c24e59cf849fd6281ec4dc7b:/docs/latex/wx/hthelpct.tex?ds=sidebyside diff --git a/docs/latex/wx/hthelpct.tex b/docs/latex/wx/hthelpct.tex index 5bb81c9323..6576ca1f3e 100644 --- a/docs/latex/wx/hthelpct.tex +++ b/docs/latex/wx/hthelpct.tex @@ -29,9 +29,18 @@ have the following line in your .rc file: #include "wx/html/msw/wxhtml.rc" \end{verbatim} +\wxheading{Note} + +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 +{\bf hhp2cached} utility from {\it utils/hhp2cached} to create it and +distribute the cached version together with helpfiles. See {\it samples/html/help} +sample for demonstration of its use. + \wxheading{Derived from} -wxEvtHandler +\helpref{wxEvtHandler}{wxevthandler} \latexignore{\rtfignore{\wxheading{Members}}} @@ -51,9 +60,11 @@ Constructor. \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\_OPENFILES}}{Allow user to open arbitrary HTML document.} +\twocolitem{\windowstyle{wxHF\_PRINT}}{Toolbar contains "print" button.} \end{twocollist} -Default value : everything enabled. +Default value: everything but wxHF\_OPENFILES enabled. \membersection{wxHtmlHelpController::AddBook}\label{wxhtmlhelpcontrolleraddbook} @@ -139,6 +150,10 @@ 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} deleted when program exits. +Once created these cached files will be used in all subsequent executions +of your application. If cached files become older than corresponding .hhp +file (e.g. if you regenerate documentation) it will be refreshed. + \membersection{wxHtmlHelpController::SetTitleFormat}\label{wxhtmlhelpcontrollersettitleformat} \func{void}{SetTitleFormat}{\param{const wxString\& }{format}} @@ -157,9 +172,23 @@ reads and writes settings (including wxHtmlWindow's settings) when needed. The only thing you must do is create wxConfig object and call UseConfig. +If you do not use {\it UseConfig}, wxHtmlHelpController will use +default wxConfig object if available (for details see +\helpref{wxConfigBase::Get}{wxconfigbaseget} and +\helpref{wxConfigBase::Set}{wxconfigbaseset}). + \membersection{wxHtmlHelpController::WriteCustomization}\label{wxhtmlhelpcontrollerwritecustomization} \func{void}{WriteCustomization}{\param{wxConfigBase* }{cfg}, \param{wxString }{path = wxEmptyString}} 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. + +