1 /////////////////////////////////////////////////////////////////////////////
4 // Author: Robert Roebling
6 // Copyright: (c) 1998 Robert Roebling, Vadim Zeitlin
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
10 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
11 #pragma implementation "notebook.h"
14 // For compilers that support precompilation, includes "wx.h".
15 #include "wx/wxprec.h"
17 #include "wx/notebook.h"
23 #include "wx/imaglist.h"
26 #include "wx/bitmap.h"
28 #include "wx/gtk/private.h"
29 #include "wx/gtk/win_gtk.h"
31 #include <gdk/gdkkeysyms.h>
33 // ----------------------------------------------------------------------------
35 // ----------------------------------------------------------------------------
37 DEFINE_EVENT_TYPE(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED
)
38 DEFINE_EVENT_TYPE(wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING
)
40 //-----------------------------------------------------------------------------
42 //-----------------------------------------------------------------------------
44 extern void wxapp_install_idle_handler();
47 //-----------------------------------------------------------------------------
49 //-----------------------------------------------------------------------------
51 extern bool g_blockEventsOnDrag
;
53 //-----------------------------------------------------------------------------
55 //-----------------------------------------------------------------------------
57 // VZ: this is rather ugly as we keep the pages themselves in an array (it
58 // allows us to have quite a few functions implemented in the base class)
59 // but the page data is kept in a separate list, so we must maintain them
60 // in sync manually... of course, the list had been there before the base
61 // class which explains it but it still would be nice to do something
64 class wxGtkNotebookPage
: public wxObject
70 m_page
= (GtkNotebookPage
*) NULL
;
71 m_box
= (GtkWidget
*) NULL
;
76 GtkNotebookPage
*m_page
;
78 GtkWidget
*m_box
; // in which the label and image are packed
81 #include "wx/listimpl.cpp"
82 WX_DEFINE_LIST(wxGtkNotebookPagesList
);
84 //-----------------------------------------------------------------------------
86 //-----------------------------------------------------------------------------
88 static void gtk_notebook_page_change_callback(GtkNotebook
*WXUNUSED(widget
),
89 GtkNotebookPage
*WXUNUSED(page
),
91 wxNotebook
*notebook
)
93 // are you trying to call SetSelection() from a notebook event handler?
95 wxCHECK_RET( !notebook
->m_inSwitchPage
,
96 _T("gtk_notebook_page_change_callback reentered") );
98 notebook
->m_inSwitchPage
= TRUE
;
100 wxapp_install_idle_handler();
102 int old
= notebook
->GetSelection();
104 wxNotebookEvent
eventChanging( wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGING
,
105 notebook
->GetId(), page
, old
);
106 eventChanging
.SetEventObject( notebook
);
108 if ( (notebook
->GetEventHandler()->ProcessEvent(eventChanging
)) &&
109 !eventChanging
.IsAllowed() )
111 /* program doesn't allow the page change */
112 gtk_signal_emit_stop_by_name( GTK_OBJECT(notebook
->m_widget
),
115 else // change allowed
117 // make wxNotebook::GetSelection() return the correct (i.e. consistent
118 // with wxNotebookEvent::GetSelection()) value even though the page is
119 // not really changed in GTK+
120 notebook
->m_selection
= page
;
122 wxNotebookEvent
eventChanged( wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED
,
123 notebook
->GetId(), page
, old
);
124 eventChanged
.SetEventObject( notebook
);
125 notebook
->GetEventHandler()->ProcessEvent( eventChanged
);
128 notebook
->m_inSwitchPage
= FALSE
;
131 //-----------------------------------------------------------------------------
133 //-----------------------------------------------------------------------------
135 static void gtk_page_size_callback( GtkWidget
*WXUNUSED(widget
), GtkAllocation
* alloc
, wxWindow
*win
)
138 wxapp_install_idle_handler();
140 if ((win
->m_x
== alloc
->x
) &&
141 (win
->m_y
== alloc
->y
) &&
142 (win
->m_width
== alloc
->width
) &&
143 (win
->m_height
== alloc
->height
))
148 win
->SetSize( alloc
->x
, alloc
->y
, alloc
->width
, alloc
->height
);
150 /* GTK 1.2 up to version 1.2.5 is broken so that we have to call allocate
151 here in order to make repositioning after resizing to take effect. */
152 if ((gtk_major_version
== 1) &&
153 (gtk_minor_version
== 2) &&
154 (gtk_micro_version
< 6) &&
156 (GTK_WIDGET_REALIZED(win
->m_wxwindow
)))
158 gtk_widget_size_allocate( win
->m_wxwindow
, alloc
);
162 //-----------------------------------------------------------------------------
163 // "realize" from m_widget
164 //-----------------------------------------------------------------------------
167 gtk_notebook_realized_callback( GtkWidget
* WXUNUSED(widget
), wxWindow
*win
)
170 wxapp_install_idle_handler();
172 /* GTK 1.2 up to version 1.2.5 is broken so that we have to call a queue_resize
173 here in order to make repositioning before showing to take effect. */
174 gtk_widget_queue_resize( win
->m_widget
);
179 //-----------------------------------------------------------------------------
181 //-----------------------------------------------------------------------------
183 static gint
gtk_notebook_key_press_callback( GtkWidget
*widget
, GdkEventKey
*gdk_event
, wxNotebook
*win
)
186 wxapp_install_idle_handler();
188 if (!win
->m_hasVMT
) return FALSE
;
189 if (g_blockEventsOnDrag
) return FALSE
;
191 /* win is a control: tab can be propagated up */
192 if ((gdk_event
->keyval
== GDK_Tab
) || (gdk_event
->keyval
== GDK_ISO_Left_Tab
))
194 int sel
= win
->GetSelection();
197 wxGtkNotebookPage
*nb_page
= win
->GetNotebookPage(sel
);
198 wxCHECK_MSG( nb_page
, FALSE
, _T("invalid selection in wxNotebook") );
200 wxNavigationKeyEvent event
;
201 event
.SetEventObject( win
);
202 /* GDK reports GDK_ISO_Left_Tab for SHIFT-TAB */
203 event
.SetDirection( (gdk_event
->keyval
== GDK_Tab
) );
204 /* CTRL-TAB changes the (parent) window, i.e. switch notebook page */
205 event
.SetWindowChange( (gdk_event
->state
& GDK_CONTROL_MASK
) );
206 event
.SetCurrentFocus( win
);
208 wxNotebookPage
*client
= win
->GetPage(sel
);
209 if ( !client
->GetEventHandler()->ProcessEvent( event
) )
214 gtk_signal_emit_stop_by_name( GTK_OBJECT(widget
), "key_press_event" );
221 //-----------------------------------------------------------------------------
222 // InsertChild callback for wxNotebook
223 //-----------------------------------------------------------------------------
225 static void wxInsertChildInNotebook( wxNotebook
* WXUNUSED(parent
), wxWindow
* WXUNUSED(child
) )
227 /* we don't do anything here but pray */
230 //-----------------------------------------------------------------------------
232 //-----------------------------------------------------------------------------
234 IMPLEMENT_DYNAMIC_CLASS(wxNotebook
,wxControl
)
236 BEGIN_EVENT_TABLE(wxNotebook
, wxControl
)
237 EVT_NAVIGATION_KEY(wxNotebook::OnNavigationKey
)
240 void wxNotebook::Init()
243 m_inSwitchPage
= FALSE
;
245 m_imageList
= (wxImageList
*) NULL
;
247 m_themeEnabled
= TRUE
;
250 wxNotebook::wxNotebook()
255 wxNotebook::wxNotebook( wxWindow
*parent
, wxWindowID id
,
256 const wxPoint
& pos
, const wxSize
& size
,
257 long style
, const wxString
& name
)
260 Create( parent
, id
, pos
, size
, style
, name
);
263 wxNotebook::~wxNotebook()
268 bool wxNotebook::Create(wxWindow
*parent
, wxWindowID id
,
269 const wxPoint
& pos
, const wxSize
& size
,
270 long style
, const wxString
& name
)
273 m_acceptsFocus
= TRUE
;
274 m_insertCallback
= (wxInsertChildFunction
)wxInsertChildInNotebook
;
276 if (!PreCreation( parent
, pos
, size
) ||
277 !CreateBase( parent
, id
, pos
, size
, style
, wxDefaultValidator
, name
))
279 wxFAIL_MSG( wxT("wxNoteBook creation failed") );
284 m_widget
= gtk_notebook_new();
286 gtk_notebook_set_scrollable( GTK_NOTEBOOK(m_widget
), 1 );
288 gtk_signal_connect( GTK_OBJECT(m_widget
), "switch_page",
289 GTK_SIGNAL_FUNC(gtk_notebook_page_change_callback
), (gpointer
)this );
291 m_parent
->DoAddChild( this );
293 if (m_windowStyle
& wxNB_RIGHT
)
294 gtk_notebook_set_tab_pos( GTK_NOTEBOOK(m_widget
), GTK_POS_RIGHT
);
295 if (m_windowStyle
& wxNB_LEFT
)
296 gtk_notebook_set_tab_pos( GTK_NOTEBOOK(m_widget
), GTK_POS_LEFT
);
297 if (m_windowStyle
& wxNB_BOTTOM
)
298 gtk_notebook_set_tab_pos( GTK_NOTEBOOK(m_widget
), GTK_POS_BOTTOM
);
300 gtk_signal_connect( GTK_OBJECT(m_widget
), "key_press_event",
301 GTK_SIGNAL_FUNC(gtk_notebook_key_press_callback
), (gpointer
)this );
305 SetFont( parent
->GetFont() );
307 gtk_signal_connect( GTK_OBJECT(m_widget
), "realize",
308 GTK_SIGNAL_FUNC(gtk_notebook_realized_callback
), (gpointer
) this );
315 int wxNotebook::GetSelection() const
317 wxCHECK_MSG( m_widget
!= NULL
, -1, wxT("invalid notebook") );
319 if ( m_selection
== -1 )
321 GList
*nb_pages
= GTK_NOTEBOOK(m_widget
)->children
;
323 if (g_list_length(nb_pages
) != 0)
325 GtkNotebook
*notebook
= GTK_NOTEBOOK(m_widget
);
327 gpointer cur
= notebook
->cur_page
;
330 wxConstCast(this, wxNotebook
)->m_selection
=
331 g_list_index( nb_pages
, cur
);
339 wxString
wxNotebook::GetPageText( size_t page
) const
341 wxCHECK_MSG( m_widget
!= NULL
, wxT(""), wxT("invalid notebook") );
343 wxGtkNotebookPage
* nb_page
= GetNotebookPage(page
);
345 return nb_page
->m_text
;
350 int wxNotebook::GetPageImage( size_t page
) const
352 wxCHECK_MSG( m_widget
!= NULL
, -1, wxT("invalid notebook") );
354 wxGtkNotebookPage
* nb_page
= GetNotebookPage(page
);
356 return nb_page
->m_image
;
361 wxGtkNotebookPage
* wxNotebook::GetNotebookPage( int page
) const
363 wxCHECK_MSG( m_widget
!= NULL
, (wxGtkNotebookPage
*) NULL
, wxT("invalid notebook") );
365 wxCHECK_MSG( page
< (int)m_pagesData
.GetCount(), (wxGtkNotebookPage
*) NULL
, wxT("invalid notebook index") );
367 return m_pagesData
.Item(page
)->GetData();
370 int wxNotebook::SetSelection( size_t page
)
372 wxCHECK_MSG( m_widget
!= NULL
, -1, wxT("invalid notebook") );
374 wxCHECK_MSG( page
< m_pagesData
.GetCount(), -1, wxT("invalid notebook index") );
376 int selOld
= GetSelection();
378 // cache the selection
380 gtk_notebook_set_page( GTK_NOTEBOOK(m_widget
), page
);
382 wxNotebookPage
*client
= GetPage(page
);
389 bool wxNotebook::SetPageText( size_t page
, const wxString
&text
)
391 wxCHECK_MSG( m_widget
!= NULL
, FALSE
, wxT("invalid notebook") );
393 wxGtkNotebookPage
* nb_page
= GetNotebookPage(page
);
395 wxCHECK_MSG( nb_page
, FALSE
, wxT("SetPageText: invalid page index") );
397 nb_page
->m_text
= text
;
399 gtk_label_set( nb_page
->m_label
, wxGTK_CONV( nb_page
->m_text
) );
404 bool wxNotebook::SetPageImage( size_t page
, int image
)
406 /* HvdH 28-12-98: now it works, but it's a bit of a kludge */
408 wxGtkNotebookPage
* nb_page
= GetNotebookPage(page
);
410 if (!nb_page
) return FALSE
;
412 /* Optimization posibility: return immediately if image unchanged.
413 * Not enabled because it may break existing (stupid) code that
414 * manipulates the imagelist to cycle images */
416 /* if (image == nb_page->m_image) return TRUE; */
418 /* For different cases:
419 1) no image -> no image
424 if (image
== -1 && nb_page
->m_image
== -1)
425 return TRUE
; /* Case 1): Nothing to do. */
427 GtkWidget
*pixmapwid
= (GtkWidget
*) NULL
;
429 if (nb_page
->m_image
!= -1)
431 /* Case 2) or 4). There is already an image in the gtkhbox. Let's find it */
433 GList
*child
= gtk_container_children(GTK_CONTAINER(nb_page
->m_box
));
436 if (GTK_IS_PIXMAP(child
->data
))
438 pixmapwid
= GTK_WIDGET(child
->data
);
444 /* We should have the pixmap widget now */
445 wxASSERT(pixmapwid
!= NULL
);
449 /* If there's no new widget, just remove the old from the box */
450 gtk_container_remove(GTK_CONTAINER(nb_page
->m_box
), pixmapwid
);
451 nb_page
->m_image
= -1;
453 return TRUE
; /* Case 2) */
457 /* Only cases 3) and 4) left */
458 wxASSERT( m_imageList
!= NULL
); /* Just in case */
460 /* Construct the new pixmap */
461 const wxBitmap
*bmp
= m_imageList
->GetBitmap(image
);
462 GdkPixmap
*pixmap
= bmp
->GetPixmap();
463 GdkBitmap
*mask
= (GdkBitmap
*) NULL
;
464 if ( bmp
->GetMask() )
466 mask
= bmp
->GetMask()->GetBitmap();
469 if (pixmapwid
== NULL
)
471 /* Case 3) No old pixmap. Create a new one and prepend it to the hbox */
472 pixmapwid
= gtk_pixmap_new (pixmap
, mask
);
474 /* CHECKME: Are these pack flags okay? */
475 gtk_box_pack_start(GTK_BOX(nb_page
->m_box
), pixmapwid
, FALSE
, FALSE
, m_padding
);
476 gtk_widget_show(pixmapwid
);
480 /* Case 4) Simply replace the pixmap */
481 gtk_pixmap_set(GTK_PIXMAP(pixmapwid
), pixmap
, mask
);
484 nb_page
->m_image
= image
;
489 void wxNotebook::SetPageSize( const wxSize
&WXUNUSED(size
) )
491 wxFAIL_MSG( wxT("wxNotebook::SetPageSize not implemented") );
494 void wxNotebook::SetPadding( const wxSize
&padding
)
496 wxCHECK_RET( m_widget
!= NULL
, wxT("invalid notebook") );
498 m_padding
= padding
.GetWidth();
501 for (i
=0; i
<int(GetPageCount()); i
++)
503 wxGtkNotebookPage
* nb_page
= GetNotebookPage(i
);
504 wxASSERT(nb_page
!= NULL
);
506 if (nb_page
->m_image
!= -1)
508 // gtk_box_set_child_packing sets padding on BOTH sides
509 // icon provides left padding, label provides center and right
510 int image
= nb_page
->m_image
;
512 SetPageImage(i
,image
);
514 wxASSERT(nb_page
->m_label
);
515 gtk_box_set_child_packing(GTK_BOX(nb_page
->m_box
),
516 GTK_WIDGET(nb_page
->m_label
),
517 FALSE
, FALSE
, m_padding
, GTK_PACK_END
);
521 void wxNotebook::SetTabSize(const wxSize
& WXUNUSED(sz
))
523 wxFAIL_MSG( wxT("wxNotebook::SetTabSize not implemented") );
526 bool wxNotebook::DeleteAllPages()
528 wxCHECK_MSG( m_widget
!= NULL
, FALSE
, wxT("invalid notebook") );
530 while (m_pagesData
.GetCount() > 0)
531 DeletePage( m_pagesData
.GetCount()-1 );
533 wxASSERT_MSG( GetPageCount() == 0, _T("all pages must have been deleted") );
535 return wxNotebookBase::DeleteAllPages();
538 bool wxNotebook::DeletePage( size_t page
)
540 if ( m_selection
== (int)m_pagesData
.GetCount() - 1 )
542 // the index will become invalid after the page is deleted
546 // it will call our DoRemovePage() to do the real work
547 return wxNotebookBase::DeletePage(page
);
550 wxNotebookPage
*wxNotebook::DoRemovePage( size_t page
)
552 wxNotebookPage
*client
= wxNotebookBase::DoRemovePage(page
);
556 gtk_widget_ref( client
->m_widget
);
557 gtk_widget_unrealize( client
->m_widget
);
558 gtk_widget_unparent( client
->m_widget
);
560 // gtk_notebook_remove_page() sends "switch_page" signal with some strange
561 // new page index (when deleting selected page 0, new page is 1 although,
562 // clearly, the selection should stay 0), so suppress this
563 gtk_signal_disconnect_by_func( GTK_OBJECT(m_widget
),
564 GTK_SIGNAL_FUNC(gtk_notebook_page_change_callback
), (gpointer
) this );
566 gtk_notebook_remove_page( GTK_NOTEBOOK(m_widget
), page
);
568 gtk_signal_connect( GTK_OBJECT(m_widget
), "switch_page",
569 GTK_SIGNAL_FUNC(gtk_notebook_page_change_callback
), (gpointer
)this );
571 wxGtkNotebookPage
* p
= GetNotebookPage(page
);
572 m_pagesData
.DeleteObject(p
);
578 bool wxNotebook::InsertPage( size_t position
,
580 const wxString
& text
,
584 wxCHECK_MSG( m_widget
!= NULL
, FALSE
, wxT("invalid notebook") );
586 wxCHECK_MSG( win
->GetParent() == this, FALSE
,
587 wxT("Can't add a page whose parent is not the notebook!") );
589 wxCHECK_MSG( position
<= GetPageCount(), FALSE
,
590 _T("invalid page index in wxNotebookPage::InsertPage()") );
592 /* don't receive switch page during addition */
593 gtk_signal_disconnect_by_func( GTK_OBJECT(m_widget
),
594 GTK_SIGNAL_FUNC(gtk_notebook_page_change_callback
), (gpointer
) this );
597 win
->SetThemeEnabled(TRUE
);
599 GtkNotebook
*notebook
= GTK_NOTEBOOK(m_widget
);
601 wxGtkNotebookPage
*nb_page
= new wxGtkNotebookPage();
603 if ( position
== GetPageCount() )
604 m_pagesData
.Append( nb_page
);
606 m_pagesData
.Insert( m_pagesData
.Item( position
), nb_page
);
608 m_pages
.Insert(win
, position
);
610 nb_page
->m_box
= gtk_hbox_new( FALSE
, 1 );
611 gtk_container_border_width( GTK_CONTAINER(nb_page
->m_box
), 2 );
613 gtk_signal_connect( GTK_OBJECT(win
->m_widget
), "size_allocate",
614 GTK_SIGNAL_FUNC(gtk_page_size_callback
), (gpointer
)win
);
617 // On VMS position is unsigned and thus always positive
619 gtk_notebook_append_page( notebook
, win
->m_widget
, nb_page
->m_box
);
622 gtk_notebook_insert_page( notebook
, win
->m_widget
, nb_page
->m_box
, position
);
624 nb_page
->m_page
= (GtkNotebookPage
*) g_list_last(notebook
->children
)->data
;
626 /* set the label image */
627 nb_page
->m_image
= imageId
;
631 wxASSERT( m_imageList
!= NULL
);
633 const wxBitmap
*bmp
= m_imageList
->GetBitmap(imageId
);
634 GdkPixmap
*pixmap
= bmp
->GetPixmap();
635 GdkBitmap
*mask
= (GdkBitmap
*) NULL
;
636 if ( bmp
->GetMask() )
638 mask
= bmp
->GetMask()->GetBitmap();
641 GtkWidget
*pixmapwid
= gtk_pixmap_new (pixmap
, mask
);
643 gtk_box_pack_start(GTK_BOX(nb_page
->m_box
), pixmapwid
, FALSE
, FALSE
, m_padding
);
645 gtk_widget_show(pixmapwid
);
648 /* set the label text */
649 nb_page
->m_text
= text
;
650 if (nb_page
->m_text
.IsEmpty()) nb_page
->m_text
= wxT("");
652 nb_page
->m_label
= GTK_LABEL( gtk_label_new(nb_page
->m_text
.mbc_str()) );
653 gtk_box_pack_end( GTK_BOX(nb_page
->m_box
), GTK_WIDGET(nb_page
->m_label
), FALSE
, FALSE
, m_padding
);
656 gtk_widget_show( GTK_WIDGET(nb_page
->m_label
) );
657 if (select
&& (m_pagesData
.GetCount() > 1))
660 // On VMS position is unsigned and thus always positive
662 SetSelection( GetPageCount()-1 );
665 SetSelection( position
);
668 gtk_signal_connect( GTK_OBJECT(m_widget
), "switch_page",
669 GTK_SIGNAL_FUNC(gtk_notebook_page_change_callback
), (gpointer
)this );
674 void wxNotebook::OnNavigationKey(wxNavigationKeyEvent
& event
)
676 if (event
.IsWindowChange())
677 AdvanceSelection( event
.GetDirection() );
682 #if wxUSE_CONSTRAINTS
684 // override these 2 functions to do nothing: everything is done in OnSize
685 void wxNotebook::SetConstraintSizes( bool WXUNUSED(recurse
) )
687 // don't set the sizes of the pages - their correct size is not yet known
688 wxControl::SetConstraintSizes(FALSE
);
691 bool wxNotebook::DoPhase( int WXUNUSED(nPhase
) )
698 void wxNotebook::ApplyWidgetStyle()
700 // TODO, font for labels etc
703 gtk_widget_set_style( m_widget
, m_widgetStyle
);
706 bool wxNotebook::IsOwnGtkWindow( GdkWindow
*window
)
708 return ((m_widget
->window
== window
) ||
709 (NOTEBOOK_PANEL(m_widget
) == window
));
712 //-----------------------------------------------------------------------------
714 //-----------------------------------------------------------------------------
716 IMPLEMENT_DYNAMIC_CLASS(wxNotebookEvent
, wxNotifyEvent
)