]> git.saurik.com Git - wxWidgets.git/blob - src/msw/notebook.cpp
Applied [ 745533 ] implemented wxNotebook::DoGetBestSize
[wxWidgets.git] / src / msw / notebook.cpp
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: msw/notebook.cpp
3 // Purpose: implementation of wxNotebook
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created: 11.06.98
7 // RCS-ID: $Id$
8 // Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
11
12 #ifdef __GNUG__
13 #pragma implementation "notebook.h"
14 #endif
15
16 // For compilers that support precompilation, includes "wx.h".
17 #include "wx/wxprec.h"
18
19 #ifdef __BORLANDC__
20 #pragma hdrstop
21 #endif
22
23 #if wxUSE_NOTEBOOK
24
25 // wxWindows
26 #ifndef WX_PRECOMP
27 #include "wx/string.h"
28 #endif // WX_PRECOMP
29
30 #include "wx/log.h"
31 #include "wx/imaglist.h"
32 #include "wx/event.h"
33 #include "wx/control.h"
34 #include "wx/notebook.h"
35
36 #include "wx/msw/private.h"
37
38 // Windows standard headers
39 #ifndef __WIN95__
40 #error "wxNotebook is only supported Windows 95 and above"
41 #endif //Win95
42
43 #include <windowsx.h> // for SetWindowFont
44
45 #ifdef __GNUWIN32_OLD__
46 #include "wx/msw/gnuwin32/extra.h"
47 #endif
48
49 #if defined(__WIN95__) && !(defined(__GNUWIN32_OLD__) && !defined(__CYGWIN10__))
50 #include <commctrl.h>
51 #endif
52
53 // ----------------------------------------------------------------------------
54 // macros
55 // ----------------------------------------------------------------------------
56
57 // check that the page index is valid
58 #define IS_VALID_PAGE(nPage) (((nPage) >= 0) && ((nPage) < GetPageCount()))
59
60 // hide the ugly cast
61 #define m_hwnd (HWND)GetHWND()
62
63 // ----------------------------------------------------------------------------
64 // constants
65 // ----------------------------------------------------------------------------
66
67 // This is a work-around for missing defines in gcc-2.95 headers
68 #ifndef TCS_RIGHT
69 #define TCS_RIGHT 0x0002
70 #endif
71
72 #ifndef TCS_VERTICAL
73 #define TCS_VERTICAL 0x0080
74 #endif
75
76 #ifndef TCS_BOTTOM
77 #define TCS_BOTTOM TCS_RIGHT
78 #endif
79
80 // ----------------------------------------------------------------------------
81 // event table
82 // ----------------------------------------------------------------------------
83
84 DEFINE_EVENT_TYPE(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED)
85 DEFINE_EVENT_TYPE(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING)
86
87 BEGIN_EVENT_TABLE(wxNotebook, wxControl)
88 EVT_NOTEBOOK_PAGE_CHANGED(-1, wxNotebook::OnSelChange)
89
90 EVT_SIZE(wxNotebook::OnSize)
91
92 EVT_SET_FOCUS(wxNotebook::OnSetFocus)
93
94 EVT_NAVIGATION_KEY(wxNotebook::OnNavigationKey)
95 END_EVENT_TABLE()
96
97 IMPLEMENT_DYNAMIC_CLASS(wxNotebook, wxControl)
98 IMPLEMENT_DYNAMIC_CLASS(wxNotebookEvent, wxNotifyEvent)
99
100 // ============================================================================
101 // implementation
102 // ============================================================================
103
104 // ----------------------------------------------------------------------------
105 // wxNotebook construction
106 // ----------------------------------------------------------------------------
107
108 // common part of all ctors
109 void wxNotebook::Init()
110 {
111 m_imageList = NULL;
112 m_nSelection = -1;
113 }
114
115 // default for dynamic class
116 wxNotebook::wxNotebook()
117 {
118 Init();
119 }
120
121 // the same arguments as for wxControl
122 wxNotebook::wxNotebook(wxWindow *parent,
123 wxWindowID id,
124 const wxPoint& pos,
125 const wxSize& size,
126 long style,
127 const wxString& name)
128 {
129 Init();
130
131 Create(parent, id, pos, size, style, name);
132 }
133
134 // Create() function
135 bool wxNotebook::Create(wxWindow *parent,
136 wxWindowID id,
137 const wxPoint& pos,
138 const wxSize& size,
139 long style,
140 const wxString& name)
141 {
142 // base init
143 if ( !CreateControl(parent, id, pos, size, style | wxTAB_TRAVERSAL,
144 wxDefaultValidator, name) )
145 return FALSE;
146
147 if ( !MSWCreateControl(WC_TABCONTROL, _T(""), pos, size) )
148 return FALSE;
149
150 SetBackgroundColour(wxColour(::GetSysColor(COLOR_BTNFACE)));
151
152 return TRUE;
153 }
154
155 WXDWORD wxNotebook::MSWGetStyle(long style, WXDWORD *exstyle) const
156 {
157 WXDWORD tabStyle = wxControl::MSWGetStyle(style, exstyle);
158
159 tabStyle |= WS_TABSTOP | TCS_TABS;
160
161 if ( style & wxNB_MULTILINE )
162 tabStyle |= TCS_MULTILINE;
163 if ( style & wxNB_FIXEDWIDTH )
164 tabStyle |= TCS_FIXEDWIDTH;
165
166 if ( style & wxNB_BOTTOM )
167 tabStyle |= TCS_RIGHT;
168 else if ( style & wxNB_LEFT )
169 tabStyle |= TCS_VERTICAL;
170 else if ( style & wxNB_RIGHT )
171 tabStyle |= TCS_VERTICAL | TCS_RIGHT;
172
173 // ex style
174 if ( exstyle )
175 {
176 // note that we never want to have the default WS_EX_CLIENTEDGE style
177 // as it looks too ugly for the notebooks
178 *exstyle = 0;
179 }
180
181 return tabStyle;
182 }
183
184 // ----------------------------------------------------------------------------
185 // wxNotebook accessors
186 // ----------------------------------------------------------------------------
187
188 int wxNotebook::GetPageCount() const
189 {
190 // consistency check
191 wxASSERT( (int)m_pages.Count() == TabCtrl_GetItemCount(m_hwnd) );
192
193 return m_pages.Count();
194 }
195
196 int wxNotebook::GetRowCount() const
197 {
198 return TabCtrl_GetRowCount(m_hwnd);
199 }
200
201 int wxNotebook::SetSelection(int nPage)
202 {
203 wxCHECK_MSG( IS_VALID_PAGE(nPage), -1, wxT("notebook page out of range") );
204
205 if ( nPage != m_nSelection )
206 {
207 wxNotebookEvent event(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING, m_windowId);
208 event.SetSelection(nPage);
209 event.SetOldSelection(m_nSelection);
210 event.SetEventObject(this);
211 if ( !GetEventHandler()->ProcessEvent(event) || event.IsAllowed() )
212 {
213 // program allows the page change
214 event.SetEventType(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED);
215 (void)GetEventHandler()->ProcessEvent(event);
216
217 TabCtrl_SetCurSel(m_hwnd, nPage);
218 }
219 }
220
221 return m_nSelection;
222 }
223
224 bool wxNotebook::SetPageText(int nPage, const wxString& strText)
225 {
226 wxCHECK_MSG( IS_VALID_PAGE(nPage), FALSE, wxT("notebook page out of range") );
227
228 TC_ITEM tcItem;
229 tcItem.mask = TCIF_TEXT;
230 tcItem.pszText = (wxChar *)strText.c_str();
231
232 return TabCtrl_SetItem(m_hwnd, nPage, &tcItem) != 0;
233 }
234
235 wxString wxNotebook::GetPageText(int nPage) const
236 {
237 wxCHECK_MSG( IS_VALID_PAGE(nPage), wxT(""), wxT("notebook page out of range") );
238
239 wxChar buf[256];
240 TC_ITEM tcItem;
241 tcItem.mask = TCIF_TEXT;
242 tcItem.pszText = buf;
243 tcItem.cchTextMax = WXSIZEOF(buf);
244
245 wxString str;
246 if ( TabCtrl_GetItem(m_hwnd, nPage, &tcItem) )
247 str = tcItem.pszText;
248
249 return str;
250 }
251
252 int wxNotebook::GetPageImage(int nPage) const
253 {
254 wxCHECK_MSG( IS_VALID_PAGE(nPage), -1, wxT("notebook page out of range") );
255
256 TC_ITEM tcItem;
257 tcItem.mask = TCIF_IMAGE;
258
259 return TabCtrl_GetItem(m_hwnd, nPage, &tcItem) ? tcItem.iImage : -1;
260 }
261
262 bool wxNotebook::SetPageImage(int nPage, int nImage)
263 {
264 wxCHECK_MSG( IS_VALID_PAGE(nPage), FALSE, wxT("notebook page out of range") );
265
266 TC_ITEM tcItem;
267 tcItem.mask = TCIF_IMAGE;
268 tcItem.iImage = nImage;
269
270 return TabCtrl_SetItem(m_hwnd, nPage, &tcItem) != 0;
271 }
272
273 void wxNotebook::SetImageList(wxImageList* imageList)
274 {
275 wxNotebookBase::SetImageList(imageList);
276
277 if ( imageList )
278 {
279 TabCtrl_SetImageList(m_hwnd, (HIMAGELIST)imageList->GetHIMAGELIST());
280 }
281 }
282
283 // ----------------------------------------------------------------------------
284 // wxNotebook size settings
285 // ----------------------------------------------------------------------------
286
287 void wxNotebook::SetPageSize(const wxSize& size)
288 {
289 // transform the page size into the notebook size
290 RECT rc;
291 rc.left =
292 rc.top = 0;
293 rc.right = size.x;
294 rc.bottom = size.y;
295
296 TabCtrl_AdjustRect(GetHwnd(), TRUE, &rc);
297
298 // and now set it
299 SetSize(rc.right - rc.left, rc.bottom - rc.top);
300 }
301
302 void wxNotebook::SetPadding(const wxSize& padding)
303 {
304 TabCtrl_SetPadding(GetHwnd(), padding.x, padding.y);
305 }
306
307 // Windows-only at present. Also, you must use the wxNB_FIXEDWIDTH
308 // style.
309 void wxNotebook::SetTabSize(const wxSize& sz)
310 {
311 ::SendMessage(GetHwnd(), TCM_SETITEMSIZE, 0, MAKELPARAM(sz.x, sz.y));
312 }
313
314 wxSize wxNotebook::CalcSizeFromPage(const wxSize& sizePage) const
315 {
316 wxSize sizeTotal = sizePage;
317
318 // We need to make getting tab size part of the wxWindows API.
319 wxSize tabSize(0, 0);
320 if (GetPageCount() > 0)
321 {
322 RECT rect;
323 TabCtrl_GetItemRect((HWND) GetHWND(), 0, & rect);
324 tabSize.x = rect.right - rect.left;
325 tabSize.y = rect.bottom - rect.top;
326 }
327 if ( HasFlag(wxNB_LEFT) || HasFlag(wxNB_RIGHT) )
328 {
329 sizeTotal.x += tabSize.x + 7;
330 sizeTotal.y += 7;
331 }
332 else
333 {
334 sizeTotal.x += 7;
335 sizeTotal.y += tabSize.y + 7;
336 }
337
338 return sizeTotal;
339 }
340
341 void wxNotebook::AdjustPageSize(wxNotebookPage *page)
342 {
343 wxCHECK_RET( page, _T("NULL page in wxNotebook::AdjustPageSize") );
344
345 RECT rc;
346 rc.left =
347 rc.top = 0;
348
349 // get the page size from the notebook size
350 GetSize((int *)&rc.right, (int *)&rc.bottom);
351 TabCtrl_AdjustRect(m_hwnd, FALSE, &rc);
352
353 page->SetSize(rc.left, rc.top, rc.right - rc.left, rc.bottom - rc.top);
354 }
355
356 // ----------------------------------------------------------------------------
357 // wxNotebook operations
358 // ----------------------------------------------------------------------------
359
360 // remove one page from the notebook, without deleting
361 wxNotebookPage *wxNotebook::DoRemovePage(int nPage)
362 {
363 wxNotebookPage *pageRemoved = wxNotebookBase::DoRemovePage(nPage);
364 if ( !pageRemoved )
365 return NULL;
366
367 TabCtrl_DeleteItem(m_hwnd, nPage);
368
369 if ( m_pages.IsEmpty() )
370 {
371 // no selection any more, the notebook becamse empty
372 m_nSelection = -1;
373 }
374 else // notebook still not empty
375 {
376 // change the selected page if it was deleted or became invalid
377 int selNew;
378 if ( m_nSelection == GetPageCount() )
379 {
380 // last page deleted, make the new last page the new selection
381 selNew = m_nSelection - 1;
382 }
383 else if ( nPage <= m_nSelection )
384 {
385 // we must show another page, even if it has the same index
386 selNew = m_nSelection;
387 }
388 else // nothing changes for the currently selected page
389 {
390 selNew = -1;
391
392 // we still must refresh the current page: this needs to be done
393 // for some unknown reason if the tab control shows the up-down
394 // control (i.e. when there are too many pages) -- otherwise after
395 // deleting a page nothing at all is shown
396 m_pages[m_nSelection]->Refresh();
397 }
398
399 if ( selNew != -1 )
400 {
401 // m_nSelection must be always valid so reset it before calling
402 // SetSelection()
403 m_nSelection = -1;
404 SetSelection(selNew);
405 }
406 }
407
408 return pageRemoved;
409 }
410
411 // remove all pages
412 bool wxNotebook::DeleteAllPages()
413 {
414 int nPageCount = GetPageCount();
415 int nPage;
416 for ( nPage = 0; nPage < nPageCount; nPage++ )
417 delete m_pages[nPage];
418
419 m_pages.Clear();
420
421 TabCtrl_DeleteAllItems(m_hwnd);
422
423 m_nSelection = -1;
424
425 return TRUE;
426 }
427
428 // same as AddPage() but does it at given position
429 bool wxNotebook::InsertPage(int nPage,
430 wxNotebookPage *pPage,
431 const wxString& strText,
432 bool bSelect,
433 int imageId)
434 {
435 wxCHECK_MSG( pPage != NULL, FALSE, _T("NULL page in wxNotebook::InsertPage") );
436 wxCHECK_MSG( IS_VALID_PAGE(nPage) || nPage == GetPageCount(), FALSE,
437 _T("invalid index in wxNotebook::InsertPage") );
438
439 wxASSERT_MSG( pPage->GetParent() == this,
440 _T("notebook pages must have notebook as parent") );
441
442 // add a new tab to the control
443 // ----------------------------
444
445 // init all fields to 0
446 TC_ITEM tcItem;
447 wxZeroMemory(tcItem);
448
449 // set the image, if any
450 if ( imageId != -1 )
451 {
452 tcItem.mask |= TCIF_IMAGE;
453 tcItem.iImage = imageId;
454 }
455
456 // and the text
457 if ( !strText.IsEmpty() )
458 {
459 tcItem.mask |= TCIF_TEXT;
460 tcItem.pszText = (wxChar *)strText.c_str(); // const_cast
461 }
462
463 // fit the notebook page to the tab control's display area: this should be
464 // done before adding it to the notebook or TabCtrl_InsertItem() will
465 // change the notebooks size itself!
466 AdjustPageSize(pPage);
467
468 // finally do insert it
469 if ( TabCtrl_InsertItem(m_hwnd, nPage, &tcItem) == -1 )
470 {
471 wxLogError(wxT("Can't create the notebook page '%s'."), strText.c_str());
472
473 return FALSE;
474 }
475
476 // succeeded: save the pointer to the page
477 m_pages.Insert(pPage, nPage);
478
479 // for the first page (only) we need to adjust the size again because the
480 // notebook size changed: the tabs which hadn't been there before are now
481 // shown
482 if ( m_pages.GetCount() == 1 )
483 {
484 AdjustPageSize(pPage);
485 }
486
487 // hide the page: unless it is selected, it shouldn't be shown (and if it
488 // is selected it will be shown later)
489 HWND hwnd = GetWinHwnd(pPage);
490 SetWindowLong(hwnd, GWL_STYLE, GetWindowLong(hwnd, GWL_STYLE) & ~WS_VISIBLE);
491
492 // this updates internal flag too -- otherwise it would get out of sync
493 // with the real state
494 pPage->Show(FALSE);
495
496
497 // now deal with the selection
498 // ---------------------------
499
500 // if the inserted page is before the selected one, we must update the
501 // index of the selected page
502 if ( nPage <= m_nSelection )
503 {
504 // one extra page added
505 m_nSelection++;
506 }
507
508 // some page should be selected: either this one or the first one if there
509 // is still no selection
510 int selNew = -1;
511 if ( bSelect )
512 selNew = nPage;
513 else if ( m_nSelection == -1 )
514 selNew = 0;
515
516 if ( selNew != -1 )
517 SetSelection(selNew);
518
519 return TRUE;
520 }
521
522 // ----------------------------------------------------------------------------
523 // wxNotebook callbacks
524 // ----------------------------------------------------------------------------
525
526 void wxNotebook::OnSize(wxSizeEvent& event)
527 {
528 // fit the notebook page to the tab control's display area
529 RECT rc;
530 rc.left = rc.top = 0;
531 GetSize((int *)&rc.right, (int *)&rc.bottom);
532
533 TabCtrl_AdjustRect(m_hwnd, FALSE, &rc);
534
535 int width = rc.right - rc.left,
536 height = rc.bottom - rc.top;
537 size_t nCount = m_pages.Count();
538 for ( size_t nPage = 0; nPage < nCount; nPage++ ) {
539 wxNotebookPage *pPage = m_pages[nPage];
540 pPage->SetSize(rc.left, rc.top, width, height);
541 }
542
543 event.Skip();
544 }
545
546 void wxNotebook::OnSelChange(wxNotebookEvent& event)
547 {
548 // is it our tab control?
549 if ( event.GetEventObject() == this )
550 {
551 int sel = event.GetOldSelection();
552 if ( sel != -1 )
553 m_pages[sel]->Show(FALSE);
554
555 sel = event.GetSelection();
556 if ( sel != -1 )
557 {
558 wxNotebookPage *pPage = m_pages[sel];
559 pPage->Show(TRUE);
560 pPage->SetFocus();
561 }
562
563 m_nSelection = sel;
564 }
565
566 // we want to give others a chance to process this message as well
567 event.Skip();
568 }
569
570 void wxNotebook::OnSetFocus(wxFocusEvent& event)
571 {
572 // this function is only called when the focus is explicitly set (i.e. from
573 // the program) to the notebook - in this case we don't need the
574 // complicated OnNavigationKey() logic because the programmer knows better
575 // what [s]he wants
576
577 // set focus to the currently selected page if any
578 if ( m_nSelection != -1 )
579 m_pages[m_nSelection]->SetFocus();
580
581 event.Skip();
582 }
583
584 void wxNotebook::OnNavigationKey(wxNavigationKeyEvent& event)
585 {
586 if ( event.IsWindowChange() ) {
587 // change pages
588 AdvanceSelection(event.GetDirection());
589 }
590 else {
591 // we get this event in 2 cases
592 //
593 // a) one of our pages might have generated it because the user TABbed
594 // out from it in which case we should propagate the event upwards and
595 // our parent will take care of setting the focus to prev/next sibling
596 //
597 // or
598 //
599 // b) the parent panel wants to give the focus to us so that we
600 // forward it to our selected page. We can't deal with this in
601 // OnSetFocus() because we don't know which direction the focus came
602 // from in this case and so can't choose between setting the focus to
603 // first or last panel child
604
605 wxWindow *parent = GetParent();
606 if ( event.GetEventObject() == parent )
607 {
608 // no, it doesn't come from child, case (b): forward to a page
609 if ( m_nSelection != -1 )
610 {
611 // so that the page knows that the event comes from it's parent
612 // and is being propagated downwards
613 event.SetEventObject(this);
614
615 wxWindow *page = m_pages[m_nSelection];
616 if ( !page->GetEventHandler()->ProcessEvent(event) )
617 {
618 page->SetFocus();
619 }
620 //else: page manages focus inside it itself
621 }
622 else
623 {
624 // we have no pages - still have to give focus to _something_
625 SetFocus();
626 }
627 }
628 else
629 {
630 // it comes from our child, case (a), pass to the parent
631 if ( parent ) {
632 event.SetCurrentFocus(this);
633 parent->GetEventHandler()->ProcessEvent(event);
634 }
635 }
636 }
637 }
638
639 // ----------------------------------------------------------------------------
640 // wxNotebook base class virtuals
641 // ----------------------------------------------------------------------------
642
643 #if wxUSE_CONSTRAINTS
644
645 // override these 2 functions to do nothing: everything is done in OnSize
646
647 void wxNotebook::SetConstraintSizes(bool WXUNUSED(recurse))
648 {
649 // don't set the sizes of the pages - their correct size is not yet known
650 wxControl::SetConstraintSizes(FALSE);
651 }
652
653 bool wxNotebook::DoPhase(int WXUNUSED(nPhase))
654 {
655 return TRUE;
656 }
657
658 #endif // wxUSE_CONSTRAINTS
659
660 // ----------------------------------------------------------------------------
661 // wxNotebook Windows message handlers
662 // ----------------------------------------------------------------------------
663
664 bool wxNotebook::MSWOnScroll(int orientation, WXWORD nSBCode,
665 WXWORD pos, WXHWND control)
666 {
667 // don't generate EVT_SCROLLWIN events for the WM_SCROLLs coming from the
668 // up-down control
669 if ( control )
670 return FALSE;
671
672 return wxNotebookBase::MSWOnScroll(orientation, nSBCode, pos, control);
673 }
674
675 bool wxNotebook::MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM* result)
676 {
677 wxNotebookEvent event(wxEVT_NULL, m_windowId);
678
679 NMHDR* hdr = (NMHDR *)lParam;
680 switch ( hdr->code ) {
681 case TCN_SELCHANGE:
682 event.SetEventType(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED);
683 break;
684
685 case TCN_SELCHANGING:
686 event.SetEventType(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING);
687 break;
688
689 default:
690 return wxControl::MSWOnNotify(idCtrl, lParam, result);
691 }
692
693 event.SetSelection(TabCtrl_GetCurSel(m_hwnd));
694 event.SetOldSelection(m_nSelection);
695 event.SetEventObject(this);
696 event.SetInt(idCtrl);
697
698 bool processed = GetEventHandler()->ProcessEvent(event);
699 *result = !event.IsAllowed();
700 return processed;
701 }
702
703 #endif // wxUSE_NOTEBOOK