]>
Commit | Line | Data |
---|---|---|
1e6feb95 VZ |
1 | /////////////////////////////////////////////////////////////////////////////// |
2 | // Name: wx/univ/notebook.h | |
3 | // Purpose: universal version of wxNotebook | |
4 | // Author: Vadim Zeitlin | |
5 | // Modified by: | |
6 | // Created: 01.02.01 | |
7 | // RCS-ID: $Id$ | |
442b35b5 | 8 | // Copyright: (c) 2001 SciTech Software, Inc. (www.scitechsoft.com) |
65571936 | 9 | // Licence: wxWindows licence |
1e6feb95 VZ |
10 | /////////////////////////////////////////////////////////////////////////////// |
11 | ||
12 | #ifndef _WX_UNIV_NOTEBOOK_H_ | |
13 | #define _WX_UNIV_NOTEBOOK_H_ | |
14 | ||
b5435dcc MB |
15 | #include "wx/arrstr.h" |
16 | ||
1e6feb95 VZ |
17 | class WXDLLEXPORT wxSpinButton; |
18 | ||
19 | // ---------------------------------------------------------------------------- | |
20 | // the actions supported by this control | |
21 | // ---------------------------------------------------------------------------- | |
22 | ||
23 | // change the page: to the next/previous/given one | |
24 | #define wxACTION_NOTEBOOK_NEXT _T("nexttab") | |
25 | #define wxACTION_NOTEBOOK_PREV _T("prevtab") | |
26 | #define wxACTION_NOTEBOOK_GOTO _T("gototab") | |
27 | ||
28 | // ---------------------------------------------------------------------------- | |
29 | // wxNotebook | |
30 | // ---------------------------------------------------------------------------- | |
31 | ||
32 | class WXDLLEXPORT wxNotebook : public wxNotebookBase | |
33 | { | |
34 | public: | |
35 | // ctors and such | |
36 | // -------------- | |
37 | ||
6463b9f5 | 38 | wxNotebook() { Init(); } |
1e6feb95 VZ |
39 | |
40 | wxNotebook(wxWindow *parent, | |
41 | wxWindowID id, | |
42 | const wxPoint& pos = wxDefaultPosition, | |
43 | const wxSize& size = wxDefaultSize, | |
44 | long style = 0, | |
630ad6c6 | 45 | const wxString& name = wxNotebookNameStr) |
6463b9f5 JS |
46 | { |
47 | Init(); | |
48 | ||
49 | (void)Create(parent, id, pos, size, style, name); | |
50 | } | |
1e6feb95 VZ |
51 | |
52 | // quasi ctor | |
53 | bool Create(wxWindow *parent, | |
54 | wxWindowID id, | |
55 | const wxPoint& pos = wxDefaultPosition, | |
56 | const wxSize& size = wxDefaultSize, | |
57 | long style = 0, | |
630ad6c6 | 58 | const wxString& name = wxNotebookNameStr); |
1e6feb95 VZ |
59 | |
60 | // dtor | |
61 | virtual ~wxNotebook(); | |
62 | ||
63 | // implement wxNotebookBase pure virtuals | |
64 | // -------------------------------------- | |
65 | ||
15aad3b9 | 66 | virtual int SetSelection(size_t nPage); |
58161def | 67 | virtual int GetSelection() const { return (int) m_sel; } |
1e6feb95 | 68 | |
15aad3b9 VZ |
69 | virtual bool SetPageText(size_t nPage, const wxString& strText); |
70 | virtual wxString GetPageText(size_t nPage) const; | |
1e6feb95 | 71 | |
15aad3b9 VZ |
72 | virtual int GetPageImage(size_t nPage) const; |
73 | virtual bool SetPageImage(size_t nPage, int nImage); | |
1e6feb95 VZ |
74 | |
75 | virtual void SetPageSize(const wxSize& size); | |
76 | virtual void SetPadding(const wxSize& padding); | |
77 | virtual void SetTabSize(const wxSize& sz); | |
78 | ||
2ce7af35 | 79 | virtual wxSize CalcSizeFromPage(const wxSize& sizePage) const; |
1e6feb95 VZ |
80 | |
81 | virtual bool DeleteAllPages(); | |
82 | ||
15aad3b9 | 83 | virtual bool InsertPage(size_t nPage, |
1e6feb95 VZ |
84 | wxNotebookPage *pPage, |
85 | const wxString& strText, | |
a290fa5a | 86 | bool bSelect = false, |
1e6feb95 VZ |
87 | int imageId = -1); |
88 | ||
89 | // style tests | |
90 | // ----------- | |
91 | ||
a290fa5a | 92 | // return true if all tabs have the same width |
d7787243 | 93 | bool FixedSizeTabs() const { return HasFlag(wxNB_FIXEDWIDTH); } |
1e6feb95 VZ |
94 | |
95 | // return wxTOP/wxBOTTOM/wxRIGHT/wxLEFT | |
96 | wxDirection GetTabOrientation() const; | |
97 | ||
a290fa5a | 98 | // return true if the notebook has tabs at the sidesand not at the top (or |
1e6feb95 VZ |
99 | // bottom) as usual |
100 | bool IsVertical() const; | |
101 | ||
102 | // hit testing | |
103 | // ----------- | |
104 | ||
e450aa69 | 105 | virtual int HitTest(const wxPoint& pt, long *flags = NULL) const; |
1e6feb95 VZ |
106 | |
107 | // input handling | |
108 | // -------------- | |
109 | ||
110 | virtual bool PerformAction(const wxControlAction& action, | |
111 | long numArg = 0l, | |
112 | const wxString& strArg = wxEmptyString); | |
113 | ||
114 | // refresh the currently selected tab | |
115 | void RefreshCurrent(); | |
116 | ||
117 | protected: | |
15aad3b9 | 118 | virtual wxNotebookPage *DoRemovePage(size_t nPage); |
1e6feb95 VZ |
119 | |
120 | // drawing | |
121 | virtual void DoDraw(wxControlRenderer *renderer); | |
122 | void DoDrawTab(wxDC& dc, const wxRect& rect, size_t n); | |
123 | ||
124 | // resizing | |
125 | virtual wxSize DoGetBestClientSize() const; | |
126 | virtual void DoMoveWindow(int x, int y, int width, int height); | |
127 | virtual void DoSetSize(int x, int y, | |
128 | int width, int height, | |
129 | int sizeFlags = wxSIZE_AUTO); | |
130 | ||
131 | // common part of all ctors | |
132 | void Init(); | |
133 | ||
134 | // resize the tab to fit its title (and icon if any) | |
135 | void ResizeTab(int page); | |
136 | ||
137 | // recalculate the geometry of the notebook completely | |
138 | void Relayout(); | |
139 | ||
140 | // is the spin button currently shown? | |
141 | bool HasSpinBtn() const; | |
142 | ||
143 | // calculate last (fully) visible tab: updates m_lastVisible | |
144 | void CalcLastVisibleTab(); | |
145 | ||
146 | // show or hide the spin control for tabs scrolling depending on whether it | |
147 | // is needed or not | |
148 | void UpdateSpinBtn(); | |
149 | ||
150 | // position the spin button | |
151 | void PositionSpinBtn(); | |
152 | ||
153 | // refresh the given tab only | |
a290fa5a | 154 | void RefreshTab(int page, bool forceSelected = false); |
1e6feb95 VZ |
155 | |
156 | // refresh all tabs | |
157 | void RefreshAllTabs(); | |
158 | ||
159 | // get the tab rect (inefficient, don't use this in a loop) | |
160 | wxRect GetTabRect(int page) const; | |
161 | ||
162 | // get the rectangle containing all tabs | |
163 | wxRect GetAllTabsRect() const; | |
164 | ||
165 | // get the part occupied by the tabs - slightly smaller than | |
166 | // GetAllTabsRect() because the tabs may be indented from it | |
167 | wxRect GetTabsPart() const; | |
168 | ||
169 | // calculate the tab size (without padding) | |
170 | wxSize CalcTabSize(int page) const; | |
171 | ||
172 | // get the (cached) size of a tab | |
173 | void GetTabSize(int page, wxCoord *w, wxCoord *h) const; | |
174 | ||
175 | // get the (cached) width of the tab | |
176 | wxCoord GetTabWidth(int page) const | |
177 | { return FixedSizeTabs() ? m_widthMax : m_widths[page]; } | |
178 | ||
a290fa5a | 179 | // return true if the tab has an associated image |
1e6feb95 VZ |
180 | bool HasImage(int page) const |
181 | { return m_imageList && m_images[page] != -1; } | |
182 | ||
183 | // get the part of the notebook reserved for the pages (slightly larger | |
184 | // than GetPageRect() as we draw a border and leave marginin between) | |
185 | wxRect GetPagePart() const; | |
186 | ||
187 | // get the page rect in our client coords | |
188 | wxRect GetPageRect() const; | |
189 | ||
190 | // get our client size from the page size | |
191 | wxSize GetSizeForPage(const wxSize& size) const; | |
192 | ||
1e6feb95 VZ |
193 | // scroll the tabs so that the first page shown becomes the given one |
194 | void ScrollTo(int page); | |
195 | ||
196 | // scroll the tabs so that the first page shown becomes the given one | |
197 | void ScrollLastTo(int page); | |
198 | ||
199 | // the pages titles | |
200 | wxArrayString m_titles; | |
201 | ||
202 | // the current selection | |
203 | size_t m_sel; | |
204 | ||
205 | // the spin button to change the pages | |
206 | wxSpinButton *m_spinbtn; | |
207 | ||
208 | // the offset of the first page shown (may be changed with m_spinbtn) | |
209 | wxCoord m_offset; | |
210 | ||
211 | // the first and last currently visible tabs: the name is not completely | |
212 | // accurate as m_lastVisible is, in fact, the first tab which is *not* | |
213 | // visible: so the visible tabs are those with indexes such that | |
214 | // m_firstVisible <= n < m_lastVisible | |
215 | size_t m_firstVisible, | |
216 | m_lastVisible; | |
217 | ||
218 | // the last fully visible item, usually just m_lastVisible - 1 but may be | |
219 | // different from it | |
220 | size_t m_lastFullyVisible; | |
221 | ||
222 | // the height of tabs in a normal notebook or the width of tabs in a | |
223 | // notebook with tabs on a side | |
224 | wxCoord m_heightTab; | |
225 | ||
226 | // the biggest height (or width) of a notebook tab (used only if | |
227 | // FixedSizeTabs()) or -1 if not calculated yet | |
228 | wxCoord m_widthMax; | |
229 | ||
230 | // the cached widths (or heights) of tabs | |
231 | wxArrayInt m_widths; | |
232 | ||
233 | // the icon indices | |
234 | wxArrayInt m_images; | |
235 | ||
236 | // the accel indexes for labels | |
237 | wxArrayInt m_accels; | |
238 | ||
239 | // the padding | |
240 | wxSize m_sizePad; | |
241 | ||
242 | DECLARE_DYNAMIC_CLASS(wxNotebook) | |
243 | }; | |
244 | ||
245 | // ---------------------------------------------------------------------------- | |
246 | // wxStdNotebookInputHandler: translates SPACE and ENTER keys and the left mouse | |
247 | // click into button press/release actions | |
248 | // ---------------------------------------------------------------------------- | |
249 | ||
250 | class WXDLLEXPORT wxStdNotebookInputHandler : public wxStdInputHandler | |
251 | { | |
252 | public: | |
253 | wxStdNotebookInputHandler(wxInputHandler *inphand); | |
254 | ||
23645bfa | 255 | virtual bool HandleKey(wxInputConsumer *consumer, |
1e6feb95 VZ |
256 | const wxKeyEvent& event, |
257 | bool pressed); | |
23645bfa | 258 | virtual bool HandleMouse(wxInputConsumer *consumer, |
1e6feb95 | 259 | const wxMouseEvent& event); |
23645bfa VS |
260 | virtual bool HandleMouseMove(wxInputConsumer *consumer, const wxMouseEvent& event); |
261 | virtual bool HandleFocus(wxInputConsumer *consumer, const wxFocusEvent& event); | |
262 | virtual bool HandleActivation(wxInputConsumer *consumer, bool activated); | |
1e6feb95 VZ |
263 | |
264 | protected: | |
23645bfa | 265 | void HandleFocusChange(wxInputConsumer *consumer); |
1e6feb95 VZ |
266 | }; |
267 | ||
268 | #endif // _WX_UNIV_NOTEBOOK_H_ | |
269 |