X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ae3c17b4013e80b99976c750c19fca47729517f6..c7d4ca810570664b68f7a4f0f11d2a5a64aa6163:/interface/wx/treebook.h diff --git a/interface/wx/treebook.h b/interface/wx/treebook.h index c950031b2d..77f75a9732 100644 --- a/interface/wx/treebook.h +++ b/interface/wx/treebook.h @@ -1,75 +1,13 @@ ///////////////////////////////////////////////////////////////////////////// // Name: treebook.h -// Purpose: interface of wxTreebookEvent +// Purpose: interface of wxTreebook // Author: wxWidgets team // RCS-ID: $Id$ // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// -/** - @class wxTreebookEvent - @wxheader{treebook.h} - - This class represents the events generated by a treebook control: currently, - there are four of them. The EVT_TREEBOOK_PAGE_CHANGING() and - EVT_TREEBOOK_PAGE_CHANGED() - have exactly the same behaviour as - wxNotebookEvent. - - The other two EVT_TREEBOOK_NODE_COLLAPSED() and EVT_TREEBOOK_NODE_EXPANDED() - are triggered when page node in the tree control is collapsed/expanded. The - page index could be retreived by calling GetSelection(). - - @beginEventTable{wxTreebookEvent} - @event{EVT_TREEBOOK_PAGE_CHANGED(id, func)} - The page selection was changed. Processes a @c - wxEVT_COMMAND_TREEBOOK_PAGE_CHANGED event. - @event{EVT_TREEBOOK_PAGE_CHANGING(id, func)} - The page selection is about to be changed. Processes a @c - wxEVT_COMMAND_TREEBOOK_PAGE_CHANGING event. This event can be @ref - wxNotifyEvent::Veto() "vetoed". - @event{EVT_TREEBOOK_NODE_COLLAPSED(id, func)} - The page node is going to be collapsed. Processes a @c - wxEVT_COMMAND_TREEBOOK_NODE_COLLAPSED event. - @event{EVT_TREEBOOK_NODE_EXPANDED(id, func)} - The page node is going to be expanded. Processes a @c - wxEVT_COMMAND_TREEBOOK_NODE_EXPANDED event. - @endEventTable - - @library{wxcore} - @category{events} - - @see wxTreebook, wxNotebookEvent -*/ -class wxTreebookEvent : public wxNotifyEvent -{ -public: - /** - @see wxNotebookEvent - */ - wxTreebookEvent(wxEventType commandType = wxEVT_NULL, int id = 0, - int nSel = wxNOT_FOUND, - int nOldSel = wxNOT_FOUND); - - /** - Returns the page that was selected before the change, @c wxNOT_FOUND if - none was selected. - */ - int GetOldSelection() const; - - /** - Returns the currently selected page, or @c wxNOT_FOUND if none was - selected. - - @see wxNotebookEvent::GetSelection() - */ - int GetSelection() const; -}; - - - /** @class wxTreebook - @wxheader{treebook.h} This class is an extension of the wxNotebook class that allows a tree structured set of pages to be shown in a control. A classic example is a @@ -83,7 +21,7 @@ public: AddPage() and AddSubPage() to sequentially populate your tree by adding at every step a page or a subpage to the end of the tree. - @beginEventTable{wxTreebookEvent} + @beginEventTable{wxBookCtrlEvent} @event{EVT_TREEBOOK_PAGE_CHANGED(id, func)} The page selection was changed. Processes a @c wxEVT_COMMAND_TREEBOOK_PAGE_CHANGED event. @@ -102,7 +40,7 @@ public: @library{wxcore} @category{miscwnd} - @see wxTreebookEvent, wxNotebook, wxTreeCtrl, wxImageList, + @see wxBookCtrl, wxBookCtrlEvent, wxNotebook, wxTreeCtrl, wxImageList, @ref overview_bookctrl, @ref page_samples_notebook */ class wxTreebook : public wxBookCtrlBase @@ -139,23 +77,21 @@ public: Destroys the wxTreebook object. Also deletes all the pages owned by the control (inserted previously into it). */ - ~wxTreebook(); + virtual ~wxTreebook(); /** Adds a new page. The page is placed at the topmost level after all other pages. @NULL could be specified for page to create an empty page. */ - bool AddPage(wxWindow* page, const wxString& text, - bool bSelect = false, - int imageId = wxNOT_FOUND); + virtual bool AddPage(wxWindow* page, const wxString& text, + bool bSelect = false, int imageId = wxNOT_FOUND); /** Adds a new child-page to the last top-level page. @NULL could be specified for page to create an empty page. */ - bool AddSubPage(wxWindow* page, const wxString& text, - bool bSelect = false, - int imageId = wxNOT_FOUND); + virtual bool AddSubPage(wxWindow* page, const wxString& text, + bool bSelect = false, int imageId = wxNOT_FOUND); /** Sets the image list for the page control and takes ownership of the @@ -163,7 +99,7 @@ public: @see wxImageList, SetImageList() */ - void AssignImageList(wxImageList* imageList); + virtual void AssignImageList(wxImageList* imageList); /** Changes the selection for the given page, returning the previous @@ -173,7 +109,7 @@ public: This is the only difference with SetSelection(). See @ref overview_eventhandling_prog for more info. */ - int ChangeSelection(size_t page); + virtual int ChangeSelection(size_t page); /** Shortcut for @ref wxTreebook::ExpandNode() "ExpandNode"( @a pageId, @@ -194,26 +130,26 @@ public: /** Deletes all pages inserted into the treebook. No event is generated. */ - bool DeleteAllPages(); + virtual bool DeleteAllPages(); /** Deletes the page at the specified position and all its children. Could trigger page selection change in a case when selected page is removed. In that case its parent is selected (or the next page if no parent). */ - bool DeletePage(size_t pagePos); + virtual bool DeletePage(size_t pagePos); /** Expands (collapses) the @a pageId node. Returns the previous state. May generate page changing events (if selected page is under the collapsed branch, then its parent is autoselected). */ - bool ExpandNode(size_t pageId, bool expand = true); + virtual bool ExpandNode(size_t pageId, bool expand = true); /** Returns the image index for the given page. */ - int GetPageImage(size_t n) const; + virtual int GetPageImage(size_t n) const; /** Returns the parent page of the given one or @c wxNOT_FOUND if this is a @@ -224,7 +160,7 @@ public: /** Returns the string for the given page. */ - wxString GetPageText(size_t n) const; + virtual wxString GetPageText(size_t n) const; /** Returns the currently selected page, or @c wxNOT_FOUND if none was @@ -232,35 +168,33 @@ public: @note This method may return either the previously or newly selected page when called from the EVT_TREEBOOK_PAGE_CHANGED() handler - depending on the platform and so wxTreebookEvent::GetSelection() + depending on the platform and so wxBookCtrlEvent::GetSelection() should be used instead in this case. */ - int GetSelection() const; + virtual int GetSelection() const; /** Inserts a new page just before the page indicated by @a pagePos. The new page is placed before @a pagePos page and on the same level. @NULL could be specified for page to create an empty page. */ - bool InsertPage(size_t pagePos, wxWindow* page, - const wxString& text, - bool bSelect = false, - int imageId = wxNOT_FOUND); + virtual bool InsertPage(size_t pagePos, wxWindow* page, + const wxString& text, bool bSelect = false, + int imageId = wxNOT_FOUND); /** Inserts a sub page under the specified page. @NULL could be specified for page to create an empty page. */ - bool InsertSubPage(size_t pagePos, wxWindow* page, - const wxString& text, - bool bSelect = false, - int imageId = wxNOT_FOUND); + virtual bool InsertSubPage(size_t pagePos, wxWindow* page, + const wxString& text, bool bSelect = false, + int imageId = wxNOT_FOUND); /** Returns @true if the page represented by @a pageId is expanded. */ - bool IsNodeExpanded(size_t pageId) const; + virtual bool IsNodeExpanded(size_t pageId) const; /** Sets the image list for the page control. It does not take ownership of @@ -268,18 +202,18 @@ public: @see wxImageList, AssignImageList() */ - void SetImageList(wxImageList* imageList); + virtual void SetImageList(wxImageList* imageList); /** Sets the image index for the given @a page. @a imageId is an index into the image list which was set with SetImageList(). */ - bool SetPageImage(size_t page, int imageId); + virtual bool SetPageImage(size_t page, int imageId); /** Sets the @a text for the given @a page. */ - bool SetPageText(size_t page, const wxString& text); + virtual bool SetPageText(size_t page, const wxString& text); /** @deprecated Please use ChangeSelection() instead. @@ -290,6 +224,6 @@ public: @see GetSelection(), ChangeSelection() */ - int SetSelection(size_t n); + virtual int SetSelection(size_t n); };