X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/12f5e1e78fe906050ff2fee9529476db332633f0..9e9574fe45b176ee74bba8fad7574cf9906145d1:/interface/wx/html/helpwnd.h diff --git a/interface/wx/html/helpwnd.h b/interface/wx/html/helpwnd.h index 9cac6fb2bd..870f8ad313 100644 --- a/interface/wx/html/helpwnd.h +++ b/interface/wx/html/helpwnd.h @@ -2,111 +2,115 @@ // Name: html/helpwnd.h // Purpose: interface of wxHtmlHelpWindow // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// +/*! + * Command IDs + */ +enum +{ + //wxID_HTML_HELPFRAME = wxID_HIGHEST + 1, + wxID_HTML_PANEL = wxID_HIGHEST + 10, + wxID_HTML_BACK, + wxID_HTML_FORWARD, + wxID_HTML_UPNODE, + wxID_HTML_UP, + wxID_HTML_DOWN, + wxID_HTML_PRINT, + wxID_HTML_OPENFILE, + wxID_HTML_OPTIONS, + wxID_HTML_BOOKMARKSLIST, + wxID_HTML_BOOKMARKSADD, + wxID_HTML_BOOKMARKSREMOVE, + wxID_HTML_TREECTRL, + wxID_HTML_INDEXPAGE, + wxID_HTML_INDEXLIST, + wxID_HTML_INDEXTEXT, + wxID_HTML_INDEXBUTTON, + wxID_HTML_INDEXBUTTONALL, + wxID_HTML_NOTEBOOK, + wxID_HTML_SEARCHPAGE, + wxID_HTML_SEARCHTEXT, + wxID_HTML_SEARCHLIST, + wxID_HTML_SEARCHBUTTON, + wxID_HTML_SEARCHCHOICE, + wxID_HTML_COUNTINFO +}; + + /** @class wxHtmlHelpWindow - This class is used by wxHtmlHelpController - to display help within a frame or dialog, but you can use it yourself to create - an embedded HTML help window. + This class is used by wxHtmlHelpController to display help within a frame or + dialog, but you can use it yourself to create an embedded HTML help window. For example: - @code - // m_embeddedHelpWindow is a wxHtmlHelpWindow + // m_embeddedHelpWindow is a wxHtmlHelpWindow // m_embeddedHtmlHelp is a wxHtmlHelpController // Create embedded HTML Help window m_embeddedHelpWindow = new wxHtmlHelpWindow; - m_embeddedHtmlHelp.UseConfig(config, rootPath); // Set your own config - object here + m_embeddedHtmlHelp.UseConfig(config, rootPath); // Set your own config object here m_embeddedHtmlHelp.SetHelpWindow(m_embeddedHelpWindow); - m_embeddedHelpWindow-Create(this, - wxID_ANY, wxDefaultPosition, GetClientSize(), - wxTAB_TRAVERSAL|wxBORDER_NONE, wxHF_DEFAULT_STYLE); - m_embeddedHtmlHelp.AddBook(wxFileName(_T("doc.zip"))); + m_embeddedHelpWindow->Create(this, wxID_ANY, wxDefaultPosition, GetClientSize(), + wxTAB_TRAVERSAL|wxBORDER_NONE, wxHF_DEFAULT_STYLE); + m_embeddedHtmlHelp.AddBook(wxFileName(wxT("doc.zip"))); @endcode You should pass the style wxHF_EMBEDDED to the style parameter of - wxHtmlHelpController to allow - the embedded window to be destroyed independently of the help controller. + wxHtmlHelpController to allow the embedded window to be destroyed + independently of the help controller. @library{wxhtml} - @category{FIXME} + @category{help,html} */ class wxHtmlHelpWindow : public wxWindow { public: - //@{ + wxHtmlHelpWindow(wxHtmlHelpData* data = NULL); + /** Constructor. - Constructor. For the values of @e helpStyle, please see the documentation for + + For the values of @a helpStyle, please see the documentation for wxHtmlHelpController. */ - wxHtmlHelpWindow(wxHtmlHelpData* data = NULL); wxHtmlHelpWindow(wxWindow* parent, int wxWindowID, const wxPoint& pos = wxDefaultPosition, - const wxSize& pos = wxDefaultSize, + const wxSize& size = wxDefaultSize, int style = wxTAB_TRAVERSAL|wxBORDER_NONE, int helpStyle = wxHF_DEFAULT_STYLE, wxHtmlHelpData* data = NULL); - //@} /** - You may override this virtual method to add more buttons to the help window's - toolbar. @a toolBar is a pointer to the toolbar and @a style is the style - flag as passed to the Create method. - wxToolBar::Realize is called immediately after returning from this function. - See @e samples/html/helpview for an example. - */ - virtual void AddToolbarButtons(wxToolBar* toolBar, int style); - - /** - Creates the help window. See @ref wxhtmlhelpwindow() "the constructor" + Creates the help window. See @ref wxHtmlHelpWindow() "the constructor" for a description of the parameters. */ bool Create(wxWindow* parent, wxWindowID id, const wxPoint& pos = wxDefaultPosition, - const wxSize& pos = wxDefaultSize, - int style = wxTAB_TRAVERSAL|wxBORDER_NONE, - int helpStyle = wxHF_DEFAULT_STYLE, - wxHtmlHelpData* data = NULL); - - /** - Creates contents panel. (May take some time.) - Protected. - */ - void CreateContents(); + const wxSize& size = wxDefaultSize, int style = wxTAB_TRAVERSAL|wxBORDER_NONE, + int helpStyle = wxHF_DEFAULT_STYLE); /** - Creates index panel. (May take some time.) - Protected. + Displays page x. + If not found it will give the user the choice of searching books. + Looking for the page runs in these steps: + -# try to locate file named x (if x is for example "doc/howto.htm") + -# try to open starting page of book x + -# try to find x in contents (if x is for example "How To ...") + -# try to find x in index (if x is for example "How To ...") */ - void CreateIndex(); + bool Display(const wxString& x); /** - Creates search panel. - */ - void CreateSearch(); + @overload - //@{ - /** - Displays page x. If not found it will give the user the choice of - searching books. - Looking for the page runs in these steps: - try to locate file named x (if x is for example "doc/howto.htm") - try to open starting page of book x - try to find x in contents (if x is for example "How To ...") - try to find x in index (if x is for example "How To ...") - The second form takes numeric ID as the parameter. - (uses extension to MS format, param name="ID" value=id) + This form takes numeric ID as the parameter (uses an extension to MS format, + param name="ID" value=id). */ - bool Display(const wxString& x); bool Display(const int id); - //@} /** Displays contents panel. @@ -125,43 +129,69 @@ public: wxHtmlHelpData* GetData(); /** - Search for given keyword. Optionally it searches through the index (mode = - wxHELP_SEARCH_INDEX), default the content (mode = wxHELP_SEARCH_ALL). + Search for given keyword. Optionally it searches through the index + (mode = @c wxHELP_SEARCH_INDEX), default the content (mode = @c wxHELP_SEARCH_ALL). */ bool KeywordSearch(const wxString& keyword, wxHelpSearchMode mode = wxHELP_SEARCH_ALL); /** - Reads the user's settings for this window (see - wxHtmlHelpController::ReadCustomization) + Reads the user's settings for this window. + + @see wxHtmlHelpController::ReadCustomization */ void ReadCustomization(wxConfigBase* cfg, const wxString& path = wxEmptyString); + /** + Associates a wxConfig object with the help window. It is recommended that you + use wxHtmlHelpController::UseConfig instead. + */ + void UseConfig(wxConfigBase* config, + const wxString& rootpath = wxEmptyString); + + /** + Saves the user's settings for this window. + + @see wxHtmlHelpController::WriteCustomization + */ + void WriteCustomization(wxConfigBase* cfg, + const wxString& path = wxEmptyString); + /** Refresh all panels. This is necessary if a new book was added. - Protected. */ void RefreshLists(); + + wxHtmlHelpController* GetController() const; + void SetController(wxHtmlHelpController* controller); + +protected: + /** - Sets the frame's title format. @a format must contain exactly one "%s" - (it will be replaced by the page title). + Creates search panel. */ - void SetTitleFormat(const wxString& format); + void CreateSearch(); /** - Associates a wxConfig object with the help window. It is recommended that you - use wxHtmlHelpController::UseConfig instead. + You may override this virtual method to add more buttons to the help window's + toolbar. @a toolBar is a pointer to the toolbar and @a style is the style + flag as passed to the Create() method. + + wxToolBar::Realize is called immediately after returning from this function. + See @c samples/html/helpview for an example. */ - void UseConfig(wxConfigBase* config, - const wxString& rootpath = wxEmptyString); + virtual void AddToolbarButtons(wxToolBar* toolBar, int style); /** - Saves the user's settings for this window(see - wxHtmlHelpController::WriteCustomization). + Creates contents panel. (May take some time.) */ - void WriteCustomization(wxConfigBase* cfg, - const wxString& path = wxEmptyString); + void CreateContents(); + + /** + Creates index panel. (May take some time.) + */ + void CreateIndex(); };