2 * Copyright (C) 2002, 2003 Kristian Rietveld <kris@gtk.org>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 #include "gtkcombobox.h"
24 #include "gtkbindings.h"
25 #include "gtkcelllayout.h"
26 #include "gtkcellrenderertext.h"
27 #include "gtkcellview.h"
28 #include "gtkeventbox.h"
31 #include "gtkliststore.h"
34 #include "gtkscrolledwindow.h"
35 #include "gtkseparatormenuitem.h"
36 #include "gtktearoffmenuitem.h"
37 #include "gtktogglebutton.h"
38 #include "gtktreeselection.h"
39 #include "gtkvseparator.h"
40 #include "gtkwindow.h"
41 #include "gtkprivate.h"
43 #include <gdk/gdkkeysyms.h>
45 #include <gobject/gvaluecollector.h>
50 #include "gtkmarshalers.h"
53 #include "gtktreeprivate.h"
56 /* WELCOME, to THE house of evil code */
58 typedef struct _ComboCellInfo ComboCellInfo;
61 GtkCellRenderer *cell;
64 GtkCellLayoutDataFunc func;
66 GDestroyNotify destroy;
72 #define GTK_COMBO_BOX_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_COMBO_BOX, GtkComboBoxPrivate))
74 struct _GtkComboBoxPrivate
83 GtkTreeRowReference *active_row;
86 GtkTreeViewColumn *column;
89 GtkWidget *cell_view_frame;
96 GtkWidget *popup_widget;
97 GtkWidget *popup_window;
98 GtkWidget *popup_frame;
99 GtkWidget *scrolled_window;
107 guint resize_idle_id;
113 guint popup_in_progress : 1;
114 guint popup_shown : 1;
115 guint add_tearoffs : 1;
117 guint is_cell_renderer : 1;
118 guint editing_canceled : 1;
119 guint auto_scroll : 1;
120 guint focus_on_click : 1;
122 GtkTreeViewRowSeparatorFunc row_separator_func;
123 gpointer row_separator_data;
124 GtkDestroyNotify row_separator_destroy;
126 gchar *tearoff_title;
129 /* While debugging this evil code, I have learned that
130 * there are actually 4 modes to this widget, which can
131 * be characterized as follows
133 * 1) menu mode, no child added
136 * cell_view -> GtkCellView, regular child
137 * cell_view_frame -> NULL
138 * button -> GtkToggleButton set_parent to combo
139 * arrow -> GtkArrow set_parent to button
140 * separator -> GtkVSepator set_parent to button
141 * popup_widget -> GtkMenu
142 * popup_window -> NULL
143 * popup_frame -> NULL
144 * scrolled_window -> NULL
146 * 2) menu mode, child added
150 * cell_view_frame -> NULL
151 * button -> GtkToggleButton set_parent to combo
152 * arrow -> GtkArrow, child of button
154 * popup_widget -> GtkMenu
155 * popup_window -> NULL
156 * popup_frame -> NULL
157 * scrolled_window -> NULL
159 * 3) list mode, no child added
161 * tree_view -> GtkTreeView, child of popup_frame
162 * cell_view -> GtkCellView, regular child
163 * cell_view_frame -> GtkFrame, set parent to combo
164 * button -> GtkToggleButton, set_parent to combo
165 * arrow -> GtkArrow, child of button
167 * popup_widget -> tree_view
168 * popup_window -> GtkWindow
169 * popup_frame -> GtkFrame, child of popup_window
170 * scrolled_window -> GtkScrolledWindow, child of popup_frame
172 * 4) list mode, child added
174 * tree_view -> GtkTreeView, child of popup_frame
176 * cell_view_frame -> NULL
177 * button -> GtkToggleButton, set_parent to combo
178 * arrow -> GtkArrow, child of button
180 * popup_widget -> tree_view
181 * popup_window -> GtkWindow
182 * popup_frame -> GtkFrame, child of popup_window
183 * scrolled_window -> GtkScrolledWindow, child of popup_frame
196 PROP_ROW_SPAN_COLUMN,
197 PROP_COLUMN_SPAN_COLUMN,
206 static guint combo_box_signals[LAST_SIGNAL] = {0,};
208 #define BONUS_PADDING 4
209 #define SCROLL_TIME 100
213 static void gtk_combo_box_cell_layout_init (GtkCellLayoutIface *iface);
214 static void gtk_combo_box_cell_editable_init (GtkCellEditableIface *iface);
215 static void gtk_combo_box_finalize (GObject *object);
216 static void gtk_combo_box_destroy (GtkObject *object);
218 static void gtk_combo_box_set_property (GObject *object,
222 static void gtk_combo_box_get_property (GObject *object,
227 static void gtk_combo_box_state_changed (GtkWidget *widget,
228 GtkStateType previous);
229 static void gtk_combo_box_grab_focus (GtkWidget *widget);
230 static void gtk_combo_box_style_set (GtkWidget *widget,
232 static void gtk_combo_box_button_toggled (GtkWidget *widget,
234 static void gtk_combo_box_button_state_changed (GtkWidget *widget,
235 GtkStateType previous,
237 static void gtk_combo_box_add (GtkContainer *container,
239 static void gtk_combo_box_remove (GtkContainer *container,
242 static ComboCellInfo *gtk_combo_box_get_cell_info (GtkComboBox *combo_box,
243 GtkCellRenderer *cell);
245 static void gtk_combo_box_menu_show (GtkWidget *menu,
247 static void gtk_combo_box_menu_hide (GtkWidget *menu,
250 static void gtk_combo_box_set_popup_widget (GtkComboBox *combo_box,
252 static void gtk_combo_box_menu_position_below (GtkMenu *menu,
257 static void gtk_combo_box_menu_position_over (GtkMenu *menu,
262 static void gtk_combo_box_menu_position (GtkMenu *menu,
268 static gint gtk_combo_box_calc_requested_width (GtkComboBox *combo_box,
270 static void gtk_combo_box_remeasure (GtkComboBox *combo_box);
272 static void gtk_combo_box_unset_model (GtkComboBox *combo_box);
274 static void gtk_combo_box_size_request (GtkWidget *widget,
275 GtkRequisition *requisition);
276 static void gtk_combo_box_size_allocate (GtkWidget *widget,
277 GtkAllocation *allocation);
278 static void gtk_combo_box_forall (GtkContainer *container,
279 gboolean include_internals,
280 GtkCallback callback,
281 gpointer callback_data);
282 static gboolean gtk_combo_box_expose_event (GtkWidget *widget,
283 GdkEventExpose *event);
284 static gboolean gtk_combo_box_scroll_event (GtkWidget *widget,
285 GdkEventScroll *event);
286 static void gtk_combo_box_set_active_internal (GtkComboBox *combo_box,
288 static gboolean gtk_combo_box_key_press (GtkWidget *widget,
292 static void gtk_combo_box_check_appearance (GtkComboBox *combo_box);
293 static gchar * gtk_combo_box_real_get_active_text (GtkComboBox *combo_box);
295 /* listening to the model */
296 static void gtk_combo_box_model_row_inserted (GtkTreeModel *model,
300 static void gtk_combo_box_model_row_deleted (GtkTreeModel *model,
303 static void gtk_combo_box_model_rows_reordered (GtkTreeModel *model,
308 static void gtk_combo_box_model_row_changed (GtkTreeModel *model,
312 static void gtk_combo_box_model_row_expanded (GtkTreeModel *model,
318 static void gtk_combo_box_list_position (GtkComboBox *combo_box,
323 static void gtk_combo_box_list_setup (GtkComboBox *combo_box);
324 static void gtk_combo_box_list_destroy (GtkComboBox *combo_box);
326 static gboolean gtk_combo_box_list_button_released (GtkWidget *widget,
327 GdkEventButton *event,
329 static gboolean gtk_combo_box_list_key_press (GtkWidget *widget,
332 static gboolean gtk_combo_box_list_enter_notify (GtkWidget *widget,
333 GdkEventCrossing *event,
335 static void gtk_combo_box_list_auto_scroll (GtkComboBox *combo,
338 static gboolean gtk_combo_box_list_scroll_timeout (GtkComboBox *combo);
339 static gboolean gtk_combo_box_list_button_pressed (GtkWidget *widget,
340 GdkEventButton *event,
343 static gboolean gtk_combo_box_list_select_func (GtkTreeSelection *selection,
346 gboolean path_currently_selected,
349 static void gtk_combo_box_list_row_changed (GtkTreeModel *model,
353 static void gtk_combo_box_list_popup_resize (GtkComboBox *combo_box);
356 static void gtk_combo_box_menu_setup (GtkComboBox *combo_box,
357 gboolean add_children);
358 static void gtk_combo_box_menu_fill (GtkComboBox *combo_box);
359 static void gtk_combo_box_menu_fill_level (GtkComboBox *combo_box,
362 static void gtk_combo_box_update_title (GtkComboBox *combo_box);
363 static void gtk_combo_box_menu_destroy (GtkComboBox *combo_box);
365 static void gtk_combo_box_relayout_item (GtkComboBox *combo_box,
369 static void gtk_combo_box_relayout (GtkComboBox *combo_box);
371 static gboolean gtk_combo_box_menu_button_press (GtkWidget *widget,
372 GdkEventButton *event,
374 static void gtk_combo_box_menu_item_activate (GtkWidget *item,
376 static void gtk_combo_box_menu_row_inserted (GtkTreeModel *model,
380 static void gtk_combo_box_menu_row_deleted (GtkTreeModel *model,
383 static void gtk_combo_box_menu_rows_reordered (GtkTreeModel *model,
388 static void gtk_combo_box_menu_row_changed (GtkTreeModel *model,
392 static gboolean gtk_combo_box_menu_key_press (GtkWidget *widget,
395 static void gtk_combo_box_menu_popup (GtkComboBox *combo_box,
397 guint32 activate_time);
398 static GtkWidget *gtk_cell_view_menu_item_new (GtkComboBox *combo_box,
403 static void gtk_combo_box_cell_layout_pack_start (GtkCellLayout *layout,
404 GtkCellRenderer *cell,
406 static void gtk_combo_box_cell_layout_pack_end (GtkCellLayout *layout,
407 GtkCellRenderer *cell,
409 static void gtk_combo_box_cell_layout_clear (GtkCellLayout *layout);
410 static void gtk_combo_box_cell_layout_add_attribute (GtkCellLayout *layout,
411 GtkCellRenderer *cell,
412 const gchar *attribute,
414 static void gtk_combo_box_cell_layout_set_cell_data_func (GtkCellLayout *layout,
415 GtkCellRenderer *cell,
416 GtkCellLayoutDataFunc func,
418 GDestroyNotify destroy);
419 static void gtk_combo_box_cell_layout_clear_attributes (GtkCellLayout *layout,
420 GtkCellRenderer *cell);
421 static void gtk_combo_box_cell_layout_reorder (GtkCellLayout *layout,
422 GtkCellRenderer *cell,
424 static gboolean gtk_combo_box_mnemonic_activate (GtkWidget *widget,
425 gboolean group_cycling);
427 static void gtk_combo_box_sync_cells (GtkComboBox *combo_box,
428 GtkCellLayout *cell_layout);
429 static void combo_cell_data_func (GtkCellLayout *cell_layout,
430 GtkCellRenderer *cell,
431 GtkTreeModel *tree_model,
434 static void gtk_combo_box_child_show (GtkWidget *widget,
435 GtkComboBox *combo_box);
436 static void gtk_combo_box_child_hide (GtkWidget *widget,
437 GtkComboBox *combo_box);
440 /* GtkCellEditable method implementations */
441 static void gtk_combo_box_start_editing (GtkCellEditable *cell_editable,
445 G_DEFINE_TYPE_WITH_CODE (GtkComboBox, gtk_combo_box, GTK_TYPE_BIN,
446 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
447 gtk_combo_box_cell_layout_init)
448 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_EDITABLE,
449 gtk_combo_box_cell_editable_init))
453 gtk_combo_box_class_init (GtkComboBoxClass *klass)
455 GObjectClass *object_class;
456 GtkObjectClass *gtk_object_class;
457 GtkContainerClass *container_class;
458 GtkWidgetClass *widget_class;
460 klass->get_active_text = gtk_combo_box_real_get_active_text;
462 container_class = (GtkContainerClass *)klass;
463 container_class->forall = gtk_combo_box_forall;
464 container_class->add = gtk_combo_box_add;
465 container_class->remove = gtk_combo_box_remove;
467 widget_class = (GtkWidgetClass *)klass;
468 widget_class->size_allocate = gtk_combo_box_size_allocate;
469 widget_class->size_request = gtk_combo_box_size_request;
470 widget_class->expose_event = gtk_combo_box_expose_event;
471 widget_class->scroll_event = gtk_combo_box_scroll_event;
472 widget_class->mnemonic_activate = gtk_combo_box_mnemonic_activate;
473 widget_class->grab_focus = gtk_combo_box_grab_focus;
474 widget_class->style_set = gtk_combo_box_style_set;
475 widget_class->state_changed = gtk_combo_box_state_changed;
477 gtk_object_class = (GtkObjectClass *)klass;
478 gtk_object_class->destroy = gtk_combo_box_destroy;
480 object_class = (GObjectClass *)klass;
481 object_class->finalize = gtk_combo_box_finalize;
482 object_class->set_property = gtk_combo_box_set_property;
483 object_class->get_property = gtk_combo_box_get_property;
487 * GtkComboBox::changed:
488 * @widget: the object which received the signal
490 * The changed signal is emitted when the active
491 * item is changed. The can be due to the user selecting
492 * a different item from the list, or due to a
493 * call to gtk_combo_box_set_active_iter().
494 * It will also be emitted while typing into a GtkComboBoxEntry,
495 * as well as when selecting an item from the GtkComboBoxEntry's list.
499 combo_box_signals[CHANGED] =
500 g_signal_new (I_("changed"),
501 G_OBJECT_CLASS_TYPE (klass),
503 G_STRUCT_OFFSET (GtkComboBoxClass, changed),
505 g_cclosure_marshal_VOID__VOID,
512 * The model from which the combo box takes the values shown
517 g_object_class_install_property (object_class,
519 g_param_spec_object ("model",
520 P_("ComboBox model"),
521 P_("The model for the combo box"),
523 GTK_PARAM_READWRITE));
526 * GtkComboBox:wrap-width:
528 * If wrap-width is set to a positive value, the list will be
529 * displayed in multiple columns, the number of columns is
530 * determined by wrap-width.
534 g_object_class_install_property (object_class,
536 g_param_spec_int ("wrap-width",
538 P_("Wrap width for laying out the items in a grid"),
542 GTK_PARAM_READWRITE));
546 * GtkComboBox:row-span-column:
548 * If this is set to a non-negative value, it must be the index of a column
549 * of type %G_TYPE_INT in the model.
551 * The values of that column are used to determine how many rows a value
552 * in the list will span. Therefore, the values in the model column pointed
553 * to by this property must be greater than zero and not larger than wrap-width.
557 g_object_class_install_property (object_class,
558 PROP_ROW_SPAN_COLUMN,
559 g_param_spec_int ("row-span-column",
560 P_("Row span column"),
561 P_("TreeModel column containing the row span values"),
565 GTK_PARAM_READWRITE));
569 * GtkComboBox:column-span-column:
571 * If this is set to a non-negative value, it must be the index of a column
572 * of type %G_TYPE_INT in the model.
574 * The values of that column are used to determine how many columns a value
575 * in the list will span.
579 g_object_class_install_property (object_class,
580 PROP_COLUMN_SPAN_COLUMN,
581 g_param_spec_int ("column-span-column",
582 P_("Column span column"),
583 P_("TreeModel column containing the column span values"),
587 GTK_PARAM_READWRITE));
591 * GtkComboBox:active:
593 * The item which is currently active. If the model is a non-flat treemodel,
594 * and the active item is not an immediate child of the root of the tree,
595 * this property has the value <literal>gtk_tree_path_get_indices (path)[0]</literal>,
596 * where <literal>path</literal> is the #GtkTreePath of the active item.
600 g_object_class_install_property (object_class,
602 g_param_spec_int ("active",
604 P_("The item which is currently active"),
608 GTK_PARAM_READWRITE));
611 * GtkComboBox:add-tearoffs:
613 * The add-tearoffs property controls whether generated menus
614 * have tearoff menu items.
616 * Note that this only affects menu style combo boxes.
620 g_object_class_install_property (object_class,
622 g_param_spec_boolean ("add-tearoffs",
623 P_("Add tearoffs to menus"),
624 P_("Whether dropdowns should have a tearoff menu item"),
626 GTK_PARAM_READWRITE));
629 * GtkComboBox:has-frame:
631 * The has-frame property controls whether a frame
632 * is drawn around the entry.
636 g_object_class_install_property (object_class,
638 g_param_spec_boolean ("has-frame",
640 P_("Whether the combo box draws a frame around the child"),
642 GTK_PARAM_READWRITE));
644 g_object_class_install_property (object_class,
646 g_param_spec_boolean ("focus-on-click",
647 P_("Focus on click"),
648 P_("Whether the combo box grabs focus when it is clicked with the mouse"),
650 GTK_PARAM_READWRITE));
653 * GtkComboBox:tearoff-title:
655 * A title that may be displayed by the window manager
656 * when the popup is torn-off.
660 g_object_class_install_property (object_class,
662 g_param_spec_string ("tearoff-title",
664 P_("A title that may be displayed by the window manager when the popup is torn-off"),
666 GTK_PARAM_READWRITE));
670 * GtkComboBox:popup-shown:
672 * Whether the combo boxes dropdown is popped up.
673 * Note that this property is mainly useful, because
674 * it allows you to connect to notify::popup-shown.
678 g_object_class_install_property (object_class,
680 g_param_spec_boolean ("popup-shown",
682 P_("Whether the combo's dropdown is shown"),
684 GTK_PARAM_READABLE));
686 gtk_widget_class_install_style_property (widget_class,
687 g_param_spec_boolean ("appears-as-list",
688 P_("Appears as list"),
689 P_("Whether dropdowns should look like lists rather than menus"),
691 GTK_PARAM_READABLE));
693 g_type_class_add_private (object_class, sizeof (GtkComboBoxPrivate));
697 gtk_combo_box_cell_layout_init (GtkCellLayoutIface *iface)
699 iface->pack_start = gtk_combo_box_cell_layout_pack_start;
700 iface->pack_end = gtk_combo_box_cell_layout_pack_end;
701 iface->clear = gtk_combo_box_cell_layout_clear;
702 iface->add_attribute = gtk_combo_box_cell_layout_add_attribute;
703 iface->set_cell_data_func = gtk_combo_box_cell_layout_set_cell_data_func;
704 iface->clear_attributes = gtk_combo_box_cell_layout_clear_attributes;
705 iface->reorder = gtk_combo_box_cell_layout_reorder;
709 gtk_combo_box_cell_editable_init (GtkCellEditableIface *iface)
711 iface->start_editing = gtk_combo_box_start_editing;
715 gtk_combo_box_init (GtkComboBox *combo_box)
717 combo_box->priv = GTK_COMBO_BOX_GET_PRIVATE (combo_box);
719 combo_box->priv->cell_view = gtk_cell_view_new ();
720 gtk_widget_set_parent (combo_box->priv->cell_view, GTK_WIDGET (combo_box));
721 GTK_BIN (combo_box)->child = combo_box->priv->cell_view;
722 gtk_widget_show (combo_box->priv->cell_view);
724 combo_box->priv->width = 0;
725 combo_box->priv->height = 0;
726 combo_box->priv->wrap_width = 0;
728 combo_box->priv->active_row = NULL;
729 combo_box->priv->col_column = -1;
730 combo_box->priv->row_column = -1;
732 combo_box->priv->popup_shown = FALSE;
733 combo_box->priv->add_tearoffs = FALSE;
734 combo_box->priv->has_frame = TRUE;
735 combo_box->priv->is_cell_renderer = FALSE;
736 combo_box->priv->editing_canceled = FALSE;
737 combo_box->priv->auto_scroll = FALSE;
738 combo_box->priv->focus_on_click = TRUE;
740 gtk_combo_box_check_appearance (combo_box);
744 gtk_combo_box_set_property (GObject *object,
749 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
754 gtk_combo_box_set_model (combo_box, g_value_get_object (value));
757 case PROP_WRAP_WIDTH:
758 gtk_combo_box_set_wrap_width (combo_box, g_value_get_int (value));
761 case PROP_ROW_SPAN_COLUMN:
762 gtk_combo_box_set_row_span_column (combo_box, g_value_get_int (value));
765 case PROP_COLUMN_SPAN_COLUMN:
766 gtk_combo_box_set_column_span_column (combo_box, g_value_get_int (value));
770 gtk_combo_box_set_active (combo_box, g_value_get_int (value));
773 case PROP_ADD_TEAROFFS:
774 gtk_combo_box_set_add_tearoffs (combo_box, g_value_get_boolean (value));
778 combo_box->priv->has_frame = g_value_get_boolean (value);
781 case PROP_FOCUS_ON_CLICK:
782 gtk_combo_box_set_focus_on_click (combo_box,
783 g_value_get_boolean (value));
786 case PROP_TEAROFF_TITLE:
787 gtk_combo_box_set_title (combo_box, g_value_get_string (value));
790 case PROP_POPUP_SHOWN:
791 if (g_value_get_boolean (value))
793 gtk_combo_box_popup (combo_box);
797 gtk_combo_box_popdown (combo_box);
807 gtk_combo_box_get_property (GObject *object,
812 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
817 g_value_set_object (value, combo_box->priv->model);
820 case PROP_WRAP_WIDTH:
821 g_value_set_int (value, combo_box->priv->wrap_width);
824 case PROP_ROW_SPAN_COLUMN:
825 g_value_set_int (value, combo_box->priv->row_column);
828 case PROP_COLUMN_SPAN_COLUMN:
829 g_value_set_int (value, combo_box->priv->col_column);
833 g_value_set_int (value, gtk_combo_box_get_active (combo_box));
836 case PROP_ADD_TEAROFFS:
837 g_value_set_boolean (value, gtk_combo_box_get_add_tearoffs (combo_box));
841 g_value_set_boolean (value, combo_box->priv->has_frame);
844 case PROP_FOCUS_ON_CLICK:
845 g_value_set_boolean (value, combo_box->priv->focus_on_click);
848 case PROP_TEAROFF_TITLE:
849 g_value_set_string (value, gtk_combo_box_get_title (combo_box));
852 case PROP_POPUP_SHOWN:
853 g_value_set_boolean (value, combo_box->priv->popup_shown);
857 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
863 gtk_combo_box_state_changed (GtkWidget *widget,
864 GtkStateType previous)
866 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
868 if (GTK_WIDGET_REALIZED (widget))
870 if (combo_box->priv->tree_view && combo_box->priv->cell_view)
871 gtk_cell_view_set_background_color (GTK_CELL_VIEW (combo_box->priv->cell_view),
872 &widget->style->base[GTK_WIDGET_STATE (widget)]);
875 gtk_widget_queue_draw (widget);
879 gtk_combo_box_button_state_changed (GtkWidget *widget,
880 GtkStateType previous,
883 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
885 if (GTK_WIDGET_REALIZED (widget))
887 if (!combo_box->priv->tree_view && combo_box->priv->cell_view)
889 if ((GTK_WIDGET_STATE (widget) == GTK_STATE_INSENSITIVE) !=
890 (GTK_WIDGET_STATE (combo_box->priv->cell_view) == GTK_STATE_INSENSITIVE))
891 gtk_widget_set_sensitive (combo_box->priv->cell_view, GTK_WIDGET_SENSITIVE (widget));
893 gtk_widget_set_state (combo_box->priv->cell_view,
894 GTK_WIDGET_STATE (widget));
899 gtk_widget_queue_draw (widget);
903 gtk_combo_box_check_appearance (GtkComboBox *combo_box)
905 gboolean appears_as_list;
907 /* if wrap_width > 0, then we are in grid-mode and forced to use
910 if (combo_box->priv->wrap_width)
911 appears_as_list = FALSE;
913 gtk_widget_style_get (GTK_WIDGET (combo_box),
914 "appears-as-list", &appears_as_list,
919 /* Destroy all the menu mode widgets, if they exist. */
920 if (GTK_IS_MENU (combo_box->priv->popup_widget))
921 gtk_combo_box_menu_destroy (combo_box);
923 /* Create the list mode widgets, if they don't already exist. */
924 if (!GTK_IS_TREE_VIEW (combo_box->priv->tree_view))
925 gtk_combo_box_list_setup (combo_box);
929 /* Destroy all the list mode widgets, if they exist. */
930 if (GTK_IS_TREE_VIEW (combo_box->priv->tree_view))
931 gtk_combo_box_list_destroy (combo_box);
933 /* Create the menu mode widgets, if they don't already exist. */
934 if (!GTK_IS_MENU (combo_box->priv->popup_widget))
935 gtk_combo_box_menu_setup (combo_box, TRUE);
940 gtk_combo_box_style_set (GtkWidget *widget,
943 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
945 gtk_combo_box_check_appearance (combo_box);
947 if (combo_box->priv->tree_view && combo_box->priv->cell_view)
948 gtk_cell_view_set_background_color (GTK_CELL_VIEW (combo_box->priv->cell_view),
949 &widget->style->base[GTK_WIDGET_STATE (widget)]);
953 gtk_combo_box_button_toggled (GtkWidget *widget,
956 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
958 if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (widget)))
960 if (!combo_box->priv->popup_in_progress)
961 gtk_combo_box_popup (combo_box);
964 gtk_combo_box_popdown (combo_box);
968 gtk_combo_box_add (GtkContainer *container,
971 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
973 if (combo_box->priv->cell_view && combo_box->priv->cell_view->parent)
975 gtk_widget_unparent (combo_box->priv->cell_view);
976 GTK_BIN (container)->child = NULL;
977 gtk_widget_queue_resize (GTK_WIDGET (container));
980 gtk_widget_set_parent (widget, GTK_WIDGET (container));
981 GTK_BIN (container)->child = widget;
983 if (combo_box->priv->cell_view &&
984 widget != combo_box->priv->cell_view)
986 /* since the cell_view was unparented, it's gone now */
987 combo_box->priv->cell_view = NULL;
989 if (!combo_box->priv->tree_view && combo_box->priv->separator)
991 gtk_container_remove (GTK_CONTAINER (combo_box->priv->separator->parent),
992 combo_box->priv->separator);
993 combo_box->priv->separator = NULL;
995 gtk_widget_queue_resize (GTK_WIDGET (container));
997 else if (combo_box->priv->cell_view_frame)
999 gtk_widget_unparent (combo_box->priv->cell_view_frame);
1000 combo_box->priv->cell_view_frame = NULL;
1001 combo_box->priv->box = NULL;
1007 gtk_combo_box_remove (GtkContainer *container,
1010 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
1012 gboolean appears_as_list;
1014 gtk_widget_unparent (widget);
1015 GTK_BIN (container)->child = NULL;
1017 if (GTK_OBJECT_FLAGS (combo_box) & GTK_IN_DESTRUCTION)
1020 gtk_widget_queue_resize (GTK_WIDGET (container));
1022 if (!combo_box->priv->tree_view)
1023 appears_as_list = FALSE;
1025 appears_as_list = TRUE;
1027 if (appears_as_list)
1028 gtk_combo_box_list_destroy (combo_box);
1029 else if (GTK_IS_MENU (combo_box->priv->popup_widget))
1031 gtk_combo_box_menu_destroy (combo_box);
1032 gtk_menu_detach (GTK_MENU (combo_box->priv->popup_widget));
1033 combo_box->priv->popup_widget = NULL;
1036 if (!combo_box->priv->cell_view)
1038 combo_box->priv->cell_view = gtk_cell_view_new ();
1039 gtk_widget_set_parent (combo_box->priv->cell_view, GTK_WIDGET (container));
1040 GTK_BIN (container)->child = combo_box->priv->cell_view;
1042 gtk_widget_show (combo_box->priv->cell_view);
1043 gtk_cell_view_set_model (GTK_CELL_VIEW (combo_box->priv->cell_view),
1044 combo_box->priv->model);
1045 gtk_combo_box_sync_cells (combo_box, GTK_CELL_LAYOUT (combo_box->priv->cell_view));
1049 if (appears_as_list)
1050 gtk_combo_box_list_setup (combo_box);
1052 gtk_combo_box_menu_setup (combo_box, TRUE);
1054 if (gtk_tree_row_reference_valid (combo_box->priv->active_row))
1056 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
1057 gtk_combo_box_set_active_internal (combo_box, path);
1058 gtk_tree_path_free (path);
1061 gtk_combo_box_set_active_internal (combo_box, NULL);
1064 static ComboCellInfo *
1065 gtk_combo_box_get_cell_info (GtkComboBox *combo_box,
1066 GtkCellRenderer *cell)
1070 for (i = combo_box->priv->cells; i; i = i->next)
1072 ComboCellInfo *info = (ComboCellInfo *)i->data;
1074 if (info && info->cell == cell)
1082 gtk_combo_box_menu_show (GtkWidget *menu,
1085 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1087 gtk_combo_box_child_show (menu, user_data);
1089 combo_box->priv->popup_in_progress = TRUE;
1090 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (combo_box->priv->button),
1092 combo_box->priv->popup_in_progress = FALSE;
1096 gtk_combo_box_menu_hide (GtkWidget *menu,
1099 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1101 gtk_combo_box_child_hide(menu,user_data);
1103 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (combo_box->priv->button),
1108 gtk_combo_box_detacher (GtkWidget *widget,
1111 GtkComboBox *combo_box;
1113 g_return_if_fail (GTK_IS_COMBO_BOX (widget));
1115 combo_box = GTK_COMBO_BOX (widget);
1116 g_return_if_fail (combo_box->priv->popup_widget == (GtkWidget*) menu);
1118 g_signal_handlers_disconnect_by_func (menu->toplevel,
1119 gtk_combo_box_menu_show,
1121 g_signal_handlers_disconnect_by_func (menu->toplevel,
1122 gtk_combo_box_menu_hide,
1125 combo_box->priv->popup_widget = NULL;
1129 gtk_combo_box_set_popup_widget (GtkComboBox *combo_box,
1132 if (GTK_IS_MENU (combo_box->priv->popup_widget))
1134 gtk_menu_detach (GTK_MENU (combo_box->priv->popup_widget));
1135 combo_box->priv->popup_widget = NULL;
1137 else if (combo_box->priv->popup_widget)
1139 gtk_container_remove (GTK_CONTAINER (combo_box->priv->popup_frame),
1140 combo_box->priv->popup_widget);
1141 g_object_unref (combo_box->priv->popup_widget);
1142 combo_box->priv->popup_widget = NULL;
1145 if (GTK_IS_MENU (popup))
1147 if (combo_box->priv->popup_window)
1149 gtk_widget_destroy (combo_box->priv->popup_window);
1150 combo_box->priv->popup_window = NULL;
1151 combo_box->priv->popup_frame = NULL;
1154 combo_box->priv->popup_widget = popup;
1157 * Note that we connect to show/hide on the toplevel, not the
1158 * menu itself, since the menu is not shown/hidden when it is
1159 * popped up while torn-off.
1161 g_signal_connect (GTK_MENU (popup)->toplevel, "show",
1162 G_CALLBACK (gtk_combo_box_menu_show), combo_box);
1163 g_signal_connect (GTK_MENU (popup)->toplevel, "hide",
1164 G_CALLBACK (gtk_combo_box_menu_hide), combo_box);
1166 gtk_menu_attach_to_widget (GTK_MENU (popup),
1167 GTK_WIDGET (combo_box),
1168 gtk_combo_box_detacher);
1172 if (!combo_box->priv->popup_window)
1174 GtkWidget *toplevel;
1176 combo_box->priv->popup_window = gtk_window_new (GTK_WINDOW_POPUP);
1178 gtk_window_set_type_hint (GTK_WINDOW (combo_box->priv->popup_window),
1179 GDK_WINDOW_TYPE_HINT_COMBO);
1181 g_signal_connect (GTK_WINDOW(combo_box->priv->popup_window),"show",
1182 G_CALLBACK (gtk_combo_box_child_show),
1184 g_signal_connect (GTK_WINDOW(combo_box->priv->popup_window),"hide",
1185 G_CALLBACK (gtk_combo_box_child_hide),
1188 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (combo_box));
1189 if (GTK_IS_WINDOW (toplevel))
1191 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
1192 GTK_WINDOW (combo_box->priv->popup_window));
1193 gtk_window_set_transient_for (GTK_WINDOW (combo_box->priv->popup_window),
1194 GTK_WINDOW (toplevel));
1197 gtk_window_set_resizable (GTK_WINDOW (combo_box->priv->popup_window), FALSE);
1198 gtk_window_set_screen (GTK_WINDOW (combo_box->priv->popup_window),
1199 gtk_widget_get_screen (GTK_WIDGET (combo_box)));
1201 combo_box->priv->popup_frame = gtk_frame_new (NULL);
1202 gtk_frame_set_shadow_type (GTK_FRAME (combo_box->priv->popup_frame),
1203 GTK_SHADOW_ETCHED_IN);
1204 gtk_container_add (GTK_CONTAINER (combo_box->priv->popup_window),
1205 combo_box->priv->popup_frame);
1207 gtk_widget_show (combo_box->priv->popup_frame);
1209 combo_box->priv->scrolled_window = gtk_scrolled_window_new (NULL, NULL);
1211 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window),
1214 gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window),
1217 gtk_widget_show (combo_box->priv->scrolled_window);
1219 gtk_container_add (GTK_CONTAINER (combo_box->priv->popup_frame),
1220 combo_box->priv->scrolled_window);
1223 gtk_container_add (GTK_CONTAINER (combo_box->priv->scrolled_window),
1226 gtk_widget_show (popup);
1227 g_object_ref (popup);
1228 combo_box->priv->popup_widget = popup;
1233 gtk_combo_box_menu_position_below (GtkMenu *menu,
1239 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1245 GdkRectangle monitor;
1247 /* FIXME: is using the size request here broken? */
1248 child = GTK_BIN (combo_box)->child;
1250 gdk_window_get_origin (child->window, &sx, &sy);
1252 if (GTK_WIDGET_NO_WINDOW (child))
1254 sx += child->allocation.x;
1255 sy += child->allocation.y;
1258 gtk_widget_size_request (GTK_WIDGET (menu), &req);
1260 if (gtk_widget_get_direction (GTK_WIDGET (combo_box)) == GTK_TEXT_DIR_LTR)
1263 *x = sx + child->allocation.width - req.width;
1266 screen = gtk_widget_get_screen (GTK_WIDGET (combo_box));
1267 monitor_num = gdk_screen_get_monitor_at_window (screen,
1268 GTK_WIDGET (combo_box)->window);
1269 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1273 else if (*x + req.width > monitor.x + monitor.width)
1274 *x = monitor.x + monitor.width - req.width;
1276 if (monitor.y + monitor.height - *y - child->allocation.height >= req.height)
1277 *y += child->allocation.height;
1278 else if (*y - monitor.y >= req.height)
1280 else if (monitor.y + monitor.height - *y - child->allocation.height > *y - monitor.y)
1281 *y += child->allocation.height;
1289 gtk_combo_box_menu_position_over (GtkMenu *menu,
1295 GtkComboBox *combo_box;
1299 GtkRequisition requisition;
1306 g_return_if_fail (GTK_IS_COMBO_BOX (user_data));
1308 combo_box = GTK_COMBO_BOX (user_data);
1309 widget = GTK_WIDGET (combo_box);
1311 gtk_widget_get_child_requisition (GTK_WIDGET (menu), &requisition);
1312 menu_width = requisition.width;
1314 active = gtk_menu_get_active (GTK_MENU (combo_box->priv->popup_widget));
1315 gdk_window_get_origin (widget->window, &menu_xpos, &menu_ypos);
1317 menu_xpos += widget->allocation.x;
1318 menu_ypos += widget->allocation.y + widget->allocation.height / 2 - 2;
1322 gtk_widget_get_child_requisition (active, &requisition);
1323 menu_ypos -= requisition.height / 2;
1326 children = GTK_MENU_SHELL (combo_box->priv->popup_widget)->children;
1329 child = children->data;
1331 if (active == child)
1334 if (GTK_WIDGET_VISIBLE (child))
1336 gtk_widget_get_child_requisition (child, &requisition);
1337 menu_ypos -= requisition.height;
1340 children = children->next;
1343 if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
1344 menu_xpos = menu_xpos + widget->allocation.width - menu_width;
1346 /* Clamp the position on screen */
1347 screen_width = gdk_screen_get_width (gtk_widget_get_screen (widget));
1351 else if ((menu_xpos + menu_width) > screen_width)
1352 menu_xpos -= ((menu_xpos + menu_width) - screen_width);
1361 gtk_combo_box_menu_position (GtkMenu *menu,
1367 GtkComboBox *combo_box;
1368 GtkWidget *menu_item;
1370 combo_box = GTK_COMBO_BOX (user_data);
1372 if (combo_box->priv->wrap_width > 0 || combo_box->priv->cell_view == NULL)
1373 gtk_combo_box_menu_position_below (menu, x, y, push_in, user_data);
1376 /* FIXME handle nested menus better */
1377 menu_item = gtk_menu_get_active (GTK_MENU (combo_box->priv->popup_widget));
1379 gtk_menu_shell_select_item (GTK_MENU_SHELL (combo_box->priv->popup_widget),
1382 gtk_combo_box_menu_position_over (menu, x, y, push_in, user_data);
1388 gtk_combo_box_list_position (GtkComboBox *combo_box,
1397 GdkRectangle monitor;
1398 GtkRequisition popup_req;
1399 GtkPolicyType hpolicy, vpolicy;
1401 sample = GTK_BIN (combo_box)->child;
1403 gdk_window_get_origin (sample->window, x, y);
1405 if (GTK_WIDGET_NO_WINDOW (sample))
1407 *x += sample->allocation.x;
1408 *y += sample->allocation.y;
1411 *width = sample->allocation.width;
1413 if (combo_box->priv->cell_view_frame && combo_box->priv->has_frame)
1415 *x -= GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
1416 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->xthickness;
1417 *width += 2 * (GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
1418 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->xthickness);
1421 hpolicy = vpolicy = GTK_POLICY_NEVER;
1422 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window),
1424 gtk_widget_size_request (combo_box->priv->popup_frame, &popup_req);
1426 if (popup_req.width > *width)
1428 hpolicy = GTK_POLICY_ALWAYS;
1429 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window),
1431 gtk_widget_size_request (combo_box->priv->popup_frame, &popup_req);
1434 *height = popup_req.height;
1436 screen = gtk_widget_get_screen (GTK_WIDGET (combo_box));
1437 monitor_num = gdk_screen_get_monitor_at_window (screen,
1438 GTK_WIDGET (combo_box)->window);
1439 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1443 else if (*x + *width > monitor.x + monitor.width)
1444 *x = monitor.x + monitor.width - *width;
1446 if (*y + sample->allocation.height + *height <= monitor.y + monitor.height)
1447 *y += sample->allocation.height;
1448 else if (*y - *height >= monitor.y)
1450 else if (monitor.y + monitor.height - (*y + sample->allocation.height) > *y - monitor.y)
1452 *y += sample->allocation.height;
1453 *height = monitor.y + monitor.height - *y;
1457 *height = *y - monitor.y;
1461 if (popup_req.height > *height)
1463 vpolicy = GTK_POLICY_ALWAYS;
1465 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window),
1471 cell_view_is_sensitive (GtkCellView *cell_view)
1473 GList *cells, *list;
1476 cells = gtk_cell_view_get_cell_renderers (cell_view);
1482 g_object_get (list->data, "sensitive", &sensitive, NULL);
1489 g_list_free (cells);
1495 tree_column_row_is_sensitive (GtkComboBox *combo_box,
1498 GList *cells, *list;
1501 if (!combo_box->priv->column)
1504 if (combo_box->priv->row_separator_func)
1506 if ((*combo_box->priv->row_separator_func) (combo_box->priv->model, iter,
1507 combo_box->priv->row_separator_data))
1511 gtk_tree_view_column_cell_set_cell_data (combo_box->priv->column,
1512 combo_box->priv->model,
1513 iter, FALSE, FALSE);
1515 cells = gtk_tree_view_column_get_cell_renderers (combo_box->priv->column);
1521 g_object_get (list->data, "sensitive", &sensitive, NULL);
1528 g_list_free (cells);
1534 update_menu_sensitivity (GtkComboBox *combo_box,
1537 GList *children, *child;
1538 GtkWidget *item, *submenu, *separator;
1539 GtkWidget *cell_view;
1542 if (!combo_box->priv->model)
1545 children = gtk_container_get_children (GTK_CONTAINER (menu));
1547 for (child = children; child; child = child->next)
1549 item = GTK_WIDGET (child->data);
1550 cell_view = GTK_BIN (item)->child;
1552 if (!GTK_IS_CELL_VIEW (cell_view))
1555 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (item));
1556 if (submenu != NULL)
1558 gtk_widget_set_sensitive (item, TRUE);
1559 update_menu_sensitivity (combo_box, submenu);
1563 sensitive = cell_view_is_sensitive (GTK_CELL_VIEW (cell_view));
1565 if (menu != combo_box->priv->popup_widget && child == children)
1567 separator = GTK_WIDGET (child->next->data);
1568 g_object_set (item, "visible", sensitive, NULL);
1569 g_object_set (separator, "visible", sensitive, NULL);
1572 gtk_widget_set_sensitive (item, sensitive);
1576 g_list_free (children);
1580 gtk_combo_box_menu_popup (GtkComboBox *combo_box,
1582 guint32 activate_time)
1586 GtkRequisition requisition;
1589 update_menu_sensitivity (combo_box, combo_box->priv->popup_widget);
1592 if (gtk_tree_row_reference_valid (combo_box->priv->active_row))
1594 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
1595 active_item = gtk_tree_path_get_indices (path)[0];
1596 gtk_tree_path_free (path);
1598 if (combo_box->priv->add_tearoffs)
1602 /* FIXME handle nested menus better */
1603 gtk_menu_set_active (GTK_MENU (combo_box->priv->popup_widget), active_item);
1605 if (combo_box->priv->wrap_width == 0)
1607 width = GTK_WIDGET (combo_box)->allocation.width;
1608 gtk_widget_set_size_request (combo_box->priv->popup_widget, -1, -1);
1609 gtk_widget_size_request (combo_box->priv->popup_widget, &requisition);
1611 gtk_widget_set_size_request (combo_box->priv->popup_widget,
1612 MAX (width, requisition.width), -1);
1615 gtk_menu_popup (GTK_MENU (combo_box->priv->popup_widget),
1617 gtk_combo_box_menu_position, combo_box,
1618 button, activate_time);
1622 popup_grab_on_window (GdkWindow *window,
1623 guint32 activate_time,
1624 gboolean grab_keyboard)
1626 if ((gdk_pointer_grab (window, TRUE,
1627 GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK |
1628 GDK_POINTER_MOTION_MASK,
1629 NULL, NULL, activate_time) == 0))
1631 if (!grab_keyboard ||
1632 gdk_keyboard_grab (window, TRUE,
1633 activate_time) == 0)
1637 gdk_display_pointer_ungrab (gdk_drawable_get_display (window),
1647 * gtk_combo_box_popup:
1648 * @combo_box: a #GtkComboBox
1650 * Pops up the menu or dropdown list of @combo_box.
1652 * This function is mostly intended for use by accessibility technologies;
1653 * applications should have little use for it.
1658 gtk_combo_box_popup (GtkComboBox *combo_box)
1660 gint x, y, width, height;
1661 GtkTreePath *path, *ppath;
1662 GtkWidget *toplevel;
1664 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
1666 if (!GTK_WIDGET_REALIZED (combo_box))
1669 if (GTK_WIDGET_MAPPED (combo_box->priv->popup_widget))
1672 if (GTK_IS_MENU (combo_box->priv->popup_widget))
1674 gtk_combo_box_menu_popup (combo_box, 0, 0);
1678 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (combo_box));
1679 if (GTK_IS_WINDOW (toplevel))
1680 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
1681 GTK_WINDOW (combo_box->priv->popup_window));
1683 gtk_widget_show_all (combo_box->priv->popup_frame);
1684 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
1686 gtk_widget_set_size_request (combo_box->priv->popup_window, width, height);
1687 gtk_window_move (GTK_WINDOW (combo_box->priv->popup_window), x, y);
1689 if (gtk_tree_row_reference_valid (combo_box->priv->active_row))
1691 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
1692 ppath = gtk_tree_path_copy (path);
1693 if (gtk_tree_path_up (ppath))
1694 gtk_tree_view_expand_to_path (GTK_TREE_VIEW (combo_box->priv->tree_view),
1696 gtk_tree_view_set_cursor (GTK_TREE_VIEW (combo_box->priv->tree_view),
1698 gtk_tree_path_free (path);
1699 gtk_tree_path_free (ppath);
1701 gtk_tree_view_set_hover_expand (GTK_TREE_VIEW (combo_box->priv->tree_view),
1705 gtk_widget_show (combo_box->priv->popup_window);
1707 gtk_widget_grab_focus (combo_box->priv->popup_window);
1708 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (combo_box->priv->button),
1711 if (!GTK_WIDGET_HAS_FOCUS (combo_box->priv->tree_view))
1712 gtk_widget_grab_focus (combo_box->priv->tree_view);
1714 if (!popup_grab_on_window (combo_box->priv->popup_window->window,
1715 GDK_CURRENT_TIME, TRUE))
1717 gtk_widget_hide (combo_box->priv->popup_window);
1721 gtk_grab_add (combo_box->priv->popup_window);
1725 * gtk_combo_box_popdown:
1726 * @combo_box: a #GtkComboBox
1728 * Hides the menu or dropdown list of @combo_box.
1730 * This function is mostly intended for use by accessibility technologies;
1731 * applications should have little use for it.
1736 gtk_combo_box_popdown (GtkComboBox *combo_box)
1738 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
1740 if (GTK_IS_MENU (combo_box->priv->popup_widget))
1742 gtk_menu_popdown (GTK_MENU (combo_box->priv->popup_widget));
1746 if (!GTK_WIDGET_REALIZED (GTK_WIDGET (combo_box)))
1749 gtk_grab_remove (combo_box->priv->popup_window);
1750 gtk_widget_hide_all (combo_box->priv->popup_window);
1751 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (combo_box->priv->button),
1756 gtk_combo_box_calc_requested_width (GtkComboBox *combo_box,
1762 if (combo_box->priv->cell_view)
1763 gtk_widget_style_get (combo_box->priv->cell_view,
1764 "focus-line-width", &padding,
1769 /* add some pixels for good measure */
1770 padding += BONUS_PADDING;
1772 if (combo_box->priv->cell_view)
1773 gtk_cell_view_get_size_of_row (GTK_CELL_VIEW (combo_box->priv->cell_view),
1778 return req.width + padding;
1782 gtk_combo_box_remeasure (GtkComboBox *combo_box)
1787 if (!combo_box->priv->model ||
1788 !gtk_tree_model_get_iter_first (combo_box->priv->model, &iter))
1791 combo_box->priv->width = 0;
1792 combo_box->priv->height = 0;
1794 path = gtk_tree_path_new_from_indices (0, -1);
1800 if (combo_box->priv->cell_view)
1801 gtk_cell_view_get_size_of_row (GTK_CELL_VIEW (combo_box->priv->cell_view),
1809 combo_box->priv->width = MAX (combo_box->priv->width, req.width);
1810 combo_box->priv->height = MAX (combo_box->priv->height, req.height);
1812 gtk_tree_path_next (path);
1814 while (gtk_tree_model_iter_next (combo_box->priv->model, &iter));
1816 gtk_tree_path_free (path);
1820 gtk_combo_box_size_request (GtkWidget *widget,
1821 GtkRequisition *requisition)
1824 gint focus_width, focus_pad;
1825 GtkRequisition bin_req;
1827 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1830 gtk_widget_size_request (GTK_BIN (widget)->child, &bin_req);
1831 gtk_combo_box_remeasure (combo_box);
1832 bin_req.width = MAX (bin_req.width, combo_box->priv->width);
1833 bin_req.height = MAX (bin_req.height, combo_box->priv->height);
1835 gtk_widget_style_get (GTK_WIDGET (widget),
1836 "focus-line-width", &focus_width,
1837 "focus-padding", &focus_pad,
1840 if (!combo_box->priv->tree_view)
1844 if (combo_box->priv->cell_view)
1846 GtkRequisition button_req, sep_req, arrow_req;
1847 gint border_width, xthickness, ythickness;
1849 gtk_widget_size_request (combo_box->priv->button, &button_req);
1850 border_width = GTK_CONTAINER (combo_box)->border_width;
1851 xthickness = combo_box->priv->button->style->xthickness;
1852 ythickness = combo_box->priv->button->style->ythickness;
1854 bin_req.width = MAX (bin_req.width, combo_box->priv->width);
1855 bin_req.height = MAX (bin_req.height, combo_box->priv->height);
1857 gtk_widget_size_request (combo_box->priv->separator, &sep_req);
1858 gtk_widget_size_request (combo_box->priv->arrow, &arrow_req);
1860 height = MAX (sep_req.height, arrow_req.height);
1861 height = MAX (height, bin_req.height);
1863 width = bin_req.width + sep_req.width + arrow_req.width;
1865 height += 2*(border_width + ythickness + focus_width + focus_pad);
1866 width += 2*(border_width + xthickness + focus_width + focus_pad);
1868 requisition->width = width;
1869 requisition->height = height;
1873 GtkRequisition but_req;
1875 gtk_widget_size_request (combo_box->priv->button, &but_req);
1877 requisition->width = bin_req.width + but_req.width;
1878 requisition->height = MAX (bin_req.height, but_req.height);
1884 GtkRequisition button_req, frame_req;
1886 /* sample + frame */
1887 *requisition = bin_req;
1889 requisition->width += 2 * focus_width;
1891 if (combo_box->priv->cell_view_frame)
1893 gtk_widget_size_request (combo_box->priv->cell_view_frame, &frame_req);
1894 if (combo_box->priv->has_frame)
1896 requisition->width += 2 *
1897 (GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
1898 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->xthickness);
1899 requisition->height += 2 *
1900 (GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
1901 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->ythickness);
1906 gtk_widget_size_request (combo_box->priv->button, &button_req);
1908 requisition->height = MAX (requisition->height, button_req.height);
1909 requisition->width += button_req.width;
1914 gtk_combo_box_size_allocate (GtkWidget *widget,
1915 GtkAllocation *allocation)
1917 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1918 gint focus_width, focus_pad;
1919 GtkAllocation child;
1921 gboolean is_rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
1923 widget->allocation = *allocation;
1925 gtk_widget_style_get (GTK_WIDGET (widget),
1926 "focus-line-width", &focus_width,
1927 "focus-padding", &focus_pad,
1930 if (!combo_box->priv->tree_view)
1932 if (combo_box->priv->cell_view)
1934 gint border_width, xthickness, ythickness;
1938 gtk_widget_size_allocate (combo_box->priv->button, allocation);
1940 /* set some things ready */
1941 border_width = GTK_CONTAINER (combo_box->priv->button)->border_width;
1942 xthickness = combo_box->priv->button->style->xthickness;
1943 ythickness = combo_box->priv->button->style->ythickness;
1945 child.x = allocation->x;
1946 child.y = allocation->y;
1947 width = allocation->width;
1948 child.height = allocation->height;
1950 if (!combo_box->priv->is_cell_renderer)
1952 child.x += border_width + xthickness + focus_width + focus_pad;
1953 child.y += border_width + ythickness + focus_width + focus_pad;
1954 width -= 2 * (child.x - allocation->x);
1955 child.height -= 2 * (child.y - allocation->y);
1959 /* handle the children */
1960 gtk_widget_size_request (combo_box->priv->arrow, &req);
1961 child.width = req.width;
1963 child.x += width - req.width;
1964 child.width = MAX (1, child.width);
1965 child.height = MAX (1, child.height);
1966 gtk_widget_size_allocate (combo_box->priv->arrow, &child);
1968 child.x += req.width;
1969 gtk_widget_size_request (combo_box->priv->separator, &req);
1970 child.width = req.width;
1972 child.x -= req.width;
1973 child.width = MAX (1, child.width);
1974 child.height = MAX (1, child.height);
1975 gtk_widget_size_allocate (combo_box->priv->separator, &child);
1979 child.x += req.width;
1980 child.width = allocation->x + allocation->width
1981 - (border_width + xthickness + focus_width + focus_pad)
1986 child.width = child.x;
1987 child.x = allocation->x
1988 + border_width + xthickness + focus_width + focus_pad;
1989 child.width -= child.x;
1992 child.width = MAX (1, child.width);
1993 child.height = MAX (1, child.height);
1994 gtk_widget_size_allocate (GTK_BIN (widget)->child, &child);
1998 gtk_widget_size_request (combo_box->priv->button, &req);
2000 child.x = allocation->x;
2002 child.x = allocation->x + allocation->width - req.width;
2003 child.y = allocation->y;
2004 child.width = req.width;
2005 child.height = allocation->height;
2006 child.width = MAX (1, child.width);
2007 child.height = MAX (1, child.height);
2008 gtk_widget_size_allocate (combo_box->priv->button, &child);
2011 child.x = allocation->x + req.width;
2013 child.x = allocation->x;
2014 child.y = allocation->y;
2015 child.width = allocation->width - req.width;
2016 child.width = MAX (1, child.width);
2017 child.height = MAX (1, child.height);
2018 gtk_widget_size_allocate (GTK_BIN (widget)->child, &child);
2026 gtk_widget_size_request (combo_box->priv->button, &req);
2028 child.x = allocation->x;
2030 child.x = allocation->x + allocation->width - req.width;
2031 child.y = allocation->y;
2032 child.width = req.width;
2033 child.height = allocation->height;
2034 child.width = MAX (1, child.width);
2035 child.height = MAX (1, child.height);
2036 gtk_widget_size_allocate (combo_box->priv->button, &child);
2040 child.x = allocation->x + req.width;
2042 child.x = allocation->x;
2043 child.y = allocation->y;
2044 child.width = allocation->width - req.width;
2045 child.height = allocation->height;
2047 if (combo_box->priv->cell_view_frame)
2049 child.width = MAX (1, child.width);
2050 child.height = MAX (1, child.height);
2051 gtk_widget_size_allocate (combo_box->priv->cell_view_frame, &child);
2054 if (combo_box->priv->has_frame)
2057 GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
2058 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->xthickness;
2060 GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
2061 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->ythickness;
2062 child.width -= 2 * (
2063 GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
2064 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->xthickness);
2065 child.height -= 2 * (
2066 GTK_CONTAINER (combo_box->priv->cell_view_frame)->border_width +
2067 GTK_WIDGET (combo_box->priv->cell_view_frame)->style->ythickness);
2071 child.width = MAX (1, child.width);
2072 child.height = MAX (1, child.height);
2073 gtk_widget_size_allocate (GTK_BIN (combo_box)->child, &child);
2078 gtk_combo_box_unset_model (GtkComboBox *combo_box)
2080 if (combo_box->priv->model)
2082 g_signal_handler_disconnect (combo_box->priv->model,
2083 combo_box->priv->inserted_id);
2084 g_signal_handler_disconnect (combo_box->priv->model,
2085 combo_box->priv->deleted_id);
2086 g_signal_handler_disconnect (combo_box->priv->model,
2087 combo_box->priv->reordered_id);
2088 g_signal_handler_disconnect (combo_box->priv->model,
2089 combo_box->priv->changed_id);
2093 if (!combo_box->priv->tree_view)
2095 if (combo_box->priv->popup_widget)
2096 gtk_container_foreach (GTK_CONTAINER (combo_box->priv->popup_widget),
2097 (GtkCallback)gtk_widget_destroy, NULL);
2100 if (combo_box->priv->model)
2102 g_object_unref (combo_box->priv->model);
2103 combo_box->priv->model = NULL;
2106 if (combo_box->priv->active_row)
2108 gtk_tree_row_reference_free (combo_box->priv->active_row);
2109 combo_box->priv->active_row = NULL;
2112 if (combo_box->priv->cell_view)
2113 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (combo_box->priv->cell_view), NULL);
2117 gtk_combo_box_forall (GtkContainer *container,
2118 gboolean include_internals,
2119 GtkCallback callback,
2120 gpointer callback_data)
2122 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
2124 if (include_internals)
2126 if (combo_box->priv->button)
2127 (* callback) (combo_box->priv->button, callback_data);
2128 if (combo_box->priv->cell_view_frame)
2129 (* callback) (combo_box->priv->cell_view_frame, callback_data);
2132 if (GTK_BIN (container)->child)
2133 (* callback) (GTK_BIN (container)->child, callback_data);
2137 gtk_combo_box_child_show (GtkWidget *widget,
2138 GtkComboBox *combo_box)
2140 GtkComboBoxPrivate *priv = combo_box->priv;
2142 priv->popup_shown = TRUE;
2143 g_object_notify (G_OBJECT (combo_box), "popup-shown");
2147 gtk_combo_box_child_hide (GtkWidget *widget,
2148 GtkComboBox *combo_box)
2150 GtkComboBoxPrivate *priv = combo_box->priv;
2152 priv->popup_shown = FALSE;
2153 g_object_notify (G_OBJECT (combo_box), "popup-shown");
2157 gtk_combo_box_expose_event (GtkWidget *widget,
2158 GdkEventExpose *event)
2160 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2162 if (!combo_box->priv->tree_view)
2164 gtk_container_propagate_expose (GTK_CONTAINER (widget),
2165 combo_box->priv->button, event);
2169 gtk_container_propagate_expose (GTK_CONTAINER (widget),
2170 combo_box->priv->button, event);
2172 if (combo_box->priv->cell_view_frame)
2173 gtk_container_propagate_expose (GTK_CONTAINER (widget),
2174 combo_box->priv->cell_view_frame, event);
2177 gtk_container_propagate_expose (GTK_CONTAINER (widget),
2178 GTK_BIN (widget)->child, event);
2193 path_visible (GtkTreeView *view,
2199 /* Note that we rely on the fact that collapsed rows don't have nodes
2201 return _gtk_tree_view_find_node (view, path, &tree, &node);
2205 tree_next_func (GtkTreeModel *model,
2210 SearchData *search_data = (SearchData *)data;
2212 if (search_data->found)
2214 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2217 if (search_data->visible &&
2218 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2221 search_data->set = TRUE;
2222 search_data->iter = *iter;
2227 if (gtk_tree_path_compare (path, search_data->path) == 0)
2228 search_data->found = TRUE;
2234 tree_next (GtkComboBox *combo,
2235 GtkTreeModel *model,
2240 SearchData search_data;
2242 search_data.combo = combo;
2243 search_data.path = gtk_tree_model_get_path (model, iter);
2244 search_data.visible = visible;
2245 search_data.found = FALSE;
2246 search_data.set = FALSE;
2248 gtk_tree_model_foreach (model, tree_next_func, &search_data);
2250 *next = search_data.iter;
2252 gtk_tree_path_free (search_data.path);
2254 return search_data.set;
2258 tree_prev_func (GtkTreeModel *model,
2263 SearchData *search_data = (SearchData *)data;
2265 if (gtk_tree_path_compare (path, search_data->path) == 0)
2267 search_data->found = TRUE;
2271 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2274 if (search_data->visible &&
2275 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2278 search_data->set = TRUE;
2279 search_data->iter = *iter;
2285 tree_prev (GtkComboBox *combo,
2286 GtkTreeModel *model,
2291 SearchData search_data;
2293 search_data.combo = combo;
2294 search_data.path = gtk_tree_model_get_path (model, iter);
2295 search_data.visible = visible;
2296 search_data.found = FALSE;
2297 search_data.set = FALSE;
2299 gtk_tree_model_foreach (model, tree_prev_func, &search_data);
2301 *prev = search_data.iter;
2303 gtk_tree_path_free (search_data.path);
2305 return search_data.set;
2309 tree_last_func (GtkTreeModel *model,
2314 SearchData *search_data = (SearchData *)data;
2316 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2319 /* Note that we rely on the fact that collapsed rows don't have nodes
2321 if (search_data->visible &&
2322 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2325 search_data->set = TRUE;
2326 search_data->iter = *iter;
2332 tree_last (GtkComboBox *combo,
2333 GtkTreeModel *model,
2337 SearchData search_data;
2339 search_data.combo = combo;
2340 search_data.visible = visible;
2341 search_data.set = FALSE;
2343 gtk_tree_model_foreach (model, tree_last_func, &search_data);
2345 *last = search_data.iter;
2347 return search_data.set;
2352 tree_first_func (GtkTreeModel *model,
2357 SearchData *search_data = (SearchData *)data;
2359 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2362 if (search_data->visible &&
2363 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2366 search_data->set = TRUE;
2367 search_data->iter = *iter;
2373 tree_first (GtkComboBox *combo,
2374 GtkTreeModel *model,
2378 SearchData search_data;
2380 search_data.combo = combo;
2381 search_data.visible = visible;
2382 search_data.set = FALSE;
2384 gtk_tree_model_foreach (model, tree_first_func, &search_data);
2386 *first = search_data.iter;
2388 return search_data.set;
2392 gtk_combo_box_scroll_event (GtkWidget *widget,
2393 GdkEventScroll *event)
2395 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2398 GtkTreeIter new_iter;
2400 if (!gtk_combo_box_get_active_iter (combo_box, &iter))
2403 if (event->direction == GDK_SCROLL_UP)
2404 found = tree_prev (combo_box, combo_box->priv->model,
2405 &iter, &new_iter, FALSE);
2407 found = tree_next (combo_box, combo_box->priv->model,
2408 &iter, &new_iter, FALSE);
2411 gtk_combo_box_set_active_iter (combo_box, &new_iter);
2421 gtk_combo_box_sync_cells (GtkComboBox *combo_box,
2422 GtkCellLayout *cell_layout)
2426 for (k = combo_box->priv->cells; k; k = k->next)
2429 ComboCellInfo *info = (ComboCellInfo *)k->data;
2431 if (info->pack == GTK_PACK_START)
2432 gtk_cell_layout_pack_start (cell_layout,
2433 info->cell, info->expand);
2434 else if (info->pack == GTK_PACK_END)
2435 gtk_cell_layout_pack_end (cell_layout,
2436 info->cell, info->expand);
2438 gtk_cell_layout_set_cell_data_func (cell_layout,
2440 combo_cell_data_func, info, NULL);
2442 for (j = info->attributes; j; j = j->next->next)
2444 gtk_cell_layout_add_attribute (cell_layout,
2447 GPOINTER_TO_INT (j->next->data));
2453 gtk_combo_box_menu_setup (GtkComboBox *combo_box,
2454 gboolean add_children)
2458 if (combo_box->priv->cell_view)
2460 combo_box->priv->button = gtk_toggle_button_new ();
2461 gtk_button_set_focus_on_click (GTK_BUTTON (combo_box->priv->button),
2462 combo_box->priv->focus_on_click);
2464 g_signal_connect (combo_box->priv->button, "toggled",
2465 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
2466 g_signal_connect_after (combo_box->priv->button,
2468 G_CALLBACK (gtk_combo_box_key_press), combo_box);
2469 gtk_widget_set_parent (combo_box->priv->button,
2470 GTK_BIN (combo_box)->child->parent);
2472 combo_box->priv->box = gtk_hbox_new (FALSE, 0);
2473 gtk_container_add (GTK_CONTAINER (combo_box->priv->button),
2474 combo_box->priv->box);
2476 combo_box->priv->separator = gtk_vseparator_new ();
2477 gtk_container_add (GTK_CONTAINER (combo_box->priv->box),
2478 combo_box->priv->separator);
2480 combo_box->priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
2481 gtk_container_add (GTK_CONTAINER (combo_box->priv->box),
2482 combo_box->priv->arrow);
2484 gtk_widget_show_all (combo_box->priv->button);
2488 combo_box->priv->button = gtk_toggle_button_new ();
2489 gtk_button_set_focus_on_click (GTK_BUTTON (combo_box->priv->button),
2490 combo_box->priv->focus_on_click);
2492 g_signal_connect (combo_box->priv->button, "toggled",
2493 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
2494 g_signal_connect_after (combo_box, "key_press_event",
2495 G_CALLBACK (gtk_combo_box_key_press), combo_box);
2496 gtk_widget_set_parent (combo_box->priv->button,
2497 GTK_BIN (combo_box)->child->parent);
2499 combo_box->priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
2500 gtk_container_add (GTK_CONTAINER (combo_box->priv->button),
2501 combo_box->priv->arrow);
2502 gtk_widget_show_all (combo_box->priv->button);
2505 g_signal_connect (combo_box->priv->button, "button_press_event",
2506 G_CALLBACK (gtk_combo_box_menu_button_press),
2508 g_signal_connect (combo_box->priv->button, "state_changed",
2509 G_CALLBACK (gtk_combo_box_button_state_changed),
2512 /* create our funky menu */
2513 menu = gtk_menu_new ();
2514 g_signal_connect (menu, "key_press_event",
2515 G_CALLBACK (gtk_combo_box_menu_key_press), combo_box);
2516 gtk_combo_box_set_popup_widget (combo_box, menu);
2520 gtk_combo_box_menu_fill (combo_box);
2522 /* the column is needed in tree_column_row_is_sensitive() */
2523 combo_box->priv->column = gtk_tree_view_column_new ();
2524 g_object_ref_sink (combo_box->priv->column);
2525 gtk_combo_box_sync_cells (combo_box,
2526 GTK_CELL_LAYOUT (combo_box->priv->column));
2528 gtk_combo_box_update_title (combo_box);
2532 gtk_combo_box_menu_fill (GtkComboBox *combo_box)
2536 if (!combo_box->priv->model)
2539 menu = combo_box->priv->popup_widget;
2541 if (combo_box->priv->add_tearoffs)
2543 GtkWidget *tearoff = gtk_tearoff_menu_item_new ();
2545 gtk_widget_show (tearoff);
2547 if (combo_box->priv->wrap_width)
2548 gtk_menu_attach (GTK_MENU (menu), tearoff,
2549 0, combo_box->priv->wrap_width, 0, 1);
2551 gtk_menu_shell_append (GTK_MENU_SHELL (menu), tearoff);
2554 gtk_combo_box_menu_fill_level (combo_box, menu, NULL);
2558 gtk_cell_view_menu_item_new (GtkComboBox *combo_box,
2559 GtkTreeModel *model,
2562 GtkWidget *cell_view;
2567 cell_view = gtk_cell_view_new ();
2568 gtk_cell_view_set_model (GTK_CELL_VIEW (cell_view), model);
2569 path = gtk_tree_model_get_path (model, iter);
2570 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (cell_view), path);
2571 gtk_tree_path_free (path);
2573 gtk_combo_box_sync_cells (combo_box, GTK_CELL_LAYOUT (cell_view));
2574 gtk_widget_size_request (cell_view, &req);
2575 gtk_widget_show (cell_view);
2577 item = gtk_menu_item_new ();
2578 gtk_container_add (GTK_CONTAINER (item), cell_view);
2584 gtk_combo_box_menu_fill_level (GtkComboBox *combo_box,
2586 GtkTreeIter *parent)
2588 GtkTreeModel *model = combo_box->priv->model;
2589 GtkWidget *item, *submenu, *subitem, *separator;
2591 gboolean is_separator;
2596 n_children = gtk_tree_model_iter_n_children (model, parent);
2599 for (i = 0; i < n_children; i++)
2601 gtk_tree_model_iter_nth_child (model, &iter, parent, i);
2603 if (combo_box->priv->row_separator_func)
2604 is_separator = (*combo_box->priv->row_separator_func) (combo_box->priv->model, &iter,
2605 combo_box->priv->row_separator_data);
2607 is_separator = FALSE;
2611 item = gtk_separator_menu_item_new ();
2612 path = gtk_tree_model_get_path (model, &iter);
2613 g_object_set_data_full (G_OBJECT (item),
2614 I_("gtk-combo-box-item-path"),
2615 gtk_tree_row_reference_new (model, path),
2616 (GDestroyNotify)gtk_tree_row_reference_free);
2617 gtk_tree_path_free (path);
2621 item = gtk_cell_view_menu_item_new (combo_box, model, &iter);
2622 if (gtk_tree_model_iter_has_child (model, &iter))
2624 submenu = gtk_menu_new ();
2625 gtk_widget_show (submenu);
2626 gtk_menu_item_set_submenu (GTK_MENU_ITEM (item), submenu);
2628 /* Ugly - since menus can only activate leafs, we have to
2629 * duplicate the item inside the submenu.
2631 subitem = gtk_cell_view_menu_item_new (combo_box, model, &iter);
2632 separator = gtk_separator_menu_item_new ();
2633 gtk_widget_show (subitem);
2634 gtk_widget_show (separator);
2635 g_signal_connect (subitem, "activate",
2636 G_CALLBACK (gtk_combo_box_menu_item_activate),
2638 gtk_menu_shell_append (GTK_MENU_SHELL (submenu), subitem);
2639 gtk_menu_shell_append (GTK_MENU_SHELL (submenu), separator);
2641 gtk_combo_box_menu_fill_level (combo_box, submenu, &iter);
2644 g_signal_connect (item, "activate",
2645 G_CALLBACK (gtk_combo_box_menu_item_activate),
2649 gtk_menu_shell_append (GTK_MENU_SHELL (menu), item);
2650 if (combo_box->priv->wrap_width && menu == combo_box->priv->popup_widget)
2651 gtk_combo_box_relayout_item (combo_box, item, &iter, last);
2652 gtk_widget_show (item);
2659 gtk_combo_box_menu_destroy (GtkComboBox *combo_box)
2661 g_signal_handlers_disconnect_matched (combo_box->priv->button,
2662 G_SIGNAL_MATCH_DATA,
2664 gtk_combo_box_menu_button_press, NULL);
2665 g_signal_handlers_disconnect_matched (combo_box->priv->button,
2666 G_SIGNAL_MATCH_DATA,
2668 gtk_combo_box_button_state_changed, combo_box);
2670 /* unparent will remove our latest ref */
2671 gtk_widget_unparent (combo_box->priv->button);
2673 combo_box->priv->box = NULL;
2674 combo_box->priv->button = NULL;
2675 combo_box->priv->arrow = NULL;
2676 combo_box->priv->separator = NULL;
2678 g_object_unref (combo_box->priv->column);
2679 combo_box->priv->column = NULL;
2681 /* changing the popup window will unref the menu and the children */
2689 menu_occupied (GtkMenu *menu,
2693 guint bottom_attach)
2697 for (i = GTK_MENU_SHELL (menu)->children; i; i = i->next)
2701 gtk_container_child_get (GTK_CONTAINER (menu),
2705 "bottom-attach", &b,
2709 /* look if this item intersects with the given coordinates */
2710 if (right_attach > l && left_attach < r && bottom_attach > t && top_attach < b)
2718 gtk_combo_box_relayout_item (GtkComboBox *combo_box,
2723 gint current_col = 0, current_row = 0;
2724 gint rows = 1, cols = 1;
2725 GtkWidget *menu = combo_box->priv->popup_widget;
2727 if (!GTK_IS_MENU_SHELL (menu))
2730 if (combo_box->priv->col_column == -1 &&
2731 combo_box->priv->row_column == -1 &&
2734 gtk_container_child_get (GTK_CONTAINER (menu),
2736 "right_attach", ¤t_col,
2737 "top_attach", ¤t_row,
2739 if (current_col + cols > combo_box->priv->wrap_width)
2747 if (combo_box->priv->col_column != -1)
2748 gtk_tree_model_get (combo_box->priv->model, iter,
2749 combo_box->priv->col_column, &cols,
2751 if (combo_box->priv->row_column != -1)
2752 gtk_tree_model_get (combo_box->priv->model, iter,
2753 combo_box->priv->row_column, &rows,
2758 if (current_col + cols > combo_box->priv->wrap_width)
2764 if (!menu_occupied (GTK_MENU (menu),
2765 current_col, current_col + cols,
2766 current_row, current_row + rows))
2773 /* set attach props */
2774 gtk_menu_attach (GTK_MENU (menu), item,
2775 current_col, current_col + cols,
2776 current_row, current_row + rows);
2780 gtk_combo_box_relayout (GtkComboBox *combo_box)
2785 menu = combo_box->priv->popup_widget;
2787 /* do nothing unless we are in menu style and realized */
2788 if (combo_box->priv->tree_view || !GTK_IS_MENU_SHELL (menu))
2791 list = gtk_container_get_children (GTK_CONTAINER (menu));
2793 for (j = g_list_last (list); j; j = j->prev)
2794 gtk_container_remove (GTK_CONTAINER (menu), j->data);
2796 gtk_combo_box_menu_fill (combo_box);
2803 gtk_combo_box_menu_button_press (GtkWidget *widget,
2804 GdkEventButton *event,
2807 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
2809 if (GTK_IS_MENU (combo_box->priv->popup_widget) &&
2810 event->type == GDK_BUTTON_PRESS && event->button == 1)
2812 if (combo_box->priv->focus_on_click &&
2813 !GTK_WIDGET_HAS_FOCUS (combo_box->priv->button))
2814 gtk_widget_grab_focus (combo_box->priv->button);
2816 gtk_combo_box_menu_popup (combo_box, event->button, event->time);
2825 gtk_combo_box_menu_item_activate (GtkWidget *item,
2828 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
2829 GtkWidget *cell_view;
2833 cell_view = GTK_BIN (item)->child;
2835 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
2837 path = gtk_cell_view_get_displayed_row (GTK_CELL_VIEW (cell_view));
2839 if (gtk_tree_model_get_iter (combo_box->priv->model, &iter, path))
2840 gtk_combo_box_set_active_iter (combo_box, &iter);
2842 gtk_tree_path_free (path);
2844 combo_box->priv->editing_canceled = FALSE;
2848 gtk_combo_box_model_row_inserted (GtkTreeModel *model,
2853 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
2855 if (combo_box->priv->tree_view)
2856 gtk_combo_box_list_popup_resize (combo_box);
2858 gtk_combo_box_menu_row_inserted (model, path, iter, user_data);
2862 gtk_combo_box_model_row_deleted (GtkTreeModel *model,
2866 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
2868 if (combo_box->priv->cell_view)
2870 if (!gtk_tree_row_reference_valid (combo_box->priv->active_row))
2871 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (combo_box->priv->cell_view), NULL);
2874 if (combo_box->priv->tree_view)
2875 gtk_combo_box_list_popup_resize (combo_box);
2877 gtk_combo_box_menu_row_deleted (model, path, user_data);
2881 gtk_combo_box_model_rows_reordered (GtkTreeModel *model,
2887 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
2889 gtk_tree_row_reference_reordered (G_OBJECT (user_data), path, iter, new_order);
2891 if (!combo_box->priv->tree_view)
2892 gtk_combo_box_menu_rows_reordered (model, path, iter, new_order, user_data);
2896 gtk_combo_box_model_row_changed (GtkTreeModel *model,
2901 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
2902 GtkTreePath *active_path;
2904 /* FIXME this belongs to GtkCellView */
2905 if (gtk_tree_row_reference_valid (combo_box->priv->active_row))
2907 active_path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
2908 if (gtk_tree_path_compare (path, active_path) == 0 &&
2909 combo_box->priv->cell_view)
2910 gtk_widget_queue_resize (GTK_WIDGET (combo_box->priv->cell_view));
2911 gtk_tree_path_free (active_path);
2914 if (combo_box->priv->tree_view)
2915 gtk_combo_box_list_row_changed (model, path, iter, user_data);
2917 gtk_combo_box_menu_row_changed (model, path, iter, user_data);
2921 list_popup_resize_idle (gpointer user_data)
2923 GtkComboBox *combo_box;
2924 gint x, y, width, height;
2926 GDK_THREADS_ENTER ();
2928 combo_box = GTK_COMBO_BOX (user_data);
2930 if (combo_box->priv->tree_view &&
2931 GTK_WIDGET_MAPPED (combo_box->priv->popup_window))
2933 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
2935 gtk_widget_set_size_request (combo_box->priv->popup_window, width, height);
2936 gtk_window_move (GTK_WINDOW (combo_box->priv->popup_window), x, y);
2939 combo_box->priv->resize_idle_id = 0;
2941 GDK_THREADS_LEAVE ();
2947 gtk_combo_box_list_popup_resize (GtkComboBox *combo_box)
2949 if (!combo_box->priv->resize_idle_id)
2950 combo_box->priv->resize_idle_id =
2951 g_idle_add (list_popup_resize_idle, combo_box);
2955 gtk_combo_box_model_row_expanded (GtkTreeModel *model,
2960 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
2962 gtk_combo_box_list_popup_resize (combo_box);
2967 find_menu_by_path (GtkWidget *menu,
2969 gboolean skip_first)
2974 GtkTreeRowReference *mref;
2978 list = gtk_container_get_children (GTK_CONTAINER (menu));
2981 for (i = list; i; i = i->next)
2983 if (GTK_IS_SEPARATOR_MENU_ITEM (i->data))
2985 mref = g_object_get_data (G_OBJECT (i->data), "gtk-combo-box-item-path");
2988 else if (!gtk_tree_row_reference_valid (mref))
2991 mpath = gtk_tree_row_reference_get_path (mref);
2993 else if (GTK_IS_CELL_VIEW (GTK_BIN (i->data)->child))
3001 mpath = gtk_cell_view_get_displayed_row (GTK_CELL_VIEW (GTK_BIN (i->data)->child));
3006 /* this case is necessary, since the row reference of
3007 * the cell view may already be updated after a deletion
3014 if (gtk_tree_path_compare (mpath, path) == 0)
3016 gtk_tree_path_free (mpath);
3020 if (gtk_tree_path_is_ancestor (mpath, path))
3022 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
3023 if (submenu != NULL)
3025 gtk_tree_path_free (mpath);
3026 item = find_menu_by_path (submenu, path, TRUE);
3030 gtk_tree_path_free (mpath);
3040 dump_menu_tree (GtkWidget *menu,
3047 list = gtk_container_get_children (GTK_CONTAINER (menu));
3048 for (i = list; i; i = i->next)
3050 if (GTK_IS_CELL_VIEW (GTK_BIN (i->data)->child))
3052 path = gtk_cell_view_get_displayed_row (GTK_CELL_VIEW (GTK_BIN (i->data)->child));
3053 g_print ("%*s%s\n", 2 * level, " ", gtk_tree_path_to_string (path));
3054 gtk_tree_path_free (path);
3056 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
3057 if (submenu != NULL)
3058 dump_menu_tree (submenu, level + 1);
3067 gtk_combo_box_menu_row_inserted (GtkTreeModel *model,
3073 GtkWidget *item, *menu, *separator;
3074 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3078 gboolean is_separator;
3080 if (!combo_box->priv->popup_widget)
3083 depth = gtk_tree_path_get_depth (path);
3084 pos = gtk_tree_path_get_indices (path)[depth - 1];
3087 ppath = gtk_tree_path_copy (path);
3088 gtk_tree_path_up (ppath);
3089 parent = find_menu_by_path (combo_box->priv->popup_widget, ppath, FALSE);
3090 gtk_tree_path_free (ppath);
3092 menu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (parent));
3095 menu = gtk_menu_new ();
3096 gtk_widget_show (menu);
3097 gtk_menu_item_set_submenu (GTK_MENU_ITEM (parent), menu);
3099 /* Ugly - since menus can only activate leaves, we have to
3100 * duplicate the item inside the submenu.
3102 gtk_tree_model_iter_parent (model, &piter, iter);
3103 item = gtk_cell_view_menu_item_new (combo_box, model, &piter);
3104 separator = gtk_separator_menu_item_new ();
3105 g_signal_connect (item, "activate",
3106 G_CALLBACK (gtk_combo_box_menu_item_activate),
3108 gtk_menu_shell_append (GTK_MENU_SHELL (menu), item);
3109 gtk_menu_shell_append (GTK_MENU_SHELL (menu), separator);
3110 if (cell_view_is_sensitive (GTK_CELL_VIEW (GTK_BIN (item)->child)))
3112 gtk_widget_show (item);
3113 gtk_widget_show (separator);
3120 menu = combo_box->priv->popup_widget;
3121 if (combo_box->priv->add_tearoffs)
3125 if (combo_box->priv->row_separator_func)
3126 is_separator = (*combo_box->priv->row_separator_func) (model, iter,
3127 combo_box->priv->row_separator_data);
3129 is_separator = FALSE;
3133 item = gtk_separator_menu_item_new ();
3134 g_object_set_data_full (G_OBJECT (item),
3135 I_("gtk-combo-box-item-path"),
3136 gtk_tree_row_reference_new (model, path),
3137 (GDestroyNotify)gtk_tree_row_reference_free);
3141 item = gtk_cell_view_menu_item_new (combo_box, model, iter);
3143 g_signal_connect (item, "activate",
3144 G_CALLBACK (gtk_combo_box_menu_item_activate),
3148 gtk_widget_show (item);
3149 gtk_menu_shell_insert (GTK_MENU_SHELL (menu), item, pos);
3153 gtk_combo_box_menu_row_deleted (GtkTreeModel *model,
3157 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3161 if (!combo_box->priv->popup_widget)
3164 item = find_menu_by_path (combo_box->priv->popup_widget, path, FALSE);
3165 menu = gtk_widget_get_parent (item);
3166 gtk_container_remove (GTK_CONTAINER (menu), item);
3170 gtk_combo_box_menu_rows_reordered (GtkTreeModel *model,
3176 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3178 gtk_combo_box_relayout (combo_box);
3182 gtk_combo_box_menu_row_changed (GtkTreeModel *model,
3187 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3190 gboolean is_separator;
3192 if (!combo_box->priv->popup_widget)
3195 item = find_menu_by_path (combo_box->priv->popup_widget, path, FALSE);
3197 if (combo_box->priv->row_separator_func)
3198 is_separator = (*combo_box->priv->row_separator_func) (model, iter,
3199 combo_box->priv->row_separator_data);
3201 is_separator = FALSE;
3203 if (is_separator != GTK_IS_SEPARATOR_MENU_ITEM (item))
3205 gtk_combo_box_menu_row_deleted (model, path, combo_box);
3206 gtk_combo_box_menu_row_inserted (model, path, iter, combo_box);
3209 if (combo_box->priv->wrap_width
3210 && item->parent == combo_box->priv->popup_widget)
3212 GtkWidget *pitem = NULL;
3215 prev = gtk_tree_path_copy (path);
3217 if (gtk_tree_path_prev (prev))
3218 pitem = find_menu_by_path (combo_box->priv->popup_widget, prev, FALSE);
3220 gtk_tree_path_free (prev);
3222 /* unattach item so gtk_combo_box_relayout_item() won't spuriously
3224 gtk_container_child_set (GTK_CONTAINER (combo_box->priv->popup_widget),
3229 "bottom-attach", -1,
3232 gtk_combo_box_relayout_item (combo_box, item, iter, pitem);
3235 width = gtk_combo_box_calc_requested_width (combo_box, path);
3237 if (width > combo_box->priv->width)
3239 if (combo_box->priv->cell_view)
3241 gtk_widget_set_size_request (combo_box->priv->cell_view, width, -1);
3242 gtk_widget_queue_resize (combo_box->priv->cell_view);
3244 combo_box->priv->width = width;
3253 gtk_combo_box_list_setup (GtkComboBox *combo_box)
3255 GtkTreeSelection *sel;
3257 combo_box->priv->button = gtk_toggle_button_new ();
3258 gtk_widget_set_parent (combo_box->priv->button,
3259 GTK_BIN (combo_box)->child->parent);
3260 g_signal_connect (combo_box->priv->button, "button_press_event",
3261 G_CALLBACK (gtk_combo_box_list_button_pressed), combo_box);
3262 g_signal_connect (combo_box->priv->button, "toggled",
3263 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
3264 g_signal_connect_after (combo_box, "key_press_event",
3265 G_CALLBACK (gtk_combo_box_key_press), combo_box);
3267 combo_box->priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
3268 gtk_container_add (GTK_CONTAINER (combo_box->priv->button),
3269 combo_box->priv->arrow);
3270 combo_box->priv->separator = NULL;
3271 gtk_widget_show_all (combo_box->priv->button);
3273 if (combo_box->priv->cell_view)
3275 gtk_cell_view_set_background_color (GTK_CELL_VIEW (combo_box->priv->cell_view),
3276 >K_WIDGET (combo_box)->style->base[GTK_WIDGET_STATE (combo_box)]);
3278 combo_box->priv->box = gtk_event_box_new ();
3279 gtk_event_box_set_visible_window (GTK_EVENT_BOX (combo_box->priv->box),
3282 if (combo_box->priv->has_frame)
3284 combo_box->priv->cell_view_frame = gtk_frame_new (NULL);
3285 gtk_frame_set_shadow_type (GTK_FRAME (combo_box->priv->cell_view_frame),
3290 combo_box->priv->cell_view_frame = gtk_event_box_new ();
3291 gtk_event_box_set_visible_window (GTK_EVENT_BOX (combo_box->priv->cell_view_frame),
3295 gtk_widget_set_parent (combo_box->priv->cell_view_frame,
3296 GTK_BIN (combo_box)->child->parent);
3297 gtk_container_add (GTK_CONTAINER (combo_box->priv->cell_view_frame),
3298 combo_box->priv->box);
3299 gtk_widget_show_all (combo_box->priv->cell_view_frame);
3301 g_signal_connect (combo_box->priv->box, "button_press_event",
3302 G_CALLBACK (gtk_combo_box_list_button_pressed),
3306 combo_box->priv->tree_view = gtk_tree_view_new ();
3307 sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (combo_box->priv->tree_view));
3308 gtk_tree_selection_set_mode (sel, GTK_SELECTION_BROWSE);
3309 gtk_tree_selection_set_select_function (sel,
3310 gtk_combo_box_list_select_func,
3312 gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (combo_box->priv->tree_view),
3314 gtk_tree_view_set_hover_selection (GTK_TREE_VIEW (combo_box->priv->tree_view),
3316 if (combo_box->priv->row_separator_func)
3317 gtk_tree_view_set_row_separator_func (GTK_TREE_VIEW (combo_box->priv->tree_view),
3318 combo_box->priv->row_separator_func,
3319 combo_box->priv->row_separator_data,
3321 if (combo_box->priv->model)
3322 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view),
3323 combo_box->priv->model);
3325 combo_box->priv->column = gtk_tree_view_column_new ();
3326 gtk_tree_view_append_column (GTK_TREE_VIEW (combo_box->priv->tree_view),
3327 combo_box->priv->column);
3330 gtk_combo_box_sync_cells (combo_box,
3331 GTK_CELL_LAYOUT (combo_box->priv->column));
3333 if (gtk_tree_row_reference_valid (combo_box->priv->active_row))
3337 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
3338 gtk_tree_view_set_cursor (GTK_TREE_VIEW (combo_box->priv->tree_view),
3340 gtk_tree_path_free (path);
3343 /* set sample/popup widgets */
3344 gtk_combo_box_set_popup_widget (combo_box, combo_box->priv->tree_view);
3346 g_signal_connect (combo_box->priv->tree_view, "key_press_event",
3347 G_CALLBACK (gtk_combo_box_list_key_press),
3349 g_signal_connect (combo_box->priv->tree_view, "enter_notify_event",
3350 G_CALLBACK (gtk_combo_box_list_enter_notify),
3352 g_signal_connect (combo_box->priv->tree_view, "row_expanded",
3353 G_CALLBACK (gtk_combo_box_model_row_expanded),
3355 g_signal_connect (combo_box->priv->tree_view, "row_collapsed",
3356 G_CALLBACK (gtk_combo_box_model_row_expanded),
3358 g_signal_connect (combo_box->priv->popup_window, "button_press_event",
3359 G_CALLBACK (gtk_combo_box_list_button_pressed),
3361 g_signal_connect (combo_box->priv->popup_window, "button_release_event",
3362 G_CALLBACK (gtk_combo_box_list_button_released),
3365 gtk_widget_show (combo_box->priv->tree_view);
3369 gtk_combo_box_list_destroy (GtkComboBox *combo_box)
3371 /* disconnect signals */
3372 g_signal_handlers_disconnect_matched (combo_box->priv->tree_view,
3373 G_SIGNAL_MATCH_DATA,
3374 0, 0, NULL, NULL, combo_box);
3375 g_signal_handlers_disconnect_matched (combo_box->priv->button,
3376 G_SIGNAL_MATCH_DATA,
3378 gtk_combo_box_list_button_pressed,
3380 g_signal_handlers_disconnect_matched (combo_box->priv->popup_window,
3381 G_SIGNAL_MATCH_DATA,
3383 gtk_combo_box_list_button_pressed,
3385 g_signal_handlers_disconnect_matched (combo_box->priv->popup_window,
3386 G_SIGNAL_MATCH_DATA,
3388 gtk_combo_box_list_button_released,
3391 g_signal_handlers_disconnect_matched (combo_box->priv->popup_window,
3392 G_SIGNAL_MATCH_DATA,
3394 gtk_combo_box_child_show,
3397 g_signal_handlers_disconnect_matched (combo_box->priv->popup_window,
3398 G_SIGNAL_MATCH_DATA,
3400 gtk_combo_box_child_hide,
3403 if (combo_box->priv->box)
3404 g_signal_handlers_disconnect_matched (combo_box->priv->box,
3405 G_SIGNAL_MATCH_DATA,
3407 gtk_combo_box_list_button_pressed,
3410 /* destroy things (unparent will kill the latest ref from us)
3411 * last unref on button will destroy the arrow
3413 gtk_widget_unparent (combo_box->priv->button);
3414 combo_box->priv->button = NULL;
3415 combo_box->priv->arrow = NULL;
3417 if (combo_box->priv->cell_view)
3419 g_object_set (combo_box->priv->cell_view,
3420 "background-set", FALSE,
3424 if (combo_box->priv->cell_view_frame)
3426 gtk_widget_unparent (combo_box->priv->cell_view_frame);
3427 combo_box->priv->cell_view_frame = NULL;
3428 combo_box->priv->box = NULL;
3431 if (combo_box->priv->scroll_timer)
3433 g_source_remove (combo_box->priv->scroll_timer);
3434 combo_box->priv->scroll_timer = 0;
3437 if (combo_box->priv->resize_idle_id)
3439 g_source_remove (combo_box->priv->resize_idle_id);
3440 combo_box->priv->resize_idle_id = 0;
3443 gtk_widget_destroy (combo_box->priv->tree_view);
3445 combo_box->priv->tree_view = NULL;
3446 combo_box->priv->popup_widget = NULL;
3452 gtk_combo_box_list_button_pressed (GtkWidget *widget,
3453 GdkEventButton *event,
3456 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3458 GtkWidget *ewidget = gtk_get_event_widget ((GdkEvent *)event);
3460 if (ewidget == combo_box->priv->popup_window)
3463 if ((ewidget != combo_box->priv->button && ewidget != combo_box->priv->box) ||
3464 gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (combo_box->priv->button)))
3467 if (combo_box->priv->focus_on_click &&
3468 !GTK_WIDGET_HAS_FOCUS (combo_box->priv->button))
3469 gtk_widget_grab_focus (combo_box->priv->button);
3471 gtk_combo_box_popup (combo_box);
3473 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (combo_box->priv->button),
3476 combo_box->priv->auto_scroll = FALSE;
3477 if (combo_box->priv->scroll_timer == 0)
3478 combo_box->priv->scroll_timer = g_timeout_add (SCROLL_TIME,
3479 (GSourceFunc) gtk_combo_box_list_scroll_timeout,
3482 combo_box->priv->popup_in_progress = TRUE;
3488 gtk_combo_box_list_button_released (GtkWidget *widget,
3489 GdkEventButton *event,
3493 GtkTreePath *path = NULL;
3496 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3498 gboolean popup_in_progress = FALSE;
3500 GtkWidget *ewidget = gtk_get_event_widget ((GdkEvent *)event);
3502 if (combo_box->priv->popup_in_progress)
3504 popup_in_progress = TRUE;
3505 combo_box->priv->popup_in_progress = FALSE;
3508 gtk_tree_view_set_hover_expand (GTK_TREE_VIEW (combo_box->priv->tree_view),
3510 if (combo_box->priv->scroll_timer)
3512 g_source_remove (combo_box->priv->scroll_timer);
3513 combo_box->priv->scroll_timer = 0;
3516 if (ewidget != combo_box->priv->tree_view)
3518 if ((ewidget == combo_box->priv->button ||
3519 ewidget == combo_box->priv->box) &&
3520 !popup_in_progress &&
3521 gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (combo_box->priv->button)))
3523 gtk_combo_box_popdown (combo_box);
3527 /* released outside treeview */
3528 if (ewidget != combo_box->priv->button &&
3529 ewidget != combo_box->priv->box)
3531 gtk_combo_box_popdown (combo_box);
3539 /* select something cool */
3540 ret = gtk_tree_view_get_path_at_pos (GTK_TREE_VIEW (combo_box->priv->tree_view),
3546 return TRUE; /* clicked outside window? */
3548 gtk_tree_model_get_iter (combo_box->priv->model, &iter, path);
3549 gtk_tree_path_free (path);
3551 gtk_combo_box_popdown (combo_box);
3553 if (tree_column_row_is_sensitive (combo_box, &iter))
3554 gtk_combo_box_set_active_iter (combo_box, &iter);
3560 gtk_combo_box_key_press (GtkWidget *widget,
3564 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3565 guint state = event->state & gtk_accelerator_get_default_mod_mask ();
3568 GtkTreeIter new_iter;
3570 if (combo_box->priv->model == NULL)
3573 if ((event->keyval == GDK_Down || event->keyval == GDK_KP_Down) &&
3574 state == GDK_MOD1_MASK)
3576 gtk_combo_box_popup (combo_box);
3584 switch (event->keyval)
3588 if (gtk_combo_box_get_active_iter (combo_box, &iter))
3590 found = tree_next (combo_box, combo_box->priv->model,
3591 &iter, &new_iter, FALSE);
3594 /* else fall through */
3596 case GDK_KP_Page_Up:
3599 found = tree_first (combo_box, combo_box->priv->model, &new_iter, FALSE);
3604 if (gtk_combo_box_get_active_iter (combo_box, &iter))
3606 found = tree_prev (combo_box, combo_box->priv->model,
3607 &iter, &new_iter, FALSE);
3610 /* else fall through */
3612 case GDK_KP_Page_Down:
3615 found = tree_last (combo_box, combo_box->priv->model, &new_iter, FALSE);
3622 gtk_combo_box_set_active_iter (combo_box, &new_iter);
3628 gtk_combo_box_menu_key_press (GtkWidget *widget,
3632 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3633 guint state = event->state & gtk_accelerator_get_default_mod_mask ();
3635 if ((event->keyval == GDK_Up || event->keyval == GDK_KP_Up) &&
3636 state == GDK_MOD1_MASK)
3638 gtk_combo_box_popdown (combo_box);
3647 gtk_combo_box_list_key_press (GtkWidget *widget,
3651 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3653 guint state = event->state & gtk_accelerator_get_default_mod_mask ();
3655 if (event->keyval == GDK_Escape ||
3656 ((event->keyval == GDK_Up || event->keyval == GDK_KP_Up) &&
3657 state == GDK_MOD1_MASK))
3659 gtk_combo_box_popdown (combo_box);
3661 /* reset active item -- this is incredibly lame and ugly */
3662 if (gtk_combo_box_get_active_iter (combo_box, &iter))
3663 gtk_combo_box_set_active_iter (combo_box, &iter);
3668 if (event->keyval == GDK_Return || event->keyval == GDK_KP_Enter ||
3669 event->keyval == GDK_space || event->keyval == GDK_KP_Space)
3672 GtkTreeModel *model = NULL;
3674 gtk_combo_box_popdown (combo_box);
3676 if (combo_box->priv->model)
3678 GtkTreeSelection *sel;
3680 sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (combo_box->priv->tree_view));
3682 if (gtk_tree_selection_get_selected (sel, &model, &iter))
3683 gtk_combo_box_set_active_iter (combo_box, &iter);
3693 gtk_combo_box_list_auto_scroll (GtkComboBox *combo_box,
3697 GtkWidget *tree_view = combo_box->priv->tree_view;
3701 adj = gtk_scrolled_window_get_hadjustment (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window));
3702 if (adj && adj->upper - adj->lower > adj->page_size)
3704 if (x <= tree_view->allocation.x &&
3705 adj->lower < adj->value)
3707 value = adj->value - (tree_view->allocation.x - x + 1);
3708 gtk_adjustment_set_value (adj, CLAMP (value, adj->lower, adj->upper - adj->page_size));
3710 else if (x >= tree_view->allocation.x + tree_view->allocation.width &&
3711 adj->upper - adj->page_size > adj->value)
3713 value = adj->value + (x - tree_view->allocation.x - tree_view->allocation.width + 1);
3714 gtk_adjustment_set_value (adj, CLAMP (value, 0.0, adj->upper - adj->page_size));
3718 adj = gtk_scrolled_window_get_vadjustment (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window));
3719 if (adj && adj->upper - adj->lower > adj->page_size)
3721 if (y <= tree_view->allocation.y &&
3722 adj->lower < adj->value)
3724 value = adj->value - (tree_view->allocation.y - y + 1);
3725 gtk_adjustment_set_value (adj, CLAMP (value, adj->lower, adj->upper - adj->page_size));
3727 else if (y >= tree_view->allocation.height &&
3728 adj->upper - adj->page_size > adj->value)
3730 value = adj->value + (y - tree_view->allocation.height + 1);
3731 gtk_adjustment_set_value (adj, CLAMP (value, 0.0, adj->upper - adj->page_size));
3737 gtk_combo_box_list_scroll_timeout (GtkComboBox *combo_box)
3741 GDK_THREADS_ENTER ();
3743 if (combo_box->priv->auto_scroll)
3745 gdk_window_get_pointer (combo_box->priv->tree_view->window,
3747 gtk_combo_box_list_auto_scroll (combo_box, x, y);
3750 GDK_THREADS_LEAVE ();
3756 gtk_combo_box_list_enter_notify (GtkWidget *widget,
3757 GdkEventCrossing *event,
3760 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3762 combo_box->priv->auto_scroll = TRUE;
3768 gtk_combo_box_list_select_func (GtkTreeSelection *selection,
3769 GtkTreeModel *model,
3771 gboolean path_currently_selected,
3775 gboolean sensitive = FALSE;
3777 for (list = selection->tree_view->priv->columns; list && !sensitive; list = list->next)
3779 GList *cells, *cell;
3780 gboolean cell_sensitive, cell_visible;
3782 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (list->data);
3784 if (!column->visible)
3787 gtk_tree_model_get_iter (model, &iter, path);
3788 gtk_tree_view_column_cell_set_cell_data (column, model, &iter,
3791 cell = cells = gtk_tree_view_column_get_cell_renderers (column);
3794 g_object_get (cell->data,
3795 "sensitive", &cell_sensitive,
3796 "visible", &cell_visible,
3799 if (cell_visible && cell_sensitive)
3804 g_list_free (cells);
3806 sensitive = cell_sensitive;
3813 gtk_combo_box_list_row_changed (GtkTreeModel *model,
3818 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3821 width = gtk_combo_box_calc_requested_width (combo_box, path);
3823 if (width > combo_box->priv->width)
3825 if (combo_box->priv->cell_view)
3827 gtk_widget_set_size_request (combo_box->priv->cell_view, width, -1);
3828 gtk_widget_queue_resize (combo_box->priv->cell_view);
3830 combo_box->priv->width = width;
3835 * GtkCellLayout implementation
3839 pack_start_recurse (GtkWidget *menu,
3840 GtkCellRenderer *cell,
3846 list = gtk_container_get_children (GTK_CONTAINER (menu));
3847 for (i = list; i; i = i->next)
3849 if (GTK_IS_CELL_LAYOUT (GTK_BIN (i->data)->child))
3850 gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (GTK_BIN (i->data)->child),
3853 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
3854 if (submenu != NULL)
3855 pack_start_recurse (submenu, cell, expand);
3862 gtk_combo_box_cell_layout_pack_start (GtkCellLayout *layout,
3863 GtkCellRenderer *cell,
3866 ComboCellInfo *info;
3867 GtkComboBox *combo_box;
3869 g_return_if_fail (GTK_IS_COMBO_BOX (layout));
3870 g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
3872 combo_box = GTK_COMBO_BOX (layout);
3874 g_object_ref_sink (cell);
3876 info = g_new0 (ComboCellInfo, 1);
3878 info->expand = expand;
3879 info->pack = GTK_PACK_START;
3881 combo_box->priv->cells = g_slist_append (combo_box->priv->cells, info);
3883 if (combo_box->priv->cell_view)
3884 gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (combo_box->priv->cell_view),
3887 if (combo_box->priv->column)
3888 gtk_tree_view_column_pack_start (combo_box->priv->column, cell, expand);
3890 if (GTK_IS_MENU (combo_box->priv->popup_widget))
3891 pack_start_recurse (combo_box->priv->popup_widget, cell, expand);
3895 pack_end_recurse (GtkWidget *menu,
3896 GtkCellRenderer *cell,
3902 list = gtk_container_get_children (GTK_CONTAINER (menu));
3903 for (i = list; i; i = i->next)
3905 if (GTK_IS_CELL_LAYOUT (GTK_BIN (i->data)->child))
3906 gtk_cell_layout_pack_end (GTK_CELL_LAYOUT (GTK_BIN (i->data)->child),
3909 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
3910 if (submenu != NULL)
3911 pack_end_recurse (submenu, cell, expand);
3918 gtk_combo_box_cell_layout_pack_end (GtkCellLayout *layout,
3919 GtkCellRenderer *cell,
3922 ComboCellInfo *info;
3923 GtkComboBox *combo_box;
3925 g_return_if_fail (GTK_IS_COMBO_BOX (layout));
3926 g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
3928 combo_box = GTK_COMBO_BOX (layout);
3930 g_object_ref_sink (cell);
3932 info = g_new0 (ComboCellInfo, 1);
3934 info->expand = expand;
3935 info->pack = GTK_PACK_END;
3937 combo_box->priv->cells = g_slist_append (combo_box->priv->cells, info);
3939 if (combo_box->priv->cell_view)
3940 gtk_cell_layout_pack_end (GTK_CELL_LAYOUT (combo_box->priv->cell_view),
3943 if (combo_box->priv->column)
3944 gtk_tree_view_column_pack_end (combo_box->priv->column, cell, expand);
3946 if (GTK_IS_MENU (combo_box->priv->popup_widget))
3947 pack_end_recurse (combo_box->priv->popup_widget, cell, expand);
3951 clear_recurse (GtkWidget *menu)
3956 list = gtk_container_get_children (GTK_CONTAINER (menu));
3957 for (i = list; i; i = i->next)
3959 if (GTK_IS_CELL_LAYOUT (GTK_BIN (i->data)->child))
3960 gtk_cell_layout_clear (GTK_CELL_LAYOUT (GTK_BIN (i->data)->child));
3962 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
3963 if (submenu != NULL)
3964 clear_recurse (submenu);
3971 gtk_combo_box_cell_layout_clear (GtkCellLayout *layout)
3973 GtkComboBox *combo_box;
3976 g_return_if_fail (GTK_IS_COMBO_BOX (layout));
3978 combo_box = GTK_COMBO_BOX (layout);
3980 if (combo_box->priv->cell_view)
3981 gtk_cell_layout_clear (GTK_CELL_LAYOUT (combo_box->priv->cell_view));
3983 if (combo_box->priv->column)
3984 gtk_tree_view_column_clear (combo_box->priv->column);
3986 for (i = combo_box->priv->cells; i; i = i->next)
3988 ComboCellInfo *info = (ComboCellInfo *)i->data;
3990 gtk_combo_box_cell_layout_clear_attributes (layout, info->cell);
3991 g_object_unref (info->cell);
3995 g_slist_free (combo_box->priv->cells);
3996 combo_box->priv->cells = NULL;
3998 if (GTK_IS_MENU (combo_box->priv->popup_widget))
3999 clear_recurse (combo_box->priv->popup_widget);
4003 add_attribute_recurse (GtkWidget *menu,
4004 GtkCellRenderer *cell,
4005 const gchar *attribute,
4011 list = gtk_container_get_children (GTK_CONTAINER (menu));
4012 for (i = list; i; i = i->next)
4014 if (GTK_IS_CELL_LAYOUT (GTK_BIN (i->data)->child))
4015 gtk_cell_layout_add_attribute (GTK_CELL_LAYOUT (GTK_BIN (i->data)->child),
4016 cell, attribute, column);
4018 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
4019 if (submenu != NULL)
4020 add_attribute_recurse (submenu, cell, attribute, column);
4027 gtk_combo_box_cell_layout_add_attribute (GtkCellLayout *layout,
4028 GtkCellRenderer *cell,
4029 const gchar *attribute,
4032 ComboCellInfo *info;
4033 GtkComboBox *combo_box;
4035 g_return_if_fail (GTK_IS_COMBO_BOX (layout));
4036 g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
4038 combo_box = GTK_COMBO_BOX (layout);
4040 info = gtk_combo_box_get_cell_info (combo_box, cell);
4042 info->attributes = g_slist_prepend (info->attributes,
4043 GINT_TO_POINTER (column));
4044 info->attributes = g_slist_prepend (info->attributes,
4045 g_strdup (attribute));
4047 if (combo_box->priv->cell_view)
4048 gtk_cell_layout_add_attribute (GTK_CELL_LAYOUT (combo_box->priv->cell_view),
4049 cell, attribute, column);
4051 if (combo_box->priv->column)
4052 gtk_cell_layout_add_attribute (GTK_CELL_LAYOUT (combo_box->priv->column),
4053 cell, attribute, column);
4055 if (GTK_IS_MENU (combo_box->priv->popup_widget))
4056 add_attribute_recurse (combo_box->priv->popup_widget, cell, attribute, column);
4057 gtk_widget_queue_resize (GTK_WIDGET (combo_box));
4061 combo_cell_data_func (GtkCellLayout *cell_layout,
4062 GtkCellRenderer *cell,
4063 GtkTreeModel *tree_model,
4067 ComboCellInfo *info = (ComboCellInfo *)data;
4068 GtkWidget *parent = NULL;
4073 (*info->func) (cell_layout, cell, tree_model, iter, info->func_data);
4075 if (GTK_IS_WIDGET (cell_layout))
4076 parent = gtk_widget_get_parent (GTK_WIDGET (cell_layout));
4078 if (GTK_IS_MENU_ITEM (parent) &&
4079 gtk_menu_item_get_submenu (GTK_MENU_ITEM (parent)))
4080 g_object_set (cell, "sensitive", TRUE, NULL);
4085 set_cell_data_func_recurse (GtkWidget *menu,
4086 GtkCellRenderer *cell,
4087 ComboCellInfo *info)
4091 GtkWidget *cell_view;
4093 list = gtk_container_get_children (GTK_CONTAINER (menu));
4094 for (i = list; i; i = i->next)
4096 cell_view = GTK_BIN (i->data)->child;
4097 if (GTK_IS_CELL_LAYOUT (cell_view))
4099 /* Override sensitivity for inner nodes; we don't
4100 * want menuitems with submenus to appear insensitive
4102 gtk_cell_layout_set_cell_data_func (GTK_CELL_LAYOUT (cell_view),
4104 combo_cell_data_func,
4106 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
4107 if (submenu != NULL)
4108 set_cell_data_func_recurse (submenu, cell, info);
4116 gtk_combo_box_cell_layout_set_cell_data_func (GtkCellLayout *layout,
4117 GtkCellRenderer *cell,
4118 GtkCellLayoutDataFunc func,
4120 GDestroyNotify destroy)
4122 ComboCellInfo *info;
4123 GtkComboBox *combo_box;
4125 g_return_if_fail (GTK_IS_COMBO_BOX (layout));
4127 combo_box = GTK_COMBO_BOX (layout);
4129 info = gtk_combo_box_get_cell_info (combo_box, cell);
4130 g_return_if_fail (info != NULL);
4134 GDestroyNotify d = info->destroy;
4136 info->destroy = NULL;
4137 d (info->func_data);
4141 info->func_data = func_data;
4142 info->destroy = destroy;
4144 if (combo_box->priv->cell_view)
4145 gtk_cell_layout_set_cell_data_func (GTK_CELL_LAYOUT (combo_box->priv->cell_view), cell, func, func_data, NULL);
4147 if (combo_box->priv->column)
4148 gtk_cell_layout_set_cell_data_func (GTK_CELL_LAYOUT (combo_box->priv->column), cell, func, func_data, NULL);
4150 if (GTK_IS_MENU (combo_box->priv->popup_widget))
4151 set_cell_data_func_recurse (combo_box->priv->popup_widget, cell, info);
4153 gtk_widget_queue_resize (GTK_WIDGET (combo_box));
4157 clear_attributes_recurse (GtkWidget *menu,
4158 GtkCellRenderer *cell)
4163 list = gtk_container_get_children (GTK_CONTAINER (menu));
4164 for (i = list; i; i = i->next)
4166 if (GTK_IS_CELL_LAYOUT (GTK_BIN (i->data)->child))
4167 gtk_cell_layout_clear_attributes (GTK_CELL_LAYOUT (GTK_BIN (i->data)->child),
4170 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
4171 if (submenu != NULL)
4172 clear_attributes_recurse (submenu, cell);
4179 gtk_combo_box_cell_layout_clear_attributes (GtkCellLayout *layout,
4180 GtkCellRenderer *cell)
4182 ComboCellInfo *info;
4183 GtkComboBox *combo_box;
4186 g_return_if_fail (GTK_IS_COMBO_BOX (layout));
4187 g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
4189 combo_box = GTK_COMBO_BOX (layout);
4191 info = gtk_combo_box_get_cell_info (combo_box, cell);
4192 g_return_if_fail (info != NULL);
4194 list = info->attributes;
4195 while (list && list->next)
4197 g_free (list->data);
4198 list = list->next->next;
4200 g_slist_free (info->attributes);
4201 info->attributes = NULL;
4203 if (combo_box->priv->cell_view)
4204 gtk_cell_layout_clear_attributes (GTK_CELL_LAYOUT (combo_box->priv->cell_view), cell);
4206 if (combo_box->priv->column)
4207 gtk_cell_layout_clear_attributes (GTK_CELL_LAYOUT (combo_box->priv->column), cell);
4209 if (GTK_IS_MENU (combo_box->priv->popup_widget))
4210 clear_attributes_recurse (combo_box->priv->popup_widget, cell);
4212 gtk_widget_queue_resize (GTK_WIDGET (combo_box));
4216 reorder_recurse (GtkWidget *menu,
4217 GtkCellRenderer *cell,
4223 list = gtk_container_get_children (GTK_CONTAINER (menu));
4224 for (i = list; i; i = i->next)
4226 if (GTK_IS_CELL_LAYOUT (GTK_BIN (i->data)->child))
4227 gtk_cell_layout_reorder (GTK_CELL_LAYOUT (GTK_BIN (i->data)->child),
4230 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (i->data));
4231 if (submenu != NULL)
4232 reorder_recurse (submenu, cell, position);
4239 gtk_combo_box_cell_layout_reorder (GtkCellLayout *layout,
4240 GtkCellRenderer *cell,
4243 ComboCellInfo *info;
4244 GtkComboBox *combo_box;
4247 g_return_if_fail (GTK_IS_COMBO_BOX (layout));
4248 g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
4250 combo_box = GTK_COMBO_BOX (layout);
4252 info = gtk_combo_box_get_cell_info (combo_box, cell);
4254 g_return_if_fail (info != NULL);
4255 g_return_if_fail (position >= 0);
4257 link = g_slist_find (combo_box->priv->cells, info);
4259 g_return_if_fail (link != NULL);
4261 combo_box->priv->cells = g_slist_remove_link (combo_box->priv->cells, link);
4262 combo_box->priv->cells = g_slist_insert (combo_box->priv->cells, info,
4265 if (combo_box->priv->cell_view)
4266 gtk_cell_layout_reorder (GTK_CELL_LAYOUT (combo_box->priv->cell_view),
4269 if (combo_box->priv->column)
4270 gtk_cell_layout_reorder (GTK_CELL_LAYOUT (combo_box->priv->column),
4273 if (GTK_IS_MENU (combo_box->priv->popup_widget))
4274 reorder_recurse (combo_box->priv->popup_widget, cell, position);
4276 gtk_widget_queue_draw (GTK_WIDGET (combo_box));
4284 * gtk_combo_box_new:
4286 * Creates a new empty #GtkComboBox.
4288 * Return value: A new #GtkComboBox.
4293 gtk_combo_box_new (void)
4295 return g_object_new (GTK_TYPE_COMBO_BOX, NULL);
4299 * gtk_combo_box_new_with_model:
4300 * @model: A #GtkTreeModel.
4302 * Creates a new #GtkComboBox with the model initialized to @model.
4304 * Return value: A new #GtkComboBox.
4309 gtk_combo_box_new_with_model (GtkTreeModel *model)
4311 GtkComboBox *combo_box;
4313 g_return_val_if_fail (GTK_IS_TREE_MODEL (model), NULL);
4315 combo_box = g_object_new (GTK_TYPE_COMBO_BOX, "model", model, NULL);
4317 return GTK_WIDGET (combo_box);
4321 * gtk_combo_box_get_wrap_width:
4322 * @combo_box: A #GtkComboBox.
4324 * Returns the wrap width which is used to determine the number
4325 * of columns for the popup menu. If the wrap width is larger than
4326 * 1, the combo box is in table mode.
4328 * Returns: the wrap width.
4333 gtk_combo_box_get_wrap_width (GtkComboBox *combo_box)
4335 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
4337 return combo_box->priv->wrap_width;
4341 * gtk_combo_box_set_wrap_width:
4342 * @combo_box: A #GtkComboBox.
4343 * @width: Preferred number of columns.
4345 * Sets the wrap width of @combo_box to be @width. The wrap width is basically
4346 * the preferred number of columns when you want the popup to be layed out
4352 gtk_combo_box_set_wrap_width (GtkComboBox *combo_box,
4355 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4356 g_return_if_fail (width >= 0);
4358 if (width != combo_box->priv->wrap_width)
4360 combo_box->priv->wrap_width = width;
4362 gtk_combo_box_check_appearance (combo_box);
4363 gtk_combo_box_relayout (combo_box);
4365 g_object_notify (G_OBJECT (combo_box), "wrap-width");
4370 * gtk_combo_box_get_row_span_column:
4371 * @combo_box: A #GtkComboBox.
4373 * Returns the column with row span information for @combo_box.
4375 * Returns: the row span column.
4380 gtk_combo_box_get_row_span_column (GtkComboBox *combo_box)
4382 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
4384 return combo_box->priv->row_column;
4388 * gtk_combo_box_set_row_span_column:
4389 * @combo_box: A #GtkComboBox.
4390 * @row_span: A column in the model passed during construction.
4392 * Sets the column with row span information for @combo_box to be @row_span.
4393 * The row span column contains integers which indicate how many rows
4394 * an item should span.
4399 gtk_combo_box_set_row_span_column (GtkComboBox *combo_box,
4404 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4406 col = gtk_tree_model_get_n_columns (combo_box->priv->model);
4407 g_return_if_fail (row_span >= -1 && row_span < col);
4409 if (row_span != combo_box->priv->row_column)
4411 combo_box->priv->row_column = row_span;
4413 gtk_combo_box_relayout (combo_box);
4415 g_object_notify (G_OBJECT (combo_box), "row-span-column");
4420 * gtk_combo_box_get_column_span_column:
4421 * @combo_box: A #GtkComboBox.
4423 * Returns the column with column span information for @combo_box.
4425 * Returns: the column span column.
4430 gtk_combo_box_get_column_span_column (GtkComboBox *combo_box)
4432 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
4434 return combo_box->priv->col_column;
4438 * gtk_combo_box_set_column_span_column:
4439 * @combo_box: A #GtkComboBox.
4440 * @column_span: A column in the model passed during construction.
4442 * Sets the column with column span information for @combo_box to be
4443 * @column_span. The column span column contains integers which indicate
4444 * how many columns an item should span.
4449 gtk_combo_box_set_column_span_column (GtkComboBox *combo_box,
4454 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4456 col = gtk_tree_model_get_n_columns (combo_box->priv->model);
4457 g_return_if_fail (column_span >= -1 && column_span < col);
4459 if (column_span != combo_box->priv->col_column)
4461 combo_box->priv->col_column = column_span;
4463 gtk_combo_box_relayout (combo_box);
4465 g_object_notify (G_OBJECT (combo_box), "column-span-column");
4470 * gtk_combo_box_get_active:
4471 * @combo_box: A #GtkComboBox.
4473 * Returns the index of the currently active item, or -1 if there's no
4474 * active item. If the model is a non-flat treemodel, and the active item
4475 * is not an immediate child of the root of the tree, this function returns
4476 * <literal>gtk_tree_path_get_indices (path)[0]</literal>, where
4477 * <literal>path</literal> is the #GtkTreePath of the active item.
4479 * Return value: An integer which is the index of the currently active item, or
4480 * -1 if there's no active item.
4485 gtk_combo_box_get_active (GtkComboBox *combo_box)
4488 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
4490 if (gtk_tree_row_reference_valid (combo_box->priv->active_row))
4494 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
4495 result = gtk_tree_path_get_indices (path)[0];
4496 gtk_tree_path_free (path);
4505 * gtk_combo_box_set_active:
4506 * @combo_box: A #GtkComboBox.
4507 * @index_: An index in the model passed during construction, or -1 to have
4510 * Sets the active item of @combo_box to be the item at @index.
4515 gtk_combo_box_set_active (GtkComboBox *combo_box,
4518 GtkTreePath *path = NULL;
4519 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4520 g_return_if_fail (index_ >= -1);
4523 path = gtk_tree_path_new_from_indices (index_, -1);
4525 gtk_combo_box_set_active_internal (combo_box, path);
4528 gtk_tree_path_free (path);
4532 gtk_combo_box_set_active_internal (GtkComboBox *combo_box,
4535 GtkTreePath *active_path;
4538 if (path && gtk_tree_row_reference_valid (combo_box->priv->active_row))
4540 active_path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
4541 path_cmp = gtk_tree_path_compare (path, active_path);
4542 gtk_tree_path_free (active_path);
4547 if (combo_box->priv->active_row)
4549 gtk_tree_row_reference_free (combo_box->priv->active_row);
4550 combo_box->priv->active_row = NULL;
4555 if (combo_box->priv->tree_view)
4556 gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (combo_box->priv->tree_view)));
4559 GtkMenu *menu = GTK_MENU (combo_box->priv->popup_widget);
4561 if (GTK_IS_MENU (menu))
4562 gtk_menu_set_active (menu, -1);
4565 if (combo_box->priv->cell_view)
4566 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (combo_box->priv->cell_view), NULL);
4570 combo_box->priv->active_row =
4571 gtk_tree_row_reference_new (combo_box->priv->model, path);
4573 if (combo_box->priv->tree_view)
4575 gtk_tree_view_set_cursor (GTK_TREE_VIEW (combo_box->priv->tree_view),
4578 else if (GTK_IS_MENU (combo_box->priv->popup_widget))
4580 /* FIXME handle nested menus better */
4581 gtk_menu_set_active (GTK_MENU (combo_box->priv->popup_widget),
4582 gtk_tree_path_get_indices (path)[0]);
4585 if (combo_box->priv->cell_view)
4586 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (combo_box->priv->cell_view),
4590 g_signal_emit (combo_box, combo_box_signals[CHANGED], 0);
4591 g_object_notify (G_OBJECT (combo_box), "active");
4596 * gtk_combo_box_get_active_iter:
4597 * @combo_box: A #GtkComboBox
4598 * @iter: The uninitialized #GtkTreeIter.
4600 * Sets @iter to point to the current active item, if it exists.
4602 * Return value: %TRUE, if @iter was set
4607 gtk_combo_box_get_active_iter (GtkComboBox *combo_box,
4613 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
4615 if (!gtk_tree_row_reference_valid (combo_box->priv->active_row))
4618 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
4619 result = gtk_tree_model_get_iter (combo_box->priv->model, iter, path);
4620 gtk_tree_path_free (path);
4626 * gtk_combo_box_set_active_iter:
4627 * @combo_box: A #GtkComboBox
4628 * @iter: The #GtkTreeIter.
4630 * Sets the current active item to be the one referenced by @iter.
4631 * @iter must correspond to a path of depth one.
4636 gtk_combo_box_set_active_iter (GtkComboBox *combo_box,
4641 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4643 path = gtk_tree_model_get_path (gtk_combo_box_get_model (combo_box), iter);
4644 gtk_combo_box_set_active_internal (combo_box, path);
4645 gtk_tree_path_free (path);
4649 * gtk_combo_box_set_model:
4650 * @combo_box: A #GtkComboBox.
4651 * @model: A #GtkTreeModel.
4653 * Sets the model used by @combo_box to be @model. Will unset a previously set
4654 * model (if applicable). If model is %NULL, then it will unset the model.
4656 * Note that this function does not clear the cell renderers, you have to
4657 * call gtk_combo_box_cell_layout_clear() yourself if you need to set up
4658 * different cell renderers for the new model.
4663 gtk_combo_box_set_model (GtkComboBox *combo_box,
4664 GtkTreeModel *model)
4666 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4670 gtk_combo_box_unset_model (combo_box);
4674 g_return_if_fail (GTK_IS_TREE_MODEL (model));
4676 if (model == combo_box->priv->model)
4679 if (combo_box->priv->model)
4680 gtk_combo_box_unset_model (combo_box);
4682 combo_box->priv->model = model;
4683 g_object_ref (combo_box->priv->model);
4685 combo_box->priv->inserted_id =
4686 g_signal_connect (combo_box->priv->model, "row_inserted",
4687 G_CALLBACK (gtk_combo_box_model_row_inserted),
4689 combo_box->priv->deleted_id =
4690 g_signal_connect (combo_box->priv->model, "row_deleted",
4691 G_CALLBACK (gtk_combo_box_model_row_deleted),
4693 combo_box->priv->reordered_id =
4694 g_signal_connect (combo_box->priv->model, "rows_reordered",
4695 G_CALLBACK (gtk_combo_box_model_rows_reordered),
4697 combo_box->priv->changed_id =
4698 g_signal_connect (combo_box->priv->model, "row_changed",
4699 G_CALLBACK (gtk_combo_box_model_row_changed),
4702 if (combo_box->priv->tree_view)
4705 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view),
4706 combo_box->priv->model);
4707 gtk_combo_box_list_popup_resize (combo_box);
4712 if (combo_box->priv->popup_widget)
4713 gtk_combo_box_menu_fill (combo_box);
4717 if (combo_box->priv->cell_view)
4718 gtk_cell_view_set_model (GTK_CELL_VIEW (combo_box->priv->cell_view),
4719 combo_box->priv->model);
4723 * gtk_combo_box_get_model
4724 * @combo_box: A #GtkComboBox.
4726 * Returns the #GtkTreeModel which is acting as data source for @combo_box.
4728 * Return value: A #GtkTreeModel which was passed during construction.
4733 gtk_combo_box_get_model (GtkComboBox *combo_box)
4735 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4737 return combo_box->priv->model;
4741 /* convenience API for simple text combos */
4744 * gtk_combo_box_new_text:
4746 * Convenience function which constructs a new text combo box, which is a
4747 * #GtkComboBox just displaying strings. If you use this function to create
4748 * a text combo box, you should only manipulate its data source with the
4749 * following convenience functions: gtk_combo_box_append_text(),
4750 * gtk_combo_box_insert_text(), gtk_combo_box_prepend_text() and
4751 * gtk_combo_box_remove_text().
4753 * Return value: A new text combo box.
4758 gtk_combo_box_new_text (void)
4760 GtkWidget *combo_box;
4761 GtkCellRenderer *cell;
4762 GtkListStore *store;
4764 store = gtk_list_store_new (1, G_TYPE_STRING);
4765 combo_box = gtk_combo_box_new_with_model (GTK_TREE_MODEL (store));
4766 g_object_unref (store);
4768 cell = gtk_cell_renderer_text_new ();
4769 gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (combo_box), cell, TRUE);
4770 gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (combo_box), cell,
4778 * gtk_combo_box_append_text:
4779 * @combo_box: A #GtkComboBox constructed using gtk_combo_box_new_text().
4782 * Appends @string to the list of strings stored in @combo_box. Note that
4783 * you can only use this function with combo boxes constructed with
4784 * gtk_combo_box_new_text().
4789 gtk_combo_box_append_text (GtkComboBox *combo_box,
4793 GtkListStore *store;
4795 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4796 g_return_if_fail (GTK_IS_LIST_STORE (combo_box->priv->model));
4797 g_return_if_fail (text != NULL);
4799 store = GTK_LIST_STORE (combo_box->priv->model);
4801 gtk_list_store_append (store, &iter);
4802 gtk_list_store_set (store, &iter, 0, text, -1);
4806 * gtk_combo_box_insert_text:
4807 * @combo_box: A #GtkComboBox constructed using gtk_combo_box_new_text().
4808 * @position: An index to insert @text.
4811 * Inserts @string at @position in the list of strings stored in @combo_box.
4812 * Note that you can only use this function with combo boxes constructed
4813 * with gtk_combo_box_new_text().
4818 gtk_combo_box_insert_text (GtkComboBox *combo_box,
4823 GtkListStore *store;
4825 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4826 g_return_if_fail (GTK_IS_LIST_STORE (combo_box->priv->model));
4827 g_return_if_fail (position >= 0);
4828 g_return_if_fail (text != NULL);
4830 store = GTK_LIST_STORE (combo_box->priv->model);
4832 gtk_list_store_insert (store, &iter, position);
4833 gtk_list_store_set (store, &iter, 0, text, -1);
4837 * gtk_combo_box_prepend_text:
4838 * @combo_box: A #GtkComboBox constructed with gtk_combo_box_new_text().
4841 * Prepends @string to the list of strings stored in @combo_box. Note that
4842 * you can only use this function with combo boxes constructed with
4843 * gtk_combo_box_new_text().
4848 gtk_combo_box_prepend_text (GtkComboBox *combo_box,
4852 GtkListStore *store;
4854 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4855 g_return_if_fail (GTK_IS_LIST_STORE (combo_box->priv->model));
4856 g_return_if_fail (text != NULL);
4858 store = GTK_LIST_STORE (combo_box->priv->model);
4860 gtk_list_store_prepend (store, &iter);
4861 gtk_list_store_set (store, &iter, 0, text, -1);
4865 * gtk_combo_box_remove_text:
4866 * @combo_box: A #GtkComboBox constructed with gtk_combo_box_new_text().
4867 * @position: Index of the item to remove.
4869 * Removes the string at @position from @combo_box. Note that you can only use
4870 * this function with combo boxes constructed with gtk_combo_box_new_text().
4875 gtk_combo_box_remove_text (GtkComboBox *combo_box,
4879 GtkListStore *store;
4881 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4882 g_return_if_fail (GTK_IS_LIST_STORE (combo_box->priv->model));
4883 g_return_if_fail (position >= 0);
4885 store = GTK_LIST_STORE (combo_box->priv->model);
4887 if (gtk_tree_model_iter_nth_child (combo_box->priv->model, &iter,
4889 gtk_list_store_remove (store, &iter);
4893 * gtk_combo_box_get_active_text:
4894 * @combo_box: A #GtkComboBox constructed with gtk_combo_box_new_text().
4896 * Returns the currently active string in @combo_box or %NULL if none
4897 * is selected. Note that you can only use this function with combo
4898 * boxes constructed with gtk_combo_box_new_text() and with
4899 * #GtkComboBoxEntry<!-- -->s.
4901 * Returns: a newly allocated string containing the currently active text.
4906 gtk_combo_box_get_active_text (GtkComboBox *combo_box)
4908 GtkComboBoxClass *class;
4910 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4912 class = GTK_COMBO_BOX_GET_CLASS (combo_box);
4914 if (class->get_active_text)
4915 return (* class->get_active_text) (combo_box);
4921 gtk_combo_box_real_get_active_text (GtkComboBox *combo_box)
4926 g_return_val_if_fail (GTK_IS_LIST_STORE (combo_box->priv->model), NULL);
4928 if (gtk_combo_box_get_active_iter (combo_box, &iter))
4929 gtk_tree_model_get (combo_box->priv->model, &iter,
4936 gtk_combo_box_mnemonic_activate (GtkWidget *widget,
4937 gboolean group_cycling)
4939 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4941 gtk_widget_grab_focus (combo_box->priv->button);
4947 gtk_combo_box_grab_focus (GtkWidget *widget)
4949 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4951 gtk_widget_grab_focus (combo_box->priv->button);
4955 gtk_combo_box_destroy (GtkObject *object)
4957 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
4959 if (combo_box->priv->popup_idle_id > 0)
4961 g_source_remove (combo_box->priv->popup_idle_id);
4962 combo_box->priv->popup_idle_id = 0;
4965 gtk_combo_box_popdown (combo_box);
4967 if (combo_box->priv->row_separator_destroy)
4968 (* combo_box->priv->row_separator_destroy) (combo_box->priv->row_separator_data);
4970 combo_box->priv->row_separator_func = NULL;
4971 combo_box->priv->row_separator_data = NULL;
4972 combo_box->priv->row_separator_destroy = NULL;
4974 GTK_OBJECT_CLASS (gtk_combo_box_parent_class)->destroy (object);
4975 combo_box->priv->cell_view = NULL;
4979 gtk_combo_box_finalize (GObject *object)
4981 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
4984 if (GTK_IS_MENU (combo_box->priv->popup_widget))
4986 gtk_combo_box_menu_destroy (combo_box);
4987 gtk_menu_detach (GTK_MENU (combo_box->priv->popup_widget));
4988 combo_box->priv->popup_widget = NULL;
4991 if (GTK_IS_TREE_VIEW (combo_box->priv->tree_view))
4992 gtk_combo_box_list_destroy (combo_box);
4994 if (combo_box->priv->popup_window)
4995 gtk_widget_destroy (combo_box->priv->popup_window);
4997 gtk_combo_box_unset_model (combo_box);
4999 for (i = combo_box->priv->cells; i; i = i->next)
5001 ComboCellInfo *info = (ComboCellInfo *)i->data;
5002 GSList *list = info->attributes;
5005 info->destroy (info->func_data);
5007 while (list && list->next)
5009 g_free (list->data);
5010 list = list->next->next;
5012 g_slist_free (info->attributes);
5014 g_object_unref (info->cell);
5017 g_slist_free (combo_box->priv->cells);
5019 g_free (combo_box->priv->tearoff_title);
5021 G_OBJECT_CLASS (gtk_combo_box_parent_class)->finalize (object);
5025 gtk_cell_editable_key_press (GtkWidget *widget,
5029 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
5031 if (event->keyval == GDK_Escape)
5033 combo_box->priv->editing_canceled = TRUE;
5035 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
5036 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
5040 else if (event->keyval == GDK_Return)
5042 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
5043 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
5052 popdown_idle (gpointer data)
5054 GtkComboBox *combo_box;
5056 GDK_THREADS_ENTER ();
5058 combo_box = GTK_COMBO_BOX (data);
5060 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
5061 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
5063 g_object_unref (combo_box);
5065 GDK_THREADS_LEAVE ();
5071 popdown_handler (GtkWidget *widget,
5074 g_idle_add (popdown_idle, g_object_ref (data));
5078 popup_idle (gpointer data)
5080 GtkComboBox *combo_box;
5082 GDK_THREADS_ENTER ();
5084 combo_box = GTK_COMBO_BOX (data);
5086 if (GTK_IS_MENU (combo_box->priv->popup_widget) &&
5087 combo_box->priv->cell_view)
5088 g_signal_connect_object (combo_box->priv->popup_widget,
5089 "unmap", G_CALLBACK (popdown_handler),
5092 /* we unset this if a menu item is activated */
5093 combo_box->priv->editing_canceled = TRUE;
5094 gtk_combo_box_popup (combo_box);
5096 combo_box->priv->popup_idle_id = 0;
5098 GDK_THREADS_LEAVE ();
5104 gtk_combo_box_start_editing (GtkCellEditable *cell_editable,
5107 GtkComboBox *combo_box = GTK_COMBO_BOX (cell_editable);
5109 combo_box->priv->is_cell_renderer = TRUE;
5111 if (combo_box->priv->cell_view)
5113 g_signal_connect_object (combo_box->priv->button, "key_press_event",
5114 G_CALLBACK (gtk_cell_editable_key_press),
5117 gtk_widget_grab_focus (combo_box->priv->button);
5121 g_signal_connect_object (GTK_BIN (combo_box)->child, "key_press_event",
5122 G_CALLBACK (gtk_cell_editable_key_press),
5125 gtk_widget_grab_focus (GTK_WIDGET (GTK_BIN (combo_box)->child));
5126 GTK_WIDGET_UNSET_FLAGS (combo_box->priv->button, GTK_CAN_FOCUS);
5129 /* we do the immediate popup only for the optionmenu-like
5132 if (combo_box->priv->is_cell_renderer &&
5133 combo_box->priv->cell_view && !combo_box->priv->tree_view)
5134 combo_box->priv->popup_idle_id = g_idle_add (popup_idle, combo_box);
5139 * gtk_combo_box_get_add_tearoffs:
5140 * @combo_box: a #GtkComboBox
5142 * Gets the current value of the :add-tearoffs property.
5144 * Return value: the current value of the :add-tearoffs property.
5147 gtk_combo_box_get_add_tearoffs (GtkComboBox *combo_box)
5149 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5151 return combo_box->priv->add_tearoffs;
5155 * gtk_combo_box_set_add_tearoffs:
5156 * @combo_box: a #GtkComboBox
5157 * @add_tearoffs: %TRUE to add tearoff menu items
5159 * Sets whether the popup menu should have a tearoff
5165 gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box,
5166 gboolean add_tearoffs)
5168 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5170 add_tearoffs = add_tearoffs != FALSE;
5172 if (combo_box->priv->add_tearoffs != add_tearoffs)
5174 combo_box->priv->add_tearoffs = add_tearoffs;
5175 gtk_combo_box_check_appearance (combo_box);
5176 gtk_combo_box_relayout (combo_box);
5177 g_object_notify (G_OBJECT (combo_box), "add-tearoffs");
5182 * gtk_combo_box_get_title:
5183 * @combo_box: a #GtkComboBox
5185 * Gets the current title of the menu in tearoff mode. See
5186 * gtk_combo_box_set_add_tearoffs().
5188 * Returns: the menu's title in tearoff mode. This is an internal copy of the
5189 * string which must not be freed.
5193 G_CONST_RETURN gchar*
5194 gtk_combo_box_get_title (GtkComboBox *combo_box)
5196 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
5198 return combo_box->priv->tearoff_title;
5202 gtk_combo_box_update_title (GtkComboBox *combo_box)
5204 gtk_combo_box_check_appearance (combo_box);
5206 if (combo_box->priv->popup_widget &&
5207 GTK_IS_MENU (combo_box->priv->popup_widget))
5208 gtk_menu_set_title (GTK_MENU (combo_box->priv->popup_widget),
5209 combo_box->priv->tearoff_title);
5213 * gtk_combo_box_set_title:
5214 * @combo_box: a #GtkComboBox
5215 * @title: a title for the menu in tearoff mode.
5217 * Sets the menu's title in tearoff mode.
5222 gtk_combo_box_set_title (GtkComboBox *combo_box,
5225 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5227 if (strcmp (title ? title : "",
5228 combo_box->priv->tearoff_title ? combo_box->priv->tearoff_title : "") != 0)
5230 g_free (combo_box->priv->tearoff_title);
5231 combo_box->priv->tearoff_title = g_strdup (title);
5233 gtk_combo_box_update_title (combo_box);
5235 g_object_notify (G_OBJECT (combo_box), "tearoff-title");
5240 _gtk_combo_box_editing_canceled (GtkComboBox *combo_box)
5242 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), TRUE);
5244 return combo_box->priv->editing_canceled;
5248 * gtk_combo_box_get_popup_accessible:
5249 * @combo_box: a #GtkComboBox
5251 * Gets the accessible object corresponding to the combo box's popup.
5253 * This function is mostly intended for use by accessibility technologies;
5254 * applications should have little use for it.
5256 * Returns: the accessible object corresponding to the combo box's popup.
5261 gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box)
5265 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
5267 if (combo_box->priv->popup_widget)
5269 atk_obj = gtk_widget_get_accessible (combo_box->priv->popup_widget);
5277 * gtk_combo_box_get_row_separator_func:
5278 * @combo_box: a #GtkComboBox
5280 * Returns the current row separator function.
5282 * Return value: the current row separator function.
5286 GtkTreeViewRowSeparatorFunc
5287 gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box)
5289 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
5291 return combo_box->priv->row_separator_func;
5295 * gtk_combo_box_set_row_separator_func:
5296 * @combo_box: a #GtkComboBox
5297 * @func: a #GtkTreeViewRowSeparatorFunc
5298 * @data: user data to pass to @func, or %NULL
5299 * @destroy: destroy notifier for @data, or %NULL
5301 * Sets the row separator function, which is used to determine
5302 * whether a row should be drawn as a separator. If the row separator
5303 * function is %NULL, no separators are drawn. This is the default value.
5308 gtk_combo_box_set_row_separator_func (GtkComboBox *combo_box,
5309 GtkTreeViewRowSeparatorFunc func,
5311 GtkDestroyNotify destroy)
5313 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5315 if (combo_box->priv->row_separator_destroy)
5316 (* combo_box->priv->row_separator_destroy) (combo_box->priv->row_separator_data);
5318 combo_box->priv->row_separator_func = func;
5319 combo_box->priv->row_separator_data = data;
5320 combo_box->priv->row_separator_destroy = destroy;
5322 if (combo_box->priv->tree_view)
5323 gtk_tree_view_set_row_separator_func (GTK_TREE_VIEW (combo_box->priv->tree_view),
5326 gtk_combo_box_relayout (combo_box);
5328 gtk_widget_queue_draw (GTK_WIDGET (combo_box));
5333 * gtk_combo_box_set_focus_on_click:
5334 * @combo: a #GtkComboBox
5335 * @focus_on_click: whether the combo box grabs focus when clicked
5338 * Sets whether the combo box will grab focus when it is clicked with
5339 * the mouse. Making mouse clicks not grab focus is useful in places
5340 * like toolbars where you don't want the keyboard focus removed from
5341 * the main area of the application.
5346 gtk_combo_box_set_focus_on_click (GtkComboBox *combo_box,
5347 gboolean focus_on_click)
5349 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5351 focus_on_click = focus_on_click != FALSE;
5353 if (combo_box->priv->focus_on_click != focus_on_click)
5355 combo_box->priv->focus_on_click = focus_on_click;
5357 if (combo_box->priv->button)
5358 gtk_button_set_focus_on_click (GTK_BUTTON (combo_box->priv->button),
5361 g_object_notify (G_OBJECT (combo_box), "focus-on-click");
5366 * gtk_combo_box_get_focus_on_click:
5367 * @combo: a #GtkComboBox
5369 * Returns whether the combo box grabs focus when it is clicked
5370 * with the mouse. See gtk_combo_box_set_focus_on_click().
5372 * Return value: %TRUE if the combo box grabs focus when it is
5373 * clicked with the mouse.
5378 gtk_combo_box_get_focus_on_click (GtkComboBox *combo_box)
5380 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5382 return combo_box->priv->focus_on_click;
5386 #define __GTK_COMBO_BOX_C__
5387 #include "gtkaliasdef.c"