src/gtk/listbox.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/gtk/listbox.cpp
   3 // Purpose:
   4 // Author:      Robert Roebling
   5 // Modified By: Ryan Norton (GtkTreeView implementation)
   6 // Id:          $Id$
   7 // Copyright:   (c) 1998 Robert Roebling
   8 // Licence:     wxWindows licence
   9 /////////////////////////////////////////////////////////////////////////////
  10
  11 // For compilers that support precompilation, includes "wx.h".
  12 #include "wx/wxprec.h"
  13
  14 #include "wx/defs.h"
  15
  16 #if wxUSE_LISTBOX
  17
  18 #include "wx/listbox.h"
  19 #include "wx/dynarray.h"
  20 #include "wx/arrstr.h"
  21 #include "wx/utils.h"
  22 #include "wx/intl.h"
  23 #include "wx/checklst.h"
  24 #include "wx/settings.h"
  25 #include "wx/log.h"
  26 #include "wx/gtk/private.h"
  27 #include "wx/gtk/treeentry_gtk.h"
  28
  29 #if wxUSE_TOOLTIPS
  30 #include "wx/tooltip.h"
  31 #endif
  32
  33 #include <gdk/gdk.h>
  34 #include <gtk/gtk.h>
  35 #include <gdk/gdkkeysyms.h>
  36
  37 //-----------------------------------------------------------------------------
  38 // data
  39 //-----------------------------------------------------------------------------
  40
  41 extern bool           g_blockEventsOnDrag;
  42 extern bool           g_blockEventsOnScroll;
  43 extern wxCursor       g_globalCursor;
  44
  45
  46 //-----------------------------------------------------------------------------
  47 // idle system
  48 //-----------------------------------------------------------------------------
  49
  50 extern void wxapp_install_idle_handler();
  51 extern bool g_isIdle;
  52
  53 //-----------------------------------------------------------------------------
  54 // Macro to tell which row the strings are in (1 if native checklist, 0 if not)
  55 //-----------------------------------------------------------------------------
  56
  57 #if wxUSE_CHECKLISTBOX && wxUSE_NATIVEGTKCHECKLIST
  58 #   define WXLISTBOX_DATACOLUMN_ARG(x)  (x->m_hasCheckBoxes ? 1 : 0)
  59 #else
  60 #   define WXLISTBOX_DATACOLUMN_ARG(x)  (0)
  61 #endif // wxUSE_CHECKLISTBOX && wxUSE_NATIVEGTKCHECKLIST
  62
  63 #define WXLISTBOX_DATACOLUMN    WXLISTBOX_DATACOLUMN_ARG(this)
  64
  65 //-----------------------------------------------------------------------------
  66 // "row-activated"
  67 //-----------------------------------------------------------------------------
  68
  69 extern "C" {
  70 static void
  71 gtk_listbox_row_activated_callback(GtkTreeView        *treeview,
  72                                    GtkTreePath        *path,
  73                                    GtkTreeViewColumn  *col,
  74                                    wxListBox          *listbox)
  75 {
  76     if (g_isIdle) wxapp_install_idle_handler();
  77
  78     if (g_blockEventsOnDrag) return;
  79     if (g_blockEventsOnScroll) return;
  80
  81     if (!listbox->m_hasVMT) return;
  82
  83     //Notes:
  84     //1) This is triggered by either a double-click or a space press
  85     //2) We handle both here because
  86     //2a) in the case of a space/keypress we can't really know
  87     //    which item was pressed on because we can't get coords
  88     //    from a keyevent
  89     //2b) It seems more correct
  90
  91     int sel = gtk_tree_path_get_indices(path)[0];
  92
  93     if(!listbox->m_spacePressed)
  94     {
  95         //Assume it was double-click
  96         wxCommandEvent event(wxEVT_COMMAND_LISTBOX_DOUBLECLICKED, listbox->GetId() );
  97         event.SetEventObject( listbox );
  98
  99         if(listbox->IsSelected(sel))
 100         {
 101             GtkTreeEntry* entry = listbox->GtkGetEntry(sel);
 102
 103             if(entry)
 104             {
 105                 event.SetInt(sel);
 106                 event.SetString(wxConvUTF8.cMB2WX(gtk_tree_entry_get_label(entry)));
 107
 108                 if ( listbox->HasClientObjectData() )
 109                     event.SetClientObject(
 110                     (wxClientData*) gtk_tree_entry_get_userdata(entry) );
 111                 else if ( listbox->HasClientUntypedData() )
 112                     event.SetClientData( gtk_tree_entry_get_userdata(entry) );
 113                 g_object_unref(G_OBJECT(entry));
 114             }
 115             else
 116             {
 117                 wxLogSysError(wxT("Internal error - could not get entry for double-click"));
 118                 event.SetInt(-1);
 119             }
 120         }
 121         else
 122             event.SetInt(-1);
 123
 124         listbox->GetEventHandler()->ProcessEvent( event );
 125     }
 126     else
 127     {
 128         listbox->m_spacePressed = false; //don't block selection behaviour anymore
 129
 130         //Space was pressed - toggle the appropriate checkbox and the selection
 131 #if wxUSE_CHECKLISTBOX //Do it for both native and non-native
 132         if (listbox->m_hasCheckBoxes)
 133         {
 134             wxCheckListBox *clb = (wxCheckListBox *)listbox;
 135
 136             clb->Check( sel, !clb->IsChecked(sel) );
 137
 138             wxCommandEvent new_event( wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, listbox->GetId() );
 139             new_event.SetEventObject( listbox );
 140             new_event.SetInt( sel );
 141             listbox->GetEventHandler()->ProcessEvent( new_event );
 142         }
 143 #endif // wxUSE_CHECKLISTBOX
 144
 145         if(  (((listbox->GetWindowStyleFlag() & wxLB_MULTIPLE) != 0) ||
 146               ((listbox->GetWindowStyleFlag() & wxLB_EXTENDED) != 0)) )
 147     {
 148             //toggle the selection + send event
 149             if(listbox->IsSelected( sel ))
 150                 listbox->GtkSetSelection(sel, FALSE, FALSE);
 151     else
 152                 listbox->GtkSetSelection(sel, TRUE, FALSE);
 153         }
 154     }
 155 }
 156 }
 157
 158 //-----------------------------------------------------------------------------
 159 // "button_press_event"
 160 //-----------------------------------------------------------------------------
 161
 162 extern "C" {
 163 static gint
 164 gtk_listbox_button_press_callback( GtkWidget *widget,
 165                                    GdkEventButton *gdk_event,
 166                                    wxListBox *listbox )
 167 {
 168     if (g_isIdle) wxapp_install_idle_handler();
 169
 170     if (g_blockEventsOnDrag) return FALSE;
 171     if (g_blockEventsOnScroll) return FALSE;
 172
 173     if (!listbox->m_hasVMT) return FALSE;
 174
 175     //Just to be on the safe side - it should be unset in the activate callback
 176     //but we don't want any obscure bugs if it doesn't get called somehow...
 177     listbox->m_spacePressed = false;
 178
 179 #if wxUSE_CHECKLISTBOX && !wxUSE_NATIVEGTKCHECKLIST
 180     if ((listbox->m_hasCheckBoxes) && (gdk_event->x < 15) && (gdk_event->type != GDK_2BUTTON_PRESS))
 181     {
 182         GtkTreePath* path;
 183         gtk_tree_view_get_path_at_pos(GTK_TREE_VIEW(widget),
 184                                   (gint)gdk_event->x, (gint)gdk_event->y,
 185                                   &path, NULL, NULL, NULL);
 186         int sel = gtk_tree_path_get_indices(path)[0];
 187         gtk_tree_path_free(path);
 188
 189         wxCheckListBox *clb = (wxCheckListBox *)listbox;
 190
 191         clb->Check( sel, !clb->IsChecked(sel) );
 192
 193         wxCommandEvent event( wxEVT_COMMAND_CHECKLISTBOX_TOGGLED, listbox->GetId() );
 194         event.SetEventObject( listbox );
 195         event.SetInt( sel );
 196         listbox->GetEventHandler()->ProcessEvent( event );
 197     }
 198 #endif // wxUSE_CHECKLISTBOX && !wxUSE_NATIVEGTKCHECKLIST
 199
 200     return FALSE;
 201 }
 202 }
 203
 204 //-----------------------------------------------------------------------------
 205 // "key_press_event"
 206 //-----------------------------------------------------------------------------
 207
 208 extern "C" {
 209 static gint
 210 gtk_listbox_key_press_callback( GtkWidget *widget,
 211                                 GdkEventKey *gdk_event,
 212                                 wxListBox *listbox )
 213 {
 214     if (g_isIdle) wxapp_install_idle_handler();
 215
 216     if (g_blockEventsOnDrag) return FALSE;
 217
 218
 219     bool ret = FALSE;
 220
 221     if ((gdk_event->keyval == GDK_Tab) || (gdk_event->keyval == GDK_ISO_Left_Tab))
 222     {
 223         wxNavigationKeyEvent new_event;
 224         /* GDK reports GDK_ISO_Left_Tab for SHIFT-TAB */
 225         new_event.SetDirection( (gdk_event->keyval == GDK_Tab) );
 226         /* CTRL-TAB changes the (parent) window, i.e. switch notebook page */
 227         new_event.SetWindowChange( (gdk_event->state & GDK_CONTROL_MASK) );
 228         new_event.SetCurrentFocus( listbox );
 229         ret = listbox->GetEventHandler()->ProcessEvent( new_event );
 230     }
 231
 232     if ((gdk_event->keyval == GDK_Return) && (!ret))
 233     {
 234         // eat return in all modes (RN:WHY?)
 235         ret = TRUE;
 236     }
 237
 238     // Check or uncheck item with SPACE
 239     if (gdk_event->keyval == ' ')
 240         {
 241         //In the keyevent we don't know the index of the item
 242         //and the activated event gets called anyway...
 243         //
 244         //Also, activating with the space causes the treeview to
 245         //unselect all the items and then select the item in question
 246         //wx's behaviour is to just toggle the item's selection state
 247         //and leave the others alone
 248         listbox->m_spacePressed = true;
 249     }
 250
 251     if (ret)
 252     {
 253         g_signal_stop_emission_by_name (widget, "key_press_event");
 254         return TRUE;
 255     }
 256
 257     return FALSE;
 258 }
 259 }
 260
 261 //-----------------------------------------------------------------------------
 262 // "select" and "deselect"
 263 //-----------------------------------------------------------------------------
 264
 265 extern "C" {
 266 static gboolean gtk_listitem_select_cb( GtkTreeSelection* selection,
 267                                         GtkTreeModel* model,
 268                                         GtkTreePath* path,
 269                                         gboolean is_selected,
 270                                         wxListBox *listbox )
 271 {
 272     if (g_isIdle) wxapp_install_idle_handler();
 273
 274     if (!listbox->m_hasVMT) return TRUE;
 275     if (g_blockEventsOnDrag) return TRUE;
 276
 277     if (listbox->m_spacePressed) return FALSE; //see keyevent callback
 278     if (listbox->m_blockEvent) return TRUE;
 279
 280     // NB: wxdocs explicitly say that this event only gets sent when
 281     // something is actually selected, plus the controls example
 282     // assumes so and passes -1 to the dogetclientdata funcs if not
 283
 284     // OK, so basically we need to do a bit of a run-around here as
 285     // 1) is_selected says whether the item(s?) are CURRENTLY selected -
 286     //    i.e. if is_selected is FALSE then the item is going to be
 287     //    selected right now!
 288     // 2) However, since it is not already selected and the user
 289     //    will expect it to be we need to manually select it and
 290     //    return FALSE telling GTK we handled the selection
 291     if (is_selected) return TRUE;
 292
 293     int nIndex = gtk_tree_path_get_indices(path)[0];
 294     GtkTreeEntry* entry = listbox->GtkGetEntry(nIndex);
 295
 296     if(entry)
 297     {
 298         //Now, as mentioned above, we manually select the row that is/was going
 299         //to be selected anyway by GTK
 300         listbox->m_blockEvent = TRUE; //if we don't block events we will lock the
 301                                       //app due to recursion!!
 302
 303         GtkTreeSelection* selection =
 304             gtk_tree_view_get_selection(listbox->m_treeview);
 305         GtkTreeIter iter;
 306         gtk_tree_model_get_iter(GTK_TREE_MODEL(listbox->m_liststore), &iter, path);
 307         gtk_tree_selection_select_iter(selection, &iter);
 308
 309         listbox->m_blockEvent = FALSE;
 310
 311         //Finally, send the wx event
 312     wxCommandEvent event(wxEVT_COMMAND_LISTBOX_SELECTED, listbox->GetId() );
 313     event.SetEventObject( listbox );
 314
 315     // indicate whether this is a selection or a deselection
 316         event.SetExtraLong( 1 );
 317
 318         event.SetInt(nIndex);
 319         event.SetString(wxConvUTF8.cMB2WX(gtk_tree_entry_get_label(entry)));
 320
 321         if ( listbox->HasClientObjectData() )
 322             event.SetClientObject(
 323                     (wxClientData*) gtk_tree_entry_get_userdata(entry)
 324                                  );
 325         else if ( listbox->HasClientUntypedData() )
 326             event.SetClientData( gtk_tree_entry_get_userdata(entry) );
 327
 328     listbox->GetEventHandler()->ProcessEvent( event );
 329
 330         g_object_unref(G_OBJECT(entry));
 331         return FALSE;  //We handled it/did it manually
 332     }
 333
 334     return TRUE; //allow selection to change
 335 }
 336 }
 337
 338 //-----------------------------------------------------------------------------
 339 // GtkTreeEntry destruction (to destroy client data)
 340 //-----------------------------------------------------------------------------
 341
 342 extern "C" {
 343 static void gtk_tree_entry_destroy_cb(GtkTreeEntry* entry,
 344                                       wxListBox* listbox)
 345 {
 346     if(listbox->HasClientObjectData())
 347     {
 348         gpointer userdata = gtk_tree_entry_get_userdata(entry);
 349         if(userdata)
 350             delete (wxClientData *)userdata;
 351     }
 352 }
 353 }
 354
 355 //-----------------------------------------------------------------------------
 356 // Sorting callback (standard CmpNoCase return value)
 357 //-----------------------------------------------------------------------------
 358
 359 extern "C" {
 360 static gint gtk_listbox_sort_callback(GtkTreeModel *model,
 361                                       GtkTreeIter  *a,
 362                                       GtkTreeIter  *b,
 363                                       wxListBox    *listbox)
 364 {
 365     GtkTreeEntry* entry;
 366     GtkTreeEntry* entry2;
 367
 368     gtk_tree_model_get(GTK_TREE_MODEL(listbox->m_liststore),
 369                              a,
 370                              WXLISTBOX_DATACOLUMN_ARG(listbox),
 371                              &entry, -1);
 372     gtk_tree_model_get(GTK_TREE_MODEL(listbox->m_liststore),
 373                              b,
 374                              WXLISTBOX_DATACOLUMN_ARG(listbox),
 375                              &entry2, -1);
 376     wxCHECK_MSG(entry, 0, wxT("Could not get entry"));
 377     wxCHECK_MSG(entry2, 0, wxT("Could not get entry2"));
 378
 379     //We compare collate keys here instead of calling g_utf8_collate
 380     //as it is rather slow (and even the docs reccommend this)
 381     int ret = strcasecmp(gtk_tree_entry_get_collate_key(entry),
 382                          gtk_tree_entry_get_collate_key(entry2));
 383
 384     g_object_unref(G_OBJECT(entry));
 385     g_object_unref(G_OBJECT(entry2));
 386
 387     return ret;
 388 }
 389 }
 390
 391 //-----------------------------------------------------------------------------
 392 // Searching callback (TRUE == not equal, FALSE == equal)
 393 //-----------------------------------------------------------------------------
 394
 395 extern "C" {
 396 static gboolean gtk_listbox_searchequal_callback(GtkTreeModel* model,
 397                                                  gint column,
 398                                                  const gchar* key,
 399                                                  GtkTreeIter* iter,
 400                                                  wxListBox* listbox)
 401 {
 402     GtkTreeEntry* entry;
 403
 404     gtk_tree_model_get(GTK_TREE_MODEL(listbox->m_liststore),
 405                              iter,
 406                              WXLISTBOX_DATACOLUMN_ARG(listbox),
 407                              &entry, -1);
 408     wxCHECK_MSG(entry, 0, wxT("Could not get entry"));
 409     gchar* keycollatekey = g_utf8_collate_key(key, -1);
 410
 411     int ret = strcasecmp(keycollatekey,
 412                          gtk_tree_entry_get_collate_key(entry));
 413
 414     g_free(keycollatekey);
 415     g_object_unref(G_OBJECT(entry));
 416
 417     return ret != 0;
 418 }
 419 }
 420
 421 //-----------------------------------------------------------------------------
 422 // wxListBox
 423 //-----------------------------------------------------------------------------
 424
 425 IMPLEMENT_DYNAMIC_CLASS(wxListBox, wxControl)
 426
 427 // ----------------------------------------------------------------------------
 428 // construction
 429 // ----------------------------------------------------------------------------
 430
 431 wxListBox::wxListBox()
 432 {
 433     m_treeview = (GtkTreeView*) NULL;
 434 #if wxUSE_CHECKLISTBOX
 435     m_hasCheckBoxes = FALSE;
 436 #endif // wxUSE_CHECKLISTBOX
 437     m_spacePressed = false;
 438 }
 439
 440 bool wxListBox::Create( wxWindow *parent, wxWindowID id,
 441                         const wxPoint &pos, const wxSize &size,
 442                         const wxArrayString& choices,
 443                         long style, const wxValidator& validator,
 444                         const wxString &name )
 445 {
 446     wxCArrayString chs(choices);
 447
 448     return Create( parent, id, pos, size, chs.GetCount(), chs.GetStrings(),
 449                    style, validator, name );
 450 }
 451
 452 bool wxListBox::Create( wxWindow *parent, wxWindowID id,
 453                         const wxPoint &pos, const wxSize &size,
 454                         int n, const wxString choices[],
 455                         long style, const wxValidator& validator,
 456                         const wxString &name )
 457 {
 458     m_needParent = TRUE;
 459     m_acceptsFocus = TRUE;
 460     m_blockEvent = FALSE;
 461
 462     if (!PreCreation( parent, pos, size ) ||
 463         !CreateBase( parent, id, pos, size, style, validator, name ))
 464     {
 465         wxFAIL_MSG( wxT("wxListBox creation failed") );
 466         return FALSE;
 467     }
 468
 469     m_widget = gtk_scrolled_window_new( (GtkAdjustment*) NULL, (GtkAdjustment*) NULL );
 470     if (style & wxLB_ALWAYS_SB)
 471     {
 472       gtk_scrolled_window_set_policy( GTK_SCROLLED_WINDOW(m_widget),
 473         GTK_POLICY_AUTOMATIC, GTK_POLICY_ALWAYS );
 474     }
 475     else
 476     {
 477       gtk_scrolled_window_set_policy( GTK_SCROLLED_WINDOW(m_widget),
 478         GTK_POLICY_AUTOMATIC, GTK_POLICY_AUTOMATIC );
 479     }
 480
 481     m_treeview = GTK_TREE_VIEW( gtk_tree_view_new( ) );
 482
 483     //wxListBox doesn't have a header :)
 484     //NB: If enabled SetFirstItem doesn't work correctly
 485     gtk_tree_view_set_headers_visible(m_treeview, FALSE);
 486
 487 #if wxUSE_CHECKLISTBOX && wxUSE_NATIVEGTKCHECKLIST
 488     if(m_hasCheckBoxes)
 489         ((wxCheckListBox*)this)->DoCreateCheckList();
 490 #endif // wxUSE_CHECKLISTBOX && wxUSE_NATIVEGTKCHECKLIST
 491
 492     // Create the data column
 493     gtk_tree_view_insert_column_with_attributes(m_treeview, -1, "",
 494                                                 gtk_cell_renderer_text_new(),
 495                                                 "text",
 496                                                 WXLISTBOX_DATACOLUMN, NULL);
 497
 498     // Now create+set the model (GtkListStore) - first argument # of columns
 499
 500 #if wxUSE_CHECKLISTBOX && wxUSE_NATIVEGTKCHECKLIST
 501     if(m_hasCheckBoxes)
 502         m_liststore = gtk_list_store_new(2, G_TYPE_BOOLEAN,
 503                                             GTK_TYPE_TREE_ENTRY);
 504     else
 505 #endif
 506         m_liststore = gtk_list_store_new(1, GTK_TYPE_TREE_ENTRY);
 507
 508     gtk_tree_view_set_model(m_treeview, GTK_TREE_MODEL(m_liststore));
 509
 510     g_object_unref(G_OBJECT(m_liststore)); //free on treeview destruction
 511
 512     // Disable the pop-up textctrl that enables searching - note that
 513     // the docs specify that even if this disabled (which we are doing)
 514     // the user can still have it through the start-interactive-search
 515     // key binding...either way we want to provide a searchequal callback
 516     // NB: If this is enabled a doubleclick event (activate) gets sent
 517     //     on a successful search
 518     gtk_tree_view_set_search_column(m_treeview, WXLISTBOX_DATACOLUMN);
 519     gtk_tree_view_set_search_equal_func(m_treeview,
 520        (GtkTreeViewSearchEqualFunc) gtk_listbox_searchequal_callback,
 521                                         this,
 522                                         NULL);
 523
 524     gtk_tree_view_set_enable_search(m_treeview, FALSE);
 525
 526
 527     GtkTreeSelection* selection = gtk_tree_view_get_selection( m_treeview );
 528     gtk_tree_selection_set_select_function(selection,
 529                      (GtkTreeSelectionFunc)gtk_listitem_select_cb,
 530                                            this, NULL); //NULL == destroycb
 531
 532     GtkSelectionMode mode;
 533     if (style & wxLB_MULTIPLE)
 534     {
 535         mode = GTK_SELECTION_MULTIPLE;
 536     }
 537     else if (style & wxLB_EXTENDED)
 538     {
 539         mode = GTK_SELECTION_EXTENDED;
 540     }
 541     else
 542     {
 543         // if style was 0 set single mode
 544         m_windowStyle |= wxLB_SINGLE;
 545         mode = GTK_SELECTION_SINGLE;
 546     }
 547
 548     gtk_tree_selection_set_mode( selection, mode );
 549
 550     //Handle sortable stuff
 551     if(style & wxLB_SORT)
 552     {
 553         //Setup sorting in ascending (wx) order
 554         gtk_tree_sortable_set_sort_column_id(GTK_TREE_SORTABLE(m_liststore),
 555                                              WXLISTBOX_DATACOLUMN,
 556                                              GTK_SORT_ASCENDING);
 557
 558         //Set the sort callback
 559         gtk_tree_sortable_set_sort_func(GTK_TREE_SORTABLE(m_liststore),
 560                                         WXLISTBOX_DATACOLUMN,
 561                    (GtkTreeIterCompareFunc) gtk_listbox_sort_callback,
 562                                         this, //userdata
 563                                         NULL //"destroy notifier"
 564                                        );
 565     }
 566
 567
 568     gtk_scrolled_window_add_with_viewport( GTK_SCROLLED_WINDOW(m_widget),
 569                                            GTK_WIDGET(m_treeview) );
 570
 571     /* make list scroll when moving the focus down using cursor keys */
 572     gtk_container_set_focus_vadjustment(
 573         GTK_CONTAINER(m_treeview),
 574         gtk_scrolled_window_get_vadjustment(
 575         GTK_SCROLLED_WINDOW(m_widget)));
 576
 577     gtk_widget_show( GTK_WIDGET(m_treeview) );
 578
 579     wxListBox::DoInsertItems(wxArrayString(n, choices), 0); // insert initial items
 580
 581     //treeview-specific events
 582     g_signal_connect(m_treeview, "row-activated",
 583                      G_CALLBACK(gtk_listbox_row_activated_callback), this);
 584
 585     // other events
 586     g_signal_connect (m_treeview, "button_press_event",
 587                       G_CALLBACK (gtk_listbox_button_press_callback),
 588                       this);
 589     g_signal_connect (m_treeview, "key_press_event",
 590                       G_CALLBACK (gtk_listbox_key_press_callback),
 591                            this);
 592
 593     m_parent->DoAddChild( this );
 594
 595     PostCreation(size);
 596     SetBestSize(size); // need this too because this is a wxControlWithItems
 597
 598     return TRUE;
 599 }
 600
 601 wxListBox::~wxListBox()
 602 {
 603     m_hasVMT = FALSE;
 604
 605     Clear();
 606 }
 607
 608 // ----------------------------------------------------------------------------
 609 // adding items
 610 // ----------------------------------------------------------------------------
 611
 612 void wxListBox::GtkInsertItems(const wxArrayString& items,
 613                         void** clientData, int pos)
 614 {
 615     wxCHECK_RET( m_treeview != NULL, wxT("invalid listbox") );
 616
 617     InvalidateBestSize();
 618
 619     // Create and set column ids and GValues
 620
 621     size_t nNum = items.GetCount();
 622     int nCurCount = wxListBox::GetCount();
 623     wxASSERT_MSG(pos <= nCurCount, wxT("Invalid index passed to wxListBox"));
 624
 625     GtkTreeIter* pIter;
 626     if (pos == nCurCount)
 627     {
 628         pIter = NULL; // append
 629     }
 630     else
 631     {
 632         GtkTreeIter iter;
 633         gboolean res = gtk_tree_model_iter_nth_child(
 634                         GTK_TREE_MODEL(m_liststore),
 635                         &iter, NULL, //NULL = parent = get first
 636                         pos );
 637         if(!res)
 638         {
 639             wxLogSysError(wxT("internal wxListBox error in insertion"));
 640             return;
 641         }
 642
 643         pIter = &iter;
 644     }
 645
 646     for (size_t i = 0; i < nNum; ++i)
 647     {
 648         wxString label = items[i];
 649
 650 #if wxUSE_CHECKLISTBOX && !wxUSE_NATIVEGTKCHECKLIST
 651     if (m_hasCheckBoxes)
 652     {
 653         label.Prepend(wxCHECKLBOX_STRING);
 654     }
 655 #endif // wxUSE_CHECKLISTBOX
 656
 657
 658         GtkTreeEntry* entry = gtk_tree_entry_new();
 659         gtk_tree_entry_set_label(entry, wxConvUTF8.cWX2MB(label));
 660         gtk_tree_entry_set_destroy_func(entry,
 661                 (GtkTreeEntryDestroy)gtk_tree_entry_destroy_cb,
 662                             this);
 663
 664         if (clientData)
 665             gtk_tree_entry_set_userdata(entry, clientData[i]);
 666
 667         GtkTreeIter itercur;
 668         gtk_list_store_insert_before(m_liststore, &itercur, pIter);
 669
 670 #if wxUSE_CHECKLISTBOX && wxUSE_NATIVEGTKCHECKLIST
 671         if (m_hasCheckBoxes)
 672         {
 673             gtk_list_store_set(m_liststore, &itercur,
 674                                  0, FALSE, //FALSE == not toggled
 675                                  1, entry, -1);
 676         }
 677         else
 678 #endif
 679             gtk_list_store_set(m_liststore, &itercur,
 680                                  0, entry, -1);
 681
 682         g_object_unref(G_OBJECT(entry)); //liststore always refs :)
 683     }
 684 }
 685
 686 void wxListBox::DoInsertItems(const wxArrayString& items, int pos)
 687 {
 688     GtkInsertItems(items, NULL, pos);
 689 }
 690
 691 int wxListBox::DoAppend( const wxString& item )
 692 {
 693     InvalidateBestSize();
 694
 695     //Just call DoInsertItems for now
 696     //RN: Originally I had gtk_list_store_append etc.
 697     //    here as an optimization but now the insert
 698     //    has been streamlined and its quite a bit of code duplication
 699     int nWhere = wxListBox::GetCount();
 700     wxArrayString aItems;
 701     aItems.Add(item);
 702     wxListBox::DoInsertItems(aItems, nWhere);
 703     return nWhere;
 704 }
 705
 706 void wxListBox::DoSetItems( const wxArrayString& items,
 707                             void **clientData)
 708 {
 709     Clear();
 710     GtkInsertItems(items, clientData, 0);
 711 }
 712
 713 // ----------------------------------------------------------------------------
 714 // deleting items
 715 // ----------------------------------------------------------------------------
 716
 717 void wxListBox::Clear()
 718 {
 719     wxCHECK_RET( m_treeview != NULL, wxT("invalid listbox") );
 720
 721     gtk_list_store_clear( m_liststore ); /* well, THAT was easy :) */
 722 }
 723
 724 void wxListBox::Delete( int n )
 725 {
 726     wxCHECK_RET( m_treeview != NULL, wxT("invalid listbox") );
 727
 728     GtkTreeIter iter;
 729     gboolean res = gtk_tree_model_iter_nth_child(
 730                         GTK_TREE_MODEL(m_liststore),
 731                         &iter, NULL, //NULL = parent = get first
 732                         n
 733                                                 );
 734
 735     wxCHECK_RET( res, wxT("wrong listbox index") );
 736
 737     //this returns false if iter is invalid (i.e. deleting item
 738     //at end) but since we don't use iter, well... :)
 739     gtk_list_store_remove(m_liststore, &iter);
 740 }
 741
 742 // ----------------------------------------------------------------------------
 743 // get GtkTreeEntry from position (note: you need to g_unref it if valid)
 744 // ----------------------------------------------------------------------------
 745
 746 struct _GtkTreeEntry* wxListBox::GtkGetEntry(int n) const
 747 {
 748     GtkTreeIter iter;
 749     gboolean res = gtk_tree_model_iter_nth_child(
 750                         GTK_TREE_MODEL(m_liststore),
 751                         &iter, NULL, //NULL = parent = get first
 752                         n );
 753
 754     if (!res)
 755     {
 756         wxLogDebug(wxT("gtk_tree_model_iter_nth_child failed\n")
 757                    wxT("Passed in value was:[%i]  List size:[%i]"),
 758                    n, wxListBox::GetCount() );
 759         return NULL;
 760     }
 761
 762
 763     GtkTreeEntry* entry = NULL;
 764     gtk_tree_model_get(GTK_TREE_MODEL(m_liststore), &iter,
 765                        WXLISTBOX_DATACOLUMN, &entry, -1);
 766
 767     return entry;
 768 }
 769
 770 // ----------------------------------------------------------------------------
 771 // client data
 772 // ----------------------------------------------------------------------------
 773
 774 void* wxListBox::DoGetItemClientData( int n ) const
 775 {
 776     wxCHECK_MSG( n >= 0 && n < wxListBox::GetCount(), NULL,
 777                  wxT("Invalid index passed to GetItemClientData") );
 778
 779     GtkTreeEntry* entry = GtkGetEntry(n);
 780     wxCHECK_MSG(entry, NULL, wxT("could not get entry"));
 781
 782     void* userdata = gtk_tree_entry_get_userdata( entry );
 783     g_object_unref(G_OBJECT(entry));
 784     return userdata;
 785 }
 786
 787 wxClientData* wxListBox::DoGetItemClientObject( int n ) const
 788 {
 789     return (wxClientData*) wxListBox::DoGetItemClientData(n);
 790 }
 791
 792 void wxListBox::DoSetItemClientData( int n, void* clientData )
 793 {
 794     wxCHECK_RET( n >= 0 && n < wxListBox::GetCount(),
 795                  wxT("Invalid index passed to SetItemClientData") );
 796
 797     GtkTreeEntry* entry = GtkGetEntry(n);
 798     wxCHECK_RET(entry, wxT("could not get entry"));
 799
 800     gtk_tree_entry_set_userdata( entry, clientData );
 801     g_object_unref(G_OBJECT(entry));
 802 }
 803
 804 void wxListBox::DoSetItemClientObject( int n, wxClientData* clientData )
 805 {
 806     // wxItemContainer already deletes data for us
 807     wxListBox::DoSetItemClientData(n, (void*) clientData);
 808 }
 809
 810 // ----------------------------------------------------------------------------
 811 // string list access
 812 // ----------------------------------------------------------------------------
 813
 814 void wxListBox::SetString( int n, const wxString &string )
 815 {
 816     wxCHECK_RET( m_treeview != NULL, wxT("invalid listbox") );
 817
 818     GtkTreeEntry* entry = GtkGetEntry(n);
 819     wxCHECK_RET( entry, wxT("wrong listbox index") );
 820
 821     wxString label = string;
 822
 823 #if wxUSE_CHECKLISTBOX && !wxUSE_NATIVEGTKCHECKLIST
 824         if (m_hasCheckBoxes)
 825             label.Prepend(wxCHECKLBOX_STRING);
 826 #endif // wxUSE_CHECKLISTBOX
 827
 828     // RN: This may look wierd but the problem is that the TreeView
 829     // doesn't resort or update when changed above and there is no real
 830     // notification function...
 831     void* userdata = gtk_tree_entry_get_userdata(entry);
 832     gtk_tree_entry_set_userdata(entry, NULL); //don't delete on destroy
 833     g_object_unref(G_OBJECT(entry));
 834
 835     bool bWasSelected = wxListBox::IsSelected(n);
 836     wxListBox::Delete(n);
 837
 838     wxArrayString aItems;
 839     aItems.Add(label);
 840     GtkInsertItems(aItems, &userdata, n);
 841     if (bWasSelected)
 842         wxListBox::GtkSetSelection(n, TRUE, TRUE);
 843 }
 844
 845 wxString wxListBox::GetString( int n ) const
 846 {
 847     wxCHECK_MSG( m_treeview != NULL, wxEmptyString, wxT("invalid listbox") );
 848
 849     GtkTreeEntry* entry = GtkGetEntry(n);
 850     wxCHECK_MSG( entry, wxEmptyString, wxT("wrong listbox index") );
 851
 852     wxString label = wxGTK_CONV_BACK( gtk_tree_entry_get_label(entry) );
 853
 854 #if wxUSE_CHECKLISTBOX && !wxUSE_NATIVEGTKCHECKLIST
 855     // checklistboxes have "[±] " prepended to their lables, remove it
 856     //
 857     // NB: 4 below is the length of wxCHECKLBOX_STRING from wx/gtk/checklst.h
 858     if ( m_hasCheckBoxes )
 859         label.erase(0, 4);
 860 #endif // wxUSE_CHECKLISTBOX
 861
 862     g_object_unref(G_OBJECT(entry));
 863     return label;
 864 }
 865
 866 int wxListBox::GetCount() const
 867 {
 868     wxCHECK_MSG( m_treeview != NULL, -1, wxT("invalid listbox") );
 869
 870     return gtk_tree_model_iter_n_children(GTK_TREE_MODEL(m_liststore), NULL);
 871 }
 872
 873 int wxListBox::FindString( const wxString &item, bool bCase ) const
 874 {
 875     wxCHECK_MSG( m_treeview != NULL, wxNOT_FOUND, wxT("invalid listbox") );
 876
 877     //Sort of hackish - maybe there is a faster way
 878     int nCount = wxListBox::GetCount();
 879
 880     for(int i = 0; i < nCount; ++i)
 881     {
 882         if( item.IsSameAs( wxListBox::GetString(i), bCase ) )
 883             return i;
 884     }
 885
 886
 887     // it's not an error if the string is not found -> no wxCHECK
 888     return wxNOT_FOUND;
 889 }
 890
 891 // ----------------------------------------------------------------------------
 892 // selection
 893 // ----------------------------------------------------------------------------
 894
 895 int wxListBox::GetSelection() const
 896 {
 897     wxCHECK_MSG( m_treeview != NULL, -1, wxT("invalid listbox"));
 898     wxCHECK_MSG( HasFlag(wxLB_SINGLE), -1,
 899                     wxT("must be single selection listbox"));
 900
 901     GtkTreeIter iter;
 902     GtkTreeSelection* selection = gtk_tree_view_get_selection(m_treeview);
 903
 904     // only works on single-sel
 905     if (!gtk_tree_selection_get_selected(selection, NULL, &iter))
 906         return -1;
 907
 908     GtkTreePath* path =
 909         gtk_tree_model_get_path(GTK_TREE_MODEL(m_liststore), &iter);
 910
 911     int sel = gtk_tree_path_get_indices(path)[0];
 912
 913     gtk_tree_path_free(path);
 914
 915     return sel;
 916 }
 917
 918 int wxListBox::GetSelections( wxArrayInt& aSelections ) const
 919 {
 920     wxCHECK_MSG( m_treeview != NULL, -1, wxT("invalid listbox") );
 921
 922     aSelections.Empty();
 923
 924         int i = 0;
 925     GtkTreeIter iter;
 926     GtkTreeSelection* selection = gtk_tree_view_get_selection(m_treeview);
 927
 928     if (gtk_tree_model_get_iter_first(GTK_TREE_MODEL(m_liststore), &iter))
 929     { //gtk_tree_selection_get_selected_rows is GTK 2.2+ so iter instead
 930         do
 931         {
 932             if (gtk_tree_selection_iter_is_selected(selection, &iter))
 933                 aSelections.Add(i);
 934
 935             i++;
 936         } while(gtk_tree_model_iter_next(GTK_TREE_MODEL(m_liststore), &iter));
 937     }
 938
 939     return aSelections.GetCount();
 940 }
 941
 942 bool wxListBox::IsSelected( int n ) const
 943 {
 944     wxCHECK_MSG( m_treeview != NULL, FALSE, wxT("invalid listbox") );
 945
 946     GtkTreeSelection* selection = gtk_tree_view_get_selection(m_treeview);
 947
 948     GtkTreeIter iter;
 949     gboolean res = gtk_tree_model_iter_nth_child(
 950                         GTK_TREE_MODEL(m_liststore),
 951                         &iter, NULL, //NULL = parent = get first
 952                         n );
 953
 954     wxCHECK_MSG( res, FALSE, wxT("Invalid index") );
 955
 956     return gtk_tree_selection_iter_is_selected(selection, &iter);
 957 }
 958
 959 void wxListBox::DoSetSelection( int n, bool select )
 960 {
 961     return GtkSetSelection(n, select, TRUE); //docs say no events here
 962 }
 963
 964 void wxListBox::GtkSetSelection(int n, const bool select, const bool blockEvent)
 965 {
 966     wxCHECK_RET( m_treeview != NULL, wxT("invalid listbox") );
 967
 968     GtkTreeSelection* selection = gtk_tree_view_get_selection(m_treeview);
 969
 970     GtkTreeIter iter;
 971     gboolean res = gtk_tree_model_iter_nth_child(
 972                         GTK_TREE_MODEL(m_liststore),
 973                         &iter, NULL, //NULL = parent = get first
 974                         n
 975                                                 );
 976     wxCHECK_RET( res, wxT("Invalid index") );
 977
 978     m_blockEvent = blockEvent;
 979
 980     if (select)
 981         gtk_tree_selection_select_iter(selection, &iter);
 982     else
 983         gtk_tree_selection_unselect_iter(selection, &iter);
 984
 985     m_blockEvent = FALSE;
 986 }
 987
 988 void wxListBox::DoSetFirstItem( int n )
 989 {
 990     wxCHECK_RET( m_treeview, wxT("invalid listbox") );
 991     wxCHECK_RET( n >= 0 && n < wxListBox::GetCount(), wxT("invalid index"));
 992
 993     //RN: I have no idea why this line is needed...
 994     if (gdk_pointer_is_grabbed () && GTK_WIDGET_HAS_GRAB (m_treeview))
 995         return;
 996
 997     // terribly efficient (RN:???)
 998     // RN: Note that evidently the vadjustment property "vadjustment" from
 999     // GtkTreeView is different from the "gtk-vadjustment"...
1000     // (i.e. gtk_tree_view_get_vadjustment)
1001     const gchar *vadjustment_key = "gtk-vadjustment";
1002     guint vadjustment_key_id = g_quark_from_static_string (vadjustment_key);
1003
1004     GtkAdjustment *adjustment =
1005        (GtkAdjustment*) g_object_get_qdata(G_OBJECT (m_treeview), vadjustment_key_id);
1006     wxCHECK_RET( adjustment, wxT("invalid listbox code") );
1007
1008     // Get the greater of the item heights from each column
1009     gint cellheight = 0, cellheightcur;
1010     GList* columnlist = gtk_tree_view_get_columns(m_treeview);
1011     GList* curlist = columnlist;
1012
1013     while(curlist)
1014     {
1015         gtk_tree_view_column_cell_get_size(
1016             GTK_TREE_VIEW_COLUMN(curlist->data),
1017             NULL, NULL, NULL, NULL,
1018             &cellheightcur);
1019
1020         cellheight = cellheightcur > cellheight ?
1021                       cellheightcur : cellheight;
1022
1023         curlist = curlist->next;
1024     }
1025
1026     g_list_free(columnlist);
1027
1028     float y = (float) (cellheight * n);
1029     if (y > adjustment->upper - adjustment->page_size)
1030         y = adjustment->upper - adjustment->page_size;
1031     gtk_adjustment_set_value( adjustment, y );
1032 }
1033
1034
1035 // ----------------------------------------------------------------------------
1036 // helpers
1037 // ----------------------------------------------------------------------------
1038
1039 #if wxUSE_TOOLTIPS
1040 void wxListBox::ApplyToolTip( GtkTooltips *tips, const wxChar *tip )
1041 {
1042     // RN: Is this needed anymore?
1043     gtk_tooltips_set_tip( tips, GTK_WIDGET( m_treeview ), wxGTK_CONV(tip), (gchar*) NULL );
1044 }
1045 #endif // wxUSE_TOOLTIPS
1046
1047 GtkWidget *wxListBox::GetConnectWidget()
1048 {
1049     // return GTK_WIDGET(m_treeview);
1050     return m_widget;
1051 }
1052
1053 bool wxListBox::IsOwnGtkWindow( GdkWindow *window )
1054 {
1055     return (window == GetGtkBinWindow());
1056 }
1057
1058 GdkWindow* wxListBox::GetGtkBinWindow()
1059 {
1060     // GtkTreeView has 2 GdkWindows (just like GtkPizza and
1061     // any other GtkWidget that can scroll). The one on top
1062     // is usually called "->bin_window" and is the one we are
1063     // looking for here. Since GtkTreeView hides this in the
1064     // private data section, we assume that "->window" only has
1065     // one child window, namely, the "->bin_window".
1066
1067     GdkWindow *window = GTK_WIDGET(m_treeview)->window;
1068     if (window == NULL)
1069         return NULL;
1070
1071     GList *children = gdk_window_peek_children( window );
1072     if (g_list_length(children) == 0)
1073         return NULL;
1074
1075     GdkWindow *bin_window = (GdkWindow*) g_list_nth_data( children, 0 );
1076     return bin_window;
1077 }
1078
1079 void wxListBox::DoApplyWidgetStyle(GtkRcStyle *style)
1080 {
1081     if (m_hasBgCol && m_backgroundColour.Ok())
1082     {
1083         GdkWindow *window = GetGtkBinWindow();
1084         if (window)
1085         {
1086             m_backgroundColour.CalcPixel( gdk_window_get_colormap( window ) );
1087             gdk_window_set_background( window, m_backgroundColour.GetColor() );
1088             gdk_window_clear( window );
1089         }
1090     }
1091
1092     gtk_widget_modify_style( GTK_WIDGET(m_treeview), style );
1093 }
1094
1095 void wxListBox::OnInternalIdle()
1096 {
1097     //RN: Is this needed anymore?
1098     wxCursor cursor = m_cursor;
1099     if (g_globalCursor.Ok()) cursor = g_globalCursor;
1100
1101     if (GTK_WIDGET(m_treeview)->window && cursor.Ok())
1102     {
1103         /* I now set the cursor the anew in every OnInternalIdle call
1104            as setting the cursor in a parent window also effects the
1105            windows above so that checking for the current cursor is
1106            not possible. */
1107         GdkWindow *window = GetGtkBinWindow();
1108         gdk_window_set_cursor( window, cursor.GetCursor() );
1109     }
1110
1111     if (wxUpdateUIEvent::CanUpdate(this))
1112         UpdateWindowUI(wxUPDATE_UI_FROMIDLE);
1113 }
1114
1115 wxSize wxListBox::DoGetBestSize() const
1116 {
1117     wxCHECK_MSG(m_treeview, wxDefaultSize, wxT("invalid tree view"));
1118
1119     int lbWidth;
1120     int lbHeight;
1121
1122     // Get the visible area of the tree view
1123     GdkRectangle rect;
1124     gtk_tree_view_get_visible_rect(m_treeview, &rect);
1125     lbWidth = rect.width;
1126     lbHeight = rect.height;
1127
1128     // Add room for the scrollbar
1129     lbWidth += wxSystemSettings::GetMetric(wxSYS_VSCROLL_X);
1130
1131     // And just a bit more
1132     int cx, cy;
1133     GetTextExtent( wxT("X"), &cx, &cy);
1134     lbWidth += 3 * cx;
1135
1136     // don't make the listbox too tall (limit height to around 10 items) but don't
1137     // make it too small neither
1138     lbHeight = (cy+4) * wxMin(wxMax(GetCount(), 3), 10);
1139
1140     wxSize best(lbWidth, lbHeight);
1141     CacheBestSize(best);
1142     return best;
1143 }
1144
1145 // static
1146 wxVisualAttributes
1147 wxListBox::GetClassDefaultAttributes(wxWindowVariant WXUNUSED(variant))
1148 {
1149     return GetDefaultAttributesFromGTKWidget(gtk_tree_view_new, true);
1150 }
1151
1152 #endif // wxUSE_LISTBOX