// Purpose: interface of wxHtmlHelpController
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
@param showWaitMsg
If @true then a decoration-less window with progress message is displayed.
*/
- bool AddBook(const wxFileName& bookFile, bool showWaitMsg);
+ bool AddBook(const wxFileName& bookFile, bool showWaitMsg = false);
/**
Adds a book (i.e. a @ref overview_html_helpformats ".hhp file"; an HTML Help
@param showWaitMsg
If @true then a decoration-less window with progress message is displayed.
*/
- bool AddBook(const wxString& bookUrl, bool showWaitMsg);
+ bool AddBook(const wxString& bookUrl, bool showWaitMsg = false);
/**
Displays page @a x.
-# try to find x in index (if x is for example "How To ...")
-# switch to Search panel and start searching
*/
- void Display(const wxString& x);
+ bool Display(const wxString& x);
/**
@overload
This alternative form is used to search help contents by numeric IDs.
*/
- void Display(const int id);
+ bool Display(int id);
/**
Displays help window and focuses contents panel.
virtual void ReadCustomization(wxConfigBase* cfg,
const wxString& path = wxEmptyString);
+ /**
+ Sets whether the help frame should prevent application from exiting
+ if it's the only remaining top level window.
+
+ @enable
+ If @true, the application will not quit unless the help frame is
+ closed. Default is @false, i.e. the application does exit if only
+ the help window remains opened.
+
+ @see wxApp::SetExitOnFrameDelete()
+
+ @since 2.9.2
+ */
+ void SetShouldPreventAppExit(bool enable);
+
/**
Sets the path for storing temporary files - cached binary versions of index and
contents files.
@code
// The help can be browsed during the lifetime of this object; when the
// user quits the help, program execution will continue.
- wxHtmlModalHelp help(parent, wxT("help"), wxT("My topic"));
+ wxHtmlModalHelp help(parent, "help", "My topic");
@endcode
@library{wxhtml}