]>
Commit | Line | Data |
---|---|---|
53b28675 | 1 | ///////////////////////////////////////////////////////////////////////////// |
716b7364 RR |
2 | // Name: notebook.h |
3 | // Purpose: wxNotebook class | |
53b28675 RR |
4 | // Author: Robert Roebling |
5 | // Modified by: | |
6 | // RCS-ID: $Id$ | |
7 | // Copyright: (c) Julian Smart and Markus Holzem | |
ff829f3f | 8 | // Licence: wxWindows license |
53b28675 RR |
9 | ///////////////////////////////////////////////////////////////////////////// |
10 | ||
716b7364 RR |
11 | #ifndef __NOTEBOOKH__ |
12 | #define __NOTEBOOKH__ | |
53b28675 RR |
13 | |
14 | #ifdef __GNUG__ | |
15 | #pragma interface "notebook.h" | |
16 | #endif | |
17 | ||
18 | #include "wx/defs.h" | |
19 | #include "wx/object.h" | |
20 | #include "wx/string.h" | |
21 | #include "wx/control.h" | |
22 | ||
23 | //----------------------------------------------------------------------------- | |
24 | // classes | |
25 | //----------------------------------------------------------------------------- | |
26 | ||
27 | class wxImageList; | |
53b28675 | 28 | class wxNotebook; |
8aadf227 | 29 | class wxNotebookPage; |
53b28675 | 30 | |
ff829f3f VZ |
31 | // ---------------------------------------------------------------------------- |
32 | // notebook events | |
33 | // ---------------------------------------------------------------------------- | |
219f895a | 34 | |
ff829f3f VZ |
35 | class wxNotebookEvent : public wxCommandEvent |
36 | { | |
37 | public: | |
003a43dc | 38 | wxNotebookEvent(wxEventType commandType = wxEVT_NULL, int id = 0, |
ff829f3f VZ |
39 | int nSel = -1, int nOldSel = -1) |
40 | : wxCommandEvent(commandType, id) { m_nSel = nSel; m_nOldSel = nOldSel; } | |
53b28675 | 41 | |
ff829f3f VZ |
42 | // accessors |
43 | int GetSelection() const { return m_nSel; } | |
44 | int GetOldSelection() const { return m_nOldSel; } | |
53b28675 | 45 | |
ff829f3f VZ |
46 | private: |
47 | int m_nSel, // currently selected page | |
48 | m_nOldSel; // previously selected page | |
53b28675 | 49 | |
ff829f3f | 50 | DECLARE_DYNAMIC_CLASS(wxNotebookEvent) |
53b28675 RR |
51 | }; |
52 | ||
53 | //----------------------------------------------------------------------------- | |
ff829f3f | 54 | // wxNotebook |
53b28675 RR |
55 | //----------------------------------------------------------------------------- |
56 | ||
ff829f3f | 57 | class wxNotebook : public wxControl |
53b28675 | 58 | { |
ff829f3f VZ |
59 | public: |
60 | // ctors | |
61 | // ----- | |
62 | // default for dynamic class | |
63 | wxNotebook(); | |
64 | // the same arguments as for wxControl (@@@ any special styles?) | |
65 | wxNotebook(wxWindow *parent, | |
debe6624 | 66 | wxWindowID id, |
ff829f3f VZ |
67 | const wxPoint& pos = wxDefaultPosition, |
68 | const wxSize& size = wxDefaultSize, | |
debe6624 | 69 | long style = 0, |
ff829f3f VZ |
70 | const wxString& name = "notebook"); |
71 | // Create() function | |
72 | bool Create(wxWindow *parent, | |
debe6624 | 73 | wxWindowID id, |
ff829f3f VZ |
74 | const wxPoint& pos = wxDefaultPosition, |
75 | const wxSize& size = wxDefaultSize, | |
debe6624 | 76 | long style = 0, |
ff829f3f VZ |
77 | const wxString& name = "notebook"); |
78 | // dtor | |
79 | ~wxNotebook(); | |
80 | ||
81 | // accessors | |
82 | // --------- | |
83 | // get number of pages in the dialog | |
84 | int GetPageCount() const; | |
85 | ||
86 | // set the currently selected page, return the index of the previously | |
87 | // selected one (or -1 on error) | |
88 | // NB: this function will _not_ generate wxEVT_NOTEBOOK_PAGE_xxx events | |
89 | int SetSelection(int nPage); | |
90 | // cycle thru the tabs | |
91 | void AdvanceSelection(bool bForward = TRUE); | |
92 | // get the currently selected page | |
93 | int GetSelection() const; | |
94 | ||
95 | // set/get the title of a page | |
96 | bool SetPageText(int nPage, const wxString& strText); | |
97 | wxString GetPageText(int nPage) const; | |
98 | ||
99 | // image list stuff: each page may have an image associated with it. All | |
100 | // the images belong to an image list, so you have to | |
101 | // 1) create an image list | |
102 | // 2) associate it with the notebook | |
103 | // 3) set for each page it's image | |
104 | // associate image list with a control | |
105 | void SetImageList(wxImageList* imageList); | |
106 | // get pointer (may be NULL) to the associated image list | |
107 | wxImageList* GetImageList() const { return m_imageList; } | |
108 | ||
109 | // sets/returns item's image index in the current image list | |
110 | int GetPageImage(int nPage) const; | |
111 | bool SetPageImage(int nPage, int nImage); | |
112 | ||
113 | // currently it's always 1 because wxGTK doesn't support multi-row | |
114 | // tab controls | |
115 | int GetRowCount() const; | |
116 | ||
117 | // control the appearance of the notebook pages | |
118 | // set the size (the same for all pages) | |
119 | void SetPageSize(const wxSize& size); | |
120 | // set the padding between tabs (in pixels) | |
121 | void SetPadding(const wxSize& padding); | |
122 | ||
123 | // operations | |
124 | // ---------- | |
125 | // remove one page from the notebook | |
126 | bool DeletePage(int nPage); | |
127 | // remove all pages | |
128 | bool DeleteAllPages(); | |
129 | // adds a new page to the notebook (it will be deleted ny the notebook, | |
130 | // don't delete it yourself). If bSelect, this page becomes active. | |
131 | bool AddPage(wxWindow *pPage, | |
132 | const wxString& strText, | |
133 | bool bSelect = FALSE, | |
134 | int imageId = -1); | |
135 | // @@@@ VZ: I don't know how to implement InsertPage() | |
136 | ||
137 | // get the panel which represents the given page | |
138 | wxWindow *GetPage(int nPage) const; | |
139 | ||
5a8c929e VZ |
140 | // implementation |
141 | // -------------- | |
5a8c929e | 142 | // base class virtuals |
ff829f3f | 143 | virtual void AddChild(wxWindow *child); |
5a8c929e VZ |
144 | virtual void SetConstraintSizes(bool recurse); |
145 | virtual bool DoPhase(int phase); | |
a81258be RR |
146 | virtual void SetFont( const wxFont &font ); |
147 | virtual void SetBackgroundColour( const wxColour &colour ); | |
ff829f3f | 148 | |
ff829f3f VZ |
149 | private: |
150 | // common part of all ctors | |
151 | void Init(); | |
152 | ||
153 | // helper function | |
154 | wxNotebookPage* GetNotebookPage(int page) const; | |
155 | ||
156 | wxImageList* m_imageList; | |
157 | wxList m_pages; | |
c86f1403 | 158 | size_t m_idHandler; // the change page handler id |
53b28675 | 159 | |
ff829f3f | 160 | DECLARE_DYNAMIC_CLASS(wxNotebook) |
53b28675 RR |
161 | }; |
162 | ||
ff829f3f VZ |
163 | // ---------------------------------------------------------------------------- |
164 | // event macros | |
165 | // ---------------------------------------------------------------------------- | |
166 | typedef void (wxEvtHandler::*wxNotebookEventFunction)(wxNotebookEvent&); | |
167 | ||
168 | #define EVT_NOTEBOOK_PAGE_CHANGED(id, fn) \ | |
169 | { \ | |
170 | wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED, \ | |
171 | id, \ | |
172 | -1, \ | |
173 | (wxObjectEventFunction)(wxEventFunction)(wxNotebookEventFunction) &fn, \ | |
174 | NULL \ | |
175 | }, | |
176 | ||
177 | #define EVT_NOTEBOOK_PAGE_CHANGING(id, fn) \ | |
178 | { \ | |
7ce404dd | 179 | wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING, \ |
ff829f3f VZ |
180 | id, \ |
181 | -1, \ | |
182 | (wxObjectEventFunction)(wxEventFunction)(wxNotebookEventFunction) &fn, \ | |
183 | NULL \ | |
184 | }, | |
53b28675 RR |
185 | |
186 | #endif | |
716b7364 | 187 | // __NOTEBOOKH__ |