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"
22 #include "gtkcellareabox.h"
23 #include "gtktreemenu.h"
25 #include "gtkbindings.h"
26 #include "gtkcelllayout.h"
27 #include "gtkcellrenderertext.h"
28 #include "gtkcellview.h"
29 #include "gtkeventbox.h"
32 #include "gtkliststore.h"
34 #include "gtkmenuprivate.h"
35 #include "gtkmenushellprivate.h"
36 #include "gtkscrolledwindow.h"
37 #include "gtkseparatormenuitem.h"
38 #include "gtktearoffmenuitem.h"
39 #include "gtktogglebutton.h"
40 #include "gtktreeselection.h"
41 #include "gtkvseparator.h"
42 #include "gtkwindow.h"
43 #include "gtktypebuiltins.h"
44 #include "gtkprivate.h"
46 #include <gobject/gvaluecollector.h>
51 #include "gtkmarshalers.h"
54 #include "gtkentryprivate.h"
55 #include "gtktreeprivate.h"
60 * @Short_description: A widget used to choose from a list of items
62 * @See_also: #GtkComboBoxText, #GtkTreeModel, #GtkCellRenderer
64 * A GtkComboBox is a widget that allows the user to choose from a list of
65 * valid choices. The GtkComboBox displays the selected choice. When
66 * activated, the GtkComboBox displays a popup which allows the user to
67 * make a new choice. The style in which the selected value is displayed,
68 * and the style of the popup is determined by the current theme. It may
69 * be similar to a Windows-style combo box.
71 * The GtkComboBox uses the model-view pattern; the list of valid choices
72 * is specified in the form of a tree model, and the display of the choices
73 * can be adapted to the data in the model by using cell renderers, as you
74 * would in a tree view. This is possible since GtkComboBox implements the
75 * #GtkCellLayout interface. The tree model holding the valid choices is
76 * not restricted to a flat list, it can be a real tree, and the popup will
77 * reflect the tree structure.
79 * To allow the user to enter values not in the model, the 'has-entry'
80 * property allows the GtkComboBox to contain a #GtkEntry. This entry
81 * can be accessed by calling gtk_bin_get_child() on the combo box.
83 * For a simple list of textual choices, the model-view API of GtkComboBox
84 * can be a bit overwhelming. In this case, #GtkComboBoxText offers a
85 * simple alternative. Both GtkComboBox and #GtkComboBoxText can contain
90 /* WELCOME, to THE house of evil code */
91 struct _GtkComboBoxPrivate
101 GtkShadowType shadow_type;
103 gint active; /* Only temporary */
104 GtkTreeRowReference *active_row;
106 GtkWidget *tree_view;
108 GtkWidget *cell_view;
109 GtkWidget *cell_view_frame;
114 GtkWidget *separator;
116 GtkWidget *popup_widget;
117 GtkWidget *popup_window;
118 GtkWidget *scrolled_window;
125 guint activate_button;
126 guint32 activate_time;
128 guint resize_idle_id;
130 /* For "has-entry" specific behavior we track
131 * an automated cell renderer and text column
134 GtkCellRenderer *text_renderer;
138 guint popup_in_progress : 1;
139 guint popup_shown : 1;
140 guint add_tearoffs : 1;
142 guint is_cell_renderer : 1;
143 guint editing_canceled : 1;
144 guint auto_scroll : 1;
145 guint focus_on_click : 1;
146 guint button_sensitivity : 2;
148 guint popup_fixed_width : 1;
150 GtkTreeViewRowSeparatorFunc row_separator_func;
151 gpointer row_separator_data;
152 GDestroyNotify row_separator_destroy;
154 GdkDevice *grab_pointer;
155 GdkDevice *grab_keyboard;
157 gchar *tearoff_title;
160 /* While debugging this evil code, I have learned that
161 * there are actually 4 modes to this widget, which can
162 * be characterized as follows
164 * 1) menu mode, no child added
167 * cell_view -> GtkCellView, regular child
168 * cell_view_frame -> NULL
169 * button -> GtkToggleButton set_parent to combo
170 * arrow -> GtkArrow set_parent to button
171 * separator -> GtkVSepator set_parent to button
172 * popup_widget -> GtkMenu
173 * popup_window -> NULL
174 * scrolled_window -> NULL
176 * 2) menu mode, child added
180 * cell_view_frame -> NULL
181 * button -> GtkToggleButton set_parent to combo
182 * arrow -> GtkArrow, child of button
184 * popup_widget -> GtkMenu
185 * popup_window -> NULL
186 * scrolled_window -> NULL
188 * 3) list mode, no child added
190 * tree_view -> GtkTreeView, child of scrolled_window
191 * cell_view -> GtkCellView, regular child
192 * cell_view_frame -> GtkFrame, set parent to combo
193 * button -> GtkToggleButton, set_parent to combo
194 * arrow -> GtkArrow, child of button
196 * popup_widget -> tree_view
197 * popup_window -> GtkWindow
198 * scrolled_window -> GtkScrolledWindow, child of popup_window
200 * 4) list mode, child added
202 * tree_view -> GtkTreeView, child of scrolled_window
204 * cell_view_frame -> NULL
205 * button -> GtkToggleButton, set_parent to combo
206 * arrow -> GtkArrow, child of button
208 * popup_widget -> tree_view
209 * popup_window -> GtkWindow
210 * scrolled_window -> GtkScrolledWindow, child of popup_window
226 PROP_ROW_SPAN_COLUMN,
227 PROP_COLUMN_SPAN_COLUMN,
234 PROP_BUTTON_SENSITIVITY,
235 PROP_EDITING_CANCELED,
237 PROP_ENTRY_TEXT_COLUMN,
238 PROP_POPUP_FIXED_WIDTH,
244 static guint combo_box_signals[LAST_SIGNAL] = {0,};
246 #define BONUS_PADDING 4
247 #define SCROLL_TIME 100
251 static void gtk_combo_box_cell_layout_init (GtkCellLayoutIface *iface);
252 static void gtk_combo_box_cell_editable_init (GtkCellEditableIface *iface);
253 static GObject *gtk_combo_box_constructor (GType type,
254 guint n_construct_properties,
255 GObjectConstructParam *construct_properties);
256 static void gtk_combo_box_dispose (GObject *object);
257 static void gtk_combo_box_finalize (GObject *object);
258 static void gtk_combo_box_destroy (GtkWidget *widget);
260 static void gtk_combo_box_set_property (GObject *object,
264 static void gtk_combo_box_get_property (GObject *object,
269 static void gtk_combo_box_state_flags_changed (GtkWidget *widget,
270 GtkStateFlags previous);
271 static void gtk_combo_box_grab_focus (GtkWidget *widget);
272 static void gtk_combo_box_style_updated (GtkWidget *widget);
273 static void gtk_combo_box_button_toggled (GtkWidget *widget,
275 static void gtk_combo_box_button_state_flags_changed (GtkWidget *widget,
276 GtkStateFlags previous,
278 static void gtk_combo_box_add (GtkContainer *container,
280 static void gtk_combo_box_remove (GtkContainer *container,
283 static void gtk_combo_box_menu_show (GtkWidget *menu,
285 static void gtk_combo_box_menu_hide (GtkWidget *menu,
288 static void gtk_combo_box_set_popup_widget (GtkComboBox *combo_box,
290 static void gtk_combo_box_menu_position_below (GtkMenu *menu,
295 static void gtk_combo_box_menu_position_over (GtkMenu *menu,
300 static void gtk_combo_box_menu_position (GtkMenu *menu,
306 static void gtk_combo_box_unset_model (GtkComboBox *combo_box);
308 static void gtk_combo_box_size_allocate (GtkWidget *widget,
309 GtkAllocation *allocation);
310 static void gtk_combo_box_forall (GtkContainer *container,
311 gboolean include_internals,
312 GtkCallback callback,
313 gpointer callback_data);
314 static gboolean gtk_combo_box_draw (GtkWidget *widget,
316 static gboolean gtk_combo_box_scroll_event (GtkWidget *widget,
317 GdkEventScroll *event);
318 static void gtk_combo_box_set_active_internal (GtkComboBox *combo_box,
321 static void gtk_combo_box_check_appearance (GtkComboBox *combo_box);
322 static void gtk_combo_box_real_move_active (GtkComboBox *combo_box,
323 GtkScrollType scroll);
324 static void gtk_combo_box_real_popup (GtkComboBox *combo_box);
325 static gboolean gtk_combo_box_real_popdown (GtkComboBox *combo_box);
327 /* listening to the model */
328 static void gtk_combo_box_model_row_inserted (GtkTreeModel *model,
332 static void gtk_combo_box_model_row_deleted (GtkTreeModel *model,
335 static void gtk_combo_box_model_rows_reordered (GtkTreeModel *model,
340 static void gtk_combo_box_model_row_changed (GtkTreeModel *model,
344 static void gtk_combo_box_model_row_expanded (GtkTreeModel *model,
350 static void gtk_combo_box_list_position (GtkComboBox *combo_box,
355 static void gtk_combo_box_list_setup (GtkComboBox *combo_box);
356 static void gtk_combo_box_list_destroy (GtkComboBox *combo_box);
358 static gboolean gtk_combo_box_list_button_released (GtkWidget *widget,
359 GdkEventButton *event,
361 static gboolean gtk_combo_box_list_key_press (GtkWidget *widget,
364 static gboolean gtk_combo_box_list_enter_notify (GtkWidget *widget,
365 GdkEventCrossing *event,
367 static void gtk_combo_box_list_auto_scroll (GtkComboBox *combo,
370 static gboolean gtk_combo_box_list_scroll_timeout (GtkComboBox *combo);
371 static gboolean gtk_combo_box_list_button_pressed (GtkWidget *widget,
372 GdkEventButton *event,
375 static gboolean gtk_combo_box_list_select_func (GtkTreeSelection *selection,
378 gboolean path_currently_selected,
381 static void gtk_combo_box_list_row_changed (GtkTreeModel *model,
385 static void gtk_combo_box_list_popup_resize (GtkComboBox *combo_box);
388 static void gtk_combo_box_menu_setup (GtkComboBox *combo_box,
389 gboolean add_children);
390 static void gtk_combo_box_update_title (GtkComboBox *combo_box);
391 static void gtk_combo_box_menu_destroy (GtkComboBox *combo_box);
394 static gboolean gtk_combo_box_menu_button_press (GtkWidget *widget,
395 GdkEventButton *event,
397 static void gtk_combo_box_menu_activate (GtkWidget *menu,
399 GtkComboBox *combo_box);
400 static void gtk_combo_box_update_sensitivity (GtkComboBox *combo_box);
401 static gboolean gtk_combo_box_menu_key_press (GtkWidget *widget,
404 static void gtk_combo_box_menu_popup (GtkComboBox *combo_box,
406 guint32 activate_time);
409 static GtkCellArea *gtk_combo_box_cell_layout_get_area (GtkCellLayout *cell_layout);
411 static gboolean gtk_combo_box_mnemonic_activate (GtkWidget *widget,
412 gboolean group_cycling);
414 static void gtk_combo_box_child_show (GtkWidget *widget,
415 GtkComboBox *combo_box);
416 static void gtk_combo_box_child_hide (GtkWidget *widget,
417 GtkComboBox *combo_box);
419 /* GtkComboBox:has-entry callbacks */
420 static void gtk_combo_box_entry_contents_changed (GtkEntry *entry,
422 static void gtk_combo_box_entry_active_changed (GtkComboBox *combo_box,
426 /* GtkBuildable method implementation */
427 static GtkBuildableIface *parent_buildable_iface;
429 static void gtk_combo_box_buildable_init (GtkBuildableIface *iface);
430 static gboolean gtk_combo_box_buildable_custom_tag_start (GtkBuildable *buildable,
433 const gchar *tagname,
434 GMarkupParser *parser,
436 static void gtk_combo_box_buildable_custom_tag_end (GtkBuildable *buildable,
439 const gchar *tagname,
441 static GObject *gtk_combo_box_buildable_get_internal_child (GtkBuildable *buildable,
443 const gchar *childname);
446 /* GtkCellEditable method implementations */
447 static void gtk_combo_box_start_editing (GtkCellEditable *cell_editable,
450 static void gtk_combo_box_get_preferred_width (GtkWidget *widget,
453 static void gtk_combo_box_get_preferred_height (GtkWidget *widget,
456 static void gtk_combo_box_get_preferred_width_for_height (GtkWidget *widget,
460 static void gtk_combo_box_get_preferred_height_for_width (GtkWidget *widget,
466 G_DEFINE_TYPE_WITH_CODE (GtkComboBox, gtk_combo_box, GTK_TYPE_BIN,
467 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
468 gtk_combo_box_cell_layout_init)
469 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_EDITABLE,
470 gtk_combo_box_cell_editable_init)
471 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
472 gtk_combo_box_buildable_init))
477 gtk_combo_box_class_init (GtkComboBoxClass *klass)
479 GObjectClass *object_class;
480 GtkContainerClass *container_class;
481 GtkWidgetClass *widget_class;
482 GtkBindingSet *binding_set;
484 container_class = (GtkContainerClass *)klass;
485 container_class->forall = gtk_combo_box_forall;
486 container_class->add = gtk_combo_box_add;
487 container_class->remove = gtk_combo_box_remove;
489 widget_class = (GtkWidgetClass *)klass;
490 widget_class->size_allocate = gtk_combo_box_size_allocate;
491 widget_class->draw = gtk_combo_box_draw;
492 widget_class->scroll_event = gtk_combo_box_scroll_event;
493 widget_class->mnemonic_activate = gtk_combo_box_mnemonic_activate;
494 widget_class->grab_focus = gtk_combo_box_grab_focus;
495 widget_class->style_updated = gtk_combo_box_style_updated;
496 widget_class->state_flags_changed = gtk_combo_box_state_flags_changed;
497 widget_class->get_preferred_width = gtk_combo_box_get_preferred_width;
498 widget_class->get_preferred_height = gtk_combo_box_get_preferred_height;
499 widget_class->get_preferred_height_for_width = gtk_combo_box_get_preferred_height_for_width;
500 widget_class->get_preferred_width_for_height = gtk_combo_box_get_preferred_width_for_height;
501 widget_class->destroy = gtk_combo_box_destroy;
503 object_class = (GObjectClass *)klass;
504 object_class->constructor = gtk_combo_box_constructor;
505 object_class->dispose = gtk_combo_box_dispose;
506 object_class->finalize = gtk_combo_box_finalize;
507 object_class->set_property = gtk_combo_box_set_property;
508 object_class->get_property = gtk_combo_box_get_property;
512 * GtkComboBox::changed:
513 * @widget: the object which received the signal
515 * The changed signal is emitted when the active
516 * item is changed. The can be due to the user selecting
517 * a different item from the list, or due to a
518 * call to gtk_combo_box_set_active_iter().
519 * It will also be emitted while typing into the entry of a combo box
524 combo_box_signals[CHANGED] =
525 g_signal_new (I_("changed"),
526 G_OBJECT_CLASS_TYPE (klass),
528 G_STRUCT_OFFSET (GtkComboBoxClass, changed),
530 g_cclosure_marshal_VOID__VOID,
533 * GtkComboBox::move-active:
534 * @widget: the object that received the signal
535 * @scroll_type: a #GtkScrollType
537 * The ::move-active signal is a
538 * <link linkend="keybinding-signals">keybinding signal</link>
539 * which gets emitted to move the active selection.
543 combo_box_signals[MOVE_ACTIVE] =
544 g_signal_new_class_handler (I_("move-active"),
545 G_OBJECT_CLASS_TYPE (klass),
546 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
547 G_CALLBACK (gtk_combo_box_real_move_active),
549 g_cclosure_marshal_VOID__ENUM,
551 GTK_TYPE_SCROLL_TYPE);
554 * GtkComboBox::popup:
555 * @widget: the object that received the signal
557 * The ::popup signal is a
558 * <link linkend="keybinding-signals">keybinding signal</link>
559 * which gets emitted to popup the combo box list.
561 * The default binding for this signal is Alt+Down.
565 combo_box_signals[POPUP] =
566 g_signal_new_class_handler (I_("popup"),
567 G_OBJECT_CLASS_TYPE (klass),
568 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
569 G_CALLBACK (gtk_combo_box_real_popup),
571 g_cclosure_marshal_VOID__VOID,
574 * GtkComboBox::popdown:
575 * @button: the object which received the signal
577 * The ::popdown signal is a
578 * <link linkend="keybinding-signals">keybinding signal</link>
579 * which gets emitted to popdown the combo box list.
581 * The default bindings for this signal are Alt+Up and Escape.
585 combo_box_signals[POPDOWN] =
586 g_signal_new_class_handler (I_("popdown"),
587 G_OBJECT_CLASS_TYPE (klass),
588 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
589 G_CALLBACK (gtk_combo_box_real_popdown),
591 _gtk_marshal_BOOLEAN__VOID,
595 binding_set = gtk_binding_set_by_class (widget_class);
597 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Down, GDK_MOD1_MASK,
599 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Down, GDK_MOD1_MASK,
602 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Up, GDK_MOD1_MASK,
604 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Up, GDK_MOD1_MASK,
606 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Escape, 0,
609 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Up, 0,
611 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_STEP_UP);
612 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Up, 0,
614 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_STEP_UP);
615 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Page_Up, 0,
617 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_PAGE_UP);
618 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Page_Up, 0,
620 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_PAGE_UP);
621 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Home, 0,
623 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_START);
624 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Home, 0,
626 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_START);
628 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Down, 0,
630 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_STEP_DOWN);
631 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Down, 0,
633 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_STEP_DOWN);
634 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Page_Down, 0,
636 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_PAGE_DOWN);
637 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Page_Down, 0,
639 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_PAGE_DOWN);
640 gtk_binding_entry_add_signal (binding_set, GDK_KEY_End, 0,
642 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_END);
643 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_End, 0,
645 GTK_TYPE_SCROLL_TYPE, GTK_SCROLL_END);
648 g_object_class_override_property (object_class,
649 PROP_EDITING_CANCELED,
655 * The model from which the combo box takes the values shown
660 g_object_class_install_property (object_class,
662 g_param_spec_object ("model",
663 P_("ComboBox model"),
664 P_("The model for the combo box"),
666 GTK_PARAM_READWRITE));
669 * GtkComboBox:wrap-width:
671 * If wrap-width is set to a positive value, the list will be
672 * displayed in multiple columns, the number of columns is
673 * determined by wrap-width.
677 g_object_class_install_property (object_class,
679 g_param_spec_int ("wrap-width",
681 P_("Wrap width for laying out the items in a grid"),
685 GTK_PARAM_READWRITE));
689 * GtkComboBox:row-span-column:
691 * If this is set to a non-negative value, it must be the index of a column
692 * of type %G_TYPE_INT in the model.
694 * The values of that column are used to determine how many rows a value in
695 * the list will span. Therefore, the values in the model column pointed to
696 * by this property must be greater than zero and not larger than wrap-width.
700 g_object_class_install_property (object_class,
701 PROP_ROW_SPAN_COLUMN,
702 g_param_spec_int ("row-span-column",
703 P_("Row span column"),
704 P_("TreeModel column containing the row span values"),
708 GTK_PARAM_READWRITE));
712 * GtkComboBox:column-span-column:
714 * If this is set to a non-negative value, it must be the index of a column
715 * of type %G_TYPE_INT in the model.
717 * The values of that column are used to determine how many columns a value
718 * in the list will span.
722 g_object_class_install_property (object_class,
723 PROP_COLUMN_SPAN_COLUMN,
724 g_param_spec_int ("column-span-column",
725 P_("Column span column"),
726 P_("TreeModel column containing the column span values"),
730 GTK_PARAM_READWRITE));
734 * GtkComboBox:active:
736 * The item which is currently active. If the model is a non-flat treemodel,
737 * and the active item is not an immediate child of the root of the tree,
738 * this property has the value
739 * <literal>gtk_tree_path_get_indices (path)[0]</literal>,
740 * where <literal>path</literal> is the #GtkTreePath of the active item.
744 g_object_class_install_property (object_class,
746 g_param_spec_int ("active",
748 P_("The item which is currently active"),
752 GTK_PARAM_READWRITE));
755 * GtkComboBox:add-tearoffs:
757 * The add-tearoffs property controls whether generated menus
758 * have tearoff menu items.
760 * Note that this only affects menu style combo boxes.
764 g_object_class_install_property (object_class,
766 g_param_spec_boolean ("add-tearoffs",
767 P_("Add tearoffs to menus"),
768 P_("Whether dropdowns should have a tearoff menu item"),
770 GTK_PARAM_READWRITE));
773 * GtkComboBox:has-frame:
775 * The has-frame property controls whether a frame
776 * is drawn around the entry.
780 g_object_class_install_property (object_class,
782 g_param_spec_boolean ("has-frame",
784 P_("Whether the combo box draws a frame around the child"),
786 GTK_PARAM_READWRITE));
788 g_object_class_install_property (object_class,
790 g_param_spec_boolean ("focus-on-click",
791 P_("Focus on click"),
792 P_("Whether the combo box grabs focus when it is clicked with the mouse"),
794 GTK_PARAM_READWRITE));
797 * GtkComboBox:tearoff-title:
799 * A title that may be displayed by the window manager
800 * when the popup is torn-off.
804 g_object_class_install_property (object_class,
806 g_param_spec_string ("tearoff-title",
808 P_("A title that may be displayed by the window manager when the popup is torn-off"),
810 GTK_PARAM_READWRITE));
814 * GtkComboBox:popup-shown:
816 * Whether the combo boxes dropdown is popped up.
817 * Note that this property is mainly useful, because
818 * it allows you to connect to notify::popup-shown.
822 g_object_class_install_property (object_class,
824 g_param_spec_boolean ("popup-shown",
826 P_("Whether the combo's dropdown is shown"),
828 GTK_PARAM_READABLE));
832 * GtkComboBox:button-sensitivity:
834 * Whether the dropdown button is sensitive when
835 * the model is empty.
839 g_object_class_install_property (object_class,
840 PROP_BUTTON_SENSITIVITY,
841 g_param_spec_enum ("button-sensitivity",
842 P_("Button Sensitivity"),
843 P_("Whether the dropdown button is sensitive when the model is empty"),
844 GTK_TYPE_SENSITIVITY_TYPE,
845 GTK_SENSITIVITY_AUTO,
846 GTK_PARAM_READWRITE));
849 * GtkComboBox:has-entry:
851 * Whether the combo box has an entry.
855 g_object_class_install_property (object_class,
857 g_param_spec_boolean ("has-entry",
859 P_("Whether combo box has an entry"),
861 GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
864 * GtkComboBox:entry-text-column:
866 * The column in the combo box's model to associate with strings from the entry
867 * if the combo was created with #GtkComboBox:has-entry = %TRUE.
871 g_object_class_install_property (object_class,
872 PROP_ENTRY_TEXT_COLUMN,
873 g_param_spec_int ("entry-text-column",
874 P_("Entry Text Column"),
875 P_("The column in the combo box's model to associate "
876 "with strings from the entry if the combo was "
877 "created with #GtkComboBox:has-entry = %TRUE"),
879 GTK_PARAM_READWRITE));
882 * GtkComboBox:id-column:
884 * The column in the combo box's model that provides string
885 * IDs for the values in the model, if != -1.
889 g_object_class_install_property (object_class,
891 g_param_spec_int ("id-column",
893 P_("The column in the combo box's model that provides "
894 "string IDs for the values in the model"),
896 GTK_PARAM_READWRITE));
899 * GtkComboBox:active-id:
901 * The value of the ID column of the active row.
905 g_object_class_install_property (object_class,
907 g_param_spec_string ("active-id",
909 P_("The value of the id column "
910 "for the active row"),
911 NULL, GTK_PARAM_READWRITE));
914 * GtkComboBox:popup-fixed-width:
916 * Whether the popup's width should be a fixed width matching the
917 * allocated width of the combo box.
921 g_object_class_install_property (object_class,
922 PROP_POPUP_FIXED_WIDTH,
923 g_param_spec_boolean ("popup-fixed-width",
924 P_("Popup Fixed Width"),
925 P_("Whether the popup's width should be a "
926 "fixed width matching the allocated width "
929 GTK_PARAM_READWRITE));
932 * GtkComboBox:cell-area:
934 * The #GtkCellArea used to layout cell renderers for this combo box.
938 g_object_class_install_property (object_class,
940 g_param_spec_object ("cell-area",
942 P_("The GtkCellArea used to layout cells"),
944 GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
946 gtk_widget_class_install_style_property (widget_class,
947 g_param_spec_boolean ("appears-as-list",
948 P_("Appears as list"),
949 P_("Whether dropdowns should look like lists rather than menus"),
951 GTK_PARAM_READABLE));
954 * GtkComboBox:arrow-size:
956 * Sets the minimum size of the arrow in the combo box. Note
957 * that the arrow size is coupled to the font size, so in case
958 * a larger font is used, the arrow will be larger than set
963 gtk_widget_class_install_style_property (widget_class,
964 g_param_spec_int ("arrow-size",
966 P_("The minimum size of the arrow in the combo box"),
970 GTK_PARAM_READABLE));
973 * GtkComboBox:shadow-type:
975 * Which kind of shadow to draw around the combo box.
979 gtk_widget_class_install_style_property (widget_class,
980 g_param_spec_enum ("shadow-type",
982 P_("Which kind of shadow to draw around the combo box"),
983 GTK_TYPE_SHADOW_TYPE,
985 GTK_PARAM_READABLE));
987 g_type_class_add_private (object_class, sizeof (GtkComboBoxPrivate));
991 gtk_combo_box_buildable_init (GtkBuildableIface *iface)
993 parent_buildable_iface = g_type_interface_peek_parent (iface);
994 iface->add_child = _gtk_cell_layout_buildable_add_child;
995 iface->custom_tag_start = gtk_combo_box_buildable_custom_tag_start;
996 iface->custom_tag_end = gtk_combo_box_buildable_custom_tag_end;
997 iface->get_internal_child = gtk_combo_box_buildable_get_internal_child;
1001 gtk_combo_box_cell_layout_init (GtkCellLayoutIface *iface)
1003 iface->get_area = gtk_combo_box_cell_layout_get_area;
1007 gtk_combo_box_cell_editable_init (GtkCellEditableIface *iface)
1009 iface->start_editing = gtk_combo_box_start_editing;
1013 gtk_combo_box_init (GtkComboBox *combo_box)
1015 GtkComboBoxPrivate *priv;
1017 combo_box->priv = G_TYPE_INSTANCE_GET_PRIVATE (combo_box,
1019 GtkComboBoxPrivate);
1020 priv = combo_box->priv;
1022 priv->wrap_width = 0;
1025 priv->active_row = NULL;
1026 priv->col_column = -1;
1027 priv->row_column = -1;
1029 priv->popup_shown = FALSE;
1030 priv->add_tearoffs = FALSE;
1031 priv->has_frame = TRUE;
1032 priv->is_cell_renderer = FALSE;
1033 priv->editing_canceled = FALSE;
1034 priv->auto_scroll = FALSE;
1035 priv->focus_on_click = TRUE;
1036 priv->button_sensitivity = GTK_SENSITIVITY_AUTO;
1037 priv->has_entry = FALSE;
1038 priv->popup_fixed_width = TRUE;
1040 priv->text_column = -1;
1041 priv->text_renderer = NULL;
1042 priv->id_column = -1;
1046 gtk_combo_box_set_property (GObject *object,
1048 const GValue *value,
1051 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
1052 GtkComboBoxPrivate *priv = combo_box->priv;
1058 gtk_combo_box_set_model (combo_box, g_value_get_object (value));
1061 case PROP_WRAP_WIDTH:
1062 gtk_combo_box_set_wrap_width (combo_box, g_value_get_int (value));
1065 case PROP_ROW_SPAN_COLUMN:
1066 gtk_combo_box_set_row_span_column (combo_box, g_value_get_int (value));
1069 case PROP_COLUMN_SPAN_COLUMN:
1070 gtk_combo_box_set_column_span_column (combo_box, g_value_get_int (value));
1074 gtk_combo_box_set_active (combo_box, g_value_get_int (value));
1077 case PROP_ADD_TEAROFFS:
1078 gtk_combo_box_set_add_tearoffs (combo_box, g_value_get_boolean (value));
1081 case PROP_HAS_FRAME:
1082 priv->has_frame = g_value_get_boolean (value);
1084 if (priv->has_entry)
1088 child = gtk_bin_get_child (GTK_BIN (combo_box));
1090 gtk_entry_set_has_frame (GTK_ENTRY (child), priv->has_frame);
1095 case PROP_FOCUS_ON_CLICK:
1096 gtk_combo_box_set_focus_on_click (combo_box,
1097 g_value_get_boolean (value));
1100 case PROP_TEAROFF_TITLE:
1101 gtk_combo_box_set_title (combo_box, g_value_get_string (value));
1104 case PROP_POPUP_SHOWN:
1105 if (g_value_get_boolean (value))
1106 gtk_combo_box_popup (combo_box);
1108 gtk_combo_box_popdown (combo_box);
1111 case PROP_BUTTON_SENSITIVITY:
1112 gtk_combo_box_set_button_sensitivity (combo_box,
1113 g_value_get_enum (value));
1116 case PROP_POPUP_FIXED_WIDTH:
1117 gtk_combo_box_set_popup_fixed_width (combo_box,
1118 g_value_get_boolean (value));
1121 case PROP_EDITING_CANCELED:
1122 priv->editing_canceled = g_value_get_boolean (value);
1125 case PROP_HAS_ENTRY:
1126 priv->has_entry = g_value_get_boolean (value);
1129 case PROP_ENTRY_TEXT_COLUMN:
1130 gtk_combo_box_set_entry_text_column (combo_box, g_value_get_int (value));
1133 case PROP_ID_COLUMN:
1134 gtk_combo_box_set_id_column (combo_box, g_value_get_int (value));
1137 case PROP_ACTIVE_ID:
1138 gtk_combo_box_set_active_id (combo_box, g_value_get_string (value));
1141 case PROP_CELL_AREA:
1142 /* Construct-only, can only be assigned once */
1143 area = g_value_get_object (value);
1146 if (priv->area != NULL)
1148 g_warning ("cell-area has already been set, ignoring construct property");
1149 g_object_ref_sink (area);
1150 g_object_unref (area);
1153 priv->area = g_object_ref_sink (area);
1158 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1164 gtk_combo_box_get_property (GObject *object,
1169 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
1170 GtkComboBoxPrivate *priv = combo_box->priv;
1175 g_value_set_object (value, combo_box->priv->model);
1178 case PROP_WRAP_WIDTH:
1179 g_value_set_int (value, combo_box->priv->wrap_width);
1182 case PROP_ROW_SPAN_COLUMN:
1183 g_value_set_int (value, combo_box->priv->row_column);
1186 case PROP_COLUMN_SPAN_COLUMN:
1187 g_value_set_int (value, combo_box->priv->col_column);
1191 g_value_set_int (value, gtk_combo_box_get_active (combo_box));
1194 case PROP_ADD_TEAROFFS:
1195 g_value_set_boolean (value, gtk_combo_box_get_add_tearoffs (combo_box));
1198 case PROP_HAS_FRAME:
1199 g_value_set_boolean (value, combo_box->priv->has_frame);
1202 case PROP_FOCUS_ON_CLICK:
1203 g_value_set_boolean (value, combo_box->priv->focus_on_click);
1206 case PROP_TEAROFF_TITLE:
1207 g_value_set_string (value, gtk_combo_box_get_title (combo_box));
1210 case PROP_POPUP_SHOWN:
1211 g_value_set_boolean (value, combo_box->priv->popup_shown);
1214 case PROP_BUTTON_SENSITIVITY:
1215 g_value_set_enum (value, combo_box->priv->button_sensitivity);
1218 case PROP_POPUP_FIXED_WIDTH:
1219 g_value_set_boolean (value, combo_box->priv->popup_fixed_width);
1222 case PROP_EDITING_CANCELED:
1223 g_value_set_boolean (value, priv->editing_canceled);
1226 case PROP_HAS_ENTRY:
1227 g_value_set_boolean (value, priv->has_entry);
1230 case PROP_ENTRY_TEXT_COLUMN:
1231 g_value_set_int (value, priv->text_column);
1234 case PROP_ID_COLUMN:
1235 g_value_set_int (value, priv->id_column);
1238 case PROP_ACTIVE_ID:
1239 g_value_set_string (value, gtk_combo_box_get_active_id (combo_box));
1242 case PROP_CELL_AREA:
1243 g_value_set_object (value, priv->area);
1247 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1253 gtk_combo_box_state_flags_changed (GtkWidget *widget,
1254 GtkStateFlags previous)
1256 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1257 GtkComboBoxPrivate *priv = combo_box->priv;
1259 if (gtk_widget_get_realized (widget))
1261 if (priv->tree_view && priv->cell_view)
1263 GtkStyleContext *context;
1264 GtkStateFlags state;
1267 context = gtk_widget_get_style_context (widget);
1268 state = gtk_widget_get_state_flags (widget);
1270 gtk_style_context_get (context, state,
1271 "background-color", &color,
1274 gtk_cell_view_set_background_rgba (GTK_CELL_VIEW (priv->cell_view), color);
1275 gdk_rgba_free (color);
1279 gtk_widget_queue_draw (widget);
1283 gtk_combo_box_button_state_flags_changed (GtkWidget *widget,
1284 GtkStateFlags previous,
1287 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
1288 GtkComboBoxPrivate *priv = combo_box->priv;
1290 if (gtk_widget_get_realized (widget))
1292 if (!priv->tree_view && priv->cell_view)
1293 gtk_widget_set_state_flags (priv->cell_view,
1294 gtk_widget_get_state_flags (widget),
1298 gtk_widget_queue_draw (widget);
1302 gtk_combo_box_check_appearance (GtkComboBox *combo_box)
1304 GtkComboBoxPrivate *priv = combo_box->priv;
1305 gboolean appears_as_list;
1307 /* if wrap_width > 0, then we are in grid-mode and forced to use
1310 if (priv->wrap_width)
1311 appears_as_list = FALSE;
1313 gtk_widget_style_get (GTK_WIDGET (combo_box),
1314 "appears-as-list", &appears_as_list,
1317 if (appears_as_list)
1319 /* Destroy all the menu mode widgets, if they exist. */
1320 if (GTK_IS_MENU (priv->popup_widget))
1321 gtk_combo_box_menu_destroy (combo_box);
1323 /* Create the list mode widgets, if they don't already exist. */
1324 if (!GTK_IS_TREE_VIEW (priv->tree_view))
1325 gtk_combo_box_list_setup (combo_box);
1329 /* Destroy all the list mode widgets, if they exist. */
1330 if (GTK_IS_TREE_VIEW (priv->tree_view))
1331 gtk_combo_box_list_destroy (combo_box);
1333 /* Create the menu mode widgets, if they don't already exist. */
1334 if (!GTK_IS_MENU (priv->popup_widget))
1335 gtk_combo_box_menu_setup (combo_box, TRUE);
1338 gtk_widget_style_get (GTK_WIDGET (combo_box),
1339 "shadow-type", &priv->shadow_type,
1344 gtk_combo_box_style_updated (GtkWidget *widget)
1346 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1347 GtkComboBoxPrivate *priv = combo_box->priv;
1350 GTK_WIDGET_CLASS (gtk_combo_box_parent_class)->style_updated (widget);
1352 gtk_combo_box_check_appearance (combo_box);
1354 if (priv->tree_view && priv->cell_view)
1356 GtkStyleContext *context;
1359 context = gtk_widget_get_style_context (widget);
1360 gtk_style_context_get (context, 0,
1361 "background-color", &color,
1364 gtk_cell_view_set_background_rgba (GTK_CELL_VIEW (priv->cell_view),
1367 gdk_rgba_free (color);
1370 child = gtk_bin_get_child (GTK_BIN (combo_box));
1371 if (GTK_IS_ENTRY (child))
1372 g_object_set (child, "shadow-type",
1373 GTK_SHADOW_NONE == priv->shadow_type ?
1374 GTK_SHADOW_IN : GTK_SHADOW_NONE, NULL);
1378 gtk_combo_box_button_toggled (GtkWidget *widget,
1381 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
1383 if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (widget)))
1385 if (!combo_box->priv->popup_in_progress)
1386 gtk_combo_box_popup (combo_box);
1389 gtk_combo_box_popdown (combo_box);
1393 gtk_combo_box_add (GtkContainer *container,
1396 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
1397 GtkComboBoxPrivate *priv = combo_box->priv;
1399 if (priv->has_entry && !GTK_IS_ENTRY (widget))
1401 g_warning ("Attempting to add a widget with type %s to a GtkComboBox that needs an entry "
1402 "(need an instance of GtkEntry or of a subclass)",
1403 G_OBJECT_TYPE_NAME (widget));
1407 if (priv->cell_view &&
1408 gtk_widget_get_parent (priv->cell_view))
1410 gtk_widget_unparent (priv->cell_view);
1411 _gtk_bin_set_child (GTK_BIN (container), NULL);
1412 gtk_widget_queue_resize (GTK_WIDGET (container));
1415 gtk_widget_set_parent (widget, GTK_WIDGET (container));
1416 _gtk_bin_set_child (GTK_BIN (container), widget);
1418 if (priv->cell_view &&
1419 widget != priv->cell_view)
1421 /* since the cell_view was unparented, it's gone now */
1422 priv->cell_view = NULL;
1424 if (!priv->tree_view && priv->separator)
1426 gtk_container_remove (GTK_CONTAINER (gtk_widget_get_parent (priv->separator)),
1428 priv->separator = NULL;
1430 gtk_widget_queue_resize (GTK_WIDGET (container));
1432 else if (priv->cell_view_frame)
1434 gtk_widget_unparent (priv->cell_view_frame);
1435 priv->cell_view_frame = NULL;
1440 if (priv->has_entry)
1442 /* this flag is a hack to tell the entry to fill its allocation.
1444 _gtk_entry_set_is_cell_renderer (GTK_ENTRY (widget), TRUE);
1446 g_signal_connect (widget, "changed",
1447 G_CALLBACK (gtk_combo_box_entry_contents_changed),
1450 gtk_entry_set_has_frame (GTK_ENTRY (widget), priv->has_frame);
1455 gtk_combo_box_remove (GtkContainer *container,
1458 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
1459 GtkComboBoxPrivate *priv = combo_box->priv;
1461 gboolean appears_as_list;
1463 if (priv->has_entry)
1465 GtkWidget *child_widget;
1467 child_widget = gtk_bin_get_child (GTK_BIN (container));
1468 if (widget && widget == child_widget)
1470 g_signal_handlers_disconnect_by_func (widget,
1471 gtk_combo_box_entry_contents_changed,
1473 _gtk_entry_set_is_cell_renderer (GTK_ENTRY (widget), FALSE);
1477 if (widget == priv->cell_view)
1478 priv->cell_view = NULL;
1480 gtk_widget_unparent (widget);
1481 _gtk_bin_set_child (GTK_BIN (container), NULL);
1483 if (gtk_widget_in_destruction (GTK_WIDGET (combo_box)))
1486 gtk_widget_queue_resize (GTK_WIDGET (container));
1488 if (!priv->tree_view)
1489 appears_as_list = FALSE;
1491 appears_as_list = TRUE;
1493 if (appears_as_list)
1494 gtk_combo_box_list_destroy (combo_box);
1495 else if (GTK_IS_MENU (priv->popup_widget))
1497 gtk_combo_box_menu_destroy (combo_box);
1498 gtk_menu_detach (GTK_MENU (priv->popup_widget));
1499 priv->popup_widget = NULL;
1502 if (!priv->cell_view)
1504 priv->cell_view = gtk_cell_view_new ();
1505 gtk_widget_set_parent (priv->cell_view, GTK_WIDGET (container));
1506 _gtk_bin_set_child (GTK_BIN (container), priv->cell_view);
1508 gtk_widget_show (priv->cell_view);
1509 gtk_cell_view_set_model (GTK_CELL_VIEW (priv->cell_view),
1514 if (appears_as_list)
1515 gtk_combo_box_list_setup (combo_box);
1517 gtk_combo_box_menu_setup (combo_box, TRUE);
1519 if (gtk_tree_row_reference_valid (priv->active_row))
1521 path = gtk_tree_row_reference_get_path (priv->active_row);
1522 gtk_combo_box_set_active_internal (combo_box, path);
1523 gtk_tree_path_free (path);
1526 gtk_combo_box_set_active_internal (combo_box, NULL);
1530 gtk_combo_box_menu_show (GtkWidget *menu,
1533 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1534 GtkComboBoxPrivate *priv = combo_box->priv;
1536 gtk_combo_box_child_show (menu, user_data);
1538 priv->popup_in_progress = TRUE;
1539 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button),
1541 priv->popup_in_progress = FALSE;
1545 gtk_combo_box_menu_hide (GtkWidget *menu,
1548 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1550 gtk_combo_box_child_hide (menu,user_data);
1552 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (combo_box->priv->button),
1557 gtk_combo_box_detacher (GtkWidget *widget,
1560 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1561 GtkComboBoxPrivate *priv = combo_box->priv;
1563 g_return_if_fail (priv->popup_widget == (GtkWidget *) menu);
1565 g_signal_handlers_disconnect_by_func (menu->priv->toplevel,
1566 gtk_combo_box_menu_show,
1568 g_signal_handlers_disconnect_by_func (menu->priv->toplevel,
1569 gtk_combo_box_menu_hide,
1572 priv->popup_widget = NULL;
1576 gtk_combo_box_set_popup_widget (GtkComboBox *combo_box,
1579 GtkComboBoxPrivate *priv = combo_box->priv;
1581 if (GTK_IS_MENU (priv->popup_widget))
1583 gtk_menu_detach (GTK_MENU (priv->popup_widget));
1584 priv->popup_widget = NULL;
1586 else if (priv->popup_widget)
1588 gtk_container_remove (GTK_CONTAINER (priv->scrolled_window),
1589 priv->popup_widget);
1590 g_object_unref (priv->popup_widget);
1591 priv->popup_widget = NULL;
1594 if (GTK_IS_MENU (popup))
1596 if (priv->popup_window)
1598 gtk_widget_destroy (priv->popup_window);
1599 priv->popup_window = NULL;
1602 priv->popup_widget = popup;
1605 * Note that we connect to show/hide on the toplevel, not the
1606 * menu itself, since the menu is not shown/hidden when it is
1607 * popped up while torn-off.
1609 g_signal_connect (GTK_MENU (popup)->priv->toplevel, "show",
1610 G_CALLBACK (gtk_combo_box_menu_show), combo_box);
1611 g_signal_connect (GTK_MENU (popup)->priv->toplevel, "hide",
1612 G_CALLBACK (gtk_combo_box_menu_hide), combo_box);
1614 gtk_menu_attach_to_widget (GTK_MENU (popup),
1615 GTK_WIDGET (combo_box),
1616 gtk_combo_box_detacher);
1620 if (!priv->popup_window)
1622 GtkWidget *toplevel;
1624 priv->popup_window = gtk_window_new (GTK_WINDOW_POPUP);
1625 gtk_widget_set_name (priv->popup_window, "gtk-combobox-popup-window");
1627 gtk_window_set_type_hint (GTK_WINDOW (priv->popup_window),
1628 GDK_WINDOW_TYPE_HINT_COMBO);
1630 g_signal_connect (GTK_WINDOW (priv->popup_window),"show",
1631 G_CALLBACK (gtk_combo_box_child_show),
1633 g_signal_connect (GTK_WINDOW (priv->popup_window),"hide",
1634 G_CALLBACK (gtk_combo_box_child_hide),
1637 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (combo_box));
1638 if (GTK_IS_WINDOW (toplevel))
1640 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
1641 GTK_WINDOW (priv->popup_window));
1642 gtk_window_set_transient_for (GTK_WINDOW (priv->popup_window),
1643 GTK_WINDOW (toplevel));
1646 gtk_window_set_resizable (GTK_WINDOW (priv->popup_window), FALSE);
1647 gtk_window_set_screen (GTK_WINDOW (priv->popup_window),
1648 gtk_widget_get_screen (GTK_WIDGET (combo_box)));
1650 priv->scrolled_window = gtk_scrolled_window_new (NULL, NULL);
1652 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1655 gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1658 gtk_widget_show (priv->scrolled_window);
1660 gtk_container_add (GTK_CONTAINER (priv->popup_window),
1661 priv->scrolled_window);
1664 gtk_container_add (GTK_CONTAINER (priv->scrolled_window),
1667 gtk_widget_show (popup);
1668 g_object_ref (popup);
1669 priv->popup_widget = popup;
1674 get_widget_border (GtkWidget *widget,
1677 GtkStyleContext *context;
1678 GtkBorder *border_width;
1680 context = gtk_widget_get_style_context (widget);
1682 gtk_style_context_get (context,
1683 gtk_widget_get_state_flags (widget),
1684 "border-width", &border_width,
1687 *border = *border_width;
1688 gtk_border_free (border_width);
1692 gtk_combo_box_menu_position_below (GtkMenu *menu,
1698 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1699 GtkAllocation child_allocation;
1705 GdkRectangle monitor;
1708 /* FIXME: is using the size request here broken? */
1709 child = gtk_bin_get_child (GTK_BIN (combo_box));
1713 gtk_widget_get_allocation (child, &child_allocation);
1715 if (!gtk_widget_get_has_window (child))
1717 sx += child_allocation.x;
1718 sy += child_allocation.y;
1721 gdk_window_get_root_coords (gtk_widget_get_window (child),
1723 get_widget_border (GTK_WIDGET (combo_box), &border);
1726 if (combo_box->priv->popup_fixed_width)
1727 gtk_widget_get_preferred_size (GTK_WIDGET (menu), &req, NULL);
1729 gtk_widget_get_preferred_size (GTK_WIDGET (menu), NULL, &req);
1731 if (gtk_widget_get_direction (GTK_WIDGET (combo_box)) == GTK_TEXT_DIR_LTR)
1734 *x = sx + child_allocation.width - req.width;
1737 screen = gtk_widget_get_screen (GTK_WIDGET (combo_box));
1738 monitor_num = gdk_screen_get_monitor_at_window (screen,
1739 gtk_widget_get_window (GTK_WIDGET (combo_box)));
1740 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1744 else if (*x + req.width > monitor.x + monitor.width)
1745 *x = monitor.x + monitor.width - req.width;
1747 if (monitor.y + monitor.height - *y - child_allocation.height >= req.height)
1748 *y += child_allocation.height;
1749 else if (*y - monitor.y >= req.height)
1751 else if (monitor.y + monitor.height - *y - child_allocation.height > *y - monitor.y)
1752 *y += child_allocation.height;
1760 gtk_combo_box_menu_position_over (GtkMenu *menu,
1766 GtkComboBox *combo_box;
1770 GtkAllocation allocation;
1771 GtkAllocation child_allocation;
1778 combo_box = GTK_COMBO_BOX (user_data);
1779 widget = GTK_WIDGET (combo_box);
1781 active = gtk_menu_get_active (GTK_MENU (combo_box->priv->popup_widget));
1783 gtk_widget_get_allocation (widget, &allocation);
1785 menu_xpos = allocation.x;
1786 menu_ypos = allocation.y + allocation.height / 2 - 2;
1788 if (combo_box->priv->popup_fixed_width)
1789 gtk_widget_get_preferred_width (GTK_WIDGET (menu), &menu_width, NULL);
1791 gtk_widget_get_preferred_width (GTK_WIDGET (menu), NULL, &menu_width);
1795 gtk_widget_get_allocation (active, &child_allocation);
1796 menu_ypos -= child_allocation.height / 2;
1799 children = GTK_MENU_SHELL (combo_box->priv->popup_widget)->priv->children;
1802 child = children->data;
1804 if (active == child)
1807 if (gtk_widget_get_visible (child))
1809 gtk_widget_get_allocation (child, &child_allocation);
1811 menu_ypos -= child_allocation.height;
1814 children = children->next;
1817 if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
1818 menu_xpos = menu_xpos + allocation.width - menu_width;
1820 gdk_window_get_root_coords (gtk_widget_get_window (widget),
1821 menu_xpos, menu_ypos,
1822 &menu_xpos, &menu_ypos);
1824 /* Clamp the position on screen */
1825 screen_width = gdk_screen_get_width (gtk_widget_get_screen (widget));
1829 else if ((menu_xpos + menu_width) > screen_width)
1830 menu_xpos -= ((menu_xpos + menu_width) - screen_width);
1839 gtk_combo_box_menu_position (GtkMenu *menu,
1845 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1846 GtkComboBoxPrivate *priv = combo_box->priv;
1847 GtkWidget *menu_item;
1849 if (priv->wrap_width > 0 || priv->cell_view == NULL)
1850 gtk_combo_box_menu_position_below (menu, x, y, push_in, user_data);
1853 /* FIXME handle nested menus better */
1854 menu_item = gtk_menu_get_active (GTK_MENU (priv->popup_widget));
1856 gtk_menu_shell_select_item (GTK_MENU_SHELL (priv->popup_widget),
1859 gtk_combo_box_menu_position_over (menu, x, y, push_in, user_data);
1862 if (!gtk_widget_get_visible (GTK_MENU (priv->popup_widget)->priv->toplevel))
1863 gtk_window_set_type_hint (GTK_WINDOW (GTK_MENU (priv->popup_widget)->priv->toplevel),
1864 GDK_WINDOW_TYPE_HINT_COMBO);
1868 gtk_combo_box_list_position (GtkComboBox *combo_box,
1874 GtkComboBoxPrivate *priv = combo_box->priv;
1875 GtkAllocation allocation;
1878 GdkRectangle monitor;
1879 GtkRequisition popup_req;
1880 GtkPolicyType hpolicy, vpolicy;
1883 /* under windows, the drop down list is as wide as the combo box itself.
1885 GtkWidget *widget = GTK_WIDGET (combo_box);
1889 gtk_widget_get_allocation (widget, &allocation);
1891 if (!gtk_widget_get_has_window (widget))
1897 window = gtk_widget_get_window (widget);
1899 gdk_window_get_root_coords (gtk_widget_get_window (widget),
1902 *width = allocation.width;
1904 hpolicy = vpolicy = GTK_POLICY_NEVER;
1905 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1908 if (combo_box->priv->popup_fixed_width)
1910 gtk_widget_get_preferred_size (priv->scrolled_window, &popup_req, NULL);
1912 if (popup_req.width > *width)
1914 hpolicy = GTK_POLICY_ALWAYS;
1915 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1921 /* XXX This code depends on treeviews properly reporting their natural width
1922 * list-mode menus won't fill up to their natural width until then */
1923 gtk_widget_get_preferred_size (priv->scrolled_window, NULL, &popup_req);
1925 if (popup_req.width > *width)
1927 hpolicy = GTK_POLICY_NEVER;
1928 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1931 *width = popup_req.width;
1935 *height = popup_req.height;
1937 screen = gtk_widget_get_screen (GTK_WIDGET (combo_box));
1938 monitor_num = gdk_screen_get_monitor_at_window (screen, window);
1939 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1941 if (gtk_widget_get_direction (GTK_WIDGET (combo_box)) == GTK_TEXT_DIR_RTL)
1942 *x = *x + allocation.width - *width;
1946 else if (*x + *width > monitor.x + monitor.width)
1947 *x = monitor.x + monitor.width - *width;
1949 if (*y + allocation.height + *height <= monitor.y + monitor.height)
1950 *y += allocation.height;
1951 else if (*y - *height >= monitor.y)
1953 else if (monitor.y + monitor.height - (*y + allocation.height) > *y - monitor.y)
1955 *y += allocation.height;
1956 *height = monitor.y + monitor.height - *y;
1960 *height = *y - monitor.y;
1964 if (popup_req.height > *height)
1966 vpolicy = GTK_POLICY_ALWAYS;
1968 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1974 cell_layout_is_sensitive (GtkCellLayout *layout)
1976 GList *cells, *list;
1979 cells = gtk_cell_layout_get_cells (layout);
1982 for (list = cells; list; list = list->next)
1984 g_object_get (list->data, "sensitive", &sensitive, NULL);
1989 g_list_free (cells);
1995 cell_is_sensitive (GtkCellRenderer *cell,
1998 gboolean *sensitive = data;
2000 g_object_get (cell, "sensitive", sensitive, NULL);
2006 tree_column_row_is_sensitive (GtkComboBox *combo_box,
2009 GtkComboBoxPrivate *priv = combo_box->priv;
2011 if (priv->row_separator_func)
2013 if (priv->row_separator_func (priv->model, iter,
2014 priv->row_separator_data))
2022 gtk_cell_area_apply_attributes (priv->area, priv->model, iter, FALSE, FALSE);
2026 gtk_cell_area_foreach (priv->area, cell_is_sensitive, &sensitive);
2035 update_menu_sensitivity (GtkComboBox *combo_box,
2038 GtkComboBoxPrivate *priv = combo_box->priv;
2039 GList *children, *child;
2040 GtkWidget *item, *submenu, *separator;
2041 GtkWidget *cell_view;
2047 children = gtk_container_get_children (GTK_CONTAINER (menu));
2049 for (child = children; child; child = child->next)
2051 item = GTK_WIDGET (child->data);
2052 cell_view = gtk_bin_get_child (GTK_BIN (item));
2054 if (!GTK_IS_CELL_VIEW (cell_view))
2057 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (item));
2058 if (submenu != NULL)
2060 gtk_widget_set_sensitive (item, TRUE);
2061 update_menu_sensitivity (combo_box, submenu);
2065 sensitive = cell_layout_is_sensitive (GTK_CELL_LAYOUT (cell_view));
2067 if (menu != priv->popup_widget && child == children)
2069 separator = GTK_WIDGET (child->next->data);
2070 g_object_set (item, "visible", sensitive, NULL);
2071 g_object_set (separator, "visible", sensitive, NULL);
2074 gtk_widget_set_sensitive (item, sensitive);
2078 g_list_free (children);
2082 gtk_combo_box_menu_popup (GtkComboBox *combo_box,
2084 guint32 activate_time)
2086 GtkComboBoxPrivate *priv = combo_box->priv;
2089 gint width, min_width, nat_width;
2091 update_menu_sensitivity (combo_box, priv->popup_widget);
2094 if (gtk_tree_row_reference_valid (priv->active_row))
2096 path = gtk_tree_row_reference_get_path (priv->active_row);
2097 active_item = gtk_tree_path_get_indices (path)[0];
2098 gtk_tree_path_free (path);
2100 if (priv->add_tearoffs)
2104 /* FIXME handle nested menus better */
2105 gtk_menu_set_active (GTK_MENU (priv->popup_widget), active_item);
2107 if (priv->wrap_width == 0)
2109 GtkAllocation allocation;
2111 gtk_widget_get_allocation (GTK_WIDGET (combo_box), &allocation);
2112 width = allocation.width;
2113 gtk_widget_set_size_request (priv->popup_widget, -1, -1);
2114 gtk_widget_get_preferred_width (priv->popup_widget, &min_width, &nat_width);
2116 if (combo_box->priv->popup_fixed_width)
2117 width = MAX (width, min_width);
2119 width = MAX (width, nat_width);
2121 gtk_widget_set_size_request (priv->popup_widget, width, -1);
2124 gtk_menu_popup (GTK_MENU (priv->popup_widget),
2126 gtk_combo_box_menu_position, combo_box,
2127 button, activate_time);
2131 popup_grab_on_window (GdkWindow *window,
2132 GdkDevice *keyboard,
2134 guint32 activate_time)
2137 gdk_device_grab (keyboard, window,
2138 GDK_OWNERSHIP_WINDOW, TRUE,
2139 GDK_KEY_PRESS_MASK | GDK_KEY_RELEASE_MASK,
2140 NULL, activate_time) != GDK_GRAB_SUCCESS)
2144 gdk_device_grab (pointer, window,
2145 GDK_OWNERSHIP_WINDOW, TRUE,
2146 GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK |
2147 GDK_POINTER_MOTION_MASK,
2148 NULL, activate_time) != GDK_GRAB_SUCCESS)
2151 gdk_device_ungrab (keyboard, activate_time);
2160 * gtk_combo_box_popup:
2161 * @combo_box: a #GtkComboBox
2163 * Pops up the menu or dropdown list of @combo_box.
2165 * This function is mostly intended for use by accessibility technologies;
2166 * applications should have little use for it.
2171 gtk_combo_box_popup (GtkComboBox *combo_box)
2173 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
2175 g_signal_emit (combo_box, combo_box_signals[POPUP], 0);
2179 * gtk_combo_box_popup_for_device:
2180 * @combo_box: a #GtkComboBox
2181 * @device: a #GdkDevice
2183 * Pops up the menu or dropdown list of @combo_box, the popup window
2184 * will be grabbed so only @device and its associated pointer/keyboard
2185 * are the only #GdkDevice<!-- -->s able to send events to it.
2190 gtk_combo_box_popup_for_device (GtkComboBox *combo_box,
2193 GtkComboBoxPrivate *priv = combo_box->priv;
2194 gint x, y, width, height;
2195 GtkTreePath *path = NULL, *ppath;
2196 GtkWidget *toplevel;
2197 GdkDevice *keyboard, *pointer;
2200 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
2201 g_return_if_fail (GDK_IS_DEVICE (device));
2203 if (!gtk_widget_get_realized (GTK_WIDGET (combo_box)))
2206 if (gtk_widget_get_mapped (priv->popup_widget))
2209 if (priv->grab_pointer && priv->grab_keyboard)
2212 time = gtk_get_current_event_time ();
2214 if (gdk_device_get_source (device) == GDK_SOURCE_KEYBOARD)
2217 pointer = gdk_device_get_associated_device (device);
2222 keyboard = gdk_device_get_associated_device (device);
2225 if (GTK_IS_MENU (priv->popup_widget))
2227 gtk_combo_box_menu_popup (combo_box,
2228 priv->activate_button,
2229 priv->activate_time);
2233 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (combo_box));
2234 if (GTK_IS_WINDOW (toplevel))
2235 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
2236 GTK_WINDOW (priv->popup_window));
2238 gtk_widget_show_all (priv->scrolled_window);
2239 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
2241 gtk_widget_set_size_request (priv->popup_window, width, height);
2242 gtk_window_move (GTK_WINDOW (priv->popup_window), x, y);
2244 if (gtk_tree_row_reference_valid (priv->active_row))
2246 path = gtk_tree_row_reference_get_path (priv->active_row);
2247 ppath = gtk_tree_path_copy (path);
2248 if (gtk_tree_path_up (ppath))
2249 gtk_tree_view_expand_to_path (GTK_TREE_VIEW (priv->tree_view),
2251 gtk_tree_path_free (ppath);
2253 gtk_tree_view_set_hover_expand (GTK_TREE_VIEW (priv->tree_view),
2257 gtk_widget_show (priv->popup_window);
2261 gtk_tree_view_set_cursor (GTK_TREE_VIEW (priv->tree_view),
2263 gtk_tree_path_free (path);
2266 gtk_widget_grab_focus (priv->popup_window);
2267 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button),
2270 if (!gtk_widget_has_focus (priv->tree_view))
2271 gtk_widget_grab_focus (priv->tree_view);
2273 if (!popup_grab_on_window (gtk_widget_get_window (priv->popup_window),
2274 keyboard, pointer, time))
2276 gtk_widget_hide (priv->popup_window);
2280 gtk_device_grab_add (priv->popup_window, pointer, TRUE);
2281 priv->grab_pointer = pointer;
2282 priv->grab_keyboard = keyboard;
2286 gtk_combo_box_real_popup (GtkComboBox *combo_box)
2290 device = gtk_get_current_event_device ();
2294 GdkDeviceManager *device_manager;
2295 GdkDisplay *display;
2298 display = gtk_widget_get_display (GTK_WIDGET (combo_box));
2299 device_manager = gdk_display_get_device_manager (display);
2301 /* No device was set, pick the first master device */
2302 devices = gdk_device_manager_list_devices (device_manager, GDK_DEVICE_TYPE_MASTER);
2303 device = devices->data;
2304 g_list_free (devices);
2307 gtk_combo_box_popup_for_device (combo_box, device);
2311 gtk_combo_box_real_popdown (GtkComboBox *combo_box)
2313 if (combo_box->priv->popup_shown)
2315 gtk_combo_box_popdown (combo_box);
2323 * gtk_combo_box_popdown:
2324 * @combo_box: a #GtkComboBox
2326 * Hides the menu or dropdown list of @combo_box.
2328 * This function is mostly intended for use by accessibility technologies;
2329 * applications should have little use for it.
2334 gtk_combo_box_popdown (GtkComboBox *combo_box)
2336 GtkComboBoxPrivate *priv = combo_box->priv;
2338 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
2340 if (GTK_IS_MENU (priv->popup_widget))
2342 gtk_menu_popdown (GTK_MENU (priv->popup_widget));
2346 if (!gtk_widget_get_realized (GTK_WIDGET (combo_box)))
2349 gtk_device_grab_remove (priv->popup_window, priv->grab_pointer);
2350 gtk_widget_hide (priv->popup_window);
2351 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button),
2354 priv->grab_pointer = NULL;
2355 priv->grab_keyboard = NULL;
2358 #define GTK_COMBO_BOX_SIZE_ALLOCATE_BUTTON \
2359 gtk_widget_get_preferred_size (combo_box->priv->button, \
2363 child.x = allocation->x + border.right; \
2365 child.x = allocation->x + allocation->width - req.width - border.left; \
2367 child.y = allocation->y + border.top; \
2368 child.width = req.width; \
2369 child.height = allocation->height - (border.top + border.bottom); \
2370 child.width = MAX (1, child.width); \
2371 child.height = MAX (1, child.height); \
2373 gtk_widget_size_allocate (combo_box->priv->button, &child);
2377 gtk_combo_box_size_allocate (GtkWidget *widget,
2378 GtkAllocation *allocation)
2380 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2381 GtkComboBoxPrivate *priv = combo_box->priv;
2382 GtkWidget *child_widget;
2383 gint focus_width, focus_pad;
2384 GtkAllocation child;
2386 gboolean is_rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
2389 gtk_widget_set_allocation (widget, allocation);
2390 child_widget = gtk_bin_get_child (GTK_BIN (widget));
2391 get_widget_border (widget, &border);
2393 gtk_widget_style_get (widget,
2394 "focus-line-width", &focus_width,
2395 "focus-padding", &focus_pad,
2398 if (!priv->tree_view)
2400 if (priv->cell_view)
2402 GtkBorder button_border;
2407 allocation->x += border.left;
2408 allocation->y += border.top;
2409 allocation->width -= border.left + border.right;
2410 allocation->height -= border.top + border.bottom;
2412 gtk_widget_size_allocate (priv->button, allocation);
2414 /* set some things ready */
2415 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->button));
2416 get_widget_border (priv->button, &button_border);
2418 child.x = allocation->x;
2419 child.y = allocation->y;
2420 width = allocation->width;
2421 child.height = allocation->height;
2423 if (!priv->is_cell_renderer)
2425 child.x += border_width + button_border.left + focus_width + focus_pad;
2426 child.y += border_width + button_border.top + focus_width + focus_pad;
2427 width -= (2 * (border_width + focus_width + focus_pad)) +
2428 button_border.left + button_border.right;
2429 child.height -= (2 * (border_width + focus_width + focus_pad)) +
2430 button_border.top + button_border.bottom;
2433 /* handle the children */
2434 gtk_widget_get_preferred_size (priv->arrow, &req, NULL);
2435 child.width = req.width;
2437 child.x += width - req.width;
2438 child.width = MAX (1, child.width);
2439 child.height = MAX (1, child.height);
2440 gtk_widget_size_allocate (priv->arrow, &child);
2442 child.x += req.width;
2443 gtk_widget_get_preferred_size (priv->separator, &req, NULL);
2444 child.width = req.width;
2446 child.x -= req.width;
2447 child.width = MAX (1, child.width);
2448 child.height = MAX (1, child.height);
2449 gtk_widget_size_allocate (priv->separator, &child);
2453 child.x += req.width;
2454 child.width = allocation->x + allocation->width
2455 - (border_width + button_border.right + focus_width + focus_pad)
2460 child.width = child.x;
2461 child.x = allocation->x
2462 + border_width + button_border.left + focus_width + focus_pad;
2463 child.width -= child.x;
2466 if (gtk_widget_get_visible (priv->popup_widget))
2468 gint width, menu_width;
2470 if (priv->wrap_width == 0)
2472 GtkAllocation combo_box_allocation;
2474 gtk_widget_get_allocation (GTK_WIDGET (combo_box), &combo_box_allocation);
2475 width = combo_box_allocation.width;
2476 gtk_widget_set_size_request (priv->popup_widget, -1, -1);
2478 if (combo_box->priv->popup_fixed_width)
2479 gtk_widget_get_preferred_width (priv->popup_widget, &menu_width, NULL);
2481 gtk_widget_get_preferred_width (priv->popup_widget, NULL, &menu_width);
2483 gtk_widget_set_size_request (priv->popup_widget,
2484 MAX (width, menu_width), -1);
2487 /* reposition the menu after giving it a new width */
2488 gtk_menu_reposition (GTK_MENU (priv->popup_widget));
2491 child.width = MAX (1, child.width);
2492 child.height = MAX (1, child.height);
2493 gtk_widget_size_allocate (child_widget, &child);
2497 GTK_COMBO_BOX_SIZE_ALLOCATE_BUTTON
2500 child.x = allocation->x + req.width + border.right;
2502 child.x = allocation->x + border.left;
2503 child.y = allocation->y + border.top;
2504 child.width = allocation->width - req.width - (border.left + border.right);
2505 child.width = MAX (1, child.width);
2506 child.height = MAX (1, child.height);
2507 gtk_widget_size_allocate (child_widget, &child);
2513 guint border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
2516 GTK_COMBO_BOX_SIZE_ALLOCATE_BUTTON
2520 child.x = allocation->x + req.width;
2522 child.x = allocation->x;
2524 child.y = allocation->y;
2525 child.width = allocation->width - req.width;
2526 child.height = allocation->height;
2528 if (priv->cell_view_frame)
2530 child.x += border.left + border_width;
2531 child.y += border.top + border_width;
2532 child.width = MAX (1, child.width - (2 * border_width) - (border.left + border.right));
2533 child.height = MAX (1, child.height - (2 * border_width) - (border.top + border.bottom));
2534 gtk_widget_size_allocate (priv->cell_view_frame, &child);
2537 if (priv->has_frame)
2539 GtkBorder frame_border;
2541 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->cell_view_frame));
2542 get_widget_border (priv->cell_view_frame, &frame_border);
2544 child.x += border_width + frame_border.left;
2545 child.y += border_width + frame_border.right;
2546 child.width -= (2 * border_width) + frame_border.left + frame_border.right;
2547 child.height -= (2 * border_width) + frame_border.top + frame_border.bottom;
2552 child.x += border.left + border_width;
2553 child.y += border.top + border_width;
2554 child.width -= (2 * border_width) - (border.left + border.right);
2555 child.height -= (2 * border_width) - (border.top + border.bottom);
2558 if (gtk_widget_get_visible (priv->popup_window))
2560 gint x, y, width, height;
2561 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
2562 gtk_window_move (GTK_WINDOW (priv->popup_window), x, y);
2563 gtk_widget_set_size_request (priv->popup_window, width, height);
2566 child.width = MAX (1, child.width);
2567 child.height = MAX (1, child.height);
2568 gtk_widget_size_allocate (child_widget, &child);
2572 #undef GTK_COMBO_BOX_ALLOCATE_BUTTON
2575 gtk_combo_box_unset_model (GtkComboBox *combo_box)
2577 GtkComboBoxPrivate *priv = combo_box->priv;
2581 g_signal_handler_disconnect (priv->model,
2583 g_signal_handler_disconnect (priv->model,
2585 g_signal_handler_disconnect (priv->model,
2586 priv->reordered_id);
2587 g_signal_handler_disconnect (priv->model,
2593 g_object_unref (priv->model);
2597 if (priv->active_row)
2599 gtk_tree_row_reference_free (priv->active_row);
2600 priv->active_row = NULL;
2603 if (priv->cell_view)
2604 gtk_cell_view_set_model (GTK_CELL_VIEW (priv->cell_view), NULL);
2608 gtk_combo_box_forall (GtkContainer *container,
2609 gboolean include_internals,
2610 GtkCallback callback,
2611 gpointer callback_data)
2613 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
2614 GtkComboBoxPrivate *priv = combo_box->priv;
2617 if (include_internals)
2620 (* callback) (priv->button, callback_data);
2621 if (priv->cell_view_frame)
2622 (* callback) (priv->cell_view_frame, callback_data);
2625 child = gtk_bin_get_child (GTK_BIN (container));
2627 (* callback) (child, callback_data);
2631 gtk_combo_box_child_show (GtkWidget *widget,
2632 GtkComboBox *combo_box)
2634 GtkComboBoxPrivate *priv = combo_box->priv;
2636 priv->popup_shown = TRUE;
2637 g_object_notify (G_OBJECT (combo_box), "popup-shown");
2641 gtk_combo_box_child_hide (GtkWidget *widget,
2642 GtkComboBox *combo_box)
2644 GtkComboBoxPrivate *priv = combo_box->priv;
2646 priv->popup_shown = FALSE;
2647 g_object_notify (G_OBJECT (combo_box), "popup-shown");
2651 gtk_combo_box_draw (GtkWidget *widget,
2654 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2655 GtkComboBoxPrivate *priv = combo_box->priv;
2657 if (priv->shadow_type != GTK_SHADOW_NONE)
2659 GtkStyleContext *context;
2660 GtkStateFlags state;
2662 context = gtk_widget_get_style_context (widget);
2663 state = gtk_widget_get_state_flags (widget);
2664 gtk_style_context_set_state (context, state);
2666 gtk_render_background (context, cr, 0, 0,
2667 gtk_widget_get_allocated_width (widget),
2668 gtk_widget_get_allocated_height (widget));
2669 gtk_render_frame (context, cr, 0, 0,
2670 gtk_widget_get_allocated_width (widget),
2671 gtk_widget_get_allocated_height (widget));
2674 gtk_container_propagate_draw (GTK_CONTAINER (widget),
2677 if (priv->tree_view && priv->cell_view_frame)
2679 gtk_container_propagate_draw (GTK_CONTAINER (widget),
2680 priv->cell_view_frame, cr);
2683 gtk_container_propagate_draw (GTK_CONTAINER (widget),
2684 gtk_bin_get_child (GTK_BIN (widget)),
2700 path_visible (GtkTreeView *view,
2706 /* Note that we rely on the fact that collapsed rows don't have nodes
2708 return _gtk_tree_view_find_node (view, path, &tree, &node);
2712 tree_next_func (GtkTreeModel *model,
2717 SearchData *search_data = (SearchData *)data;
2719 if (search_data->found)
2721 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2724 if (search_data->visible &&
2725 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2728 search_data->set = TRUE;
2729 search_data->iter = *iter;
2734 if (gtk_tree_path_compare (path, search_data->path) == 0)
2735 search_data->found = TRUE;
2741 tree_next (GtkComboBox *combo,
2742 GtkTreeModel *model,
2747 SearchData search_data;
2749 search_data.combo = combo;
2750 search_data.path = gtk_tree_model_get_path (model, iter);
2751 search_data.visible = visible;
2752 search_data.found = FALSE;
2753 search_data.set = FALSE;
2755 gtk_tree_model_foreach (model, tree_next_func, &search_data);
2757 *next = search_data.iter;
2759 gtk_tree_path_free (search_data.path);
2761 return search_data.set;
2765 tree_prev_func (GtkTreeModel *model,
2770 SearchData *search_data = (SearchData *)data;
2772 if (gtk_tree_path_compare (path, search_data->path) == 0)
2774 search_data->found = TRUE;
2778 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2781 if (search_data->visible &&
2782 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2785 search_data->set = TRUE;
2786 search_data->iter = *iter;
2792 tree_prev (GtkComboBox *combo,
2793 GtkTreeModel *model,
2798 SearchData search_data;
2800 search_data.combo = combo;
2801 search_data.path = gtk_tree_model_get_path (model, iter);
2802 search_data.visible = visible;
2803 search_data.found = FALSE;
2804 search_data.set = FALSE;
2806 gtk_tree_model_foreach (model, tree_prev_func, &search_data);
2808 *prev = search_data.iter;
2810 gtk_tree_path_free (search_data.path);
2812 return search_data.set;
2816 tree_last_func (GtkTreeModel *model,
2821 SearchData *search_data = (SearchData *)data;
2823 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2826 /* Note that we rely on the fact that collapsed rows don't have nodes
2828 if (search_data->visible &&
2829 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2832 search_data->set = TRUE;
2833 search_data->iter = *iter;
2839 tree_last (GtkComboBox *combo,
2840 GtkTreeModel *model,
2844 SearchData search_data;
2846 search_data.combo = combo;
2847 search_data.visible = visible;
2848 search_data.set = FALSE;
2850 gtk_tree_model_foreach (model, tree_last_func, &search_data);
2852 *last = search_data.iter;
2854 return search_data.set;
2859 tree_first_func (GtkTreeModel *model,
2864 SearchData *search_data = (SearchData *)data;
2866 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2869 if (search_data->visible &&
2870 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2873 search_data->set = TRUE;
2874 search_data->iter = *iter;
2880 tree_first (GtkComboBox *combo,
2881 GtkTreeModel *model,
2885 SearchData search_data;
2887 search_data.combo = combo;
2888 search_data.visible = visible;
2889 search_data.set = FALSE;
2891 gtk_tree_model_foreach (model, tree_first_func, &search_data);
2893 *first = search_data.iter;
2895 return search_data.set;
2899 gtk_combo_box_scroll_event (GtkWidget *widget,
2900 GdkEventScroll *event)
2902 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2905 GtkTreeIter new_iter;
2907 if (!gtk_combo_box_get_active_iter (combo_box, &iter))
2910 if (event->direction == GDK_SCROLL_UP)
2911 found = tree_prev (combo_box, combo_box->priv->model,
2912 &iter, &new_iter, FALSE);
2914 found = tree_next (combo_box, combo_box->priv->model,
2915 &iter, &new_iter, FALSE);
2918 gtk_combo_box_set_active_iter (combo_box, &new_iter);
2927 gtk_combo_box_row_separator_func (GtkTreeModel *model,
2931 GtkComboBoxPrivate *priv = combo->priv;
2933 if (priv->row_separator_func)
2934 return priv->row_separator_func (model, iter, priv->row_separator_data);
2940 gtk_combo_box_header_func (GtkTreeModel *model,
2944 /* Every submenu has a selectable header, however we
2945 * can expose a method to make that configurable by
2946 * the user (like row_separator_func is done) */
2951 gtk_combo_box_menu_setup (GtkComboBox *combo_box,
2952 gboolean add_children)
2954 GtkComboBoxPrivate *priv = combo_box->priv;
2958 child = gtk_bin_get_child (GTK_BIN (combo_box));
2960 if (priv->cell_view)
2962 priv->button = gtk_toggle_button_new ();
2963 gtk_button_set_focus_on_click (GTK_BUTTON (priv->button),
2964 priv->focus_on_click);
2966 g_signal_connect (priv->button, "toggled",
2967 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
2968 gtk_widget_set_parent (priv->button,
2969 gtk_widget_get_parent (child));
2971 priv->box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0);
2972 gtk_container_add (GTK_CONTAINER (priv->button), priv->box);
2974 priv->separator = gtk_separator_new (GTK_ORIENTATION_VERTICAL);
2975 gtk_container_add (GTK_CONTAINER (priv->box), priv->separator);
2977 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
2978 gtk_container_add (GTK_CONTAINER (priv->box), priv->arrow);
2980 gtk_widget_show_all (priv->button);
2984 priv->button = gtk_toggle_button_new ();
2985 gtk_button_set_focus_on_click (GTK_BUTTON (priv->button),
2986 priv->focus_on_click);
2988 g_signal_connect (priv->button, "toggled",
2989 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
2990 gtk_widget_set_parent (priv->button,
2991 gtk_widget_get_parent (child));
2993 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
2994 gtk_container_add (GTK_CONTAINER (priv->button), priv->arrow);
2995 gtk_widget_show_all (priv->button);
2998 g_signal_connect (priv->button, "button-press-event",
2999 G_CALLBACK (gtk_combo_box_menu_button_press),
3001 g_signal_connect (priv->button, "state-flags-changed",
3002 G_CALLBACK (gtk_combo_box_button_state_flags_changed),
3005 /* create our funky menu */
3006 menu = _gtk_tree_menu_new_with_area (priv->area);
3007 gtk_widget_set_name (menu, "gtk-combobox-popup-menu");
3009 _gtk_tree_menu_set_model (GTK_TREE_MENU (menu), priv->model);
3011 _gtk_tree_menu_set_wrap_width (GTK_TREE_MENU (menu), priv->wrap_width);
3012 _gtk_tree_menu_set_row_span_column (GTK_TREE_MENU (menu), priv->row_column);
3013 _gtk_tree_menu_set_column_span_column (GTK_TREE_MENU (menu), priv->col_column);
3014 _gtk_tree_menu_set_tearoff (GTK_TREE_MENU (menu),
3015 combo_box->priv->add_tearoffs);
3017 g_signal_connect (menu, "menu-activate",
3018 G_CALLBACK (gtk_combo_box_menu_activate), combo_box);
3020 /* Chain our row_separator_func through */
3021 _gtk_tree_menu_set_row_separator_func (GTK_TREE_MENU (menu),
3022 (GtkTreeViewRowSeparatorFunc)gtk_combo_box_row_separator_func,
3025 _gtk_tree_menu_set_header_func (GTK_TREE_MENU (menu),
3026 (GtkTreeMenuHeaderFunc)gtk_combo_box_header_func,
3029 gtk_widget_set_name (menu, "gtk-combobox-popup-menu");
3031 g_signal_connect (menu, "key-press-event",
3032 G_CALLBACK (gtk_combo_box_menu_key_press), combo_box);
3033 gtk_combo_box_set_popup_widget (combo_box, menu);
3035 gtk_combo_box_update_title (combo_box);
3039 gtk_combo_box_menu_destroy (GtkComboBox *combo_box)
3041 GtkComboBoxPrivate *priv = combo_box->priv;
3043 g_signal_handlers_disconnect_matched (priv->button,
3044 G_SIGNAL_MATCH_DATA,
3046 gtk_combo_box_menu_button_press, NULL);
3047 g_signal_handlers_disconnect_matched (priv->button,
3048 G_SIGNAL_MATCH_DATA,
3050 gtk_combo_box_button_state_flags_changed, combo_box);
3051 g_signal_handlers_disconnect_matched (priv->popup_widget,
3052 G_SIGNAL_MATCH_DATA,
3054 gtk_combo_box_menu_activate, combo_box);
3056 /* unparent will remove our latest ref */
3057 gtk_widget_unparent (priv->button);
3060 priv->button = NULL;
3062 priv->separator = NULL;
3064 /* changing the popup window will unref the menu and the children */
3069 gtk_combo_box_menu_button_press (GtkWidget *widget,
3070 GdkEventButton *event,
3073 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3074 GtkComboBoxPrivate *priv = combo_box->priv;
3076 if (GTK_IS_MENU (priv->popup_widget) &&
3077 event->type == GDK_BUTTON_PRESS && event->button == 1)
3079 if (priv->focus_on_click &&
3080 !gtk_widget_has_focus (priv->button))
3081 gtk_widget_grab_focus (priv->button);
3083 gtk_combo_box_menu_popup (combo_box, event->button, event->time);
3092 gtk_combo_box_menu_activate (GtkWidget *menu,
3094 GtkComboBox *combo_box)
3098 if (gtk_tree_model_get_iter_from_string (combo_box->priv->model, &iter, path))
3099 gtk_combo_box_set_active_iter (combo_box, &iter);
3101 g_object_set (combo_box,
3102 "editing-canceled", FALSE,
3108 gtk_combo_box_update_sensitivity (GtkComboBox *combo_box)
3111 gboolean sensitive = TRUE; /* fool code checkers */
3113 if (!combo_box->priv->button)
3116 switch (combo_box->priv->button_sensitivity)
3118 case GTK_SENSITIVITY_ON:
3121 case GTK_SENSITIVITY_OFF:
3124 case GTK_SENSITIVITY_AUTO:
3125 sensitive = combo_box->priv->model &&
3126 gtk_tree_model_get_iter_first (combo_box->priv->model, &iter);
3129 g_assert_not_reached ();
3133 gtk_widget_set_sensitive (combo_box->priv->button, sensitive);
3135 /* In list-mode, we also need to update sensitivity of the event box */
3136 if (GTK_IS_TREE_VIEW (combo_box->priv->tree_view)
3137 && combo_box->priv->cell_view)
3138 gtk_widget_set_sensitive (combo_box->priv->box, sensitive);
3142 gtk_combo_box_model_row_inserted (GtkTreeModel *model,
3147 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3149 if (combo_box->priv->tree_view)
3150 gtk_combo_box_list_popup_resize (combo_box);
3152 gtk_combo_box_update_sensitivity (combo_box);
3156 gtk_combo_box_model_row_deleted (GtkTreeModel *model,
3160 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3161 GtkComboBoxPrivate *priv = combo_box->priv;
3163 if (!gtk_tree_row_reference_valid (priv->active_row))
3165 if (priv->cell_view)
3166 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (priv->cell_view), NULL);
3167 g_signal_emit (combo_box, combo_box_signals[CHANGED], 0);
3170 if (priv->tree_view)
3171 gtk_combo_box_list_popup_resize (combo_box);
3173 gtk_combo_box_update_sensitivity (combo_box);
3177 gtk_combo_box_model_rows_reordered (GtkTreeModel *model,
3183 gtk_tree_row_reference_reordered (G_OBJECT (user_data), path, iter, new_order);
3187 gtk_combo_box_model_row_changed (GtkTreeModel *model,
3192 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3193 GtkComboBoxPrivate *priv = combo_box->priv;
3194 GtkTreePath *active_path;
3196 /* FIXME this belongs to GtkCellView */
3197 if (gtk_tree_row_reference_valid (priv->active_row))
3199 active_path = gtk_tree_row_reference_get_path (priv->active_row);
3200 if (gtk_tree_path_compare (path, active_path) == 0 &&
3202 gtk_widget_queue_resize (GTK_WIDGET (priv->cell_view));
3203 gtk_tree_path_free (active_path);
3206 if (priv->tree_view)
3207 gtk_combo_box_list_row_changed (model, path, iter, user_data);
3211 list_popup_resize_idle (gpointer user_data)
3213 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3214 GtkComboBoxPrivate *priv = combo_box->priv;
3215 gint x, y, width, height;
3217 if (priv->tree_view && gtk_widget_get_mapped (priv->popup_window))
3219 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
3221 gtk_widget_set_size_request (priv->popup_window, width, height);
3222 gtk_window_move (GTK_WINDOW (priv->popup_window), x, y);
3225 priv->resize_idle_id = 0;
3231 gtk_combo_box_list_popup_resize (GtkComboBox *combo_box)
3233 GtkComboBoxPrivate *priv = combo_box->priv;
3235 if (!priv->resize_idle_id)
3236 priv->resize_idle_id =
3237 gdk_threads_add_idle (list_popup_resize_idle, combo_box);
3241 gtk_combo_box_model_row_expanded (GtkTreeModel *model,
3246 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3248 gtk_combo_box_list_popup_resize (combo_box);
3257 gtk_combo_box_list_setup (GtkComboBox *combo_box)
3259 GtkComboBoxPrivate *priv = combo_box->priv;
3260 GtkTreeSelection *sel;
3262 GtkWidget *widget = GTK_WIDGET (combo_box);
3264 priv->button = gtk_toggle_button_new ();
3265 child = gtk_bin_get_child (GTK_BIN (combo_box));
3266 gtk_widget_set_parent (priv->button,
3267 gtk_widget_get_parent (child));
3268 g_signal_connect (priv->button, "button-press-event",
3269 G_CALLBACK (gtk_combo_box_list_button_pressed), combo_box);
3270 g_signal_connect (priv->button, "toggled",
3271 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
3273 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
3274 gtk_container_add (GTK_CONTAINER (priv->button), priv->arrow);
3275 priv->separator = NULL;
3276 gtk_widget_show_all (priv->button);
3278 if (priv->cell_view)
3280 GtkStyleContext *context;
3281 GtkStateFlags state;
3284 context = gtk_widget_get_style_context (widget);
3285 state = gtk_widget_get_state_flags (widget);
3287 gtk_style_context_get (context, state,
3288 "background-color", &color,
3291 gtk_cell_view_set_background_rgba (GTK_CELL_VIEW (priv->cell_view), color);
3292 gdk_rgba_free (color);
3294 priv->box = gtk_event_box_new ();
3295 gtk_event_box_set_visible_window (GTK_EVENT_BOX (priv->box),
3298 if (priv->has_frame)
3300 priv->cell_view_frame = gtk_frame_new (NULL);
3301 gtk_frame_set_shadow_type (GTK_FRAME (priv->cell_view_frame),
3306 combo_box->priv->cell_view_frame = gtk_event_box_new ();
3307 gtk_event_box_set_visible_window (GTK_EVENT_BOX (combo_box->priv->cell_view_frame),
3311 gtk_widget_set_parent (priv->cell_view_frame,
3312 gtk_widget_get_parent (child));
3313 gtk_container_add (GTK_CONTAINER (priv->cell_view_frame), priv->box);
3314 gtk_widget_show_all (priv->cell_view_frame);
3316 g_signal_connect (priv->box, "button-press-event",
3317 G_CALLBACK (gtk_combo_box_list_button_pressed),
3321 priv->tree_view = gtk_tree_view_new ();
3322 sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (priv->tree_view));
3323 gtk_tree_selection_set_mode (sel, GTK_SELECTION_BROWSE);
3324 gtk_tree_selection_set_select_function (sel,
3325 gtk_combo_box_list_select_func,
3327 gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (priv->tree_view),
3329 gtk_tree_view_set_hover_selection (GTK_TREE_VIEW (priv->tree_view),
3332 gtk_tree_view_set_row_separator_func (GTK_TREE_VIEW (priv->tree_view),
3333 (GtkTreeViewRowSeparatorFunc)gtk_combo_box_row_separator_func,
3337 gtk_tree_view_set_model (GTK_TREE_VIEW (priv->tree_view), priv->model);
3339 gtk_tree_view_append_column (GTK_TREE_VIEW (priv->tree_view),
3340 gtk_tree_view_column_new_with_area (priv->area));
3342 if (gtk_tree_row_reference_valid (priv->active_row))
3346 path = gtk_tree_row_reference_get_path (priv->active_row);
3347 gtk_tree_view_set_cursor (GTK_TREE_VIEW (priv->tree_view),
3349 gtk_tree_path_free (path);
3352 /* set sample/popup widgets */
3353 gtk_combo_box_set_popup_widget (combo_box, priv->tree_view);
3355 g_signal_connect (priv->tree_view, "key-press-event",
3356 G_CALLBACK (gtk_combo_box_list_key_press),
3358 g_signal_connect (priv->tree_view, "enter-notify-event",
3359 G_CALLBACK (gtk_combo_box_list_enter_notify),
3361 g_signal_connect (priv->tree_view, "row-expanded",
3362 G_CALLBACK (gtk_combo_box_model_row_expanded),
3364 g_signal_connect (priv->tree_view, "row-collapsed",
3365 G_CALLBACK (gtk_combo_box_model_row_expanded),
3367 g_signal_connect (priv->popup_window, "button-press-event",
3368 G_CALLBACK (gtk_combo_box_list_button_pressed),
3370 g_signal_connect (priv->popup_window, "button-release-event",
3371 G_CALLBACK (gtk_combo_box_list_button_released),
3374 gtk_widget_show (priv->tree_view);
3376 gtk_combo_box_update_sensitivity (combo_box);
3380 gtk_combo_box_list_destroy (GtkComboBox *combo_box)
3382 GtkComboBoxPrivate *priv = combo_box->priv;
3384 /* disconnect signals */
3385 g_signal_handlers_disconnect_matched (priv->tree_view,
3386 G_SIGNAL_MATCH_DATA,
3387 0, 0, NULL, NULL, combo_box);
3388 g_signal_handlers_disconnect_matched (priv->button,
3389 G_SIGNAL_MATCH_DATA,
3391 gtk_combo_box_list_button_pressed,
3393 g_signal_handlers_disconnect_matched (priv->popup_window,
3394 G_SIGNAL_MATCH_DATA,
3396 gtk_combo_box_list_button_pressed,
3398 g_signal_handlers_disconnect_matched (priv->popup_window,
3399 G_SIGNAL_MATCH_DATA,
3401 gtk_combo_box_list_button_released,
3404 g_signal_handlers_disconnect_matched (priv->popup_window,
3405 G_SIGNAL_MATCH_DATA,
3407 gtk_combo_box_child_show,
3410 g_signal_handlers_disconnect_matched (priv->popup_window,
3411 G_SIGNAL_MATCH_DATA,
3413 gtk_combo_box_child_hide,
3417 g_signal_handlers_disconnect_matched (priv->box,
3418 G_SIGNAL_MATCH_DATA,
3420 gtk_combo_box_list_button_pressed,
3423 /* destroy things (unparent will kill the latest ref from us)
3424 * last unref on button will destroy the arrow
3426 gtk_widget_unparent (priv->button);
3427 priv->button = NULL;
3430 if (priv->cell_view)
3432 g_object_set (priv->cell_view,
3433 "background-set", FALSE,
3437 if (priv->cell_view_frame)
3439 gtk_widget_unparent (priv->cell_view_frame);
3440 priv->cell_view_frame = NULL;
3444 if (priv->scroll_timer)
3446 g_source_remove (priv->scroll_timer);
3447 priv->scroll_timer = 0;
3450 if (priv->resize_idle_id)
3452 g_source_remove (priv->resize_idle_id);
3453 priv->resize_idle_id = 0;
3456 gtk_widget_destroy (priv->tree_view);
3458 priv->tree_view = NULL;
3459 if (priv->popup_widget)
3461 g_object_unref (priv->popup_widget);
3462 priv->popup_widget = NULL;
3469 gtk_combo_box_list_button_pressed (GtkWidget *widget,
3470 GdkEventButton *event,
3473 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3474 GtkComboBoxPrivate *priv = combo_box->priv;
3476 GtkWidget *ewidget = gtk_get_event_widget ((GdkEvent *)event);
3478 if (ewidget == priv->popup_window)
3481 if ((ewidget != priv->button && ewidget != priv->box) ||
3482 gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (priv->button)))
3485 if (priv->focus_on_click &&
3486 !gtk_widget_has_focus (priv->button))
3487 gtk_widget_grab_focus (priv->button);
3489 gtk_combo_box_popup_for_device (combo_box, event->device);
3491 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button), TRUE);
3493 priv->auto_scroll = FALSE;
3494 if (priv->scroll_timer == 0)
3495 priv->scroll_timer = gdk_threads_add_timeout (SCROLL_TIME,
3496 (GSourceFunc) gtk_combo_box_list_scroll_timeout,
3499 priv->popup_in_progress = TRUE;
3505 gtk_combo_box_list_button_released (GtkWidget *widget,
3506 GdkEventButton *event,
3510 GtkTreePath *path = NULL;
3513 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3514 GtkComboBoxPrivate *priv = combo_box->priv;
3516 gboolean popup_in_progress = FALSE;
3518 GtkWidget *ewidget = gtk_get_event_widget ((GdkEvent *)event);
3520 if (priv->popup_in_progress)
3522 popup_in_progress = TRUE;
3523 priv->popup_in_progress = FALSE;
3526 gtk_tree_view_set_hover_expand (GTK_TREE_VIEW (priv->tree_view),
3528 if (priv->scroll_timer)
3530 g_source_remove (priv->scroll_timer);
3531 priv->scroll_timer = 0;
3534 if (ewidget != priv->tree_view)
3536 if ((ewidget == priv->button ||
3537 ewidget == priv->box) &&
3538 !popup_in_progress &&
3539 gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (priv->button)))
3541 gtk_combo_box_popdown (combo_box);
3545 /* released outside treeview */
3546 if (ewidget != priv->button && ewidget != priv->box)
3548 gtk_combo_box_popdown (combo_box);
3556 /* select something cool */
3557 ret = gtk_tree_view_get_path_at_pos (GTK_TREE_VIEW (priv->tree_view),
3563 return TRUE; /* clicked outside window? */
3565 gtk_tree_model_get_iter (priv->model, &iter, path);
3566 gtk_tree_path_free (path);
3568 gtk_combo_box_popdown (combo_box);
3570 if (tree_column_row_is_sensitive (combo_box, &iter))
3571 gtk_combo_box_set_active_iter (combo_box, &iter);
3577 gtk_combo_box_menu_key_press (GtkWidget *widget,
3581 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3583 if (!gtk_bindings_activate_event (G_OBJECT (widget), event))
3585 /* The menu hasn't managed the
3586 * event, forward it to the combobox
3588 gtk_bindings_activate_event (G_OBJECT (combo_box), event);
3595 gtk_combo_box_list_key_press (GtkWidget *widget,
3599 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3602 if (event->keyval == GDK_KEY_Return || event->keyval == GDK_KEY_ISO_Enter || event->keyval == GDK_KEY_KP_Enter ||
3603 event->keyval == GDK_KEY_space || event->keyval == GDK_KEY_KP_Space)
3605 GtkTreeModel *model = NULL;
3607 gtk_combo_box_popdown (combo_box);
3609 if (combo_box->priv->model)
3611 GtkTreeSelection *sel;
3613 sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (combo_box->priv->tree_view));
3615 if (gtk_tree_selection_get_selected (sel, &model, &iter))
3616 gtk_combo_box_set_active_iter (combo_box, &iter);
3622 if (!gtk_bindings_activate_event (G_OBJECT (widget), event))
3624 /* The list hasn't managed the
3625 * event, forward it to the combobox
3627 gtk_bindings_activate_event (G_OBJECT (combo_box), event);
3634 gtk_combo_box_list_auto_scroll (GtkComboBox *combo_box,
3639 GtkAllocation allocation;
3640 GtkWidget *tree_view = combo_box->priv->tree_view;
3643 gtk_widget_get_allocation (tree_view, &allocation);
3645 adj = gtk_scrolled_window_get_hadjustment (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window));
3646 if (adj && gtk_adjustment_get_upper (adj) - gtk_adjustment_get_lower (adj) > gtk_adjustment_get_page_size (adj))
3648 if (x <= allocation.x &&
3649 gtk_adjustment_get_lower (adj) < gtk_adjustment_get_value (adj))
3651 value = gtk_adjustment_get_value (adj) - (allocation.x - x + 1);
3652 gtk_adjustment_set_value (adj, value);
3654 else if (x >= allocation.x + allocation.width &&
3655 gtk_adjustment_get_upper (adj) - gtk_adjustment_get_page_size (adj) > gtk_adjustment_get_value (adj))
3657 value = gtk_adjustment_get_value (adj) + (x - allocation.x - allocation.width + 1);
3658 gtk_adjustment_set_value (adj, MAX (value, 0.0));
3662 adj = gtk_scrolled_window_get_vadjustment (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window));
3663 if (adj && gtk_adjustment_get_upper (adj) - gtk_adjustment_get_lower (adj) > gtk_adjustment_get_page_size (adj))
3665 if (y <= allocation.y &&
3666 gtk_adjustment_get_lower (adj) < gtk_adjustment_get_value (adj))
3668 value = gtk_adjustment_get_value (adj) - (allocation.y - y + 1);
3669 gtk_adjustment_set_value (adj, value);
3671 else if (y >= allocation.height &&
3672 gtk_adjustment_get_upper (adj) - gtk_adjustment_get_page_size (adj) > gtk_adjustment_get_value (adj))
3674 value = gtk_adjustment_get_value (adj) + (y - allocation.height + 1);
3675 gtk_adjustment_set_value (adj, MAX (value, 0.0));
3681 gtk_combo_box_list_scroll_timeout (GtkComboBox *combo_box)
3683 GtkComboBoxPrivate *priv = combo_box->priv;
3686 if (priv->auto_scroll)
3688 gdk_window_get_device_position (gtk_widget_get_window (priv->tree_view),
3691 gtk_combo_box_list_auto_scroll (combo_box, x, y);
3698 gtk_combo_box_list_enter_notify (GtkWidget *widget,
3699 GdkEventCrossing *event,
3702 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3704 combo_box->priv->auto_scroll = TRUE;
3710 gtk_combo_box_list_select_func (GtkTreeSelection *selection,
3711 GtkTreeModel *model,
3713 gboolean path_currently_selected,
3716 GList *list, *columns;
3717 gboolean sensitive = FALSE;
3719 columns = gtk_tree_view_get_columns (gtk_tree_selection_get_tree_view (selection));
3721 for (list = columns; list && !sensitive; list = list->next)
3723 GList *cells, *cell;
3724 gboolean cell_sensitive, cell_visible;
3726 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (list->data);
3728 if (!gtk_tree_view_column_get_visible (column))
3731 gtk_tree_model_get_iter (model, &iter, path);
3732 gtk_tree_view_column_cell_set_cell_data (column, model, &iter,
3735 cell = cells = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (column));
3738 g_object_get (cell->data,
3739 "sensitive", &cell_sensitive,
3740 "visible", &cell_visible,
3743 if (cell_visible && cell_sensitive)
3748 g_list_free (cells);
3750 sensitive = cell_sensitive;
3753 g_list_free (columns);
3759 gtk_combo_box_list_row_changed (GtkTreeModel *model,
3764 /* XXX Do nothing ? */
3768 * GtkCellLayout implementation
3770 static GtkCellArea *
3771 gtk_combo_box_cell_layout_get_area (GtkCellLayout *cell_layout)
3773 GtkComboBox *combo = GTK_COMBO_BOX (cell_layout);
3774 GtkComboBoxPrivate *priv = combo->priv;
3776 if (G_UNLIKELY (!priv->area))
3778 priv->area = gtk_cell_area_box_new ();
3779 g_object_ref_sink (priv->area);
3790 * gtk_combo_box_new:
3792 * Creates a new empty #GtkComboBox.
3794 * Return value: A new #GtkComboBox.
3799 gtk_combo_box_new (void)
3801 return g_object_new (GTK_TYPE_COMBO_BOX, NULL);
3805 * gtk_combo_box_new_with_area:
3806 * @area: the #GtkCellArea to use to layout cell renderers
3808 * Creates a new empty #GtkComboBox using @area to layout cells.
3810 * Return value: A new #GtkComboBox.
3813 gtk_combo_box_new_with_area (GtkCellArea *area)
3815 return g_object_new (GTK_TYPE_COMBO_BOX, "cell-area", area, NULL);
3819 * gtk_combo_box_new_with_area_and_entry:
3820 * @area: the #GtkCellArea to use to layout cell renderers
3822 * Creates a new empty #GtkComboBox with an entry.
3824 * The new combo box will use @area to layout cells.
3826 * Return value: A new #GtkComboBox.
3829 gtk_combo_box_new_with_area_and_entry (GtkCellArea *area)
3831 return g_object_new (GTK_TYPE_COMBO_BOX,
3839 * gtk_combo_box_new_with_entry:
3841 * Creates a new empty #GtkComboBox with an entry.
3843 * Return value: A new #GtkComboBox.
3846 gtk_combo_box_new_with_entry (void)
3848 return g_object_new (GTK_TYPE_COMBO_BOX, "has-entry", TRUE, NULL);
3852 * gtk_combo_box_new_with_model:
3853 * @model: A #GtkTreeModel.
3855 * Creates a new #GtkComboBox with the model initialized to @model.
3857 * Return value: A new #GtkComboBox.
3862 gtk_combo_box_new_with_model (GtkTreeModel *model)
3864 GtkComboBox *combo_box;
3866 g_return_val_if_fail (GTK_IS_TREE_MODEL (model), NULL);
3868 combo_box = g_object_new (GTK_TYPE_COMBO_BOX, "model", model, NULL);
3870 return GTK_WIDGET (combo_box);
3874 * gtk_combo_box_new_with_model_and_entry:
3875 * @model: A #GtkTreeModel
3877 * Creates a new empty #GtkComboBox with an entry
3878 * and with the model initialized to @model.
3880 * Return value: A new #GtkComboBox
3883 gtk_combo_box_new_with_model_and_entry (GtkTreeModel *model)
3885 return g_object_new (GTK_TYPE_COMBO_BOX,
3892 * gtk_combo_box_get_wrap_width:
3893 * @combo_box: A #GtkComboBox
3895 * Returns the wrap width which is used to determine the number of columns
3896 * for the popup menu. If the wrap width is larger than 1, the combo box
3899 * Returns: the wrap width.
3904 gtk_combo_box_get_wrap_width (GtkComboBox *combo_box)
3906 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
3908 return combo_box->priv->wrap_width;
3912 * gtk_combo_box_set_wrap_width:
3913 * @combo_box: A #GtkComboBox
3914 * @width: Preferred number of columns
3916 * Sets the wrap width of @combo_box to be @width. The wrap width is basically
3917 * the preferred number of columns when you want the popup to be layed out
3923 gtk_combo_box_set_wrap_width (GtkComboBox *combo_box,
3926 GtkComboBoxPrivate *priv;
3928 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
3929 g_return_if_fail (width >= 0);
3931 priv = combo_box->priv;
3933 if (width != priv->wrap_width)
3935 priv->wrap_width = width;
3937 gtk_combo_box_check_appearance (combo_box);
3939 if (GTK_IS_TREE_MENU (priv->popup_widget))
3940 _gtk_tree_menu_set_wrap_width (GTK_TREE_MENU (priv->popup_widget), priv->wrap_width);
3942 g_object_notify (G_OBJECT (combo_box), "wrap-width");
3947 * gtk_combo_box_get_row_span_column:
3948 * @combo_box: A #GtkComboBox
3950 * Returns the column with row span information for @combo_box.
3952 * Returns: the row span column.
3957 gtk_combo_box_get_row_span_column (GtkComboBox *combo_box)
3959 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
3961 return combo_box->priv->row_column;
3965 * gtk_combo_box_set_row_span_column:
3966 * @combo_box: A #GtkComboBox.
3967 * @row_span: A column in the model passed during construction.
3969 * Sets the column with row span information for @combo_box to be @row_span.
3970 * The row span column contains integers which indicate how many rows
3971 * an item should span.
3976 gtk_combo_box_set_row_span_column (GtkComboBox *combo_box,
3979 GtkComboBoxPrivate *priv;
3982 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
3984 priv = combo_box->priv;
3986 col = gtk_tree_model_get_n_columns (priv->model);
3987 g_return_if_fail (row_span >= -1 && row_span < col);
3989 if (row_span != priv->row_column)
3991 priv->row_column = row_span;
3993 if (GTK_IS_TREE_MENU (priv->popup_widget))
3994 _gtk_tree_menu_set_row_span_column (GTK_TREE_MENU (priv->popup_widget), priv->row_column);
3996 g_object_notify (G_OBJECT (combo_box), "row-span-column");
4001 * gtk_combo_box_get_column_span_column:
4002 * @combo_box: A #GtkComboBox
4004 * Returns the column with column span information for @combo_box.
4006 * Returns: the column span column.
4011 gtk_combo_box_get_column_span_column (GtkComboBox *combo_box)
4013 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
4015 return combo_box->priv->col_column;
4019 * gtk_combo_box_set_column_span_column:
4020 * @combo_box: A #GtkComboBox
4021 * @column_span: A column in the model passed during construction
4023 * Sets the column with column span information for @combo_box to be
4024 * @column_span. The column span column contains integers which indicate
4025 * how many columns an item should span.
4030 gtk_combo_box_set_column_span_column (GtkComboBox *combo_box,
4033 GtkComboBoxPrivate *priv;
4036 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4038 priv = combo_box->priv;
4040 col = gtk_tree_model_get_n_columns (priv->model);
4041 g_return_if_fail (column_span >= -1 && column_span < col);
4043 if (column_span != priv->col_column)
4045 priv->col_column = column_span;
4047 if (GTK_IS_TREE_MENU (priv->popup_widget))
4048 _gtk_tree_menu_set_column_span_column (GTK_TREE_MENU (priv->popup_widget), priv->col_column);
4050 g_object_notify (G_OBJECT (combo_box), "column-span-column");
4055 * gtk_combo_box_get_active:
4056 * @combo_box: A #GtkComboBox
4058 * Returns the index of the currently active item, or -1 if there's no
4059 * active item. If the model is a non-flat treemodel, and the active item
4060 * is not an immediate child of the root of the tree, this function returns
4061 * <literal>gtk_tree_path_get_indices (path)[0]</literal>, where
4062 * <literal>path</literal> is the #GtkTreePath of the active item.
4064 * Return value: An integer which is the index of the currently active item,
4065 * or -1 if there's no active item.
4070 gtk_combo_box_get_active (GtkComboBox *combo_box)
4072 GtkComboBoxPrivate *priv;
4075 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
4077 priv = combo_box->priv;
4079 if (gtk_tree_row_reference_valid (priv->active_row))
4083 path = gtk_tree_row_reference_get_path (priv->active_row);
4084 result = gtk_tree_path_get_indices (path)[0];
4085 gtk_tree_path_free (path);
4094 * gtk_combo_box_set_active:
4095 * @combo_box: A #GtkComboBox
4096 * @index_: An index in the model passed during construction, or -1 to have
4099 * Sets the active item of @combo_box to be the item at @index.
4104 gtk_combo_box_set_active (GtkComboBox *combo_box,
4107 GtkTreePath *path = NULL;
4108 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4109 g_return_if_fail (index_ >= -1);
4111 if (combo_box->priv->model == NULL)
4113 /* Save index, in case the model is set after the index */
4114 combo_box->priv->active = index_;
4120 path = gtk_tree_path_new_from_indices (index_, -1);
4122 gtk_combo_box_set_active_internal (combo_box, path);
4125 gtk_tree_path_free (path);
4129 gtk_combo_box_set_active_internal (GtkComboBox *combo_box,
4132 GtkComboBoxPrivate *priv = combo_box->priv;
4133 GtkTreePath *active_path;
4136 /* Remember whether the initially active row is valid. */
4137 gboolean is_valid_row_reference = gtk_tree_row_reference_valid (priv->active_row);
4139 if (path && is_valid_row_reference)
4141 active_path = gtk_tree_row_reference_get_path (priv->active_row);
4142 path_cmp = gtk_tree_path_compare (path, active_path);
4143 gtk_tree_path_free (active_path);
4148 if (priv->active_row)
4150 gtk_tree_row_reference_free (priv->active_row);
4151 priv->active_row = NULL;
4156 if (priv->tree_view)
4157 gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (priv->tree_view)));
4160 GtkMenu *menu = GTK_MENU (priv->popup_widget);
4162 if (GTK_IS_MENU (menu))
4163 gtk_menu_set_active (menu, -1);
4166 if (priv->cell_view)
4167 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (priv->cell_view), NULL);
4170 * Do not emit a "changed" signal when an already invalid selection was
4171 * now set to invalid.
4173 if (!is_valid_row_reference)
4179 gtk_tree_row_reference_new (priv->model, path);
4181 if (priv->tree_view)
4183 gtk_tree_view_set_cursor (GTK_TREE_VIEW (priv->tree_view),
4186 else if (GTK_IS_MENU (priv->popup_widget))
4188 /* FIXME handle nested menus better */
4189 gtk_menu_set_active (GTK_MENU (priv->popup_widget),
4190 gtk_tree_path_get_indices (path)[0]);
4193 if (priv->cell_view)
4194 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (priv->cell_view),
4198 g_signal_emit (combo_box, combo_box_signals[CHANGED], 0);
4199 g_object_notify (G_OBJECT (combo_box), "active");
4200 if (combo_box->priv->id_column >= 0)
4201 g_object_notify (G_OBJECT (combo_box), "active-id");
4206 * gtk_combo_box_get_active_iter:
4207 * @combo_box: A #GtkComboBox
4208 * @iter: (out): The uninitialized #GtkTreeIter
4210 * Sets @iter to point to the current active item, if it exists.
4212 * Return value: %TRUE, if @iter was set
4217 gtk_combo_box_get_active_iter (GtkComboBox *combo_box,
4223 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
4225 if (!gtk_tree_row_reference_valid (combo_box->priv->active_row))
4228 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
4229 result = gtk_tree_model_get_iter (combo_box->priv->model, iter, path);
4230 gtk_tree_path_free (path);
4236 * gtk_combo_box_set_active_iter:
4237 * @combo_box: A #GtkComboBox
4238 * @iter: (allow-none): The #GtkTreeIter, or %NULL
4240 * Sets the current active item to be the one referenced by @iter, or
4241 * unsets the active item if @iter is %NULL.
4246 gtk_combo_box_set_active_iter (GtkComboBox *combo_box,
4249 GtkTreePath *path = NULL;
4251 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4254 path = gtk_tree_model_get_path (gtk_combo_box_get_model (combo_box), iter);
4256 gtk_combo_box_set_active_internal (combo_box, path);
4257 gtk_tree_path_free (path);
4261 * gtk_combo_box_set_model:
4262 * @combo_box: A #GtkComboBox
4263 * @model: (allow-none): A #GtkTreeModel
4265 * Sets the model used by @combo_box to be @model. Will unset a previously set
4266 * model (if applicable). If model is %NULL, then it will unset the model.
4268 * Note that this function does not clear the cell renderers, you have to
4269 * call gtk_cell_layout_clear() yourself if you need to set up different
4270 * cell renderers for the new model.
4275 gtk_combo_box_set_model (GtkComboBox *combo_box,
4276 GtkTreeModel *model)
4278 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4279 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
4281 if (model == combo_box->priv->model)
4284 gtk_combo_box_unset_model (combo_box);
4289 combo_box->priv->model = model;
4290 g_object_ref (combo_box->priv->model);
4292 combo_box->priv->inserted_id =
4293 g_signal_connect (combo_box->priv->model, "row-inserted",
4294 G_CALLBACK (gtk_combo_box_model_row_inserted),
4296 combo_box->priv->deleted_id =
4297 g_signal_connect (combo_box->priv->model, "row-deleted",
4298 G_CALLBACK (gtk_combo_box_model_row_deleted),
4300 combo_box->priv->reordered_id =
4301 g_signal_connect (combo_box->priv->model, "rows-reordered",
4302 G_CALLBACK (gtk_combo_box_model_rows_reordered),
4304 combo_box->priv->changed_id =
4305 g_signal_connect (combo_box->priv->model, "row-changed",
4306 G_CALLBACK (gtk_combo_box_model_row_changed),
4309 if (combo_box->priv->tree_view)
4312 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view),
4313 combo_box->priv->model);
4314 gtk_combo_box_list_popup_resize (combo_box);
4317 if (GTK_IS_TREE_MENU (combo_box->priv->popup_widget))
4320 _gtk_tree_menu_set_model (GTK_TREE_MENU (combo_box->priv->popup_widget),
4321 combo_box->priv->model);
4324 if (combo_box->priv->cell_view)
4325 gtk_cell_view_set_model (GTK_CELL_VIEW (combo_box->priv->cell_view),
4326 combo_box->priv->model);
4328 if (combo_box->priv->active != -1)
4330 /* If an index was set in advance, apply it now */
4331 gtk_combo_box_set_active (combo_box, combo_box->priv->active);
4332 combo_box->priv->active = -1;
4336 gtk_combo_box_update_sensitivity (combo_box);
4338 g_object_notify (G_OBJECT (combo_box), "model");
4342 * gtk_combo_box_get_model:
4343 * @combo_box: A #GtkComboBox
4345 * Returns the #GtkTreeModel which is acting as data source for @combo_box.
4347 * Return value: (transfer none): A #GtkTreeModel which was passed
4348 * during construction.
4353 gtk_combo_box_get_model (GtkComboBox *combo_box)
4355 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4357 return combo_box->priv->model;
4361 gtk_combo_box_real_move_active (GtkComboBox *combo_box,
4362 GtkScrollType scroll)
4365 GtkTreeIter new_iter;
4366 gboolean active_iter;
4369 if (!combo_box->priv->model)
4371 gtk_widget_error_bell (GTK_WIDGET (combo_box));
4375 active_iter = gtk_combo_box_get_active_iter (combo_box, &iter);
4379 case GTK_SCROLL_STEP_BACKWARD:
4380 case GTK_SCROLL_STEP_UP:
4381 case GTK_SCROLL_STEP_LEFT:
4384 found = tree_prev (combo_box, combo_box->priv->model,
4385 &iter, &new_iter, FALSE);
4388 /* else fall through */
4390 case GTK_SCROLL_PAGE_FORWARD:
4391 case GTK_SCROLL_PAGE_DOWN:
4392 case GTK_SCROLL_PAGE_RIGHT:
4393 case GTK_SCROLL_END:
4394 found = tree_last (combo_box, combo_box->priv->model, &new_iter, FALSE);
4397 case GTK_SCROLL_STEP_FORWARD:
4398 case GTK_SCROLL_STEP_DOWN:
4399 case GTK_SCROLL_STEP_RIGHT:
4402 found = tree_next (combo_box, combo_box->priv->model,
4403 &iter, &new_iter, FALSE);
4406 /* else fall through */
4408 case GTK_SCROLL_PAGE_BACKWARD:
4409 case GTK_SCROLL_PAGE_UP:
4410 case GTK_SCROLL_PAGE_LEFT:
4411 case GTK_SCROLL_START:
4412 found = tree_first (combo_box, combo_box->priv->model, &new_iter, FALSE);
4419 if (found && active_iter)
4421 GtkTreePath *old_path;
4422 GtkTreePath *new_path;
4424 old_path = gtk_tree_model_get_path (combo_box->priv->model, &iter);
4425 new_path = gtk_tree_model_get_path (combo_box->priv->model, &new_iter);
4427 if (gtk_tree_path_compare (old_path, new_path) == 0)
4430 gtk_tree_path_free (old_path);
4431 gtk_tree_path_free (new_path);
4436 gtk_combo_box_set_active_iter (combo_box, &new_iter);
4440 gtk_widget_error_bell (GTK_WIDGET (combo_box));
4445 gtk_combo_box_mnemonic_activate (GtkWidget *widget,
4446 gboolean group_cycling)
4448 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4450 if (combo_box->priv->has_entry)
4454 child = gtk_bin_get_child (GTK_BIN (combo_box));
4456 gtk_widget_grab_focus (child);
4459 gtk_widget_grab_focus (combo_box->priv->button);
4465 gtk_combo_box_grab_focus (GtkWidget *widget)
4467 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4469 if (combo_box->priv->has_entry)
4473 child = gtk_bin_get_child (GTK_BIN (combo_box));
4475 gtk_widget_grab_focus (child);
4478 gtk_widget_grab_focus (combo_box->priv->button);
4482 gtk_combo_box_destroy (GtkWidget *widget)
4484 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4486 if (combo_box->priv->popup_idle_id > 0)
4488 g_source_remove (combo_box->priv->popup_idle_id);
4489 combo_box->priv->popup_idle_id = 0;
4492 gtk_combo_box_popdown (combo_box);
4494 if (combo_box->priv->row_separator_destroy)
4495 combo_box->priv->row_separator_destroy (combo_box->priv->row_separator_data);
4497 combo_box->priv->row_separator_func = NULL;
4498 combo_box->priv->row_separator_data = NULL;
4499 combo_box->priv->row_separator_destroy = NULL;
4501 GTK_WIDGET_CLASS (gtk_combo_box_parent_class)->destroy (widget);
4502 combo_box->priv->cell_view = NULL;
4506 gtk_combo_box_entry_contents_changed (GtkEntry *entry,
4509 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
4512 * Fixes regression reported in bug #574059. The old functionality relied on
4513 * bug #572478. As a bugfix, we now emit the "changed" signal ourselves
4514 * when the selection was already set to -1.
4516 if (gtk_combo_box_get_active(combo_box) == -1)
4517 g_signal_emit_by_name (combo_box, "changed");
4519 gtk_combo_box_set_active (combo_box, -1);
4523 gtk_combo_box_entry_active_changed (GtkComboBox *combo_box,
4526 GtkComboBoxPrivate *priv = combo_box->priv;
4527 GtkTreeModel *model;
4530 if (gtk_combo_box_get_active_iter (combo_box, &iter))
4532 GtkEntry *entry = GTK_ENTRY (gtk_bin_get_child (GTK_BIN (combo_box)));
4536 GValue value = {0,};
4538 g_signal_handlers_block_by_func (entry,
4539 gtk_combo_box_entry_contents_changed,
4542 model = gtk_combo_box_get_model (combo_box);
4544 gtk_tree_model_get_value (model, &iter,
4545 priv->text_column, &value);
4546 g_object_set_property (G_OBJECT (entry), "text", &value);
4547 g_value_unset (&value);
4549 g_signal_handlers_unblock_by_func (entry,
4550 gtk_combo_box_entry_contents_changed,
4557 gtk_combo_box_constructor (GType type,
4558 guint n_construct_properties,
4559 GObjectConstructParam *construct_properties)
4562 GtkComboBox *combo_box;
4563 GtkComboBoxPrivate *priv;
4564 GtkStyleContext *context;
4566 object = G_OBJECT_CLASS (gtk_combo_box_parent_class)->constructor
4567 (type, n_construct_properties, construct_properties);
4569 combo_box = GTK_COMBO_BOX (object);
4570 priv = combo_box->priv;
4574 priv->area = gtk_cell_area_box_new ();
4575 g_object_ref_sink (priv->area);
4578 priv->cell_view = gtk_cell_view_new_with_context (priv->area, NULL);
4579 gtk_cell_view_set_fit_model (GTK_CELL_VIEW (priv->cell_view), TRUE);
4580 gtk_cell_view_set_model (GTK_CELL_VIEW (priv->cell_view), priv->model);
4581 gtk_widget_set_parent (priv->cell_view, GTK_WIDGET (combo_box));
4582 _gtk_bin_set_child (GTK_BIN (combo_box), priv->cell_view);
4583 gtk_widget_show (priv->cell_view);
4585 gtk_combo_box_check_appearance (combo_box);
4587 context = gtk_widget_get_style_context (GTK_WIDGET (combo_box));
4588 gtk_style_context_add_class (context, GTK_STYLE_CLASS_BUTTON);
4590 if (priv->has_entry)
4594 entry = gtk_entry_new ();
4595 gtk_widget_show (entry);
4596 gtk_container_add (GTK_CONTAINER (combo_box), entry);
4598 priv->text_renderer = gtk_cell_renderer_text_new ();
4599 gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (combo_box),
4600 priv->text_renderer, TRUE);
4602 gtk_combo_box_set_active (GTK_COMBO_BOX (combo_box), -1);
4604 g_signal_connect (combo_box, "changed",
4605 G_CALLBACK (gtk_combo_box_entry_active_changed), NULL);
4613 gtk_combo_box_dispose(GObject* object)
4615 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
4617 if (GTK_IS_MENU (combo_box->priv->popup_widget))
4619 gtk_combo_box_menu_destroy (combo_box);
4620 gtk_menu_detach (GTK_MENU (combo_box->priv->popup_widget));
4621 combo_box->priv->popup_widget = NULL;
4624 if (combo_box->priv->area)
4626 g_object_unref (combo_box->priv->area);
4627 combo_box->priv->area = NULL;
4630 if (GTK_IS_TREE_VIEW (combo_box->priv->tree_view))
4631 gtk_combo_box_list_destroy (combo_box);
4633 if (combo_box->priv->popup_window)
4635 gtk_widget_destroy (combo_box->priv->popup_window);
4636 combo_box->priv->popup_window = NULL;
4639 gtk_combo_box_unset_model (combo_box);
4641 G_OBJECT_CLASS (gtk_combo_box_parent_class)->dispose (object);
4645 gtk_combo_box_finalize (GObject *object)
4647 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
4649 g_free (combo_box->priv->tearoff_title);
4651 G_OBJECT_CLASS (gtk_combo_box_parent_class)->finalize (object);
4655 gtk_cell_editable_key_press (GtkWidget *widget,
4659 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
4661 if (event->keyval == GDK_KEY_Escape)
4663 g_object_set (combo_box,
4664 "editing-canceled", TRUE,
4666 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
4667 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
4671 else if (event->keyval == GDK_KEY_Return ||
4672 event->keyval == GDK_KEY_ISO_Enter ||
4673 event->keyval == GDK_KEY_KP_Enter)
4675 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
4676 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
4685 popdown_idle (gpointer data)
4687 GtkComboBox *combo_box;
4689 combo_box = GTK_COMBO_BOX (data);
4691 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
4692 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
4694 g_object_unref (combo_box);
4700 popdown_handler (GtkWidget *widget,
4703 gdk_threads_add_idle (popdown_idle, g_object_ref (data));
4707 popup_idle (gpointer data)
4709 GtkComboBox *combo_box;
4711 combo_box = GTK_COMBO_BOX (data);
4713 if (GTK_IS_MENU (combo_box->priv->popup_widget) &&
4714 combo_box->priv->cell_view)
4715 g_signal_connect_object (combo_box->priv->popup_widget,
4716 "unmap", G_CALLBACK (popdown_handler),
4719 /* we unset this if a menu item is activated */
4720 g_object_set (combo_box,
4721 "editing-canceled", TRUE,
4723 gtk_combo_box_popup (combo_box);
4725 combo_box->priv->popup_idle_id = 0;
4726 combo_box->priv->activate_button = 0;
4727 combo_box->priv->activate_time = 0;
4733 gtk_combo_box_start_editing (GtkCellEditable *cell_editable,
4736 GtkComboBox *combo_box = GTK_COMBO_BOX (cell_editable);
4739 combo_box->priv->is_cell_renderer = TRUE;
4741 if (combo_box->priv->cell_view)
4743 g_signal_connect_object (combo_box->priv->button, "key-press-event",
4744 G_CALLBACK (gtk_cell_editable_key_press),
4747 gtk_widget_grab_focus (combo_box->priv->button);
4751 child = gtk_bin_get_child (GTK_BIN (combo_box));
4753 g_signal_connect_object (child, "key-press-event",
4754 G_CALLBACK (gtk_cell_editable_key_press),
4757 gtk_widget_grab_focus (child);
4758 gtk_widget_set_can_focus (combo_box->priv->button, FALSE);
4761 /* we do the immediate popup only for the optionmenu-like
4764 if (combo_box->priv->is_cell_renderer &&
4765 combo_box->priv->cell_view && !combo_box->priv->tree_view)
4767 if (event && event->type == GDK_BUTTON_PRESS)
4769 GdkEventButton *event_button = (GdkEventButton *)event;
4771 combo_box->priv->activate_button = event_button->button;
4772 combo_box->priv->activate_time = event_button->time;
4775 combo_box->priv->popup_idle_id =
4776 gdk_threads_add_idle (popup_idle, combo_box);
4782 * gtk_combo_box_get_add_tearoffs:
4783 * @combo_box: a #GtkComboBox
4785 * Gets the current value of the :add-tearoffs property.
4787 * Return value: the current value of the :add-tearoffs property.
4790 gtk_combo_box_get_add_tearoffs (GtkComboBox *combo_box)
4792 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
4794 return combo_box->priv->add_tearoffs;
4798 * gtk_combo_box_set_add_tearoffs:
4799 * @combo_box: a #GtkComboBox
4800 * @add_tearoffs: %TRUE to add tearoff menu items
4802 * Sets whether the popup menu should have a tearoff
4808 gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box,
4809 gboolean add_tearoffs)
4811 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4813 add_tearoffs = add_tearoffs != FALSE;
4815 if (combo_box->priv->add_tearoffs != add_tearoffs)
4817 combo_box->priv->add_tearoffs = add_tearoffs;
4818 gtk_combo_box_check_appearance (combo_box);
4820 if (GTK_IS_TREE_MENU (combo_box->priv->popup_widget))
4821 _gtk_tree_menu_set_tearoff (GTK_TREE_MENU (combo_box->priv->popup_widget),
4822 combo_box->priv->add_tearoffs);
4824 g_object_notify (G_OBJECT (combo_box), "add-tearoffs");
4829 * gtk_combo_box_get_title:
4830 * @combo_box: a #GtkComboBox
4832 * Gets the current title of the menu in tearoff mode. See
4833 * gtk_combo_box_set_add_tearoffs().
4835 * Returns: the menu's title in tearoff mode. This is an internal copy of the
4836 * string which must not be freed.
4840 G_CONST_RETURN gchar*
4841 gtk_combo_box_get_title (GtkComboBox *combo_box)
4843 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4845 return combo_box->priv->tearoff_title;
4849 gtk_combo_box_update_title (GtkComboBox *combo_box)
4851 gtk_combo_box_check_appearance (combo_box);
4853 if (combo_box->priv->popup_widget &&
4854 GTK_IS_MENU (combo_box->priv->popup_widget))
4855 gtk_menu_set_title (GTK_MENU (combo_box->priv->popup_widget),
4856 combo_box->priv->tearoff_title);
4860 * gtk_combo_box_set_title:
4861 * @combo_box: a #GtkComboBox
4862 * @title: a title for the menu in tearoff mode
4864 * Sets the menu's title in tearoff mode.
4869 gtk_combo_box_set_title (GtkComboBox *combo_box,
4872 GtkComboBoxPrivate *priv;
4874 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4876 priv = combo_box->priv;
4878 if (strcmp (title ? title : "",
4879 priv->tearoff_title ? priv->tearoff_title : "") != 0)
4881 g_free (priv->tearoff_title);
4882 priv->tearoff_title = g_strdup (title);
4884 gtk_combo_box_update_title (combo_box);
4886 g_object_notify (G_OBJECT (combo_box), "tearoff-title");
4892 * gtk_combo_box_set_popup_fixed_width:
4893 * @combo_box: a #GtkComboBox
4894 * @fixed: whether to use a fixed popup width
4896 * Specifies whether the popup's width should be a fixed width
4897 * matching the allocated width of the combo box.
4902 gtk_combo_box_set_popup_fixed_width (GtkComboBox *combo_box,
4905 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4907 if (combo_box->priv->popup_fixed_width != fixed)
4909 combo_box->priv->popup_fixed_width = fixed;
4911 g_object_notify (G_OBJECT (combo_box), "popup-fixed-width");
4916 * gtk_combo_box_get_popup_fixed_width:
4917 * @combo_box: a #GtkComboBox
4919 * Gets whether the popup uses a fixed width matching
4920 * the allocated width of the combo box.
4922 * Returns: %TRUE if the popup uses a fixed width
4927 gtk_combo_box_get_popup_fixed_width (GtkComboBox *combo_box)
4929 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
4931 return combo_box->priv->popup_fixed_width;
4936 * gtk_combo_box_get_popup_accessible:
4937 * @combo_box: a #GtkComboBox
4939 * Gets the accessible object corresponding to the combo box's popup.
4941 * This function is mostly intended for use by accessibility technologies;
4942 * applications should have little use for it.
4944 * Returns: (transfer none): the accessible object corresponding
4945 * to the combo box's popup.
4950 gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box)
4954 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4956 if (combo_box->priv->popup_widget)
4958 atk_obj = gtk_widget_get_accessible (combo_box->priv->popup_widget);
4966 * gtk_combo_box_get_row_separator_func: (skip)
4967 * @combo_box: a #GtkComboBox
4969 * Returns the current row separator function.
4971 * Return value: the current row separator function.
4975 GtkTreeViewRowSeparatorFunc
4976 gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box)
4978 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4980 return combo_box->priv->row_separator_func;
4984 * gtk_combo_box_set_row_separator_func:
4985 * @combo_box: a #GtkComboBox
4986 * @func: a #GtkTreeViewRowSeparatorFunc
4987 * @data: (allow-none): user data to pass to @func, or %NULL
4988 * @destroy: (allow-none): destroy notifier for @data, or %NULL
4990 * Sets the row separator function, which is used to determine
4991 * whether a row should be drawn as a separator. If the row separator
4992 * function is %NULL, no separators are drawn. This is the default value.
4997 gtk_combo_box_set_row_separator_func (GtkComboBox *combo_box,
4998 GtkTreeViewRowSeparatorFunc func,
5000 GDestroyNotify destroy)
5002 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5004 if (combo_box->priv->row_separator_destroy)
5005 combo_box->priv->row_separator_destroy (combo_box->priv->row_separator_data);
5007 combo_box->priv->row_separator_func = func;
5008 combo_box->priv->row_separator_data = data;
5009 combo_box->priv->row_separator_destroy = destroy;
5011 /* Provoke the underlying treeview/menu to rebuild themselves with the new separator func */
5012 if (combo_box->priv->tree_view)
5014 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view), NULL);
5015 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view), combo_box->priv->model);
5018 if (GTK_IS_TREE_MENU (combo_box->priv->popup_widget))
5020 _gtk_tree_menu_set_model (GTK_TREE_MENU (combo_box->priv->popup_widget), NULL);
5021 _gtk_tree_menu_set_model (GTK_TREE_MENU (combo_box->priv->popup_widget), combo_box->priv->model);
5024 gtk_widget_queue_draw (GTK_WIDGET (combo_box));
5028 * gtk_combo_box_set_button_sensitivity:
5029 * @combo_box: a #GtkComboBox
5030 * @sensitivity: specify the sensitivity of the dropdown button
5032 * Sets whether the dropdown button of the combo box should be
5033 * always sensitive (%GTK_SENSITIVITY_ON), never sensitive (%GTK_SENSITIVITY_OFF)
5034 * or only if there is at least one item to display (%GTK_SENSITIVITY_AUTO).
5039 gtk_combo_box_set_button_sensitivity (GtkComboBox *combo_box,
5040 GtkSensitivityType sensitivity)
5042 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5044 if (combo_box->priv->button_sensitivity != sensitivity)
5046 combo_box->priv->button_sensitivity = sensitivity;
5047 gtk_combo_box_update_sensitivity (combo_box);
5049 g_object_notify (G_OBJECT (combo_box), "button-sensitivity");
5054 * gtk_combo_box_get_button_sensitivity:
5055 * @combo_box: a #GtkComboBox
5057 * Returns whether the combo box sets the dropdown button
5058 * sensitive or not when there are no items in the model.
5060 * Return Value: %GTK_SENSITIVITY_ON if the dropdown button
5061 * is sensitive when the model is empty, %GTK_SENSITIVITY_OFF
5062 * if the button is always insensitive or
5063 * %GTK_SENSITIVITY_AUTO if it is only sensitive as long as
5064 * the model has one item to be selected.
5069 gtk_combo_box_get_button_sensitivity (GtkComboBox *combo_box)
5071 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5073 return combo_box->priv->button_sensitivity;
5078 * gtk_combo_box_get_has_entry:
5079 * @combo_box: a #GtkComboBox
5081 * Returns whether the combo box has an entry.
5083 * Return Value: whether there is an entry in @combo_box.
5088 gtk_combo_box_get_has_entry (GtkComboBox *combo_box)
5090 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5092 return combo_box->priv->has_entry;
5096 * gtk_combo_box_set_entry_text_column:
5097 * @combo_box: A #GtkComboBox
5098 * @text_column: A column in @model to get the strings from for
5099 * the internal entry
5101 * Sets the model column which @combo_box should use to get strings from
5102 * to be @text_column. The column @text_column in the model of @combo_box
5103 * must be of type %G_TYPE_STRING.
5105 * This is only relevant if @combo_box has been created with
5106 * #GtkComboBox:has-entry as %TRUE.
5111 gtk_combo_box_set_entry_text_column (GtkComboBox *combo_box,
5114 GtkComboBoxPrivate *priv = combo_box->priv;
5115 GtkTreeModel *model;
5117 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5119 model = gtk_combo_box_get_model (combo_box);
5121 g_return_if_fail (text_column >= 0);
5122 g_return_if_fail (model == NULL || text_column < gtk_tree_model_get_n_columns (model));
5124 priv->text_column = text_column;
5126 if (priv->text_renderer != NULL)
5127 gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (combo_box),
5128 priv->text_renderer,
5129 "text", text_column,
5134 * gtk_combo_box_get_entry_text_column:
5135 * @combo_box: A #GtkComboBox.
5137 * Returns the column which @combo_box is using to get the strings
5138 * from to display in the internal entry.
5140 * Return value: A column in the data source model of @combo_box.
5145 gtk_combo_box_get_entry_text_column (GtkComboBox *combo_box)
5147 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
5149 return combo_box->priv->text_column;
5153 * gtk_combo_box_set_focus_on_click:
5154 * @combo: a #GtkComboBox
5155 * @focus_on_click: whether the combo box grabs focus when clicked
5158 * Sets whether the combo box will grab focus when it is clicked with
5159 * the mouse. Making mouse clicks not grab focus is useful in places
5160 * like toolbars where you don't want the keyboard focus removed from
5161 * the main area of the application.
5166 gtk_combo_box_set_focus_on_click (GtkComboBox *combo_box,
5167 gboolean focus_on_click)
5169 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5171 focus_on_click = focus_on_click != FALSE;
5173 if (combo_box->priv->focus_on_click != focus_on_click)
5175 combo_box->priv->focus_on_click = focus_on_click;
5177 if (combo_box->priv->button)
5178 gtk_button_set_focus_on_click (GTK_BUTTON (combo_box->priv->button),
5181 g_object_notify (G_OBJECT (combo_box), "focus-on-click");
5186 * gtk_combo_box_get_focus_on_click:
5187 * @combo: a #GtkComboBox
5189 * Returns whether the combo box grabs focus when it is clicked
5190 * with the mouse. See gtk_combo_box_set_focus_on_click().
5192 * Return value: %TRUE if the combo box grabs focus when it is
5193 * clicked with the mouse.
5198 gtk_combo_box_get_focus_on_click (GtkComboBox *combo_box)
5200 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5202 return combo_box->priv->focus_on_click;
5207 gtk_combo_box_buildable_custom_tag_start (GtkBuildable *buildable,
5208 GtkBuilder *builder,
5210 const gchar *tagname,
5211 GMarkupParser *parser,
5214 if (parent_buildable_iface->custom_tag_start (buildable, builder, child,
5215 tagname, parser, data))
5218 return _gtk_cell_layout_buildable_custom_tag_start (buildable, builder, child,
5219 tagname, parser, data);
5223 gtk_combo_box_buildable_custom_tag_end (GtkBuildable *buildable,
5224 GtkBuilder *builder,
5226 const gchar *tagname,
5229 if (!_gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname, data))
5230 parent_buildable_iface->custom_tag_end (buildable, builder, child, tagname, data);
5234 gtk_combo_box_buildable_get_internal_child (GtkBuildable *buildable,
5235 GtkBuilder *builder,
5236 const gchar *childname)
5238 GtkComboBox *combo_box = GTK_COMBO_BOX (buildable);
5240 if (combo_box->priv->has_entry && strcmp (childname, "entry") == 0)
5241 return G_OBJECT (gtk_bin_get_child (GTK_BIN (buildable)));
5243 return parent_buildable_iface->get_internal_child (buildable, builder, childname);
5247 gtk_combo_box_get_preferred_width (GtkWidget *widget,
5251 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
5252 GtkComboBoxPrivate *priv = combo_box->priv;
5253 gint focus_width, focus_pad;
5254 gint font_size, arrow_size;
5255 PangoContext *context;
5256 PangoFontMetrics *metrics;
5257 PangoFontDescription *font_desc;
5259 gint minimum_width = 0, natural_width = 0;
5260 gint child_min, child_nat;
5261 GtkStyleContext *style_context;
5262 GtkStateFlags state;
5265 child = gtk_bin_get_child (GTK_BIN (widget));
5268 gtk_widget_get_preferred_width (child, &child_min, &child_nat);
5270 gtk_widget_style_get (GTK_WIDGET (widget),
5271 "focus-line-width", &focus_width,
5272 "focus-padding", &focus_pad,
5273 "arrow-size", &arrow_size,
5276 style_context = gtk_widget_get_style_context (widget);
5277 state = gtk_widget_get_state_flags (widget);
5279 gtk_style_context_get (style_context, state,
5281 "border-width", &border,
5284 context = gtk_widget_get_pango_context (GTK_WIDGET (widget));
5285 metrics = pango_context_get_metrics (context, font_desc,
5286 pango_context_get_language (context));
5287 font_size = PANGO_PIXELS (pango_font_metrics_get_ascent (metrics) +
5288 pango_font_metrics_get_descent (metrics));
5289 pango_font_metrics_unref (metrics);
5290 pango_font_description_free (font_desc);
5292 arrow_size = MAX (arrow_size, font_size);
5294 gtk_widget_set_size_request (priv->arrow, arrow_size, arrow_size);
5296 if (!priv->tree_view)
5299 if (priv->cell_view)
5301 gint sep_width, arrow_width;
5302 gint border_width, xpad;
5303 GtkBorder button_border;
5305 border_width = gtk_container_get_border_width (GTK_CONTAINER (combo_box));
5306 get_widget_border (priv->button, &button_border);
5308 gtk_widget_get_preferred_width (priv->separator, &sep_width, NULL);
5309 gtk_widget_get_preferred_width (priv->arrow, &arrow_width, NULL);
5311 xpad = 2 * (border_width + focus_width + focus_pad) +
5312 button_border.left + button_border.right;
5314 minimum_width = child_min + sep_width + arrow_width + xpad;
5315 natural_width = child_nat + sep_width + arrow_width + xpad;
5319 gint but_width, but_nat_width;
5321 gtk_widget_get_preferred_width (priv->button,
5322 &but_width, &but_nat_width);
5324 minimum_width = child_min + but_width;
5325 natural_width = child_nat + but_nat_width;
5331 gint button_width, button_nat_width;
5333 /* sample + frame */
5334 minimum_width = child_min;
5335 natural_width = child_nat;
5337 minimum_width += 2 * focus_width;
5338 natural_width += 2 * focus_width;
5340 if (priv->cell_view_frame)
5342 if (priv->has_frame)
5344 gint border_width, xpad;
5345 GtkBorder frame_border;
5347 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->cell_view_frame));
5348 get_widget_border (priv->cell_view_frame, &frame_border);
5349 xpad = (2 * border_width) + frame_border.left + frame_border.right;
5351 minimum_width += xpad;
5352 natural_width += xpad;
5357 gtk_widget_get_preferred_width (priv->button,
5358 &button_width, &button_nat_width);
5360 minimum_width += button_width;
5361 natural_width += button_nat_width;
5364 minimum_width += border->left + border->right;
5365 natural_width += border->left + border->right;
5366 gtk_border_free (border);
5369 *minimum_size = minimum_width;
5372 *natural_size = natural_width;
5376 gtk_combo_box_get_preferred_height (GtkWidget *widget,
5382 /* Combo box is height-for-width only
5383 * (so we always just reserve enough height for the minimum width) */
5384 GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, &min_width, NULL);
5385 GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width (widget, min_width, minimum_size, natural_size);
5389 gtk_combo_box_get_preferred_width_for_height (GtkWidget *widget,
5394 /* Combo box is height-for-width only
5395 * (so we assume we always reserved enough height for the minimum width) */
5396 GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, minimum_size, natural_size);
5401 gtk_combo_box_get_preferred_height_for_width (GtkWidget *widget,
5406 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
5407 GtkComboBoxPrivate *priv = combo_box->priv;
5408 gint focus_width, focus_pad;
5409 gint min_height = 0, nat_height = 0;
5414 gtk_widget_style_get (GTK_WIDGET (widget),
5415 "focus-line-width", &focus_width,
5416 "focus-padding", &focus_pad,
5419 child = gtk_bin_get_child (GTK_BIN (widget));
5421 get_widget_border (widget, &border);
5422 size = avail_size - border.left;
5424 if (!priv->tree_view)
5427 if (priv->cell_view)
5429 /* calculate x/y padding and separator/arrow size */
5430 gint sep_width, arrow_width, sep_height, arrow_height;
5431 gint border_width, xpad, ypad;
5432 GtkBorder button_border;
5434 border_width = gtk_container_get_border_width (GTK_CONTAINER (combo_box));
5435 get_widget_border (priv->button, &button_border);
5437 gtk_widget_get_preferred_width (priv->separator, &sep_width, NULL);
5438 gtk_widget_get_preferred_width (priv->arrow, &arrow_width, NULL);
5439 gtk_widget_get_preferred_height_for_width (priv->separator,
5440 sep_width, &sep_height, NULL);
5441 gtk_widget_get_preferred_height_for_width (priv->arrow,
5442 arrow_width, &arrow_height, NULL);
5444 xpad = 2 * (border_width + focus_width + focus_pad) +
5445 button_border.left + button_border.right;
5446 ypad = 2 * (border_width + focus_width + focus_pad) +
5447 button_border.top + button_border.bottom;
5449 size -= sep_width + arrow_width + xpad;
5451 /* Get height-for-width of the child widget, usually a GtkCellArea calculating
5452 * and fitting the whole treemodel */
5453 gtk_widget_get_preferred_height_for_width (child, size, &min_height, &nat_height);
5455 arrow_height = MAX (arrow_height, sep_height);
5456 min_height = MAX (min_height, arrow_height);
5457 nat_height = MAX (nat_height, arrow_height);
5464 /* there is a custom child widget inside (no priv->cell_view) */
5465 gint but_width, but_height;
5467 gtk_widget_get_preferred_width (priv->button, &but_width, NULL);
5468 gtk_widget_get_preferred_height_for_width (priv->button,
5469 but_width, &but_height, NULL);
5473 /* Get height-for-width of the child widget, usually a GtkCellArea calculating
5474 * and fitting the whole treemodel */
5475 gtk_widget_get_preferred_height_for_width (child, size, &min_height, &nat_height);
5477 min_height = MAX (min_height, but_height);
5478 nat_height = MAX (nat_height, but_height);
5484 gint but_width, but_height;
5485 gint xpad = 0, ypad = 0;
5487 gtk_widget_get_preferred_width (priv->button, &but_width, NULL);
5488 gtk_widget_get_preferred_height_for_width (priv->button,
5489 but_width, &but_height, NULL);
5491 if (priv->cell_view_frame && priv->has_frame)
5493 GtkBorder frame_border;
5496 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->cell_view_frame));
5497 get_widget_border (GTK_WIDGET (priv->cell_view_frame), &frame_border);
5499 xpad = (2 * border_width) + border.left + frame_border.right;
5500 ypad = (2 * border_width) + border.top + frame_border.bottom;
5504 size -= 2 * focus_width;
5507 /* Get height-for-width of the child widget, usually a GtkCellArea calculating
5508 * and fitting the whole treemodel */
5509 gtk_widget_get_preferred_height_for_width (child, size, &min_height, &nat_height);
5511 min_height = MAX (min_height, but_height);
5512 nat_height = MAX (nat_height, but_height);
5518 min_height += border.top + border.bottom;
5519 nat_height += border.top + border.bottom;
5522 *minimum_size = min_height;
5525 *natural_size = nat_height;
5529 * gtk_combo_box_set_id_column:
5530 * @combo_box: A #GtkComboBox
5531 * @id_column: A column in @model to get string IDs for values from
5533 * Sets the model column which @combo_box should use to get string IDs
5534 * for values from. The column @id_column in the model of @combo_box
5535 * must be of type %G_TYPE_STRING.
5540 gtk_combo_box_set_id_column (GtkComboBox *combo_box,
5543 GtkComboBoxPrivate *priv = combo_box->priv;
5544 GtkTreeModel *model;
5546 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5548 if (id_column != priv->id_column)
5550 model = gtk_combo_box_get_model (combo_box);
5552 g_return_if_fail (id_column >= 0);
5553 g_return_if_fail (model == NULL ||
5554 id_column < gtk_tree_model_get_n_columns (model));
5556 priv->id_column = id_column;
5558 g_object_notify (G_OBJECT (combo_box), "id-column");
5559 g_object_notify (G_OBJECT (combo_box), "active-id");
5564 * gtk_combo_box_get_id_column:
5565 * @combo_box: A #GtkComboBox
5567 * Returns the column which @combo_box is using to get string IDs
5570 * Return value: A column in the data source model of @combo_box.
5575 gtk_combo_box_get_id_column (GtkComboBox *combo_box)
5577 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
5579 return combo_box->priv->id_column;
5583 * gtk_combo_box_get_active_id:
5584 * @combo_box: a #GtkComboBox
5586 * Returns the ID of the active row of @combo_box. This value is taken
5587 * from the active row and the column specified by the 'id-column'
5588 * property of @combo_box (see gtk_combo_box_set_id_column()).
5590 * The returned value is an interned string which means that you can
5591 * compare the pointer by value to other interned strings and that you
5594 * If the 'id-column' property of @combo_box is not set or if no row is
5595 * selected then %NULL is returned.
5597 * Return value: the ID of the active row, or %NULL
5602 gtk_combo_box_get_active_id (GtkComboBox *combo_box)
5604 GtkTreeModel *model;
5608 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
5610 column = combo_box->priv->id_column;
5615 model = gtk_combo_box_get_model (combo_box);
5616 g_return_val_if_fail (gtk_tree_model_get_column_type (model, column) ==
5617 G_TYPE_STRING, NULL);
5619 if (gtk_combo_box_get_active_iter (combo_box, &iter))
5621 const gchar *interned;
5624 gtk_tree_model_get (model, &iter, column, &id, -1);
5625 interned = g_intern_string (id);
5635 * gtk_combo_box_set_active_id:
5636 * @combo_box: a #GtkComboBox
5637 * @active_id: the ID of the row to select
5639 * Changes the active row of @combo_box to the one that has an ID equal to @id.
5641 * If the 'id-column' property of @combo_box is unset or if no row has
5642 * the given ID then nothing happens.
5647 gtk_combo_box_set_active_id (GtkComboBox *combo_box,
5648 const gchar *active_id)
5650 GtkTreeModel *model;
5654 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5656 column = combo_box->priv->id_column;
5661 model = gtk_combo_box_get_model (combo_box);
5662 g_return_if_fail (gtk_tree_model_get_column_type (model, column) ==
5665 if (gtk_tree_model_get_iter_first (model, &iter))
5670 gtk_tree_model_get (model, &iter, column, &id, -1);
5671 match = strcmp (id, active_id) == 0;
5676 gtk_combo_box_set_active_iter (combo_box, &iter);
5679 } while (gtk_tree_model_iter_next (model, &iter));