src/gtk/notebook.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        notebook.cpp
   3 // Purpose:
   4 // Author:      Robert Roebling
   5 // Id:          $Id$
   6 // Copyright:   (c) 1998 Robert Roebling, Vadim Zeitlin
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10 #ifdef __GNUG__
  11 #pragma implementation "notebook.h"
  12 #endif
  13
  14 #include "wx/notebook.h"
  15 #include "wx/panel.h"
  16 #include "wx/utils.h"
  17 #include "wx/imaglist.h"
  18 #include "wx/intl.h"
  19 #include "wx/log.h"
  20
  21 #include "gdk/gdk.h"
  22 #include "gtk/gtk.h"
  23 #include "wx/gtk/win_gtk.h"
  24 #include "gdk/gdkkeysyms.h"
  25
  26 //-----------------------------------------------------------------------------
  27 // data
  28 //-----------------------------------------------------------------------------
  29
  30 extern bool   g_blockEventsOnDrag;
  31
  32 //-----------------------------------------------------------------------------
  33 // wxNotebookPage
  34 //-----------------------------------------------------------------------------
  35
  36 class wxNotebookPage: public wxObject
  37 {
  38 public:
  39   wxNotebookPage()
  40   {
  41     m_id = -1;
  42     m_text = "";
  43     m_image = -1;
  44     m_page = (GtkNotebookPage *) NULL;
  45     m_client = (wxWindow *) NULL;
  46     m_parent = (GtkNotebook *) NULL;
  47     m_box = (GtkWidget *) NULL;
  48     m_added = FALSE;
  49   }
  50
  51   /*
  52      mark page as "added' to the notebook, return FALSE if the page was
  53      already added
  54    */
  55
  56   bool Add()
  57   {
  58     if ( WasAdded() )
  59       return FALSE;
  60
  61     m_added = TRUE;
  62     return TRUE;
  63   }
  64
  65   bool WasAdded() const { return m_added; }
  66
  67   int                m_id;
  68   wxString           m_text;
  69   int                m_image;
  70   GtkNotebookPage   *m_page;
  71   GtkLabel          *m_label;
  72   wxWindow          *m_client;
  73   GtkNotebook       *m_parent;
  74   GtkWidget         *m_box;     // in which the label and image are packed
  75
  76 private:
  77   bool m_added;
  78 };
  79
  80 //-----------------------------------------------------------------------------
  81 // "switch_page"
  82 //-----------------------------------------------------------------------------
  83
  84 static void gtk_notebook_page_change_callback(GtkNotebook *WXUNUSED(widget),
  85                                               GtkNotebookPage *WXUNUSED(page),
  86                                               gint nPage,
  87                                               gpointer data)
  88 {
  89     wxNotebook *notebook = (wxNotebook *)data;
  90
  91     int old = notebook->GetSelection();
  92
  93     // TODO: emulate PAGE_CHANGING event
  94
  95     wxNotebookEvent event( wxEVT_COMMAND_NOTEBOOK_PAGE_CHANGED,
  96                            notebook->GetId(),  nPage, old );
  97     event.SetEventObject( notebook );
  98     notebook->GetEventHandler()->ProcessEvent( event );
  99 }
 100
 101 //-----------------------------------------------------------------------------
 102 // "size_allocate"
 103 //-----------------------------------------------------------------------------
 104
 105 static void gtk_page_size_callback( GtkWidget *WXUNUSED(widget), GtkAllocation* alloc, wxWindow *win )
 106 {
 107     if ((win->m_x == alloc->x) &&
 108         (win->m_y == alloc->y) &&
 109         (win->m_width == alloc->width) &&
 110         (win->m_height == alloc->height))
 111     {
 112         return;
 113     }
 114
 115     win->SetSize( alloc->x, alloc->y, alloc->width, alloc->height );
 116
 117     if (win->GetAutoLayout()) win->Layout();
 118 }
 119
 120 //-----------------------------------------------------------------------------
 121 // "key_press_event"
 122 //-----------------------------------------------------------------------------
 123
 124 static gint
 125 gtk_notebook_key_press_callback( GtkWidget *widget, GdkEventKey *gdk_event, wxNotebook *notebook )
 126 {
 127     if (g_blockEventsOnDrag) return FALSE;
 128
 129     if (!notebook->HasVMT()) return FALSE;
 130
 131     /* this code makes jumping down from the handles of the notebooks
 132        to the actual items in the visible notebook page possible with
 133        the down-arrow key */
 134
 135     if (gdk_event->keyval != GDK_Down) return FALSE;
 136
 137     if (notebook != notebook->FindFocus()) return FALSE;
 138
 139     if (notebook->m_pages.GetCount() == 0) return FALSE;
 140
 141     wxNode *node = notebook->m_pages.Nth( notebook->GetSelection() );
 142
 143     if (!node) return FALSE;
 144
 145     wxNotebookPage *page = (wxNotebookPage*) node->Data();
 146
 147     // don't let others the key event
 148     gtk_signal_emit_stop_by_name( GTK_OBJECT(widget), "key_press_event" );
 149
 150     page->m_client->SetFocus();
 151
 152     return TRUE;
 153 }
 154
 155 //-----------------------------------------------------------------------------
 156 // InsertChild callback for wxNotebook
 157 //-----------------------------------------------------------------------------
 158
 159 static void wxInsertChildInNotebook( wxNotebook* parent, wxWindow* child )
 160 {
 161     wxNotebookPage *page = new wxNotebookPage();
 162
 163     page->m_id = parent->GetPageCount();
 164
 165     page->m_box = gtk_hbox_new (FALSE, 0);
 166     gtk_container_border_width(GTK_CONTAINER(page->m_box), 2);
 167
 168     GtkNotebook *notebook = GTK_NOTEBOOK(parent->m_widget);
 169
 170     page->m_client = child;
 171     gtk_notebook_append_page( notebook, child->m_widget, page->m_box );
 172
 173     page->m_page = (GtkNotebookPage*) (g_list_last(notebook->children)->data);
 174
 175     page->m_parent = notebook;
 176
 177     gtk_signal_connect( GTK_OBJECT(child->m_widget), "size_allocate",
 178       GTK_SIGNAL_FUNC(gtk_page_size_callback), (gpointer)child );
 179
 180     wxASSERT_MSG( page->m_page, _T("Notebook page creation error") );
 181
 182     parent->m_pages.Append( page );
 183 }
 184
 185 //-----------------------------------------------------------------------------
 186 // wxNotebook
 187 //-----------------------------------------------------------------------------
 188
 189 IMPLEMENT_DYNAMIC_CLASS(wxNotebook,wxControl)
 190
 191 BEGIN_EVENT_TABLE(wxNotebook, wxControl)
 192     EVT_NAVIGATION_KEY(wxNotebook::OnNavigationKey)
 193 END_EVENT_TABLE()
 194
 195 void wxNotebook::Init()
 196 {
 197     m_imageList = (wxImageList *) NULL;
 198     m_pages.DeleteContents( TRUE );
 199     m_idHandler = 0;
 200 }
 201
 202 wxNotebook::wxNotebook()
 203 {
 204     Init();
 205 }
 206
 207 wxNotebook::wxNotebook( wxWindow *parent, wxWindowID id,
 208       const wxPoint& pos, const wxSize& size,
 209       long style, const wxString& name )
 210 {
 211     Init();
 212     Create( parent, id, pos, size, style, name );
 213 }
 214
 215 wxNotebook::~wxNotebook()
 216 {
 217     // don't generate change page events any more
 218     if (m_idHandler != 0)
 219       gtk_signal_disconnect(GTK_OBJECT(m_widget), m_idHandler);
 220
 221     DeleteAllPages();
 222 }
 223
 224 bool wxNotebook::Create(wxWindow *parent, wxWindowID id,
 225       const wxPoint& pos, const wxSize& size,
 226       long style, const wxString& name )
 227 {
 228     m_needParent = TRUE;
 229     m_acceptsFocus = TRUE;
 230     m_insertCallback = (wxInsertChildFunction)wxInsertChildInNotebook;
 231
 232     PreCreation( parent, id, pos, size, style, name );
 233
 234     m_widget = gtk_notebook_new();
 235
 236     gtk_notebook_set_scrollable( GTK_NOTEBOOK(m_widget), 1 );
 237
 238     m_idHandler = gtk_signal_connect (
 239                   GTK_OBJECT(m_widget), "switch_page",
 240                   GTK_SIGNAL_FUNC(gtk_notebook_page_change_callback),
 241                   (gpointer)this );
 242
 243     m_parent->AddChild( this );
 244
 245     (m_parent->m_insertCallback)( m_parent, this );
 246
 247     gtk_signal_connect( GTK_OBJECT(m_widget), "key_press_event",
 248       GTK_SIGNAL_FUNC(gtk_notebook_key_press_callback), (gpointer)this );
 249
 250     PostCreation();
 251
 252     Show( TRUE );
 253
 254     return TRUE;
 255 }
 256
 257 int wxNotebook::GetSelection() const
 258 {
 259     wxCHECK_MSG( m_widget != NULL, -1, _T("invalid notebook") );
 260
 261     if (m_pages.Number() == 0) return -1;
 262
 263     GtkNotebookPage *g_page = GTK_NOTEBOOK(m_widget)->cur_page;
 264     if (!g_page) return -1;
 265
 266     wxNotebookPage *page = (wxNotebookPage *) NULL;
 267
 268     wxNode *node = m_pages.First();
 269     while (node)
 270     {
 271         page = (wxNotebookPage*)node->Data();
 272
 273         if ((page->m_page == g_page) || (page->m_page == (GtkNotebookPage*)NULL))
 274         {
 275             // page->m_page is NULL directly after gtk_notebook_append. gtk emits
 276             // "switch_page" then and we ask for GetSelection() in the handler for
 277             // "switch_page". otherwise m_page should never be NULL. all this
 278             // might also be wrong.
 279             break;
 280         }
 281         node = node->Next();
 282     }
 283
 284     wxCHECK_MSG( node != NULL, -1, _T("wxNotebook: no selection?") );
 285
 286     return page->m_id;
 287 }
 288
 289 int wxNotebook::GetPageCount() const
 290 {
 291     // count only the pages which were already added to the notebook for MSW
 292     // compatibility (and, in fact, this behaviour makes more sense anyhow
 293     // because only the added pages are shown)
 294
 295     int n = 0;
 296     for ( wxNode *node = m_pages.First(); node; node = node->Next() )
 297     {
 298         wxNotebookPage *page = (wxNotebookPage*)node->Data();
 299
 300         if (page->WasAdded()) n++;
 301     }
 302
 303     return n;
 304 }
 305
 306 int wxNotebook::GetRowCount() const
 307 {
 308     return 1;
 309 }
 310
 311 wxString wxNotebook::GetPageText( int page ) const
 312 {
 313     wxCHECK_MSG( m_widget != NULL, _T(""), _T("invalid notebook") );
 314
 315     wxNotebookPage* nb_page = GetNotebookPage(page);
 316     if (nb_page)
 317         return nb_page->m_text;
 318     else
 319         return "";
 320 }
 321
 322 int wxNotebook::GetPageImage( int page ) const
 323 {
 324     wxCHECK_MSG( m_widget != NULL, 0, _T("invalid notebook") );
 325
 326     wxNotebookPage* nb_page = GetNotebookPage(page);
 327     if (nb_page)
 328         return nb_page->m_image;
 329     else
 330         return 0;
 331 }
 332
 333 wxNotebookPage* wxNotebook::GetNotebookPage(int page) const
 334 {
 335     wxCHECK_MSG( m_widget != NULL, (wxNotebookPage*)NULL, _T("invalid notebook") );
 336
 337     wxNotebookPage *nb_page = (wxNotebookPage *) NULL;
 338
 339     wxNode *node = m_pages.First();
 340     while (node)
 341     {
 342         nb_page = (wxNotebookPage*)node->Data();
 343         if (nb_page->m_id == page)
 344             return nb_page;
 345         node = node->Next();
 346     }
 347
 348     wxFAIL_MSG( _T("Notebook page not found!") );
 349
 350     return (wxNotebookPage *) NULL;
 351 }
 352
 353 int wxNotebook::SetSelection( int page )
 354 {
 355     wxCHECK_MSG( m_widget != NULL, -1, _T("invalid notebook") );
 356
 357     int selOld = GetSelection();
 358     wxNotebookPage* nb_page = GetNotebookPage(page);
 359
 360     if (!nb_page) return -1;
 361
 362     int page_num = 0;
 363     GList *child = GTK_NOTEBOOK(m_widget)->children;
 364     while (child)
 365     {
 366         if (nb_page->m_page == (GtkNotebookPage*)child->data)  break;
 367         page_num++;
 368         child = child->next;
 369     }
 370
 371     if (!child) return -1;
 372
 373     gtk_notebook_set_page( GTK_NOTEBOOK(m_widget), page_num );
 374
 375     return selOld;
 376 }
 377
 378 void wxNotebook::AdvanceSelection( bool bForward )
 379 {
 380     wxCHECK_RET( m_widget != NULL, _T("invalid notebook") );
 381
 382     int sel = GetSelection();
 383     int max = GetPageCount();
 384
 385     if (bForward)
 386         SetSelection( sel == max ? 0 : sel + 1 );
 387     else
 388         SetSelection( sel == 0 ? max-1 : sel - 1 );
 389 }
 390
 391 void wxNotebook::SetImageList( wxImageList* imageList )
 392 {
 393     m_imageList = imageList;
 394 }
 395
 396 bool wxNotebook::SetPageText( int page, const wxString &text )
 397 {
 398     wxCHECK_MSG( m_widget != NULL, FALSE, _T("invalid notebook") );
 399
 400     wxNotebookPage* nb_page = GetNotebookPage(page);
 401
 402     wxCHECK_MSG( nb_page, FALSE, _T("SetPageText: invalid page index") );
 403
 404     nb_page->m_text = text;
 405
 406     gtk_label_set(nb_page->m_label, nb_page->m_text.mbc_str());
 407
 408     return TRUE;
 409 }
 410
 411 bool wxNotebook::SetPageImage( int page, int image )
 412 {
 413     /* HvdH 28-12-98: now it works, but it's a bit of a kludge */
 414
 415     wxNotebookPage* nb_page = GetNotebookPage(page);
 416
 417     if (!nb_page) return FALSE;
 418
 419     /* Optimization posibility: return immediately if image unchanged.
 420      * Not enabled because it may break existing (stupid) code that
 421      * manipulates the imagelist to cycle images */
 422
 423     /* if (image == nb_page->m_image) return TRUE; */
 424
 425     /* For different cases:
 426        1) no image -> no image
 427        2) image -> no image
 428        3) no image -> image
 429        4) image -> image */
 430
 431     if (image == -1 && nb_page->m_image == -1)
 432         return TRUE; /* Case 1): Nothing to do. */
 433
 434     GtkWidget *pixmapwid = (GtkWidget*) NULL;
 435
 436     if (nb_page->m_image != -1)
 437     {
 438         /* Case 2) or 4). There is already an image in the gtkhbox. Let's find it */
 439
 440         GList *child = gtk_container_children(GTK_CONTAINER(nb_page->m_box));
 441         while (child)
 442         {
 443             if (GTK_IS_PIXMAP(child->data))
 444             {
 445                 pixmapwid = GTK_WIDGET(child->data);
 446                 break;
 447             }
 448             child = child->next;
 449         }
 450
 451         /* We should have the pixmap widget now */
 452         wxASSERT(pixmapwid != NULL);
 453
 454         if (image == -1)
 455         {
 456             /* If there's no new widget, just remove the old from the box */
 457             gtk_container_remove(GTK_CONTAINER(nb_page->m_box), pixmapwid);
 458             nb_page->m_image = -1;
 459
 460             return TRUE; /* Case 2) */
 461         }
 462     }
 463
 464     /* Only cases 3) and 4) left */
 465     wxASSERT( m_imageList != NULL ); /* Just in case */
 466
 467     /* Construct the new pixmap */
 468     const wxBitmap *bmp = m_imageList->GetBitmap(image);
 469     GdkPixmap *pixmap = bmp->GetPixmap();
 470     GdkBitmap *mask = (GdkBitmap*) NULL;
 471     if ( bmp->GetMask() )
 472     {
 473         mask = bmp->GetMask()->GetBitmap();
 474     }
 475
 476     if (pixmapwid == NULL)
 477     {
 478         /* Case 3) No old pixmap. Create a new one and prepend it to the hbox */
 479         pixmapwid = gtk_pixmap_new (pixmap, mask );
 480
 481         /* CHECKME: Are these pack flags okay? */
 482         gtk_box_pack_start(GTK_BOX(nb_page->m_box), pixmapwid, FALSE, FALSE, 3);
 483         gtk_widget_show(pixmapwid);
 484     }
 485     else
 486     {
 487         /* Case 4) Simply replace the pixmap */
 488         gtk_pixmap_set(GTK_PIXMAP(pixmapwid), pixmap, mask);
 489     }
 490
 491     nb_page->m_image = image;
 492
 493     return TRUE;
 494 }
 495
 496 void wxNotebook::SetPageSize( const wxSize &WXUNUSED(size) )
 497 {
 498     wxFAIL_MSG( _T("wxNotebook::SetPageSize not implemented") );
 499 }
 500
 501 void wxNotebook::SetPadding( const wxSize &WXUNUSED(padding) )
 502 {
 503     wxFAIL_MSG( _T("wxNotebook::SetPadding not implemented") );
 504 }
 505
 506 void wxNotebook::SetTabSize(const wxSize& sz)
 507 {
 508     wxFAIL_MSG( _T("wxNotebook::SetTabSize not implemented") );
 509 }
 510
 511 bool wxNotebook::DeleteAllPages()
 512 {
 513     wxCHECK_MSG( m_widget != NULL, FALSE, _T("invalid notebook") );
 514
 515     wxNode *page_node = m_pages.First();
 516     while (page_node)
 517     {
 518         wxNotebookPage *page = (wxNotebookPage*)page_node->Data();
 519
 520         DeletePage( page->m_id );
 521
 522         page_node = m_pages.First();
 523     }
 524
 525     return TRUE;
 526 }
 527
 528 bool wxNotebook::DeletePage( int page )
 529 {
 530     wxNotebookPage* nb_page = GetNotebookPage(page);
 531     if (!nb_page) return FALSE;
 532
 533     int page_num = 0;
 534     GList *child = GTK_NOTEBOOK(m_widget)->children;
 535     while (child)
 536     {
 537         if (nb_page->m_page == (GtkNotebookPage*)child->data) break;
 538         page_num++;
 539         child = child->next;
 540     }
 541
 542     wxCHECK_MSG( child != NULL, FALSE, _T("illegal notebook index") );
 543
 544     delete nb_page->m_client;
 545
 546     m_pages.DeleteObject( nb_page );
 547
 548     return TRUE;
 549 }
 550
 551 bool wxNotebook::RemovePage( int page )
 552 {
 553     wxNotebookPage* nb_page = GetNotebookPage(page);
 554     if (!nb_page) return FALSE;
 555
 556     int page_num = 0;
 557     GList *child = GTK_NOTEBOOK(m_widget)->children;
 558     while (child)
 559     {
 560         if (nb_page->m_page == (GtkNotebookPage*)child->data) break;
 561         page_num++;
 562         child = child->next;
 563     }
 564
 565     wxCHECK_MSG( child != NULL, FALSE, _T("illegal notebook index") );
 566
 567     gtk_notebook_remove_page( GTK_NOTEBOOK(m_widget), page_num );
 568
 569     m_pages.DeleteObject( nb_page );
 570
 571     return TRUE;
 572 }
 573
 574 bool wxNotebook::AddPage(wxWindow* win, const wxString& text,
 575                          bool select, int imageId)
 576 {
 577     wxCHECK_MSG( m_widget != NULL, FALSE, _T("invalid notebook") );
 578
 579     /* we've created the notebook page in AddChild(). Now we just have to set
 580        the caption for the page and set the others parameters. */
 581
 582     wxNotebookPage *page = (wxNotebookPage *) NULL;
 583
 584     wxNode *node = m_pages.First();
 585     while (node)
 586     {
 587         page = (wxNotebookPage*)node->Data();
 588         if ( page->m_client == win ) break;
 589         node = node->Next();
 590     }
 591
 592     wxCHECK_MSG( page != NULL, FALSE,
 593                _T("Can't add a page whose parent is not the notebook!") );
 594
 595     wxCHECK_MSG( page->Add(), FALSE,
 596                _T("Can't add the same page twice to a notebook.") );
 597
 598     if (imageId != -1)
 599     {
 600         wxASSERT( m_imageList != NULL );
 601
 602         const wxBitmap *bmp = m_imageList->GetBitmap(imageId);
 603         GdkPixmap *pixmap = bmp->GetPixmap();
 604         GdkBitmap *mask = (GdkBitmap*) NULL;
 605         if ( bmp->GetMask() )
 606         {
 607             mask = bmp->GetMask()->GetBitmap();
 608         }
 609
 610         GtkWidget *pixmapwid = gtk_pixmap_new (pixmap, mask );
 611
 612         gtk_box_pack_start(GTK_BOX(page->m_box), pixmapwid, FALSE, FALSE, 3);
 613
 614         gtk_widget_show(pixmapwid);
 615     }
 616
 617     /* then set the attributes */
 618     page->m_text = text;
 619     if (page->m_text.IsEmpty()) page->m_text = _T("");
 620     page->m_image = imageId;
 621     page->m_label = (GtkLabel *)gtk_label_new(page->m_text.mbc_str());
 622     gtk_box_pack_end( GTK_BOX(page->m_box), (GtkWidget *)page->m_label, FALSE, FALSE, 3);
 623
 624     /* @@@: what does this do? do we still need it?
 625     gtk_misc_set_alignment(GTK_MISC(page->m_label), 0.0, 0.5); */
 626
 627     gtk_widget_show((GtkWidget *)page->m_label);
 628
 629     if (select) SetSelection( GetPageCount()-1 );
 630
 631     return TRUE;
 632 }
 633
 634 void wxNotebook::OnNavigationKey(wxNavigationKeyEvent& event)
 635 {
 636     if (event.IsWindowChange())
 637         AdvanceSelection( event.GetDirection() );
 638     else
 639         event.Skip();
 640 }
 641
 642 wxWindow *wxNotebook::GetPage( int page ) const
 643 {
 644     wxCHECK_MSG( m_widget != NULL, (wxWindow*) NULL, _T("invalid notebook") );
 645
 646     wxNotebookPage* nb_page = GetNotebookPage(page);
 647     if (!nb_page)
 648         return (wxWindow *) NULL;
 649     else
 650         return nb_page->m_client;
 651 }
 652
 653 // override these 2 functions to do nothing: everything is done in OnSize
 654 void wxNotebook::SetConstraintSizes( bool WXUNUSED(recurse) )
 655 {
 656     // don't set the sizes of the pages - their correct size is not yet known
 657     wxControl::SetConstraintSizes(FALSE);
 658 }
 659
 660 bool wxNotebook::DoPhase( int WXUNUSED(nPhase) )
 661 {
 662     return TRUE;
 663 }
 664
 665 void wxNotebook::ApplyWidgetStyle()
 666 {
 667     SetWidgetStyle();
 668     gtk_widget_set_style( m_widget, m_widgetStyle );
 669 }
 670
 671 //-----------------------------------------------------------------------------
 672 // wxNotebookEvent
 673 //-----------------------------------------------------------------------------
 674
 675 IMPLEMENT_DYNAMIC_CLASS(wxNotebookEvent, wxNotifyEvent)
 676