Version: 3.1.0
wxExtHelpController Class Reference

#include <wx/generic/helpext.h>

+ Inheritance diagram for wxExtHelpController:

Detailed Description

This class implements help via an external browser.

It requires the name of a directory containing the documentation and a file mapping numerical Section numbers to relative URLS.

The map file contains two or three fields per line: numeric_id relative_URL [; comment/documentation]

The numeric_id is the id used to look up the entry in DisplaySection()/DisplayBlock(). The relative_URL is a filename of an html file, relative to the help directory. The optional comment/documentation field (after a ';') is used for keyword searches, so some meaningful text here does not hurt. If the documentation itself contains a ';', only the part before that will be displayed in the listbox, but all of it used for search.

Lines starting with ';' will be ignored.

Library:  wxAdvanced
Category:  Help
See Also
wxHelpController

Public Member Functions

 wxExtHelpController (wxWindow *parentWindow=NULL)
 
virtual ~wxExtHelpController ()
 
virtual void SetViewer (const wxString &viewer=wxEmptyString, long flags=wxHELP_NETSCAPE)
 Tell it which browser to use.
 
virtual bool Initialize (const wxString &dir)
 This must be called to tell the controller where to find the documentation.
 
virtual bool LoadFile (const wxString &file=wxEmptyString)
 If file is "", reloads file given in Initialize.
 
virtual bool DisplayContents ()
 Display list of all help entries.
 
virtual bool DisplaySection (int sectionNo)
 Display help for id sectionNo.
 
virtual bool DisplaySection (const wxString &section)
 Display help for id sectionNo – identical with DisplaySection().
 
virtual bool DisplayBlock (long blockNo)
 Display help for URL (using DisplayHelp) or keyword (using KeywordSearch)
 
virtual bool KeywordSearch (const wxString &k, wxHelpSearchMode mode=wxHELP_SEARCH_ALL)
 Search comment/documentation fields in map file and present a list to chose from.
 
virtual bool Quit ()
 Does nothing.
 
virtual void OnQuit ()
 Does nothing.
 
virtual bool DisplayHelp (const wxString &relativeURL)
 Call the browser using a relative URL.
 
virtual void SetFrameParameters (const wxString &titleFormat, const wxSize &size, const wxPoint &pos=wxDefaultPosition, bool newFrameEachTime=false)
 Allows one to override the default settings for the help frame.
 
virtual wxFrameGetFrameParameters (wxSize *size=NULL, wxPoint *pos=NULL, bool *newFrameEachTime=NULL)
 Obtains the latest settings used by the help frame and the help frame.
 
- Public Member Functions inherited from wxHelpControllerBase
 wxHelpControllerBase (wxWindow *parentWindow=NULL)
 Constructs a help instance object, but does not invoke the help viewer.
 
 ~wxHelpControllerBase ()
 Destroys the help instance, closing down the viewer if it is running.
 
virtual bool DisplayContextPopup (int contextId)
 Displays the section as a popup window using a context id.
 
virtual bool DisplayTextPopup (const wxString &text, const wxPoint &pos)
 Displays the text in a popup window, if possible.
 
virtual wxWindowGetParentWindow () const
 Returns the window to be used as the parent for the help window.
 
virtual void SetParentWindow (wxWindow *parentWindow)
 Sets the window to be used as the parent for the help window.
 
virtual bool Initialize (const wxString &file, int server)
 Initializes the help instance with a help filename, and optionally a server socket number if using wxHelp (now obsolete).
 
- Public Member Functions inherited from wxObject
 wxObject ()
 Default ctor; initializes to NULL the internal reference data.
 
 wxObject (const wxObject &other)
 Copy ctor.
 
virtual ~wxObject ()
 Destructor.
 
virtual wxClassInfoGetClassInfo () const
 This virtual function is redefined for every class that requires run-time type information, when using the wxDECLARE_CLASS macro (or similar).
 
wxObjectRefDataGetRefData () const
 Returns the wxObject::m_refData pointer, i.e. the data referenced by this object.
 
bool IsKindOf (const wxClassInfo *info) const
 Determines whether this class is a subclass of (or the same class as) the given class.
 
bool IsSameAs (const wxObject &obj) const
 Returns true if this object has the same data pointer as obj.
 
void Ref (const wxObject &clone)
 Makes this object refer to the data in clone.
 
void SetRefData (wxObjectRefData *data)
 Sets the wxObject::m_refData pointer.
 
void UnRef ()
 Decrements the reference count in the associated data, and if it is zero, deletes the data.
 
void UnShare ()
 This is the same of AllocExclusive() but this method is public.
 
void operator delete (void *buf)
 The delete operator is defined for debugging versions of the library only, when the identifier WXDEBUG is defined.
 
void * operator new (size_t size, const wxString &filename=NULL, int lineNum=0)
 The new operator is defined for debugging versions of the library only, when the identifier WXDEBUG is defined.
 

Additional Inherited Members

- Protected Member Functions inherited from wxObject
void AllocExclusive ()
 Ensure that this object's data is not shared with any other object.
 
virtual wxObjectRefDataCreateRefData () const
 Creates a new instance of the wxObjectRefData-derived class specific to this object and returns it.
 
virtual wxObjectRefDataCloneRefData (const wxObjectRefData *data) const
 Creates a new instance of the wxObjectRefData-derived class specific to this object and initializes it copying data.
 
- Protected Attributes inherited from wxObject
wxObjectRefDatam_refData
 Pointer to an object which is the object's reference-counted data.
 

Constructor & Destructor Documentation

wxExtHelpController::wxExtHelpController ( wxWindow parentWindow = NULL)
virtual wxExtHelpController::~wxExtHelpController ( )
virtual

Member Function Documentation

virtual bool wxExtHelpController::DisplayBlock ( long  blockNo)
virtual

Display help for URL (using DisplayHelp) or keyword (using KeywordSearch)

Returns
true on success

Implements wxHelpControllerBase.

virtual bool wxExtHelpController::DisplayContents ( )
virtual

Display list of all help entries.

Returns
true on success

Implements wxHelpControllerBase.

virtual bool wxExtHelpController::DisplayHelp ( const wxString relativeURL)
virtual

Call the browser using a relative URL.

virtual bool wxExtHelpController::DisplaySection ( int  sectionNo)
virtual

Display help for id sectionNo.

Returns
true on success

Implements wxHelpControllerBase.

virtual bool wxExtHelpController::DisplaySection ( const wxString section)
virtual

Display help for id sectionNo – identical with DisplaySection().

Returns
true on success

Reimplemented from wxHelpControllerBase.

virtual wxFrame* wxExtHelpController::GetFrameParameters ( wxSize size = NULL,
wxPoint pos = NULL,
bool *  newFrameEachTime = NULL 
)
virtual

Obtains the latest settings used by the help frame and the help frame.

Reimplemented from wxHelpControllerBase.

virtual bool wxExtHelpController::Initialize ( const wxString dir)
virtual

This must be called to tell the controller where to find the documentation.

If a locale is set, look in file/localename, i.e. If passed "/usr/local/myapp/help" and the current wxLocale is set to be "de", then look in "/usr/local/myapp/help/de/" first and fall back to "/usr/local/myapp/help" if that doesn't exist.

Parameters
dirdirectory name where to fine the help files
Returns
true on success

Reimplemented from wxHelpControllerBase.

virtual bool wxExtHelpController::KeywordSearch ( const wxString k,
wxHelpSearchMode  mode = wxHELP_SEARCH_ALL 
)
virtual

Search comment/documentation fields in map file and present a list to chose from.

Parameters
kstring to search for, empty string will list all entries
modeoptional parameter allows the search the index (wxHELP_SEARCH_INDEX) but this currently only supported by the wxHtmlHelpController.
Returns
true on success

Implements wxHelpControllerBase.

virtual bool wxExtHelpController::LoadFile ( const wxString file = wxEmptyString)
virtual

If file is "", reloads file given in Initialize.

Parameters
fileName of help directory.
Returns
true on success

Implements wxHelpControllerBase.

virtual void wxExtHelpController::OnQuit ( )
virtual

Does nothing.

Reimplemented from wxHelpControllerBase.

virtual bool wxExtHelpController::Quit ( )
virtual

Does nothing.

Implements wxHelpControllerBase.

virtual void wxExtHelpController::SetFrameParameters ( const wxString titleFormat,
const wxSize size,
const wxPoint pos = wxDefaultPosition,
bool  newFrameEachTime = false 
)
virtual

Allows one to override the default settings for the help frame.

Reimplemented from wxHelpControllerBase.

virtual void wxExtHelpController::SetViewer ( const wxString viewer = wxEmptyString,
long  flags = wxHELP_NETSCAPE 
)
virtual

Tell it which browser to use.

The Netscape support will check whether Netscape is already running (by looking at the .netscape/lock file in the user's home directory) and tell it to load the page into the existing window.

Parameters
viewerThe command to call a browser/html viewer.
flagsSet this to wxHELP_NETSCAPE if the browser is some variant of Netscape.

Reimplemented from wxHelpControllerBase.