#pragma interface "helpbase.h"
#endif
-#include "wx/wx.h"
+#include "wx/defs.h"
+#include "wx/object.h"
+#include "wx/string.h"
+#include "wx/gdicmn.h"
+#include "wx/frame.h"
#if wxUSE_HELP
+// Flags for SetViewer
+#define wxHELP_NETSCAPE 1
+
// Defines the API for help controllers
class WXDLLEXPORT wxHelpControllerBase: public wxObject
{
DECLARE_CLASS(wxHelpControllerBase)
public:
- inline wxHelpControllerBase(void) {}
- inline ~wxHelpControllerBase(void) {};
+ inline wxHelpControllerBase() {}
+ inline ~wxHelpControllerBase() {};
// Must call this to set the filename and server name.
// server is only required when implementing TCP/IP-based
// help controllers.
- virtual bool Initialize(const wxString& WXUNUSED(file), int WXUNUSED(server) ) { return FALSE; };
- virtual bool Initialize(const wxString& file) = 0;
+ virtual bool Initialize(const wxString& WXUNUSED(file), int WXUNUSED(server) ) { return FALSE; }
+ virtual bool Initialize(const wxString& WXUNUSED(file)) { return FALSE; }
+
+ // Set viewer: only relevant to some kinds of controller
+ virtual void SetViewer(const wxString& WXUNUSED(viewer), long WXUNUSED(flags) = 0) {}
// If file is "", reloads file given in Initialize
virtual bool LoadFile(const wxString& file = "") = 0;
virtual bool DisplaySection(int sectionNo) = 0;
virtual bool DisplayBlock(long blockNo) = 0;
virtual bool KeywordSearch(const wxString& k) = 0;
+ /// Allows one to override the default settings for the help frame.
+ virtual void SetFrameParameters(const wxString& WXUNUSED(title),
+ const wxSize& WXUNUSED(size),
+ const wxPoint& WXUNUSED(pos) = wxDefaultPosition,
+ bool WXUNUSED(newFrameEachTime) = FALSE)
+ {
+ // does nothing by default
+ }
+ /// Obtains the latest settings used by the help frame and the help
+ /// frame.
+ virtual wxFrame *GetFrameParameters(wxSize *WXUNUSED(size) = NULL,
+ wxPoint *WXUNUSED(pos) = NULL,
+ bool *WXUNUSED(newFrameEachTime) = NULL)
+ {
+ return (wxFrame*) NULL;// does nothing by default
+ }
virtual bool Quit(void) = 0;
virtual void OnQuit(void) {};
};
+
+/* By default, if wxHTML is compiled in, use the
+ wxHelpControllerHtml. If not, use the external help controller.
+ (of course, we shouldn't do it for wxMSW)
+*/
+#ifndef __WXMSW__
+#if wxUSE_HTML
+# include "wx/generic/helpwxht.h"
+# define wxHelpController wxHelpControllerHtml
+# define sm_classwxHelpController sm_classwxHelpControllerHtml
+#else
+# include "wx/generic/helpext.h"
+# define wxHelpController wxExtHelpController
+# define sm_classwxHelpController sm_classwxExtHelpController
+#endif
+#endif // wxMSW
+
#endif // wxUSE_HELP
#endif
// _WX_HELPBASEH__