X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4bf58c62d243e1d04aaa4e8b67e72289284b4200..bb84929ec5b27eae5433982703dd6d0df89bfc2d:/include/wx/gtk/notebook.h diff --git a/include/wx/gtk/notebook.h b/include/wx/gtk/notebook.h index eebf0ba9ec..4b297ddf32 100644 --- a/include/wx/gtk/notebook.h +++ b/include/wx/gtk/notebook.h @@ -1,21 +1,24 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: tabctrl.h -// Purpose: wxTabCtrl class +// Name: notebook.h +// Purpose: wxNotebook class // Author: Robert Roebling // Modified by: // RCS-ID: $Id$ -// Copyright: (c) Julian Smart and Markus Holzem -// Licence: wxWindows license +// Copyright: (c) Julian Smart and Robert Roebling +// Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// -#ifndef __TABCTRLH__ -#define __TABCTRLH__ +#ifndef __GTKNOTEBOOKH__ +#define __GTKNOTEBOOKH__ #ifdef __GNUG__ -#pragma interface "notebook.h" +#pragma interface #endif #include "wx/defs.h" + +#if wxUSE_NOTEBOOK + #include "wx/object.h" #include "wx/string.h" #include "wx/control.h" @@ -26,81 +29,145 @@ class wxImageList; class wxNotebook; -class wxNotebookPage; + +typedef wxWindow wxNotebookPage; // so far, any window can be a page //----------------------------------------------------------------------------- -// global data +// internal class //----------------------------------------------------------------------------- +class wxGtkNotebookPage; //----------------------------------------------------------------------------- // wxNotebook //----------------------------------------------------------------------------- -class wxNotebook: public wxControl +class wxNotebook : public wxControl { - DECLARE_DYNAMIC_CLASS(wxNotebook) +public: + // default for dynamic class + wxNotebook(); + // the same arguments as for wxControl + wxNotebook(wxWindow *parent, + wxWindowID id, + const wxPoint& pos = wxDefaultPosition, + const wxSize& size = wxDefaultSize, + long style = 0, + const wxString& name = "notebook"); + // Create() function + bool Create(wxWindow *parent, + wxWindowID id, + const wxPoint& pos = wxDefaultPosition, + const wxSize& size = wxDefaultSize, + long style = 0, + const wxString& name = "notebook"); + // dtor + ~wxNotebook(); + + // accessors + // --------- + // get number of pages in the dialog + int GetPageCount() const; + + // set the currently selected page, return the index of the previously + // selected one (or -1 on error) + // NB: this function will _not_ generate wxEVT_NOTEBOOK_PAGE_xxx events + int SetSelection(int nPage); + // cycle thru the tabs + void AdvanceSelection(bool bForward = TRUE); + // get the currently selected page + int GetSelection() const; + + // set/get the title of a page + bool SetPageText(int nPage, const wxString& strText); + wxString GetPageText(int nPage) const; + + // image list stuff: each page may have an image associated with it. All + // the images belong to an image list, so you have to + // 1) create an image list + // 2) associate it with the notebook + // 3) set for each page it's image + // associate image list with a control + void SetImageList(wxImageList* imageList); + void AssignImageList(wxImageList* imageList); + // get pointer (may be NULL) to the associated image list + wxImageList *GetImageList() const { return m_imageList; } + + // sets/returns item's image index in the current image list + int GetPageImage(int nPage) const; + bool SetPageImage(int nPage, int nImage); + + // currently it's always 1 because wxGTK doesn't support multi-row + // tab controls + int GetRowCount() const; + + // control the appearance of the notebook pages + // set the size (the same for all pages) + void SetPageSize(const wxSize& size); + // set the padding between tabs (in pixels) + void SetPadding(const wxSize& padding); + // sets the size of the tabs (assumes all tabs are the same size) + void SetTabSize(const wxSize& sz); + + // operations + // ---------- + // remove one page from the notebook but do not destroy it + bool RemovePage(int nPage); + // remove one page from the notebook + bool DeletePage(int nPage); + // remove all pages + bool DeleteAllPages(); - public: - - wxNotebook(void); - wxNotebook( wxWindow *parent, const wxWindowID id, - const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, - const long style = 0, const wxString& name = "notebook" ); - ~wxNotebook(void); - bool Create(wxWindow *parent, const wxWindowID id, - const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, - const long style = 0, const wxString& name = "notebook" ); - int GetSelection(void) const; - wxImageList* GetImageList(void) const; - int GetPageCount(void) const; - int GetRowCount(void) const; - wxString GetPageText( const int page ) const; - int GetPageImage( const int page ) const; - void* GetPageData( const int page ) const; - wxNotebookPage* GetNotebookPage(int page) const; - int SetSelection( const int page ); - void SetImageList( wxImageList* imageList ); - bool SetPageText( const int page, const wxString& text ); - bool SetPageImage( const int oage, const int image ); - bool SetPageData( const int page, void* data ); - void SetPageSize( const wxSize& size ); - void SetPadding( const wxSize& padding ); - bool DeleteAllPages(void); - bool DeletePage( const int page ); - bool AddPage(wxWindow* win, const wxString& text, const int imageId = -1, void* data = NULL ); - wxWindow *GetPageWindow( const int page ) const; - - // overriden to do nothing - virtual void AddChild( wxWindow *win ); - - protected: - - wxImageList* m_imageList; - wxList m_pages; + // adds a new page to the notebook (it will be deleted ny the notebook, + // don't delete it yourself). If bSelect, this page becomes active. + bool AddPage( wxNotebookPage *win, + const wxString& strText, + bool select = FALSE, + int imageId = -1 ); + // the same as AddPage(), but adds it at the specified position + bool InsertPage( int position, + wxNotebookPage *win, + const wxString& strText, + bool bSelect = FALSE, + int imageId = -1 ); + + // get the panel which represents the given page + wxNotebookPage *GetPage(int nPage) const; + + // handler for tab navigation + // -------------------------- + void OnNavigationKey(wxNavigationKeyEvent& event); + + // implementation + // -------------- + +#if wxUSE_CONSTRAINTS + void SetConstraintSizes(bool recurse); + bool DoPhase(int phase); +#endif - DECLARE_EVENT_TABLE() -}; + void ApplyWidgetStyle(); -//----------------------------------------------------------------------------- -// wxTabEvent -//----------------------------------------------------------------------------- + // report if window belongs to notebook + bool IsOwnGtkWindow( GdkWindow *window ); -class wxTabEvent: public wxCommandEvent -{ - DECLARE_DYNAMIC_CLASS(wxTabEvent) + // common part of all ctors + void Init(); - public: - - wxTabEvent( WXTYPE commandType = 0, int id = 0 ); -}; + // helper function + wxGtkNotebookPage* GetNotebookPage(int page) const; + + wxImageList* m_imageList; + bool m_ownsImageList; + wxList m_pages; + int m_lastSelection; /* hack */ -typedef void (wxEvtHandler::*wxTabEventFunction)(wxTabEvent&); +private: + DECLARE_DYNAMIC_CLASS(wxNotebook) + DECLARE_EVENT_TABLE() +}; -#define EVT_TAB_SEL_CHANGED(id, fn) { wxEVT_COMMAND_TAB_SEL_CHANGED, \ - id, -1, (wxObjectEventFunction) (wxEventFunction) (wxTabEventFunction) & fn, NULL }, -#define EVT_TAB_SEL_CHANGING(id, fn) { wxEVT_COMMAND_TAB_SEL_CHANGING, \ - id, -1, (wxObjectEventFunction) (wxEventFunction) (wxTabEventFunction) & fn, NULL }, +#endif #endif - // __TABCTRLH__ + // __GTKNOTEBOOKH__