X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1d156af3247c862e51a7c62f569a3fd302052a42..92c0fc34c104c8d7c12d6a3b78ea232690fc23f4:/interface/wx/bookctrl.h diff --git a/interface/wx/bookctrl.h b/interface/wx/bookctrl.h index 06092c4eaf..8545629faa 100644 --- a/interface/wx/bookctrl.h +++ b/interface/wx/bookctrl.h @@ -2,10 +2,45 @@ // Name: bookctrl.h // Purpose: interface of wxBookCtrlBase // Author: wxWidgets team -// RCS-ID: $Id$ // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// +/** + Bit flags returned by wxBookCtrl::HitTest(). + + Notice that wxOSX currently only returns wxBK_HITTEST_ONLABEL or + wxBK_HITTEST_NOWHERE and never the other values, so you should only test + for these two in the code that should be portable under OS X. + */ +enum +{ + /// No tab at the specified point. + wxBK_HITTEST_NOWHERE = 1, + + /// The point is over an icon. + wxBK_HITTEST_ONICON = 2, + + /// The point is over a tab label. + wxBK_HITTEST_ONLABEL = 4, + + /// The point if over a tab item but not over its icon or label. + wxBK_HITTEST_ONITEM = wxBK_HITTEST_ONICON | wxBK_HITTEST_ONLABEL, + + /// The point is over the page area. + wxBK_HITTEST_ONPAGE = 8 +}; + +/** + wxBookCtrl flags (common for wxNotebook, wxListbook, wxChoicebook, wxTreebook) +*/ +#define wxBK_DEFAULT 0x0000 +#define wxBK_TOP 0x0010 +#define wxBK_BOTTOM 0x0020 +#define wxBK_LEFT 0x0040 +#define wxBK_RIGHT 0x0080 +#define wxBK_ALIGN_MASK (wxBK_TOP | wxBK_BOTTOM | wxBK_LEFT | wxBK_RIGHT) + + /** @class wxBookCtrlBase @@ -27,7 +62,7 @@ @see @ref overview_bookctrl */ -class wxBookCtrlBase : public wxControl +class wxBookCtrlBase : public wxControl, public wxWithImages { public: enum @@ -71,33 +106,12 @@ public: */ //@{ - /** - Sets the image list for the page control and takes ownership of the list. - - @see wxImageList, SetImageList() - */ - void AssignImageList(wxImageList* imageList); - - /** - Returns the associated image list. - - @see wxImageList, SetImageList() - */ - wxImageList* GetImageList() const; /** Returns the image index for the given page. */ virtual int GetPageImage(size_t nPage) const = 0; - /** - Sets the image list for the page control. - It does not take ownership of the image list, you must delete it yourself. - - @see wxImageList, AssignImageList() - */ - virtual void SetImageList(wxImageList* imageList); - /** Sets the image index for the given page. @a image is an index into the image list which was set with SetImageList(). @@ -152,7 +166,7 @@ public: wxWindow* GetCurrentPage() const; /** - Sets the selection for the given page, returning the previous selection. + Sets the selection to the given page, returning the previous selection. Notice that the call to this function generates the page changing events, use the ChangeSelection() function if you don't want these @@ -169,7 +183,7 @@ public: void AdvanceSelection(bool forward = true); /** - Changes the selection for the given page, returning the previous selection. + Changes the selection to the given page, returning the previous selection. This function behaves as SetSelection() but does @em not generate the page changing events. @@ -178,6 +192,17 @@ public: */ virtual int ChangeSelection(size_t page) = 0; + /** + Returns the index of the specified tab window or @c wxNOT_FOUND + if not found. + + @param page One of the control pages. + @return The zero-based tab index or @c wxNOT_FOUND if not found. + + @since 2.9.5 + */ + int FindPage(const wxWindow* page) const; + //@} @@ -197,19 +222,10 @@ public: @param pt Specifies the point for the hit test. @param flags - Return value for detailed information. One of the following values: -
wxBK_HITTEST_NOWHERE | -There was no tab under this point. |
wxBK_HITTEST_ONICON | -The point was over an icon (currently wxMSW only). |
wxBK_HITTEST_ONLABEL | -The point was over a label (currently wxMSW only). |
wxBK_HITTEST_ONITEM | -The point was over an item, but not on the label or icon. |
wxBK_HITTEST_ONPAGE | -The point was over a currently selected page, not over any tab. - Note that this flag is present only if wxNOT_FOUND is returned. |