]> git.saurik.com Git - wxWidgets.git/blame - include/wx/msw/helpbest.h
fixed warnings about unneeded arguments
[wxWidgets.git] / include / wx / msw / helpbest.h
CommitLineData
3d285623
VS
1/////////////////////////////////////////////////////////////////////////////
2// Name: helpbest.h
3// Purpose: Tries to load MS HTML Help, falls back to wxHTML upon failure
4// Author: Mattia Barbon
5// Modified by:
6// Created: 02/04/2001
7// RCS-ID: $Id$
8// Copyright: (c) Mattia Barbon
3295e238 9// Licence: wxWindows licence
3d285623
VS
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_HELPBEST_H_
13#define _WX_HELPBEST_H_
14
12028905 15#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
3d285623
VS
16#pragma interface "helpbest.h"
17#endif
18
3d285623
VS
19#if wxUSE_HELP && wxUSE_MS_HTML_HELP && defined(__WIN95__) && wxUSE_WXHTML_HELP
20
21#include "wx/helpbase.h"
22
6acba9a7 23class WXDLLIMPEXP_HTML wxBestHelpController: public wxHelpControllerBase
3d285623 24{
3d285623 25public:
3295e238
VZ
26 wxBestHelpController()
27 : m_helpControllerType( wxUseNone ),
28 m_helpController( NULL )
29 {
30 }
31
32 virtual ~wxBestHelpController() { delete m_helpController; }
33
3d285623
VS
34 // Must call this to set the filename
35 virtual bool Initialize(const wxString& file);
0e4acbd4 36 virtual bool Initialize(const wxString& file, int WXUNUSED(server) ) { return Initialize( file ); }
3295e238 37
3d285623
VS
38 // If file is "", reloads file given in Initialize
39 virtual bool LoadFile(const wxString& file = wxEmptyString)
40 {
3d285623
VS
41 return m_helpController->LoadFile( GetValidFilename( file ) );
42 }
43
44 virtual bool DisplayContents()
45 {
3d285623
VS
46 return m_helpController->DisplayContents();
47 }
48
49 virtual bool DisplaySection(int sectionNo)
50 {
3d285623
VS
51 return m_helpController->DisplaySection( sectionNo );
52 }
53
54 virtual bool DisplaySection(const wxString& section)
55 {
3d285623
VS
56 return m_helpController->DisplaySection( section );
57 }
58
59 virtual bool DisplayBlock(long blockNo)
60 {
3d285623
VS
61 return m_helpController->DisplayBlock( blockNo );
62 }
63
64 virtual bool DisplayContextPopup(int contextId)
65 {
3d285623
VS
66 return m_helpController->DisplayContextPopup( contextId );
67 }
68
69 virtual bool DisplayTextPopup(const wxString& text, const wxPoint& pos)
70 {
3d285623
VS
71 return m_helpController->DisplayTextPopup( text, pos );
72 }
73
69b5cec2 74 virtual bool KeywordSearch(const wxString& k,
506c7b5b 75 wxHelpSearchMode mode = wxHELP_SEARCH_ALL)
3d285623 76 {
69b5cec2 77 return m_helpController->KeywordSearch( k, mode );
3d285623
VS
78 }
79
80 virtual bool Quit()
81 {
3d285623
VS
82 return m_helpController->Quit();
83 }
84
3295e238 85 // Allows one to override the default settings for the help frame.
3d285623 86 virtual void SetFrameParameters(const wxString& title,
3295e238
VZ
87 const wxSize& size,
88 const wxPoint& pos = wxDefaultPosition,
89 bool newFrameEachTime = FALSE)
3d285623 90 {
3d285623
VS
91 m_helpController->SetFrameParameters( title, size, pos,
92 newFrameEachTime );
93 }
94
3295e238 95 // Obtains the latest settings used by the help frame and the help frame.
3d285623 96 virtual wxFrame *GetFrameParameters(wxSize *size = NULL,
3295e238
VZ
97 wxPoint *pos = NULL,
98 bool *newFrameEachTime = NULL)
3d285623 99 {
3d285623
VS
100 return m_helpController->GetFrameParameters( size, pos,
101 newFrameEachTime );
102 }
103
104protected:
105 // Append/change extension if necessary.
106 wxString GetValidFilename(const wxString& file) const;
3295e238 107
3d285623
VS
108protected:
109 enum HelpControllerType { wxUseNone, wxUseHtmlHelp, wxUseChmHelp };
110
111 HelpControllerType m_helpControllerType;
112 wxHelpControllerBase* m_helpController;
3295e238
VZ
113
114 DECLARE_DYNAMIC_CLASS(wxBestHelpController)
22f3361e 115 DECLARE_NO_COPY_CLASS(wxBestHelpController)
3d285623
VS
116};
117
118#endif // wxUSE_HELP && wxUSE_MS_HTML_HELP && defined(__WIN95__) && wxUSE_WXHTML_HELP
119
120#endif
121 // _WX_HELPBEST_H_