man Gtk2::ComboBox () - A widget used to choose from a list of items


Gtk2::ComboBox - A widget used to choose from a list of items


  # the easy way:
  $combobox = Gtk2::ComboBox->new_text;
  foreach (@strings) {
      $combobox->append_text ($_);
  $combobox->prepend_text ($another_string);
  $combobox->insert_text ($index, $yet_another_string);
  $combobox->remove_text ($index);
  $text = $combobox->get_active_text;

  # the full-featured way.  
  # a combo box that shows stock ids and their images:
  use constant ID_COLUMN => 0;
  $model = Gtk2::ListStore->new ('Glib::String');
  foreach (qw(gtk-ok gtk-cancel gtk-yes gtk-no gtk-save gtk-open)) {
      $model->set ($model->append, ID_COLUMN, $_);
  $combo_box = Gtk2::ComboBox->new ($model);
  # to display anything, you must pack cell renderers into
  # the combobox, which implements the Gtk2::CellLayout interface.
  $renderer = Gtk2::CellRendererPixbuf->new;
  $combo_box->pack_start ($renderer, FALSE);
  $combo_box->add_attribute ($renderer, stock_id => ID_COLUMN);
  $renderer = Gtk2::CellRendererText->new;
  $combo_box->pack_start ($renderer, TRUE);
  $combo_box->add_attribute ($renderer, text => ID_COLUMN);

  # select by index
  $combo_box->set_active ($index);
  $active_index = $combo_box->get_active;

  # or by iter
  $combo_box->set_active_iter ($iter);
  $active_iter = $combo_box->get_active_iter;


Gtk2::ComboBox is a widget that allows the user to choose from a list of valid choices. The ComboBox displays the selected choice. When activated, the ComboBox displays a popup which allows the user to make a new choice.

Unlike its predecessors Gtk2::Combo and Gtk2::OptionMenu, the Gtk2::ComboBox uses the model-view pattern; the list of valid choices is specified in the form of a tree model, and the display of the choices can be adapted to the data in the model by using cell renderers, as you would in a tree view. This is possible since ComboBox implements the Gtk2::CellLayout interface. The tree model holding the valid choices is not restricted to a flat list; it can be a real tree, and the popup will reflect the tree structure.

In addition to the model-view API, ComboBox offers a simple API which is suitable for text-only combo boxes, and hides the complexity of managing the data in a model. It consists of the methods CWnew_text, CWappend_text, CWinsert_text, CWprepend_text, CWremove_text and CWget_active_text.






widget = Gtk2::ComboBox->new ($model=undef)

widget = Gtk2::ComboBox->new_text

widget = Gtk2::ComboBox->new_with_model ($model=undef)

$combo_box->set_active_iter ($iter)

$combo_box->set_active ($index)

$combo_box->set_add_tearoffs ($add_tearoffs)

$combo_box->append_text ($text)

$combo_box->set_column_span_column ($column_span)

$combo_box->set_focus_on_click ($focus_on_click)

$combo_box->set_model ($model)



$combo_box->prepend_text ($text)

$combo_box->remove_text ($position)

$combo_box->set_row_span_column ($row_span)

$combo_box->set_wrap_width ($width)


'active' (integer : readable / writable / private)
The item which is currently active
'add-tearoffs' (boolean : readable / writable / private)
Whether dropdowns should have a tearoff menu item
'column-span-column' (integer : readable / writable / private)
TreeModel column containing the column span values
'focus-on-click' (boolean : readable / writable / private)
Whether the combo box grabs focus when it is clicked with the mouse
'has-frame' (boolean : readable / writable / private)
Whether the combo box draws a frame around the child
'model' (Gtk2::TreeModel : readable / writable / private)
The model for the combo box
'row-span-column' (integer : readable / writable / private)
TreeModel column containing the row span values
'wrap-width' (integer : readable / writable / private)
Wrap width for layouting the items in a grid


changed (Gtk2::ComboBox)


Gtk2, Glib::Object, Glib::Object::_Unregistered::GInitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin


Copyright (C) 2003-2005 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.