]>
Commit | Line | Data |
---|---|---|
23324ae1 FM |
1 | ///////////////////////////////////////////////////////////////////////////// |
2 | // Name: html/helpdlg.h | |
e54c96f1 | 3 | // Purpose: interface of wxHtmlHelpDialog |
23324ae1 FM |
4 | // Author: wxWidgets team |
5 | // RCS-ID: $Id$ | |
6 | // Licence: wxWindows license | |
7 | ///////////////////////////////////////////////////////////////////////////// | |
8 | ||
9 | /** | |
10 | @class wxHtmlHelpDialog | |
7c913512 FM |
11 | |
12 | This class is used by wxHtmlHelpController | |
23324ae1 FM |
13 | to display help. |
14 | It is an internal class and should not be used directly - except for the case | |
15 | when you're writing your own HTML help controller. | |
7c913512 | 16 | |
23324ae1 FM |
17 | @library{wxhtml} |
18 | @category{FIXME} | |
19 | */ | |
20 | class wxHtmlHelpDialog : public wxFrame | |
21 | { | |
22 | public: | |
23 | //@{ | |
24 | /** | |
25 | Constructor. For the values of @e style, please see the documentation for | |
26 | wxHtmlHelpController. | |
27 | */ | |
4cc4bfaf | 28 | wxHtmlHelpDialog(wxHtmlHelpData* data = NULL); |
7c913512 FM |
29 | wxHtmlHelpDialog(wxWindow* parent, int wxWindowID, |
30 | const wxString& title = wxEmptyString, | |
31 | int style = wxHF_DEFAULT_STYLE, | |
4cc4bfaf | 32 | wxHtmlHelpData* data = NULL); |
23324ae1 FM |
33 | //@} |
34 | ||
35 | /** | |
36 | You may override this virtual method to add more buttons to the help window's | |
4cc4bfaf | 37 | toolbar. @a toolBar is a pointer to the toolbar and @a style is the style |
23324ae1 | 38 | flag as passed to the Create method. |
23324ae1 FM |
39 | wxToolBar::Realize is called immediately after returning from this function. |
40 | */ | |
4cc4bfaf | 41 | virtual void AddToolbarButtons(wxToolBar* toolBar, int style); |
23324ae1 FM |
42 | |
43 | /** | |
44 | Creates the dialog. See @ref wxhtmlhelpdialog() "the constructor" | |
45 | for a description of the parameters. | |
46 | */ | |
47 | bool Create(wxWindow* parent, wxWindowID id, | |
48 | const wxString& title = wxEmptyString, | |
49 | int style = wxHF_DEFAULT_STYLE); | |
50 | ||
51 | /** | |
52 | Returns the help controller associated with the dialog. | |
53 | */ | |
328f5751 | 54 | wxHtmlHelpController* GetController() const; |
23324ae1 FM |
55 | |
56 | /** | |
57 | Reads the user's settings for this dialog see | |
58 | wxHtmlHelpController::ReadCustomization) | |
59 | */ | |
60 | void ReadCustomization(wxConfigBase* cfg, | |
61 | const wxString& path = wxEmptyString); | |
62 | ||
63 | /** | |
64 | Sets the help controller associated with the dialog. | |
65 | */ | |
66 | void SetController(wxHtmlHelpController* contoller); | |
67 | ||
68 | /** | |
4cc4bfaf | 69 | Sets the dialog's title format. @a format must contain exactly one "%s" |
23324ae1 FM |
70 | (it will be replaced by the page title). |
71 | */ | |
72 | void SetTitleFormat(const wxString& format); | |
73 | ||
74 | /** | |
75 | Saves the user's settings for this dialog (see | |
76 | wxHtmlHelpController::WriteCustomization). | |
77 | */ | |
78 | void WriteCustomization(wxConfigBase* cfg, | |
79 | const wxString& path = wxEmptyString); | |
80 | }; | |
e54c96f1 | 81 |