]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/common/bookctrl.cpp
wxAUI: Made fixed size floating panes work
[wxWidgets.git] / src / common / bookctrl.cpp
... / ...
CommitLineData
1///////////////////////////////////////////////////////////////////////////////
2// Name: src/common/bookctrl.cpp
3// Purpose: wxBookCtrlBase implementation
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 19.08.03
7// RCS-ID: $Id$
8// Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwindows.org>
9// Licence: wxWindows licence
10///////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
19
20// For compilers that support precompilation, includes "wx.h".
21#include "wx/wxprec.h"
22
23#ifdef __BORLANDC__
24 #pragma hdrstop
25#endif
26
27#if wxUSE_BOOKCTRL
28
29#include "wx/imaglist.h"
30
31#include "wx/bookctrl.h"
32
33// ============================================================================
34// implementation
35// ============================================================================
36
37// ----------------------------------------------------------------------------
38// event table
39// ----------------------------------------------------------------------------
40
41IMPLEMENT_ABSTRACT_CLASS(wxBookCtrlBase, wxControl)
42
43BEGIN_EVENT_TABLE(wxBookCtrlBase, wxControl)
44 EVT_SIZE(wxBookCtrlBase::OnSize)
45#if wxUSE_HELP
46 EVT_HELP(wxID_ANY, wxBookCtrlBase::OnHelp)
47#endif // wxUSE_HELP
48END_EVENT_TABLE()
49
50// ----------------------------------------------------------------------------
51// constructors and destructors
52// ----------------------------------------------------------------------------
53
54void wxBookCtrlBase::Init()
55{
56 m_bookctrl = NULL;
57 m_imageList = NULL;
58 m_ownsImageList = false;
59 m_fitToCurrentPage = false;
60
61#if defined(__WXWINCE__)
62 m_internalBorder = 1;
63#else
64 m_internalBorder = 5;
65#endif
66
67 m_controlMargin = 0;
68 m_controlSizer = NULL;
69}
70
71bool
72wxBookCtrlBase::Create(wxWindow *parent,
73 wxWindowID id,
74 const wxPoint& pos,
75 const wxSize& size,
76 long style,
77 const wxString& name)
78{
79 return wxControl::Create
80 (
81 parent,
82 id,
83 pos,
84 size,
85 style,
86 wxDefaultValidator,
87 name
88 );
89}
90
91wxBookCtrlBase::~wxBookCtrlBase()
92{
93 if ( m_ownsImageList )
94 {
95 // may be NULL, ok
96 delete m_imageList;
97 }
98}
99
100// ----------------------------------------------------------------------------
101// image list
102// ----------------------------------------------------------------------------
103
104void wxBookCtrlBase::SetImageList(wxImageList *imageList)
105{
106 if ( m_ownsImageList )
107 {
108 // may be NULL, ok
109 delete m_imageList;
110
111 m_ownsImageList = false;
112 }
113
114 m_imageList = imageList;
115}
116
117void wxBookCtrlBase::AssignImageList(wxImageList* imageList)
118{
119 SetImageList(imageList);
120
121 m_ownsImageList = true;
122}
123
124// ----------------------------------------------------------------------------
125// geometry
126// ----------------------------------------------------------------------------
127
128void wxBookCtrlBase::SetPageSize(const wxSize& size)
129{
130 SetClientSize(CalcSizeFromPage(size));
131}
132
133wxSize wxBookCtrlBase::DoGetBestSize() const
134{
135 wxSize bestSize;
136
137 // iterate over all pages, get the largest width and height
138 const size_t nCount = m_pages.size();
139 for ( size_t nPage = 0; nPage < nCount; nPage++ )
140 {
141 const wxWindow * const pPage = m_pages[nPage];
142 if( pPage )
143 {
144 wxSize childBestSize(pPage->GetBestSize());
145
146 if ( childBestSize.x > bestSize.x )
147 bestSize.x = childBestSize.x;
148
149 if ( childBestSize.y > bestSize.y )
150 bestSize.y = childBestSize.y;
151 }
152 }
153
154 if (m_fitToCurrentPage && GetCurrentPage())
155 bestSize = GetCurrentPage()->GetBestSize();
156
157 // convert display area to window area, adding the size necessary for the
158 // tabs
159 wxSize best = CalcSizeFromPage(bestSize);
160 CacheBestSize(best);
161 return best;
162}
163
164#if wxUSE_HELP
165
166void wxBookCtrlBase::OnHelp(wxHelpEvent& event)
167{
168 // determine where does this even originate from to avoid redirecting it
169 // back to the page which generated it (resulting in an infinite loop)
170
171 // notice that we have to check in the hard(er) way instead of just testing
172 // if the event object == this because the book control can have other
173 // subcontrols inside it (e.g. wxSpinButton in case of a notebook in wxUniv)
174 wxWindow *source = wxStaticCast(event.GetEventObject(), wxWindow);
175 while ( source && source != this && source->GetParent() != this )
176 {
177 source = source->GetParent();
178 }
179
180 if ( source && m_pages.Index(source) == wxNOT_FOUND )
181 {
182 // this event is for the book control itself, redirect it to the
183 // corresponding page
184 wxWindow *page = NULL;
185
186 if ( event.GetOrigin() == wxHelpEvent::Origin_HelpButton )
187 {
188 // show help for the page under the mouse
189 const int pagePos = HitTest(ScreenToClient(event.GetPosition()));
190
191 if ( pagePos != wxNOT_FOUND)
192 {
193 page = GetPage((size_t)pagePos);
194 }
195 }
196 else // event from keyboard or unknown source
197 {
198 // otherwise show the current page help
199 page = GetCurrentPage();
200 }
201
202 if ( page )
203 {
204 // change event object to the page to avoid infinite recursion if
205 // we get this event ourselves if the page doesn't handle it
206 event.SetEventObject(page);
207
208 if ( page->GetEventHandler()->ProcessEvent(event) )
209 {
210 // don't call event.Skip()
211 return;
212 }
213 }
214 }
215 //else: event coming from one of our pages already
216
217 event.Skip();
218}
219
220#endif // wxUSE_HELP
221
222// ----------------------------------------------------------------------------
223// pages management
224// ----------------------------------------------------------------------------
225
226bool
227wxBookCtrlBase::InsertPage(size_t nPage,
228 wxWindow *page,
229 const wxString& WXUNUSED(text),
230 bool WXUNUSED(bSelect),
231 int WXUNUSED(imageId))
232{
233 wxCHECK_MSG( page || AllowNullPage(), false,
234 _T("NULL page in wxBookCtrlBase::InsertPage()") );
235 wxCHECK_MSG( nPage <= m_pages.size(), false,
236 _T("invalid page index in wxBookCtrlBase::InsertPage()") );
237
238 m_pages.Insert(page, nPage);
239 if ( page )
240 page->SetSize(GetPageRect());
241
242 InvalidateBestSize();
243
244 return true;
245}
246
247bool wxBookCtrlBase::DeletePage(size_t nPage)
248{
249 wxWindow *page = DoRemovePage(nPage);
250 if ( !(page || AllowNullPage()) )
251 return false;
252
253 // delete NULL is harmless
254 delete page;
255
256 return true;
257}
258
259wxWindow *wxBookCtrlBase::DoRemovePage(size_t nPage)
260{
261 wxCHECK_MSG( nPage < m_pages.size(), NULL,
262 _T("invalid page index in wxBookCtrlBase::DoRemovePage()") );
263
264 wxWindow *pageRemoved = m_pages[nPage];
265 m_pages.RemoveAt(nPage);
266 InvalidateBestSize();
267
268 return pageRemoved;
269}
270
271int wxBookCtrlBase::GetNextPage(bool forward) const
272{
273 int nPage;
274
275 int nMax = GetPageCount();
276 if ( nMax-- ) // decrement it to get the last valid index
277 {
278 int nSel = GetSelection();
279
280 // change selection wrapping if it becomes invalid
281 nPage = forward ? nSel == nMax ? 0
282 : nSel + 1
283 : nSel == 0 ? nMax
284 : nSel - 1;
285 }
286 else // notebook is empty, no next page
287 {
288 nPage = wxNOT_FOUND;
289 }
290
291 return nPage;
292}
293
294wxRect wxBookCtrlBase::GetPageRect() const
295{
296 const wxSize size = GetControllerSize();
297
298 wxPoint pt;
299 wxRect rectPage(pt, GetClientSize());
300
301 switch ( GetWindowStyle() & wxBK_ALIGN_MASK )
302 {
303 default:
304 wxFAIL_MSG( _T("unexpected alignment") );
305 // fall through
306
307 case wxBK_TOP:
308 rectPage.y = size.y + GetInternalBorder();
309 // fall through
310
311 case wxBK_BOTTOM:
312 rectPage.height -= size.y + GetInternalBorder();
313 break;
314
315 case wxBK_LEFT:
316 rectPage.x = size.x + GetInternalBorder();
317 // fall through
318
319 case wxBK_RIGHT:
320 rectPage.width -= size.x + GetInternalBorder();
321 break;
322 }
323
324 return rectPage;
325}
326
327// Lay out controls
328void wxBookCtrlBase::DoSize()
329{
330 if ( !m_bookctrl )
331 {
332 // we're not fully created yet or OnSize() should be hidden by derived class
333 return;
334 }
335
336 if (GetSizer())
337 Layout();
338 else
339 {
340 // resize controller and the page area to fit inside our new size
341 const wxSize sizeClient( GetClientSize() ),
342 sizeBorder( m_bookctrl->GetSize() - m_bookctrl->GetClientSize() ),
343 sizeCtrl( GetControllerSize() );
344
345 m_bookctrl->SetClientSize( sizeCtrl.x - sizeBorder.x, sizeCtrl.y - sizeBorder.y );
346
347 const wxSize sizeNew = m_bookctrl->GetSize();
348 wxPoint posCtrl;
349 switch ( GetWindowStyle() & wxBK_ALIGN_MASK )
350 {
351 default:
352 wxFAIL_MSG( _T("unexpected alignment") );
353 // fall through
354
355 case wxBK_TOP:
356 case wxBK_LEFT:
357 // posCtrl is already ok
358 break;
359
360 case wxBK_BOTTOM:
361 posCtrl.y = sizeClient.y - sizeNew.y;
362 break;
363
364 case wxBK_RIGHT:
365 posCtrl.x = sizeClient.x - sizeNew.x;
366 break;
367 }
368
369 if ( m_bookctrl->GetPosition() != posCtrl )
370 m_bookctrl->Move(posCtrl);
371 }
372
373 // resize all pages to fit the new control size
374 const wxRect pageRect = GetPageRect();
375 const unsigned pagesCount = m_pages.Count();
376 for ( unsigned int i = 0; i < pagesCount; ++i )
377 {
378 wxWindow * const page = m_pages[i];
379 if ( !page )
380 {
381 wxASSERT_MSG( AllowNullPage(),
382 _T("Null page in a control that does not allow null pages?") );
383 continue;
384 }
385
386 page->SetSize(pageRect);
387 }
388}
389
390void wxBookCtrlBase::OnSize(wxSizeEvent& event)
391{
392 event.Skip();
393
394 DoSize();
395}
396
397wxSize wxBookCtrlBase::GetControllerSize() const
398{
399 if(!m_bookctrl)
400 return wxSize(0,0);
401
402 const wxSize sizeClient = GetClientSize(),
403 sizeBorder = m_bookctrl->GetSize() - m_bookctrl->GetClientSize(),
404 sizeCtrl = m_bookctrl->GetBestSize() + sizeBorder;
405
406 wxSize size;
407
408 if ( IsVertical() )
409 {
410 size.x = sizeClient.x;
411 size.y = sizeCtrl.y;
412 }
413 else // left/right aligned
414 {
415 size.x = sizeCtrl.x;
416 size.y = sizeClient.y;
417 }
418
419 return size;
420}
421
422#endif // wxUSE_BOOKCTRL