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;
107 GtkTreeViewColumn *column;
109 GtkWidget *cell_view;
110 GtkWidget *cell_view_frame;
115 GtkWidget *separator;
117 GtkWidget *popup_widget;
118 GtkWidget *popup_window;
119 GtkWidget *scrolled_window;
126 guint activate_button;
127 guint32 activate_time;
129 guint resize_idle_id;
131 /* For "has-entry" specific behavior we track
132 * 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_changed (GtkWidget *widget,
270 GtkStateType 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 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_changed = gtk_combo_box_state_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);
1057 gtk_combo_box_set_model (combo_box, g_value_get_object (value));
1060 case PROP_WRAP_WIDTH:
1061 gtk_combo_box_set_wrap_width (combo_box, g_value_get_int (value));
1064 case PROP_ROW_SPAN_COLUMN:
1065 gtk_combo_box_set_row_span_column (combo_box, g_value_get_int (value));
1068 case PROP_COLUMN_SPAN_COLUMN:
1069 gtk_combo_box_set_column_span_column (combo_box, g_value_get_int (value));
1073 gtk_combo_box_set_active (combo_box, g_value_get_int (value));
1076 case PROP_ADD_TEAROFFS:
1077 gtk_combo_box_set_add_tearoffs (combo_box, g_value_get_boolean (value));
1080 case PROP_HAS_FRAME:
1081 combo_box->priv->has_frame = g_value_get_boolean (value);
1083 if (combo_box->priv->has_entry)
1087 child = gtk_bin_get_child (GTK_BIN (combo_box));
1089 gtk_entry_set_has_frame (GTK_ENTRY (child),
1090 combo_box->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 combo_box->priv->editing_canceled = g_value_get_boolean (value);
1125 case PROP_HAS_ENTRY:
1126 combo_box->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 combo_box->priv->area = g_object_ref_sink (area);
1150 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1156 gtk_combo_box_get_property (GObject *object,
1161 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
1162 GtkComboBoxPrivate *priv = combo_box->priv;
1167 g_value_set_object (value, combo_box->priv->model);
1170 case PROP_WRAP_WIDTH:
1171 g_value_set_int (value, combo_box->priv->wrap_width);
1174 case PROP_ROW_SPAN_COLUMN:
1175 g_value_set_int (value, combo_box->priv->row_column);
1178 case PROP_COLUMN_SPAN_COLUMN:
1179 g_value_set_int (value, combo_box->priv->col_column);
1183 g_value_set_int (value, gtk_combo_box_get_active (combo_box));
1186 case PROP_ADD_TEAROFFS:
1187 g_value_set_boolean (value, gtk_combo_box_get_add_tearoffs (combo_box));
1190 case PROP_HAS_FRAME:
1191 g_value_set_boolean (value, combo_box->priv->has_frame);
1194 case PROP_FOCUS_ON_CLICK:
1195 g_value_set_boolean (value, combo_box->priv->focus_on_click);
1198 case PROP_TEAROFF_TITLE:
1199 g_value_set_string (value, gtk_combo_box_get_title (combo_box));
1202 case PROP_POPUP_SHOWN:
1203 g_value_set_boolean (value, combo_box->priv->popup_shown);
1206 case PROP_BUTTON_SENSITIVITY:
1207 g_value_set_enum (value, combo_box->priv->button_sensitivity);
1210 case PROP_POPUP_FIXED_WIDTH:
1211 g_value_set_boolean (value, combo_box->priv->popup_fixed_width);
1214 case PROP_EDITING_CANCELED:
1215 g_value_set_boolean (value, priv->editing_canceled);
1218 case PROP_HAS_ENTRY:
1219 g_value_set_boolean (value, priv->has_entry);
1222 case PROP_ENTRY_TEXT_COLUMN:
1223 g_value_set_int (value, priv->text_column);
1226 case PROP_ID_COLUMN:
1227 g_value_set_int (value, priv->id_column);
1230 case PROP_ACTIVE_ID:
1231 g_value_set_string (value, gtk_combo_box_get_active_id (combo_box));
1234 case PROP_CELL_AREA:
1235 g_value_set_object (value, priv->area);
1239 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1245 gtk_combo_box_state_changed (GtkWidget *widget,
1246 GtkStateType previous)
1248 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1249 GtkComboBoxPrivate *priv = combo_box->priv;
1251 if (gtk_widget_get_realized (widget))
1253 if (priv->tree_view && priv->cell_view)
1255 GtkStyleContext *context;
1256 GtkStateFlags state;
1259 context = gtk_widget_get_style_context (widget);
1260 state = gtk_widget_get_state_flags (widget);
1262 gtk_style_context_get (context, state,
1263 "background-color", &color,
1266 gtk_cell_view_set_background_rgba (GTK_CELL_VIEW (priv->cell_view), color);
1267 gdk_rgba_free (color);
1271 gtk_widget_queue_draw (widget);
1275 gtk_combo_box_button_state_flags_changed (GtkWidget *widget,
1276 GtkStateFlags previous,
1279 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
1280 GtkComboBoxPrivate *priv = combo_box->priv;
1282 if (gtk_widget_get_realized (widget))
1284 if (!priv->tree_view && priv->cell_view)
1285 gtk_widget_set_state_flags (priv->cell_view,
1286 gtk_widget_get_state_flags (widget),
1290 gtk_widget_queue_draw (widget);
1294 gtk_combo_box_check_appearance (GtkComboBox *combo_box)
1296 GtkComboBoxPrivate *priv = combo_box->priv;
1297 gboolean appears_as_list;
1299 /* if wrap_width > 0, then we are in grid-mode and forced to use
1302 if (priv->wrap_width)
1303 appears_as_list = FALSE;
1305 gtk_widget_style_get (GTK_WIDGET (combo_box),
1306 "appears-as-list", &appears_as_list,
1309 if (appears_as_list)
1311 /* Destroy all the menu mode widgets, if they exist. */
1312 if (GTK_IS_MENU (priv->popup_widget))
1313 gtk_combo_box_menu_destroy (combo_box);
1315 /* Create the list mode widgets, if they don't already exist. */
1316 if (!GTK_IS_TREE_VIEW (priv->tree_view))
1317 gtk_combo_box_list_setup (combo_box);
1321 /* Destroy all the list mode widgets, if they exist. */
1322 if (GTK_IS_TREE_VIEW (priv->tree_view))
1323 gtk_combo_box_list_destroy (combo_box);
1325 /* Create the menu mode widgets, if they don't already exist. */
1326 if (!GTK_IS_MENU (priv->popup_widget))
1327 gtk_combo_box_menu_setup (combo_box, TRUE);
1330 gtk_widget_style_get (GTK_WIDGET (combo_box),
1331 "shadow-type", &priv->shadow_type,
1336 gtk_combo_box_style_updated (GtkWidget *widget)
1338 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1339 GtkComboBoxPrivate *priv = combo_box->priv;
1342 gtk_combo_box_check_appearance (combo_box);
1344 if (priv->tree_view && priv->cell_view)
1346 GtkStyleContext *context;
1349 context = gtk_widget_get_style_context (widget);
1350 gtk_style_context_get (context, 0,
1351 "background-color", &color,
1354 gtk_cell_view_set_background_rgba (GTK_CELL_VIEW (priv->cell_view),
1357 gdk_rgba_free (color);
1360 child = gtk_bin_get_child (GTK_BIN (combo_box));
1361 if (GTK_IS_ENTRY (child))
1362 g_object_set (child, "shadow-type",
1363 GTK_SHADOW_NONE == priv->shadow_type ?
1364 GTK_SHADOW_IN : GTK_SHADOW_NONE, NULL);
1368 gtk_combo_box_button_toggled (GtkWidget *widget,
1371 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
1373 if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (widget)))
1375 if (!combo_box->priv->popup_in_progress)
1376 gtk_combo_box_popup (combo_box);
1379 gtk_combo_box_popdown (combo_box);
1383 gtk_combo_box_add (GtkContainer *container,
1386 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
1387 GtkComboBoxPrivate *priv = combo_box->priv;
1389 if (priv->has_entry && !GTK_IS_ENTRY (widget))
1391 g_warning ("Attempting to add a widget with type %s to a GtkComboBox that needs an entry "
1392 "(need an instance of GtkEntry or of a subclass)",
1393 G_OBJECT_TYPE_NAME (widget));
1397 if (priv->cell_view &&
1398 gtk_widget_get_parent (priv->cell_view))
1400 gtk_widget_unparent (priv->cell_view);
1401 _gtk_bin_set_child (GTK_BIN (container), NULL);
1402 gtk_widget_queue_resize (GTK_WIDGET (container));
1405 gtk_widget_set_parent (widget, GTK_WIDGET (container));
1406 _gtk_bin_set_child (GTK_BIN (container), widget);
1408 if (priv->cell_view &&
1409 widget != priv->cell_view)
1411 /* since the cell_view was unparented, it's gone now */
1412 priv->cell_view = NULL;
1414 if (!priv->tree_view && priv->separator)
1416 gtk_container_remove (GTK_CONTAINER (gtk_widget_get_parent (priv->separator)),
1418 priv->separator = NULL;
1420 gtk_widget_queue_resize (GTK_WIDGET (container));
1422 else if (priv->cell_view_frame)
1424 gtk_widget_unparent (priv->cell_view_frame);
1425 priv->cell_view_frame = NULL;
1430 if (priv->has_entry)
1432 /* this flag is a hack to tell the entry to fill its allocation.
1434 _gtk_entry_set_is_cell_renderer (GTK_ENTRY (widget), TRUE);
1436 g_signal_connect (widget, "changed",
1437 G_CALLBACK (gtk_combo_box_entry_contents_changed),
1440 gtk_entry_set_has_frame (GTK_ENTRY (widget), priv->has_frame);
1445 gtk_combo_box_remove (GtkContainer *container,
1448 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
1449 GtkComboBoxPrivate *priv = combo_box->priv;
1451 gboolean appears_as_list;
1453 if (priv->has_entry)
1455 GtkWidget *child_widget;
1457 child_widget = gtk_bin_get_child (GTK_BIN (container));
1458 if (widget && widget == child_widget)
1460 g_signal_handlers_disconnect_by_func (widget,
1461 gtk_combo_box_entry_contents_changed,
1463 _gtk_entry_set_is_cell_renderer (GTK_ENTRY (widget), FALSE);
1467 if (widget == priv->cell_view)
1468 priv->cell_view = NULL;
1470 gtk_widget_unparent (widget);
1471 _gtk_bin_set_child (GTK_BIN (container), NULL);
1473 if (gtk_widget_in_destruction (GTK_WIDGET (combo_box)))
1476 gtk_widget_queue_resize (GTK_WIDGET (container));
1478 if (!priv->tree_view)
1479 appears_as_list = FALSE;
1481 appears_as_list = TRUE;
1483 if (appears_as_list)
1484 gtk_combo_box_list_destroy (combo_box);
1485 else if (GTK_IS_MENU (priv->popup_widget))
1487 gtk_combo_box_menu_destroy (combo_box);
1488 gtk_menu_detach (GTK_MENU (priv->popup_widget));
1489 priv->popup_widget = NULL;
1492 if (!priv->cell_view)
1494 priv->cell_view = gtk_cell_view_new ();
1495 gtk_widget_set_parent (priv->cell_view, GTK_WIDGET (container));
1496 _gtk_bin_set_child (GTK_BIN (container), priv->cell_view);
1498 gtk_widget_show (priv->cell_view);
1499 gtk_cell_view_set_model (GTK_CELL_VIEW (priv->cell_view),
1504 if (appears_as_list)
1505 gtk_combo_box_list_setup (combo_box);
1507 gtk_combo_box_menu_setup (combo_box, TRUE);
1509 if (gtk_tree_row_reference_valid (priv->active_row))
1511 path = gtk_tree_row_reference_get_path (priv->active_row);
1512 gtk_combo_box_set_active_internal (combo_box, path);
1513 gtk_tree_path_free (path);
1516 gtk_combo_box_set_active_internal (combo_box, NULL);
1520 gtk_combo_box_menu_show (GtkWidget *menu,
1523 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1524 GtkComboBoxPrivate *priv = combo_box->priv;
1526 gtk_combo_box_child_show (menu, user_data);
1528 priv->popup_in_progress = TRUE;
1529 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button),
1531 priv->popup_in_progress = FALSE;
1535 gtk_combo_box_menu_hide (GtkWidget *menu,
1538 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1540 gtk_combo_box_child_hide (menu,user_data);
1542 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (combo_box->priv->button),
1547 gtk_combo_box_detacher (GtkWidget *widget,
1550 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
1551 GtkComboBoxPrivate *priv = combo_box->priv;
1553 g_return_if_fail (priv->popup_widget == (GtkWidget *) menu);
1555 g_signal_handlers_disconnect_by_func (menu->priv->toplevel,
1556 gtk_combo_box_menu_show,
1558 g_signal_handlers_disconnect_by_func (menu->priv->toplevel,
1559 gtk_combo_box_menu_hide,
1562 priv->popup_widget = NULL;
1566 gtk_combo_box_set_popup_widget (GtkComboBox *combo_box,
1569 GtkComboBoxPrivate *priv = combo_box->priv;
1571 if (GTK_IS_MENU (priv->popup_widget))
1573 gtk_menu_detach (GTK_MENU (priv->popup_widget));
1574 priv->popup_widget = NULL;
1576 else if (priv->popup_widget)
1578 gtk_container_remove (GTK_CONTAINER (priv->scrolled_window),
1579 priv->popup_widget);
1580 g_object_unref (priv->popup_widget);
1581 priv->popup_widget = NULL;
1584 if (GTK_IS_MENU (popup))
1586 if (priv->popup_window)
1588 gtk_widget_destroy (priv->popup_window);
1589 priv->popup_window = NULL;
1592 priv->popup_widget = popup;
1595 * Note that we connect to show/hide on the toplevel, not the
1596 * menu itself, since the menu is not shown/hidden when it is
1597 * popped up while torn-off.
1599 g_signal_connect (GTK_MENU (popup)->priv->toplevel, "show",
1600 G_CALLBACK (gtk_combo_box_menu_show), combo_box);
1601 g_signal_connect (GTK_MENU (popup)->priv->toplevel, "hide",
1602 G_CALLBACK (gtk_combo_box_menu_hide), combo_box);
1604 gtk_menu_attach_to_widget (GTK_MENU (popup),
1605 GTK_WIDGET (combo_box),
1606 gtk_combo_box_detacher);
1610 if (!priv->popup_window)
1612 GtkWidget *toplevel;
1614 priv->popup_window = gtk_window_new (GTK_WINDOW_POPUP);
1615 gtk_widget_set_name (priv->popup_window, "gtk-combobox-popup-window");
1617 gtk_window_set_type_hint (GTK_WINDOW (priv->popup_window),
1618 GDK_WINDOW_TYPE_HINT_COMBO);
1620 g_signal_connect (GTK_WINDOW (priv->popup_window),"show",
1621 G_CALLBACK (gtk_combo_box_child_show),
1623 g_signal_connect (GTK_WINDOW (priv->popup_window),"hide",
1624 G_CALLBACK (gtk_combo_box_child_hide),
1627 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (combo_box));
1628 if (GTK_IS_WINDOW (toplevel))
1630 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
1631 GTK_WINDOW (priv->popup_window));
1632 gtk_window_set_transient_for (GTK_WINDOW (priv->popup_window),
1633 GTK_WINDOW (toplevel));
1636 gtk_window_set_resizable (GTK_WINDOW (priv->popup_window), FALSE);
1637 gtk_window_set_screen (GTK_WINDOW (priv->popup_window),
1638 gtk_widget_get_screen (GTK_WIDGET (combo_box)));
1640 priv->scrolled_window = gtk_scrolled_window_new (NULL, NULL);
1642 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1645 gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1648 gtk_widget_show (priv->scrolled_window);
1650 gtk_container_add (GTK_CONTAINER (priv->popup_window),
1651 priv->scrolled_window);
1654 gtk_container_add (GTK_CONTAINER (priv->scrolled_window),
1657 gtk_widget_show (popup);
1658 g_object_ref (popup);
1659 priv->popup_widget = popup;
1664 get_widget_border (GtkWidget *widget,
1667 GtkStyleContext *context;
1668 GtkBorder *border_width;
1670 context = gtk_widget_get_style_context (widget);
1672 gtk_style_context_get (context,
1673 gtk_widget_get_state_flags (widget),
1674 "border-width", &border_width,
1677 *border = *border_width;
1678 gtk_border_free (border_width);
1682 gtk_combo_box_menu_position_below (GtkMenu *menu,
1688 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1689 GtkAllocation child_allocation;
1695 GdkRectangle monitor;
1698 /* FIXME: is using the size request here broken? */
1699 child = gtk_bin_get_child (GTK_BIN (combo_box));
1703 gtk_widget_get_allocation (child, &child_allocation);
1705 if (!gtk_widget_get_has_window (child))
1707 sx += child_allocation.x;
1708 sy += child_allocation.y;
1711 gdk_window_get_root_coords (gtk_widget_get_window (child),
1713 get_widget_border (GTK_WIDGET (combo_box), &border);
1716 if (combo_box->priv->popup_fixed_width)
1717 gtk_widget_get_preferred_size (GTK_WIDGET (menu), &req, NULL);
1719 gtk_widget_get_preferred_size (GTK_WIDGET (menu), NULL, &req);
1721 if (gtk_widget_get_direction (GTK_WIDGET (combo_box)) == GTK_TEXT_DIR_LTR)
1724 *x = sx + child_allocation.width - req.width;
1727 screen = gtk_widget_get_screen (GTK_WIDGET (combo_box));
1728 monitor_num = gdk_screen_get_monitor_at_window (screen,
1729 gtk_widget_get_window (GTK_WIDGET (combo_box)));
1730 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1734 else if (*x + req.width > monitor.x + monitor.width)
1735 *x = monitor.x + monitor.width - req.width;
1737 if (monitor.y + monitor.height - *y - child_allocation.height >= req.height)
1738 *y += child_allocation.height;
1739 else if (*y - monitor.y >= req.height)
1741 else if (monitor.y + monitor.height - *y - child_allocation.height > *y - monitor.y)
1742 *y += child_allocation.height;
1750 gtk_combo_box_menu_position_over (GtkMenu *menu,
1756 GtkComboBox *combo_box;
1760 GtkAllocation allocation;
1761 GtkAllocation child_allocation;
1768 combo_box = GTK_COMBO_BOX (user_data);
1769 widget = GTK_WIDGET (combo_box);
1771 active = gtk_menu_get_active (GTK_MENU (combo_box->priv->popup_widget));
1773 gtk_widget_get_allocation (widget, &allocation);
1775 menu_xpos = allocation.x;
1776 menu_ypos = allocation.y + allocation.height / 2 - 2;
1778 if (combo_box->priv->popup_fixed_width)
1779 gtk_widget_get_preferred_width (GTK_WIDGET (menu), &menu_width, NULL);
1781 gtk_widget_get_preferred_width (GTK_WIDGET (menu), NULL, &menu_width);
1785 gtk_widget_get_allocation (active, &child_allocation);
1786 menu_ypos -= child_allocation.height / 2;
1789 children = GTK_MENU_SHELL (combo_box->priv->popup_widget)->priv->children;
1792 child = children->data;
1794 if (active == child)
1797 if (gtk_widget_get_visible (child))
1799 gtk_widget_get_allocation (child, &child_allocation);
1801 menu_ypos -= child_allocation.height;
1804 children = children->next;
1807 if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
1808 menu_xpos = menu_xpos + allocation.width - menu_width;
1810 gdk_window_get_root_coords (gtk_widget_get_window (widget),
1811 menu_xpos, menu_ypos,
1812 &menu_xpos, &menu_ypos);
1814 /* Clamp the position on screen */
1815 screen_width = gdk_screen_get_width (gtk_widget_get_screen (widget));
1819 else if ((menu_xpos + menu_width) > screen_width)
1820 menu_xpos -= ((menu_xpos + menu_width) - screen_width);
1829 gtk_combo_box_menu_position (GtkMenu *menu,
1835 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
1836 GtkComboBoxPrivate *priv = combo_box->priv;
1837 GtkWidget *menu_item;
1839 if (priv->wrap_width > 0 || priv->cell_view == NULL)
1840 gtk_combo_box_menu_position_below (menu, x, y, push_in, user_data);
1843 /* FIXME handle nested menus better */
1844 menu_item = gtk_menu_get_active (GTK_MENU (priv->popup_widget));
1846 gtk_menu_shell_select_item (GTK_MENU_SHELL (priv->popup_widget),
1849 gtk_combo_box_menu_position_over (menu, x, y, push_in, user_data);
1852 if (!gtk_widget_get_visible (GTK_MENU (priv->popup_widget)->priv->toplevel))
1853 gtk_window_set_type_hint (GTK_WINDOW (GTK_MENU (priv->popup_widget)->priv->toplevel),
1854 GDK_WINDOW_TYPE_HINT_COMBO);
1858 gtk_combo_box_list_position (GtkComboBox *combo_box,
1864 GtkComboBoxPrivate *priv = combo_box->priv;
1865 GtkAllocation allocation;
1868 GdkRectangle monitor;
1869 GtkRequisition popup_req;
1870 GtkPolicyType hpolicy, vpolicy;
1873 /* under windows, the drop down list is as wide as the combo box itself.
1875 GtkWidget *widget = GTK_WIDGET (combo_box);
1879 gtk_widget_get_allocation (widget, &allocation);
1881 if (!gtk_widget_get_has_window (widget))
1887 window = gtk_widget_get_window (widget);
1889 gdk_window_get_root_coords (gtk_widget_get_window (widget),
1892 *width = allocation.width;
1894 hpolicy = vpolicy = GTK_POLICY_NEVER;
1895 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1898 if (combo_box->priv->popup_fixed_width)
1900 gtk_widget_get_preferred_size (priv->scrolled_window, &popup_req, NULL);
1902 if (popup_req.width > *width)
1904 hpolicy = GTK_POLICY_ALWAYS;
1905 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1911 /* XXX This code depends on treeviews properly reporting their natural width
1912 * list-mode menus won't fill up to their natural width until then */
1913 gtk_widget_get_preferred_size (priv->scrolled_window, NULL, &popup_req);
1915 if (popup_req.width > *width)
1917 hpolicy = GTK_POLICY_NEVER;
1918 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1921 *width = popup_req.width;
1925 *height = popup_req.height;
1927 screen = gtk_widget_get_screen (GTK_WIDGET (combo_box));
1928 monitor_num = gdk_screen_get_monitor_at_window (screen, window);
1929 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
1931 if (gtk_widget_get_direction (GTK_WIDGET (combo_box)) == GTK_TEXT_DIR_RTL)
1932 *x = *x + allocation.width - *width;
1936 else if (*x + *width > monitor.x + monitor.width)
1937 *x = monitor.x + monitor.width - *width;
1939 if (*y + allocation.height + *height <= monitor.y + monitor.height)
1940 *y += allocation.height;
1941 else if (*y - *height >= monitor.y)
1943 else if (monitor.y + monitor.height - (*y + allocation.height) > *y - monitor.y)
1945 *y += allocation.height;
1946 *height = monitor.y + monitor.height - *y;
1950 *height = *y - monitor.y;
1954 if (popup_req.height > *height)
1956 vpolicy = GTK_POLICY_ALWAYS;
1958 gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (priv->scrolled_window),
1964 cell_view_is_sensitive (GtkCellView *cell_view)
1966 GList *cells, *list;
1969 cells = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (cell_view));
1972 for (list = cells; list; list = list->next)
1974 g_object_get (list->data, "sensitive", &sensitive, NULL);
1979 g_list_free (cells);
1985 tree_column_row_is_sensitive (GtkComboBox *combo_box,
1988 GtkComboBoxPrivate *priv = combo_box->priv;
1989 GList *cells, *list;
1995 if (priv->row_separator_func)
1997 if (priv->row_separator_func (priv->model, iter,
1998 priv->row_separator_data))
2002 gtk_tree_view_column_cell_set_cell_data (priv->column,
2004 iter, FALSE, FALSE);
2006 cells = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (priv->column));
2009 for (list = cells; list; list = list->next)
2011 g_object_get (list->data, "sensitive", &sensitive, NULL);
2016 g_list_free (cells);
2022 update_menu_sensitivity (GtkComboBox *combo_box,
2025 GtkComboBoxPrivate *priv = combo_box->priv;
2026 GList *children, *child;
2027 GtkWidget *item, *submenu, *separator;
2028 GtkWidget *cell_view;
2034 children = gtk_container_get_children (GTK_CONTAINER (menu));
2036 for (child = children; child; child = child->next)
2038 item = GTK_WIDGET (child->data);
2039 cell_view = gtk_bin_get_child (GTK_BIN (item));
2041 if (!GTK_IS_CELL_VIEW (cell_view))
2044 submenu = gtk_menu_item_get_submenu (GTK_MENU_ITEM (item));
2045 if (submenu != NULL)
2047 gtk_widget_set_sensitive (item, TRUE);
2048 update_menu_sensitivity (combo_box, submenu);
2052 sensitive = cell_view_is_sensitive (GTK_CELL_VIEW (cell_view));
2054 if (menu != priv->popup_widget && child == children)
2056 separator = GTK_WIDGET (child->next->data);
2057 g_object_set (item, "visible", sensitive, NULL);
2058 g_object_set (separator, "visible", sensitive, NULL);
2061 gtk_widget_set_sensitive (item, sensitive);
2065 g_list_free (children);
2069 gtk_combo_box_menu_popup (GtkComboBox *combo_box,
2071 guint32 activate_time)
2073 GtkComboBoxPrivate *priv = combo_box->priv;
2076 gint width, min_width, nat_width;
2078 update_menu_sensitivity (combo_box, priv->popup_widget);
2081 if (gtk_tree_row_reference_valid (priv->active_row))
2083 path = gtk_tree_row_reference_get_path (priv->active_row);
2084 active_item = gtk_tree_path_get_indices (path)[0];
2085 gtk_tree_path_free (path);
2087 if (priv->add_tearoffs)
2091 /* FIXME handle nested menus better */
2092 gtk_menu_set_active (GTK_MENU (priv->popup_widget), active_item);
2094 if (priv->wrap_width == 0)
2096 GtkAllocation allocation;
2098 gtk_widget_get_allocation (GTK_WIDGET (combo_box), &allocation);
2099 width = allocation.width;
2100 gtk_widget_set_size_request (priv->popup_widget, -1, -1);
2101 gtk_widget_get_preferred_width (priv->popup_widget, &min_width, &nat_width);
2103 if (combo_box->priv->popup_fixed_width)
2104 width = MAX (width, min_width);
2106 width = MAX (width, nat_width);
2108 gtk_widget_set_size_request (priv->popup_widget, width, -1);
2111 gtk_menu_popup (GTK_MENU (priv->popup_widget),
2113 gtk_combo_box_menu_position, combo_box,
2114 button, activate_time);
2118 popup_grab_on_window (GdkWindow *window,
2119 GdkDevice *keyboard,
2121 guint32 activate_time)
2124 gdk_device_grab (keyboard, window,
2125 GDK_OWNERSHIP_WINDOW, TRUE,
2126 GDK_KEY_PRESS_MASK | GDK_KEY_RELEASE_MASK,
2127 NULL, activate_time) != GDK_GRAB_SUCCESS)
2131 gdk_device_grab (pointer, window,
2132 GDK_OWNERSHIP_WINDOW, TRUE,
2133 GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK |
2134 GDK_POINTER_MOTION_MASK,
2135 NULL, activate_time) != GDK_GRAB_SUCCESS)
2138 gdk_device_ungrab (keyboard, activate_time);
2147 * gtk_combo_box_popup:
2148 * @combo_box: a #GtkComboBox
2150 * Pops up the menu or dropdown list of @combo_box.
2152 * This function is mostly intended for use by accessibility technologies;
2153 * applications should have little use for it.
2158 gtk_combo_box_popup (GtkComboBox *combo_box)
2160 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
2162 g_signal_emit (combo_box, combo_box_signals[POPUP], 0);
2166 * gtk_combo_box_popup_for_device:
2167 * @combo_box: a #GtkComboBox
2168 * @device: a #GdkDevice
2170 * Pops up the menu or dropdown list of @combo_box, the popup window
2171 * will be grabbed so only @device and its associated pointer/keyboard
2172 * are the only #GdkDevice<!-- -->s able to send events to it.
2177 gtk_combo_box_popup_for_device (GtkComboBox *combo_box,
2180 GtkComboBoxPrivate *priv = combo_box->priv;
2181 gint x, y, width, height;
2182 GtkTreePath *path = NULL, *ppath;
2183 GtkWidget *toplevel;
2184 GdkDevice *keyboard, *pointer;
2187 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
2188 g_return_if_fail (GDK_IS_DEVICE (device));
2190 if (!gtk_widget_get_realized (GTK_WIDGET (combo_box)))
2193 if (gtk_widget_get_mapped (priv->popup_widget))
2196 if (priv->grab_pointer && priv->grab_keyboard)
2199 time = gtk_get_current_event_time ();
2201 if (gdk_device_get_source (device) == GDK_SOURCE_KEYBOARD)
2204 pointer = gdk_device_get_associated_device (device);
2209 keyboard = gdk_device_get_associated_device (device);
2212 if (GTK_IS_MENU (priv->popup_widget))
2214 gtk_combo_box_menu_popup (combo_box,
2215 priv->activate_button,
2216 priv->activate_time);
2220 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (combo_box));
2221 if (GTK_IS_WINDOW (toplevel))
2222 gtk_window_group_add_window (gtk_window_get_group (GTK_WINDOW (toplevel)),
2223 GTK_WINDOW (priv->popup_window));
2225 gtk_widget_show_all (priv->scrolled_window);
2226 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
2228 gtk_widget_set_size_request (priv->popup_window, width, height);
2229 gtk_window_move (GTK_WINDOW (priv->popup_window), x, y);
2231 if (gtk_tree_row_reference_valid (priv->active_row))
2233 path = gtk_tree_row_reference_get_path (priv->active_row);
2234 ppath = gtk_tree_path_copy (path);
2235 if (gtk_tree_path_up (ppath))
2236 gtk_tree_view_expand_to_path (GTK_TREE_VIEW (priv->tree_view),
2238 gtk_tree_path_free (ppath);
2240 gtk_tree_view_set_hover_expand (GTK_TREE_VIEW (priv->tree_view),
2244 gtk_widget_show (priv->popup_window);
2248 gtk_tree_view_set_cursor (GTK_TREE_VIEW (priv->tree_view),
2250 gtk_tree_path_free (path);
2253 gtk_widget_grab_focus (priv->popup_window);
2254 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button),
2257 if (!gtk_widget_has_focus (priv->tree_view))
2258 gtk_widget_grab_focus (priv->tree_view);
2260 if (!popup_grab_on_window (gtk_widget_get_window (priv->popup_window),
2261 keyboard, pointer, time))
2263 gtk_widget_hide (priv->popup_window);
2267 gtk_device_grab_add (priv->popup_window, pointer, TRUE);
2268 priv->grab_pointer = pointer;
2269 priv->grab_keyboard = keyboard;
2273 gtk_combo_box_real_popup (GtkComboBox *combo_box)
2277 device = gtk_get_current_event_device ();
2281 GdkDeviceManager *device_manager;
2282 GdkDisplay *display;
2285 display = gtk_widget_get_display (GTK_WIDGET (combo_box));
2286 device_manager = gdk_display_get_device_manager (display);
2288 /* No device was set, pick the first master device */
2289 devices = gdk_device_manager_list_devices (device_manager, GDK_DEVICE_TYPE_MASTER);
2290 device = devices->data;
2291 g_list_free (devices);
2294 gtk_combo_box_popup_for_device (combo_box, device);
2298 gtk_combo_box_real_popdown (GtkComboBox *combo_box)
2300 if (combo_box->priv->popup_shown)
2302 gtk_combo_box_popdown (combo_box);
2310 * gtk_combo_box_popdown:
2311 * @combo_box: a #GtkComboBox
2313 * Hides the menu or dropdown list of @combo_box.
2315 * This function is mostly intended for use by accessibility technologies;
2316 * applications should have little use for it.
2321 gtk_combo_box_popdown (GtkComboBox *combo_box)
2323 GtkComboBoxPrivate *priv = combo_box->priv;
2325 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
2327 if (GTK_IS_MENU (priv->popup_widget))
2329 gtk_menu_popdown (GTK_MENU (priv->popup_widget));
2333 if (!gtk_widget_get_realized (GTK_WIDGET (combo_box)))
2336 gtk_device_grab_remove (priv->popup_window, priv->grab_pointer);
2337 gtk_widget_hide (priv->popup_window);
2338 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button),
2341 priv->grab_pointer = NULL;
2342 priv->grab_keyboard = NULL;
2345 #define GTK_COMBO_BOX_SIZE_ALLOCATE_BUTTON \
2346 gtk_widget_get_preferred_size (combo_box->priv->button, \
2350 child.x = allocation->x + border.right; \
2352 child.x = allocation->x + allocation->width - req.width - border.left; \
2354 child.y = allocation->y + border.top; \
2355 child.width = req.width; \
2356 child.height = allocation->height - (border.top + border.bottom); \
2357 child.width = MAX (1, child.width); \
2358 child.height = MAX (1, child.height); \
2360 gtk_widget_size_allocate (combo_box->priv->button, &child);
2364 gtk_combo_box_size_allocate (GtkWidget *widget,
2365 GtkAllocation *allocation)
2367 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2368 GtkComboBoxPrivate *priv = combo_box->priv;
2369 GtkWidget *child_widget;
2370 gint focus_width, focus_pad;
2371 GtkAllocation child;
2373 gboolean is_rtl = gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL;
2376 gtk_widget_set_allocation (widget, allocation);
2377 child_widget = gtk_bin_get_child (GTK_BIN (widget));
2378 get_widget_border (widget, &border);
2380 gtk_widget_style_get (widget,
2381 "focus-line-width", &focus_width,
2382 "focus-padding", &focus_pad,
2385 if (!priv->tree_view)
2387 if (priv->cell_view)
2389 GtkBorder button_border;
2394 allocation->x += border.left;
2395 allocation->y += border.top;
2396 allocation->width -= border.left + border.right;
2397 allocation->height -= border.top + border.bottom;
2399 gtk_widget_size_allocate (priv->button, allocation);
2401 /* set some things ready */
2402 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->button));
2403 get_widget_border (priv->button, &button_border);
2405 child.x = allocation->x;
2406 child.y = allocation->y;
2407 width = allocation->width;
2408 child.height = allocation->height;
2410 if (!priv->is_cell_renderer)
2412 child.x += border_width + button_border.left + focus_width + focus_pad;
2413 child.y += border_width + button_border.top + focus_width + focus_pad;
2414 width -= (2 * (border_width + focus_width + focus_pad)) +
2415 button_border.left + button_border.right;
2416 child.height -= (2 * (border_width + focus_width + focus_pad)) +
2417 button_border.top + button_border.bottom;
2420 /* handle the children */
2421 gtk_widget_get_preferred_size (priv->arrow, &req, NULL);
2422 child.width = req.width;
2424 child.x += width - req.width;
2425 child.width = MAX (1, child.width);
2426 child.height = MAX (1, child.height);
2427 gtk_widget_size_allocate (priv->arrow, &child);
2429 child.x += req.width;
2430 gtk_widget_get_preferred_size (priv->separator, &req, NULL);
2431 child.width = req.width;
2433 child.x -= req.width;
2434 child.width = MAX (1, child.width);
2435 child.height = MAX (1, child.height);
2436 gtk_widget_size_allocate (priv->separator, &child);
2440 child.x += req.width;
2441 child.width = allocation->x + allocation->width
2442 - (border_width + button_border.right + focus_width + focus_pad)
2447 child.width = child.x;
2448 child.x = allocation->x
2449 + border_width + button_border.left + focus_width + focus_pad;
2450 child.width -= child.x;
2453 if (gtk_widget_get_visible (priv->popup_widget))
2455 gint width, menu_width;
2457 if (priv->wrap_width == 0)
2459 GtkAllocation combo_box_allocation;
2461 gtk_widget_get_allocation (GTK_WIDGET (combo_box), &combo_box_allocation);
2462 width = combo_box_allocation.width;
2463 gtk_widget_set_size_request (priv->popup_widget, -1, -1);
2465 if (combo_box->priv->popup_fixed_width)
2466 gtk_widget_get_preferred_width (priv->popup_widget, &menu_width, NULL);
2468 gtk_widget_get_preferred_width (priv->popup_widget, NULL, &menu_width);
2470 gtk_widget_set_size_request (priv->popup_widget,
2471 MAX (width, menu_width), -1);
2474 /* reposition the menu after giving it a new width */
2475 gtk_menu_reposition (GTK_MENU (priv->popup_widget));
2478 child.width = MAX (1, child.width);
2479 child.height = MAX (1, child.height);
2480 gtk_widget_size_allocate (child_widget, &child);
2484 GTK_COMBO_BOX_SIZE_ALLOCATE_BUTTON
2487 child.x = allocation->x + req.width + border.right;
2489 child.x = allocation->x + border.left;
2490 child.y = allocation->y + border.top;
2491 child.width = allocation->width - req.width - (border.left + border.right);
2492 child.width = MAX (1, child.width);
2493 child.height = MAX (1, child.height);
2494 gtk_widget_size_allocate (child_widget, &child);
2500 guint border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
2503 GTK_COMBO_BOX_SIZE_ALLOCATE_BUTTON
2507 child.x = allocation->x + req.width;
2509 child.x = allocation->x;
2511 child.y = allocation->y;
2512 child.width = allocation->width - req.width;
2513 child.height = allocation->height;
2515 if (priv->cell_view_frame)
2517 child.x += border.left + border_width;
2518 child.y += border.top + border_width;
2519 child.width = MAX (1, child.width - (2 * border_width) - (border.left + border.right));
2520 child.height = MAX (1, child.height - (2 * border_width) - (border.top + border.bottom));
2521 gtk_widget_size_allocate (priv->cell_view_frame, &child);
2524 if (priv->has_frame)
2526 GtkBorder frame_border;
2528 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->cell_view_frame));
2529 get_widget_border (priv->cell_view_frame, &frame_border);
2531 child.x += border_width + frame_border.left;
2532 child.y += border_width + frame_border.right;
2533 child.width -= (2 * border_width) + frame_border.left + frame_border.right;
2534 child.height -= (2 * border_width) + frame_border.top + frame_border.bottom;
2539 child.x += border.left + border_width;
2540 child.y += border.top + border_width;
2541 child.width -= (2 * border_width) - (border.left + border.right);
2542 child.height -= (2 * border_width) - (border.top + border.bottom);
2545 if (gtk_widget_get_visible (priv->popup_window))
2547 gint x, y, width, height;
2548 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
2549 gtk_window_move (GTK_WINDOW (priv->popup_window), x, y);
2550 gtk_widget_set_size_request (priv->popup_window, width, height);
2553 child.width = MAX (1, child.width);
2554 child.height = MAX (1, child.height);
2555 gtk_widget_size_allocate (child_widget, &child);
2559 #undef GTK_COMBO_BOX_ALLOCATE_BUTTON
2562 gtk_combo_box_unset_model (GtkComboBox *combo_box)
2564 GtkComboBoxPrivate *priv = combo_box->priv;
2568 g_signal_handler_disconnect (priv->model,
2570 g_signal_handler_disconnect (priv->model,
2572 g_signal_handler_disconnect (priv->model,
2573 priv->reordered_id);
2574 g_signal_handler_disconnect (priv->model,
2580 g_object_unref (priv->model);
2584 if (priv->active_row)
2586 gtk_tree_row_reference_free (priv->active_row);
2587 priv->active_row = NULL;
2590 if (priv->cell_view)
2591 gtk_cell_view_set_model (GTK_CELL_VIEW (priv->cell_view), NULL);
2595 gtk_combo_box_forall (GtkContainer *container,
2596 gboolean include_internals,
2597 GtkCallback callback,
2598 gpointer callback_data)
2600 GtkComboBox *combo_box = GTK_COMBO_BOX (container);
2601 GtkComboBoxPrivate *priv = combo_box->priv;
2604 if (include_internals)
2607 (* callback) (priv->button, callback_data);
2608 if (priv->cell_view_frame)
2609 (* callback) (priv->cell_view_frame, callback_data);
2612 child = gtk_bin_get_child (GTK_BIN (container));
2614 (* callback) (child, callback_data);
2618 gtk_combo_box_child_show (GtkWidget *widget,
2619 GtkComboBox *combo_box)
2621 GtkComboBoxPrivate *priv = combo_box->priv;
2623 priv->popup_shown = TRUE;
2624 g_object_notify (G_OBJECT (combo_box), "popup-shown");
2628 gtk_combo_box_child_hide (GtkWidget *widget,
2629 GtkComboBox *combo_box)
2631 GtkComboBoxPrivate *priv = combo_box->priv;
2633 priv->popup_shown = FALSE;
2634 g_object_notify (G_OBJECT (combo_box), "popup-shown");
2638 gtk_combo_box_draw (GtkWidget *widget,
2641 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2642 GtkComboBoxPrivate *priv = combo_box->priv;
2644 if (priv->shadow_type != GTK_SHADOW_NONE)
2646 GtkStyleContext *context;
2647 GtkStateFlags state;
2649 context = gtk_widget_get_style_context (widget);
2650 state = gtk_widget_get_state_flags (widget);
2651 gtk_style_context_set_state (context, state);
2653 gtk_render_background (context, cr, 0, 0,
2654 gtk_widget_get_allocated_width (widget),
2655 gtk_widget_get_allocated_height (widget));
2656 gtk_render_frame (context, cr, 0, 0,
2657 gtk_widget_get_allocated_width (widget),
2658 gtk_widget_get_allocated_height (widget));
2661 gtk_container_propagate_draw (GTK_CONTAINER (widget),
2664 if (priv->tree_view && priv->cell_view_frame)
2666 gtk_container_propagate_draw (GTK_CONTAINER (widget),
2667 priv->cell_view_frame, cr);
2670 gtk_container_propagate_draw (GTK_CONTAINER (widget),
2671 gtk_bin_get_child (GTK_BIN (widget)),
2687 path_visible (GtkTreeView *view,
2693 /* Note that we rely on the fact that collapsed rows don't have nodes
2695 return _gtk_tree_view_find_node (view, path, &tree, &node);
2699 tree_next_func (GtkTreeModel *model,
2704 SearchData *search_data = (SearchData *)data;
2706 if (search_data->found)
2708 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2711 if (search_data->visible &&
2712 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2715 search_data->set = TRUE;
2716 search_data->iter = *iter;
2721 if (gtk_tree_path_compare (path, search_data->path) == 0)
2722 search_data->found = TRUE;
2728 tree_next (GtkComboBox *combo,
2729 GtkTreeModel *model,
2734 SearchData search_data;
2736 search_data.combo = combo;
2737 search_data.path = gtk_tree_model_get_path (model, iter);
2738 search_data.visible = visible;
2739 search_data.found = FALSE;
2740 search_data.set = FALSE;
2742 gtk_tree_model_foreach (model, tree_next_func, &search_data);
2744 *next = search_data.iter;
2746 gtk_tree_path_free (search_data.path);
2748 return search_data.set;
2752 tree_prev_func (GtkTreeModel *model,
2757 SearchData *search_data = (SearchData *)data;
2759 if (gtk_tree_path_compare (path, search_data->path) == 0)
2761 search_data->found = TRUE;
2765 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2768 if (search_data->visible &&
2769 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2772 search_data->set = TRUE;
2773 search_data->iter = *iter;
2779 tree_prev (GtkComboBox *combo,
2780 GtkTreeModel *model,
2785 SearchData search_data;
2787 search_data.combo = combo;
2788 search_data.path = gtk_tree_model_get_path (model, iter);
2789 search_data.visible = visible;
2790 search_data.found = FALSE;
2791 search_data.set = FALSE;
2793 gtk_tree_model_foreach (model, tree_prev_func, &search_data);
2795 *prev = search_data.iter;
2797 gtk_tree_path_free (search_data.path);
2799 return search_data.set;
2803 tree_last_func (GtkTreeModel *model,
2808 SearchData *search_data = (SearchData *)data;
2810 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2813 /* Note that we rely on the fact that collapsed rows don't have nodes
2815 if (search_data->visible &&
2816 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2819 search_data->set = TRUE;
2820 search_data->iter = *iter;
2826 tree_last (GtkComboBox *combo,
2827 GtkTreeModel *model,
2831 SearchData search_data;
2833 search_data.combo = combo;
2834 search_data.visible = visible;
2835 search_data.set = FALSE;
2837 gtk_tree_model_foreach (model, tree_last_func, &search_data);
2839 *last = search_data.iter;
2841 return search_data.set;
2846 tree_first_func (GtkTreeModel *model,
2851 SearchData *search_data = (SearchData *)data;
2853 if (!tree_column_row_is_sensitive (search_data->combo, iter))
2856 if (search_data->visible &&
2857 !path_visible (GTK_TREE_VIEW (search_data->combo->priv->tree_view), path))
2860 search_data->set = TRUE;
2861 search_data->iter = *iter;
2867 tree_first (GtkComboBox *combo,
2868 GtkTreeModel *model,
2872 SearchData search_data;
2874 search_data.combo = combo;
2875 search_data.visible = visible;
2876 search_data.set = FALSE;
2878 gtk_tree_model_foreach (model, tree_first_func, &search_data);
2880 *first = search_data.iter;
2882 return search_data.set;
2886 gtk_combo_box_scroll_event (GtkWidget *widget,
2887 GdkEventScroll *event)
2889 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
2892 GtkTreeIter new_iter;
2894 if (!gtk_combo_box_get_active_iter (combo_box, &iter))
2897 if (event->direction == GDK_SCROLL_UP)
2898 found = tree_prev (combo_box, combo_box->priv->model,
2899 &iter, &new_iter, FALSE);
2901 found = tree_next (combo_box, combo_box->priv->model,
2902 &iter, &new_iter, FALSE);
2905 gtk_combo_box_set_active_iter (combo_box, &new_iter);
2914 gtk_combo_box_row_separator_func (GtkTreeModel *model,
2918 GtkComboBoxPrivate *priv = combo->priv;
2920 if (priv->row_separator_func)
2921 return priv->row_separator_func (model, iter, priv->row_separator_data);
2927 gtk_combo_box_header_func (GtkTreeModel *model,
2931 /* Every submenu has a selectable header, however we
2932 * can expose a method to make that configurable by
2933 * the user (like row_separator_func is done) */
2938 gtk_combo_box_menu_setup (GtkComboBox *combo_box,
2939 gboolean add_children)
2941 GtkComboBoxPrivate *priv = combo_box->priv;
2945 child = gtk_bin_get_child (GTK_BIN (combo_box));
2947 if (priv->cell_view)
2949 priv->button = gtk_toggle_button_new ();
2950 gtk_button_set_focus_on_click (GTK_BUTTON (priv->button),
2951 priv->focus_on_click);
2953 g_signal_connect (priv->button, "toggled",
2954 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
2955 gtk_widget_set_parent (priv->button,
2956 gtk_widget_get_parent (child));
2958 priv->box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0);
2959 gtk_container_add (GTK_CONTAINER (priv->button), priv->box);
2961 priv->separator = gtk_separator_new (GTK_ORIENTATION_VERTICAL);
2962 gtk_container_add (GTK_CONTAINER (priv->box), priv->separator);
2964 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
2965 gtk_container_add (GTK_CONTAINER (priv->box), priv->arrow);
2967 gtk_widget_show_all (priv->button);
2971 priv->button = gtk_toggle_button_new ();
2972 gtk_button_set_focus_on_click (GTK_BUTTON (priv->button),
2973 priv->focus_on_click);
2975 g_signal_connect (priv->button, "toggled",
2976 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
2977 gtk_widget_set_parent (priv->button,
2978 gtk_widget_get_parent (child));
2980 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
2981 gtk_container_add (GTK_CONTAINER (priv->button), priv->arrow);
2982 gtk_widget_show_all (priv->button);
2985 g_signal_connect (priv->button, "button-press-event",
2986 G_CALLBACK (gtk_combo_box_menu_button_press),
2988 g_signal_connect (priv->button, "state-flags-changed",
2989 G_CALLBACK (gtk_combo_box_button_state_flags_changed),
2992 /* create our funky menu */
2993 menu = _gtk_tree_menu_new_with_area (priv->area);
2994 gtk_widget_set_name (menu, "gtk-combobox-popup-menu");
2996 _gtk_tree_menu_set_model (GTK_TREE_MENU (menu), priv->model);
2998 _gtk_tree_menu_set_wrap_width (GTK_TREE_MENU (menu), priv->wrap_width);
2999 _gtk_tree_menu_set_row_span_column (GTK_TREE_MENU (menu), priv->row_column);
3000 _gtk_tree_menu_set_column_span_column (GTK_TREE_MENU (menu), priv->col_column);
3001 _gtk_tree_menu_set_tearoff (GTK_TREE_MENU (menu),
3002 combo_box->priv->add_tearoffs);
3004 g_signal_connect (menu, "menu-activate",
3005 G_CALLBACK (gtk_combo_box_menu_activate), combo_box);
3007 /* Chain our row_separator_func through */
3008 _gtk_tree_menu_set_row_separator_func (GTK_TREE_MENU (menu),
3009 (GtkTreeViewRowSeparatorFunc)gtk_combo_box_row_separator_func,
3012 _gtk_tree_menu_set_header_func (GTK_TREE_MENU (menu),
3013 (GtkTreeMenuHeaderFunc)gtk_combo_box_header_func,
3016 gtk_widget_set_name (menu, "gtk-combobox-popup-menu");
3018 g_signal_connect (menu, "key-press-event",
3019 G_CALLBACK (gtk_combo_box_menu_key_press), combo_box);
3020 gtk_combo_box_set_popup_widget (combo_box, menu);
3022 gtk_combo_box_update_title (combo_box);
3026 gtk_combo_box_menu_destroy (GtkComboBox *combo_box)
3028 GtkComboBoxPrivate *priv = combo_box->priv;
3030 g_signal_handlers_disconnect_matched (priv->button,
3031 G_SIGNAL_MATCH_DATA,
3033 gtk_combo_box_menu_button_press, NULL);
3034 g_signal_handlers_disconnect_matched (priv->button,
3035 G_SIGNAL_MATCH_DATA,
3037 gtk_combo_box_button_state_flags_changed, combo_box);
3038 g_signal_handlers_disconnect_matched (priv->popup_widget,
3039 G_SIGNAL_MATCH_DATA,
3041 gtk_combo_box_menu_activate, combo_box);
3043 /* unparent will remove our latest ref */
3044 gtk_widget_unparent (priv->button);
3047 priv->button = NULL;
3049 priv->separator = NULL;
3051 priv->column = NULL;
3053 /* changing the popup window will unref the menu and the children */
3058 gtk_combo_box_menu_button_press (GtkWidget *widget,
3059 GdkEventButton *event,
3062 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3063 GtkComboBoxPrivate *priv = combo_box->priv;
3065 if (GTK_IS_MENU (priv->popup_widget) &&
3066 event->type == GDK_BUTTON_PRESS && event->button == 1)
3068 if (priv->focus_on_click &&
3069 !gtk_widget_has_focus (priv->button))
3070 gtk_widget_grab_focus (priv->button);
3072 gtk_combo_box_menu_popup (combo_box, event->button, event->time);
3081 gtk_combo_box_menu_activate (GtkWidget *menu,
3083 GtkComboBox *combo_box)
3087 if (gtk_tree_model_get_iter_from_string (combo_box->priv->model, &iter, path))
3088 gtk_combo_box_set_active_iter (combo_box, &iter);
3090 g_object_set (combo_box,
3091 "editing-canceled", FALSE,
3097 gtk_combo_box_update_sensitivity (GtkComboBox *combo_box)
3100 gboolean sensitive = TRUE; /* fool code checkers */
3102 if (!combo_box->priv->button)
3105 switch (combo_box->priv->button_sensitivity)
3107 case GTK_SENSITIVITY_ON:
3110 case GTK_SENSITIVITY_OFF:
3113 case GTK_SENSITIVITY_AUTO:
3114 sensitive = combo_box->priv->model &&
3115 gtk_tree_model_get_iter_first (combo_box->priv->model, &iter);
3118 g_assert_not_reached ();
3122 gtk_widget_set_sensitive (combo_box->priv->button, sensitive);
3124 /* In list-mode, we also need to update sensitivity of the event box */
3125 if (GTK_IS_TREE_VIEW (combo_box->priv->tree_view)
3126 && combo_box->priv->cell_view)
3127 gtk_widget_set_sensitive (combo_box->priv->box, sensitive);
3131 gtk_combo_box_model_row_inserted (GtkTreeModel *model,
3136 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3138 if (combo_box->priv->tree_view)
3139 gtk_combo_box_list_popup_resize (combo_box);
3141 gtk_combo_box_update_sensitivity (combo_box);
3145 gtk_combo_box_model_row_deleted (GtkTreeModel *model,
3149 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3150 GtkComboBoxPrivate *priv = combo_box->priv;
3152 if (!gtk_tree_row_reference_valid (priv->active_row))
3154 if (priv->cell_view)
3155 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (priv->cell_view), NULL);
3156 g_signal_emit (combo_box, combo_box_signals[CHANGED], 0);
3159 if (priv->tree_view)
3160 gtk_combo_box_list_popup_resize (combo_box);
3162 gtk_combo_box_update_sensitivity (combo_box);
3166 gtk_combo_box_model_rows_reordered (GtkTreeModel *model,
3172 gtk_tree_row_reference_reordered (G_OBJECT (user_data), path, iter, new_order);
3176 gtk_combo_box_model_row_changed (GtkTreeModel *model,
3181 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3182 GtkComboBoxPrivate *priv = combo_box->priv;
3183 GtkTreePath *active_path;
3185 /* FIXME this belongs to GtkCellView */
3186 if (gtk_tree_row_reference_valid (priv->active_row))
3188 active_path = gtk_tree_row_reference_get_path (priv->active_row);
3189 if (gtk_tree_path_compare (path, active_path) == 0 &&
3191 gtk_widget_queue_resize (GTK_WIDGET (priv->cell_view));
3192 gtk_tree_path_free (active_path);
3195 if (priv->tree_view)
3196 gtk_combo_box_list_row_changed (model, path, iter, user_data);
3200 list_popup_resize_idle (gpointer user_data)
3202 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3203 GtkComboBoxPrivate *priv = combo_box->priv;
3204 gint x, y, width, height;
3206 if (priv->tree_view && gtk_widget_get_mapped (priv->popup_window))
3208 gtk_combo_box_list_position (combo_box, &x, &y, &width, &height);
3210 gtk_widget_set_size_request (priv->popup_window, width, height);
3211 gtk_window_move (GTK_WINDOW (priv->popup_window), x, y);
3214 priv->resize_idle_id = 0;
3220 gtk_combo_box_list_popup_resize (GtkComboBox *combo_box)
3222 GtkComboBoxPrivate *priv = combo_box->priv;
3224 if (!priv->resize_idle_id)
3225 priv->resize_idle_id =
3226 gdk_threads_add_idle (list_popup_resize_idle, combo_box);
3230 gtk_combo_box_model_row_expanded (GtkTreeModel *model,
3235 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
3237 gtk_combo_box_list_popup_resize (combo_box);
3246 gtk_combo_box_list_setup (GtkComboBox *combo_box)
3248 GtkComboBoxPrivate *priv = combo_box->priv;
3249 GtkTreeSelection *sel;
3251 GtkWidget *widget = GTK_WIDGET (combo_box);
3253 priv->button = gtk_toggle_button_new ();
3254 child = gtk_bin_get_child (GTK_BIN (combo_box));
3255 gtk_widget_set_parent (priv->button,
3256 gtk_widget_get_parent (child));
3257 g_signal_connect (priv->button, "button-press-event",
3258 G_CALLBACK (gtk_combo_box_list_button_pressed), combo_box);
3259 g_signal_connect (priv->button, "toggled",
3260 G_CALLBACK (gtk_combo_box_button_toggled), combo_box);
3262 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
3263 gtk_container_add (GTK_CONTAINER (priv->button), priv->arrow);
3264 priv->separator = NULL;
3265 gtk_widget_show_all (priv->button);
3267 if (priv->cell_view)
3269 GtkStyleContext *context;
3270 GtkStateFlags state;
3273 context = gtk_widget_get_style_context (widget);
3274 state = gtk_widget_get_state_flags (widget);
3276 gtk_style_context_get (context, state,
3277 "background-color", &color,
3280 gtk_cell_view_set_background_rgba (GTK_CELL_VIEW (priv->cell_view), color);
3281 gdk_rgba_free (color);
3283 priv->box = gtk_event_box_new ();
3284 gtk_event_box_set_visible_window (GTK_EVENT_BOX (priv->box),
3287 if (priv->has_frame)
3289 priv->cell_view_frame = gtk_frame_new (NULL);
3290 gtk_frame_set_shadow_type (GTK_FRAME (priv->cell_view_frame),
3295 combo_box->priv->cell_view_frame = gtk_event_box_new ();
3296 gtk_event_box_set_visible_window (GTK_EVENT_BOX (combo_box->priv->cell_view_frame),
3300 gtk_widget_set_parent (priv->cell_view_frame,
3301 gtk_widget_get_parent (child));
3302 gtk_container_add (GTK_CONTAINER (priv->cell_view_frame), priv->box);
3303 gtk_widget_show_all (priv->cell_view_frame);
3305 g_signal_connect (priv->box, "button-press-event",
3306 G_CALLBACK (gtk_combo_box_list_button_pressed),
3310 priv->tree_view = gtk_tree_view_new ();
3311 sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (priv->tree_view));
3312 gtk_tree_selection_set_mode (sel, GTK_SELECTION_BROWSE);
3313 gtk_tree_selection_set_select_function (sel,
3314 gtk_combo_box_list_select_func,
3316 gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (priv->tree_view),
3318 gtk_tree_view_set_hover_selection (GTK_TREE_VIEW (priv->tree_view),
3321 gtk_tree_view_set_row_separator_func (GTK_TREE_VIEW (priv->tree_view),
3322 (GtkTreeViewRowSeparatorFunc)gtk_combo_box_row_separator_func,
3326 gtk_tree_view_set_model (GTK_TREE_VIEW (priv->tree_view), priv->model);
3328 priv->column = gtk_tree_view_column_new_with_area (priv->area);
3329 gtk_tree_view_append_column (GTK_TREE_VIEW (priv->tree_view), priv->column);
3331 if (gtk_tree_row_reference_valid (priv->active_row))
3335 path = gtk_tree_row_reference_get_path (priv->active_row);
3336 gtk_tree_view_set_cursor (GTK_TREE_VIEW (priv->tree_view),
3338 gtk_tree_path_free (path);
3341 /* set sample/popup widgets */
3342 gtk_combo_box_set_popup_widget (combo_box, priv->tree_view);
3344 g_signal_connect (priv->tree_view, "key-press-event",
3345 G_CALLBACK (gtk_combo_box_list_key_press),
3347 g_signal_connect (priv->tree_view, "enter-notify-event",
3348 G_CALLBACK (gtk_combo_box_list_enter_notify),
3350 g_signal_connect (priv->tree_view, "row-expanded",
3351 G_CALLBACK (gtk_combo_box_model_row_expanded),
3353 g_signal_connect (priv->tree_view, "row-collapsed",
3354 G_CALLBACK (gtk_combo_box_model_row_expanded),
3356 g_signal_connect (priv->popup_window, "button-press-event",
3357 G_CALLBACK (gtk_combo_box_list_button_pressed),
3359 g_signal_connect (priv->popup_window, "button-release-event",
3360 G_CALLBACK (gtk_combo_box_list_button_released),
3363 gtk_widget_show (priv->tree_view);
3365 gtk_combo_box_update_sensitivity (combo_box);
3369 gtk_combo_box_list_destroy (GtkComboBox *combo_box)
3371 GtkComboBoxPrivate *priv = combo_box->priv;
3373 /* disconnect signals */
3374 g_signal_handlers_disconnect_matched (priv->tree_view,
3375 G_SIGNAL_MATCH_DATA,
3376 0, 0, NULL, NULL, combo_box);
3377 g_signal_handlers_disconnect_matched (priv->button,
3378 G_SIGNAL_MATCH_DATA,
3380 gtk_combo_box_list_button_pressed,
3382 g_signal_handlers_disconnect_matched (priv->popup_window,
3383 G_SIGNAL_MATCH_DATA,
3385 gtk_combo_box_list_button_pressed,
3387 g_signal_handlers_disconnect_matched (priv->popup_window,
3388 G_SIGNAL_MATCH_DATA,
3390 gtk_combo_box_list_button_released,
3393 g_signal_handlers_disconnect_matched (priv->popup_window,
3394 G_SIGNAL_MATCH_DATA,
3396 gtk_combo_box_child_show,
3399 g_signal_handlers_disconnect_matched (priv->popup_window,
3400 G_SIGNAL_MATCH_DATA,
3402 gtk_combo_box_child_hide,
3406 g_signal_handlers_disconnect_matched (priv->box,
3407 G_SIGNAL_MATCH_DATA,
3409 gtk_combo_box_list_button_pressed,
3412 /* destroy things (unparent will kill the latest ref from us)
3413 * last unref on button will destroy the arrow
3415 gtk_widget_unparent (priv->button);
3416 priv->button = NULL;
3419 if (priv->cell_view)
3421 g_object_set (priv->cell_view,
3422 "background-set", FALSE,
3426 if (priv->cell_view_frame)
3428 gtk_widget_unparent (priv->cell_view_frame);
3429 priv->cell_view_frame = NULL;
3433 if (priv->scroll_timer)
3435 g_source_remove (priv->scroll_timer);
3436 priv->scroll_timer = 0;
3439 if (priv->resize_idle_id)
3441 g_source_remove (priv->resize_idle_id);
3442 priv->resize_idle_id = 0;
3445 gtk_widget_destroy (priv->tree_view);
3447 priv->tree_view = NULL;
3448 if (priv->popup_widget)
3450 g_object_unref (priv->popup_widget);
3451 priv->popup_widget = NULL;
3458 gtk_combo_box_list_button_pressed (GtkWidget *widget,
3459 GdkEventButton *event,
3462 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3463 GtkComboBoxPrivate *priv = combo_box->priv;
3465 GtkWidget *ewidget = gtk_get_event_widget ((GdkEvent *)event);
3467 if (ewidget == priv->popup_window)
3470 if ((ewidget != priv->button && ewidget != priv->box) ||
3471 gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (priv->button)))
3474 if (priv->focus_on_click &&
3475 !gtk_widget_has_focus (priv->button))
3476 gtk_widget_grab_focus (priv->button);
3478 gtk_combo_box_popup_for_device (combo_box, event->device);
3480 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->button), TRUE);
3482 priv->auto_scroll = FALSE;
3483 if (priv->scroll_timer == 0)
3484 priv->scroll_timer = gdk_threads_add_timeout (SCROLL_TIME,
3485 (GSourceFunc) gtk_combo_box_list_scroll_timeout,
3488 priv->popup_in_progress = TRUE;
3494 gtk_combo_box_list_button_released (GtkWidget *widget,
3495 GdkEventButton *event,
3499 GtkTreePath *path = NULL;
3502 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3503 GtkComboBoxPrivate *priv = combo_box->priv;
3505 gboolean popup_in_progress = FALSE;
3507 GtkWidget *ewidget = gtk_get_event_widget ((GdkEvent *)event);
3509 if (priv->popup_in_progress)
3511 popup_in_progress = TRUE;
3512 priv->popup_in_progress = FALSE;
3515 gtk_tree_view_set_hover_expand (GTK_TREE_VIEW (priv->tree_view),
3517 if (priv->scroll_timer)
3519 g_source_remove (priv->scroll_timer);
3520 priv->scroll_timer = 0;
3523 if (ewidget != priv->tree_view)
3525 if ((ewidget == priv->button ||
3526 ewidget == priv->box) &&
3527 !popup_in_progress &&
3528 gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (priv->button)))
3530 gtk_combo_box_popdown (combo_box);
3534 /* released outside treeview */
3535 if (ewidget != priv->button && ewidget != priv->box)
3537 gtk_combo_box_popdown (combo_box);
3545 /* select something cool */
3546 ret = gtk_tree_view_get_path_at_pos (GTK_TREE_VIEW (priv->tree_view),
3552 return TRUE; /* clicked outside window? */
3554 gtk_tree_model_get_iter (priv->model, &iter, path);
3555 gtk_tree_path_free (path);
3557 gtk_combo_box_popdown (combo_box);
3559 if (tree_column_row_is_sensitive (combo_box, &iter))
3560 gtk_combo_box_set_active_iter (combo_box, &iter);
3566 gtk_combo_box_menu_key_press (GtkWidget *widget,
3570 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3572 if (!gtk_bindings_activate_event (G_OBJECT (widget), event))
3574 /* The menu hasn't managed the
3575 * event, forward it to the combobox
3577 gtk_bindings_activate_event (G_OBJECT (combo_box), event);
3584 gtk_combo_box_list_key_press (GtkWidget *widget,
3588 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3591 if (event->keyval == GDK_KEY_Return || event->keyval == GDK_KEY_ISO_Enter || event->keyval == GDK_KEY_KP_Enter ||
3592 event->keyval == GDK_KEY_space || event->keyval == GDK_KEY_KP_Space)
3594 GtkTreeModel *model = NULL;
3596 gtk_combo_box_popdown (combo_box);
3598 if (combo_box->priv->model)
3600 GtkTreeSelection *sel;
3602 sel = gtk_tree_view_get_selection (GTK_TREE_VIEW (combo_box->priv->tree_view));
3604 if (gtk_tree_selection_get_selected (sel, &model, &iter))
3605 gtk_combo_box_set_active_iter (combo_box, &iter);
3611 if (!gtk_bindings_activate_event (G_OBJECT (widget), event))
3613 /* The list hasn't managed the
3614 * event, forward it to the combobox
3616 gtk_bindings_activate_event (G_OBJECT (combo_box), event);
3623 gtk_combo_box_list_auto_scroll (GtkComboBox *combo_box,
3628 GtkAllocation allocation;
3629 GtkWidget *tree_view = combo_box->priv->tree_view;
3632 gtk_widget_get_allocation (tree_view, &allocation);
3634 adj = gtk_scrolled_window_get_hadjustment (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window));
3635 if (adj && gtk_adjustment_get_upper (adj) - gtk_adjustment_get_lower (adj) > gtk_adjustment_get_page_size (adj))
3637 if (x <= allocation.x &&
3638 gtk_adjustment_get_lower (adj) < gtk_adjustment_get_value (adj))
3640 value = gtk_adjustment_get_value (adj) - (allocation.x - x + 1);
3641 gtk_adjustment_set_value (adj, value);
3643 else if (x >= allocation.x + allocation.width &&
3644 gtk_adjustment_get_upper (adj) - gtk_adjustment_get_page_size (adj) > gtk_adjustment_get_value (adj))
3646 value = gtk_adjustment_get_value (adj) + (x - allocation.x - allocation.width + 1);
3647 gtk_adjustment_set_value (adj, MAX (value, 0.0));
3651 adj = gtk_scrolled_window_get_vadjustment (GTK_SCROLLED_WINDOW (combo_box->priv->scrolled_window));
3652 if (adj && gtk_adjustment_get_upper (adj) - gtk_adjustment_get_lower (adj) > gtk_adjustment_get_page_size (adj))
3654 if (y <= allocation.y &&
3655 gtk_adjustment_get_lower (adj) < gtk_adjustment_get_value (adj))
3657 value = gtk_adjustment_get_value (adj) - (allocation.y - y + 1);
3658 gtk_adjustment_set_value (adj, value);
3660 else if (y >= allocation.height &&
3661 gtk_adjustment_get_upper (adj) - gtk_adjustment_get_page_size (adj) > gtk_adjustment_get_value (adj))
3663 value = gtk_adjustment_get_value (adj) + (y - allocation.height + 1);
3664 gtk_adjustment_set_value (adj, MAX (value, 0.0));
3670 gtk_combo_box_list_scroll_timeout (GtkComboBox *combo_box)
3672 GtkComboBoxPrivate *priv = combo_box->priv;
3675 if (priv->auto_scroll)
3677 gdk_window_get_device_position (gtk_widget_get_window (priv->tree_view),
3680 gtk_combo_box_list_auto_scroll (combo_box, x, y);
3687 gtk_combo_box_list_enter_notify (GtkWidget *widget,
3688 GdkEventCrossing *event,
3691 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
3693 combo_box->priv->auto_scroll = TRUE;
3699 gtk_combo_box_list_select_func (GtkTreeSelection *selection,
3700 GtkTreeModel *model,
3702 gboolean path_currently_selected,
3705 GList *list, *columns;
3706 gboolean sensitive = FALSE;
3708 columns = gtk_tree_view_get_columns (gtk_tree_selection_get_tree_view (selection));
3710 for (list = columns; list && !sensitive; list = list->next)
3712 GList *cells, *cell;
3713 gboolean cell_sensitive, cell_visible;
3715 GtkTreeViewColumn *column = GTK_TREE_VIEW_COLUMN (list->data);
3717 if (!gtk_tree_view_column_get_visible (column))
3720 gtk_tree_model_get_iter (model, &iter, path);
3721 gtk_tree_view_column_cell_set_cell_data (column, model, &iter,
3724 cell = cells = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (column));
3727 g_object_get (cell->data,
3728 "sensitive", &cell_sensitive,
3729 "visible", &cell_visible,
3732 if (cell_visible && cell_sensitive)
3737 g_list_free (cells);
3739 sensitive = cell_sensitive;
3742 g_list_free (columns);
3748 gtk_combo_box_list_row_changed (GtkTreeModel *model,
3753 /* XXX Do nothing ? */
3757 * GtkCellLayout implementation
3760 gtk_combo_box_cell_layout_get_area (GtkCellLayout *cell_layout)
3762 return GTK_COMBO_BOX (cell_layout)->priv->area;
3770 * gtk_combo_box_new:
3772 * Creates a new empty #GtkComboBox.
3774 * Return value: A new #GtkComboBox.
3779 gtk_combo_box_new (void)
3781 return g_object_new (GTK_TYPE_COMBO_BOX, NULL);
3785 * gtk_combo_box_new_with_area:
3786 * @area: the #GtkCellArea to use to layout cell renderers
3788 * Creates a new empty #GtkComboBox using @area to layout cells.
3790 * Return value: A new #GtkComboBox.
3793 gtk_combo_box_new_with_area (GtkCellArea *area)
3795 return g_object_new (GTK_TYPE_COMBO_BOX, "cell-area", area, NULL);
3799 * gtk_combo_box_new_with_area_and_entry:
3800 * @area: the #GtkCellArea to use to layout cell renderers
3802 * Creates a new empty #GtkComboBox with an entry.
3804 * The new combo box will use @area to layout cells.
3806 * Return value: A new #GtkComboBox.
3809 gtk_combo_box_new_with_area_and_entry (GtkCellArea *area)
3811 return g_object_new (GTK_TYPE_COMBO_BOX,
3819 * gtk_combo_box_new_with_entry:
3821 * Creates a new empty #GtkComboBox with an entry.
3823 * Return value: A new #GtkComboBox.
3826 gtk_combo_box_new_with_entry (void)
3828 return g_object_new (GTK_TYPE_COMBO_BOX, "has-entry", TRUE, NULL);
3832 * gtk_combo_box_new_with_model:
3833 * @model: A #GtkTreeModel.
3835 * Creates a new #GtkComboBox with the model initialized to @model.
3837 * Return value: A new #GtkComboBox.
3842 gtk_combo_box_new_with_model (GtkTreeModel *model)
3844 GtkComboBox *combo_box;
3846 g_return_val_if_fail (GTK_IS_TREE_MODEL (model), NULL);
3848 combo_box = g_object_new (GTK_TYPE_COMBO_BOX, "model", model, NULL);
3850 return GTK_WIDGET (combo_box);
3854 * gtk_combo_box_new_with_model_and_entry:
3855 * @model: A #GtkTreeModel
3857 * Creates a new empty #GtkComboBox with an entry
3858 * and with the model initialized to @model.
3860 * Return value: A new #GtkComboBox
3863 gtk_combo_box_new_with_model_and_entry (GtkTreeModel *model)
3865 return g_object_new (GTK_TYPE_COMBO_BOX,
3872 * gtk_combo_box_get_wrap_width:
3873 * @combo_box: A #GtkComboBox
3875 * Returns the wrap width which is used to determine the number of columns
3876 * for the popup menu. If the wrap width is larger than 1, the combo box
3879 * Returns: the wrap width.
3884 gtk_combo_box_get_wrap_width (GtkComboBox *combo_box)
3886 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
3888 return combo_box->priv->wrap_width;
3892 * gtk_combo_box_set_wrap_width:
3893 * @combo_box: A #GtkComboBox
3894 * @width: Preferred number of columns
3896 * Sets the wrap width of @combo_box to be @width. The wrap width is basically
3897 * the preferred number of columns when you want the popup to be layed out
3903 gtk_combo_box_set_wrap_width (GtkComboBox *combo_box,
3906 GtkComboBoxPrivate *priv;
3908 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
3909 g_return_if_fail (width >= 0);
3911 priv = combo_box->priv;
3913 if (width != priv->wrap_width)
3915 priv->wrap_width = width;
3917 gtk_combo_box_check_appearance (combo_box);
3919 if (GTK_IS_TREE_MENU (priv->popup_widget))
3920 _gtk_tree_menu_set_wrap_width (GTK_TREE_MENU (priv->popup_widget), priv->wrap_width);
3922 g_object_notify (G_OBJECT (combo_box), "wrap-width");
3927 * gtk_combo_box_get_row_span_column:
3928 * @combo_box: A #GtkComboBox
3930 * Returns the column with row span information for @combo_box.
3932 * Returns: the row span column.
3937 gtk_combo_box_get_row_span_column (GtkComboBox *combo_box)
3939 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
3941 return combo_box->priv->row_column;
3945 * gtk_combo_box_set_row_span_column:
3946 * @combo_box: A #GtkComboBox.
3947 * @row_span: A column in the model passed during construction.
3949 * Sets the column with row span information for @combo_box to be @row_span.
3950 * The row span column contains integers which indicate how many rows
3951 * an item should span.
3956 gtk_combo_box_set_row_span_column (GtkComboBox *combo_box,
3959 GtkComboBoxPrivate *priv;
3962 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
3964 priv = combo_box->priv;
3966 col = gtk_tree_model_get_n_columns (priv->model);
3967 g_return_if_fail (row_span >= -1 && row_span < col);
3969 if (row_span != priv->row_column)
3971 priv->row_column = row_span;
3973 if (GTK_IS_TREE_MENU (priv->popup_widget))
3974 _gtk_tree_menu_set_row_span_column (GTK_TREE_MENU (priv->popup_widget), priv->row_column);
3976 g_object_notify (G_OBJECT (combo_box), "row-span-column");
3981 * gtk_combo_box_get_column_span_column:
3982 * @combo_box: A #GtkComboBox
3984 * Returns the column with column span information for @combo_box.
3986 * Returns: the column span column.
3991 gtk_combo_box_get_column_span_column (GtkComboBox *combo_box)
3993 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), -1);
3995 return combo_box->priv->col_column;
3999 * gtk_combo_box_set_column_span_column:
4000 * @combo_box: A #GtkComboBox
4001 * @column_span: A column in the model passed during construction
4003 * Sets the column with column span information for @combo_box to be
4004 * @column_span. The column span column contains integers which indicate
4005 * how many columns an item should span.
4010 gtk_combo_box_set_column_span_column (GtkComboBox *combo_box,
4013 GtkComboBoxPrivate *priv;
4016 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4018 priv = combo_box->priv;
4020 col = gtk_tree_model_get_n_columns (priv->model);
4021 g_return_if_fail (column_span >= -1 && column_span < col);
4023 if (column_span != priv->col_column)
4025 priv->col_column = column_span;
4027 if (GTK_IS_TREE_MENU (priv->popup_widget))
4028 _gtk_tree_menu_set_column_span_column (GTK_TREE_MENU (priv->popup_widget), priv->col_column);
4030 g_object_notify (G_OBJECT (combo_box), "column-span-column");
4035 * gtk_combo_box_get_active:
4036 * @combo_box: A #GtkComboBox
4038 * Returns the index of the currently active item, or -1 if there's no
4039 * active item. If the model is a non-flat treemodel, and the active item
4040 * is not an immediate child of the root of the tree, this function returns
4041 * <literal>gtk_tree_path_get_indices (path)[0]</literal>, where
4042 * <literal>path</literal> is the #GtkTreePath of the active item.
4044 * Return value: An integer which is the index of the currently active item,
4045 * or -1 if there's no active item.
4050 gtk_combo_box_get_active (GtkComboBox *combo_box)
4052 GtkComboBoxPrivate *priv;
4055 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
4057 priv = combo_box->priv;
4059 if (gtk_tree_row_reference_valid (priv->active_row))
4063 path = gtk_tree_row_reference_get_path (priv->active_row);
4064 result = gtk_tree_path_get_indices (path)[0];
4065 gtk_tree_path_free (path);
4074 * gtk_combo_box_set_active:
4075 * @combo_box: A #GtkComboBox
4076 * @index_: An index in the model passed during construction, or -1 to have
4079 * Sets the active item of @combo_box to be the item at @index.
4084 gtk_combo_box_set_active (GtkComboBox *combo_box,
4087 GtkTreePath *path = NULL;
4088 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4089 g_return_if_fail (index_ >= -1);
4091 if (combo_box->priv->model == NULL)
4093 /* Save index, in case the model is set after the index */
4094 combo_box->priv->active = index_;
4100 path = gtk_tree_path_new_from_indices (index_, -1);
4102 gtk_combo_box_set_active_internal (combo_box, path);
4105 gtk_tree_path_free (path);
4109 gtk_combo_box_set_active_internal (GtkComboBox *combo_box,
4112 GtkComboBoxPrivate *priv = combo_box->priv;
4113 GtkTreePath *active_path;
4116 /* Remember whether the initially active row is valid. */
4117 gboolean is_valid_row_reference = gtk_tree_row_reference_valid (priv->active_row);
4119 if (path && is_valid_row_reference)
4121 active_path = gtk_tree_row_reference_get_path (priv->active_row);
4122 path_cmp = gtk_tree_path_compare (path, active_path);
4123 gtk_tree_path_free (active_path);
4128 if (priv->active_row)
4130 gtk_tree_row_reference_free (priv->active_row);
4131 priv->active_row = NULL;
4136 if (priv->tree_view)
4137 gtk_tree_selection_unselect_all (gtk_tree_view_get_selection (GTK_TREE_VIEW (priv->tree_view)));
4140 GtkMenu *menu = GTK_MENU (priv->popup_widget);
4142 if (GTK_IS_MENU (menu))
4143 gtk_menu_set_active (menu, -1);
4146 if (priv->cell_view)
4147 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (priv->cell_view), NULL);
4150 * Do not emit a "changed" signal when an already invalid selection was
4151 * now set to invalid.
4153 if (!is_valid_row_reference)
4159 gtk_tree_row_reference_new (priv->model, path);
4161 if (priv->tree_view)
4163 gtk_tree_view_set_cursor (GTK_TREE_VIEW (priv->tree_view),
4166 else if (GTK_IS_MENU (priv->popup_widget))
4168 /* FIXME handle nested menus better */
4169 gtk_menu_set_active (GTK_MENU (priv->popup_widget),
4170 gtk_tree_path_get_indices (path)[0]);
4173 if (priv->cell_view)
4174 gtk_cell_view_set_displayed_row (GTK_CELL_VIEW (priv->cell_view),
4178 g_signal_emit (combo_box, combo_box_signals[CHANGED], 0);
4179 g_object_notify (G_OBJECT (combo_box), "active");
4180 if (combo_box->priv->id_column >= 0)
4181 g_object_notify (G_OBJECT (combo_box), "active-id");
4186 * gtk_combo_box_get_active_iter:
4187 * @combo_box: A #GtkComboBox
4188 * @iter: (out): The uninitialized #GtkTreeIter
4190 * Sets @iter to point to the current active item, if it exists.
4192 * Return value: %TRUE, if @iter was set
4197 gtk_combo_box_get_active_iter (GtkComboBox *combo_box,
4203 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
4205 if (!gtk_tree_row_reference_valid (combo_box->priv->active_row))
4208 path = gtk_tree_row_reference_get_path (combo_box->priv->active_row);
4209 result = gtk_tree_model_get_iter (combo_box->priv->model, iter, path);
4210 gtk_tree_path_free (path);
4216 * gtk_combo_box_set_active_iter:
4217 * @combo_box: A #GtkComboBox
4218 * @iter: (allow-none): The #GtkTreeIter, or %NULL
4220 * Sets the current active item to be the one referenced by @iter, or
4221 * unsets the active item if @iter is %NULL.
4226 gtk_combo_box_set_active_iter (GtkComboBox *combo_box,
4229 GtkTreePath *path = NULL;
4231 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4234 path = gtk_tree_model_get_path (gtk_combo_box_get_model (combo_box), iter);
4236 gtk_combo_box_set_active_internal (combo_box, path);
4237 gtk_tree_path_free (path);
4241 * gtk_combo_box_set_model:
4242 * @combo_box: A #GtkComboBox
4243 * @model: (allow-none): A #GtkTreeModel
4245 * Sets the model used by @combo_box to be @model. Will unset a previously set
4246 * model (if applicable). If model is %NULL, then it will unset the model.
4248 * Note that this function does not clear the cell renderers, you have to
4249 * call gtk_cell_layout_clear() yourself if you need to set up different
4250 * cell renderers for the new model.
4255 gtk_combo_box_set_model (GtkComboBox *combo_box,
4256 GtkTreeModel *model)
4258 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4259 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
4261 if (model == combo_box->priv->model)
4264 gtk_combo_box_unset_model (combo_box);
4269 combo_box->priv->model = model;
4270 g_object_ref (combo_box->priv->model);
4272 combo_box->priv->inserted_id =
4273 g_signal_connect (combo_box->priv->model, "row-inserted",
4274 G_CALLBACK (gtk_combo_box_model_row_inserted),
4276 combo_box->priv->deleted_id =
4277 g_signal_connect (combo_box->priv->model, "row-deleted",
4278 G_CALLBACK (gtk_combo_box_model_row_deleted),
4280 combo_box->priv->reordered_id =
4281 g_signal_connect (combo_box->priv->model, "rows-reordered",
4282 G_CALLBACK (gtk_combo_box_model_rows_reordered),
4284 combo_box->priv->changed_id =
4285 g_signal_connect (combo_box->priv->model, "row-changed",
4286 G_CALLBACK (gtk_combo_box_model_row_changed),
4289 if (combo_box->priv->tree_view)
4292 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view),
4293 combo_box->priv->model);
4294 gtk_combo_box_list_popup_resize (combo_box);
4297 if (GTK_IS_TREE_MENU (combo_box->priv->popup_widget))
4300 _gtk_tree_menu_set_model (GTK_TREE_MENU (combo_box->priv->popup_widget),
4301 combo_box->priv->model);
4304 if (combo_box->priv->cell_view)
4305 gtk_cell_view_set_model (GTK_CELL_VIEW (combo_box->priv->cell_view),
4306 combo_box->priv->model);
4308 if (combo_box->priv->active != -1)
4310 /* If an index was set in advance, apply it now */
4311 gtk_combo_box_set_active (combo_box, combo_box->priv->active);
4312 combo_box->priv->active = -1;
4316 gtk_combo_box_update_sensitivity (combo_box);
4318 g_object_notify (G_OBJECT (combo_box), "model");
4322 * gtk_combo_box_get_model:
4323 * @combo_box: A #GtkComboBox
4325 * Returns the #GtkTreeModel which is acting as data source for @combo_box.
4327 * Return value: (transfer none): A #GtkTreeModel which was passed
4328 * during construction.
4333 gtk_combo_box_get_model (GtkComboBox *combo_box)
4335 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4337 return combo_box->priv->model;
4341 gtk_combo_box_real_move_active (GtkComboBox *combo_box,
4342 GtkScrollType scroll)
4345 GtkTreeIter new_iter;
4346 gboolean active_iter;
4349 if (!combo_box->priv->model)
4351 gtk_widget_error_bell (GTK_WIDGET (combo_box));
4355 active_iter = gtk_combo_box_get_active_iter (combo_box, &iter);
4359 case GTK_SCROLL_STEP_BACKWARD:
4360 case GTK_SCROLL_STEP_UP:
4361 case GTK_SCROLL_STEP_LEFT:
4364 found = tree_prev (combo_box, combo_box->priv->model,
4365 &iter, &new_iter, FALSE);
4368 /* else fall through */
4370 case GTK_SCROLL_PAGE_FORWARD:
4371 case GTK_SCROLL_PAGE_DOWN:
4372 case GTK_SCROLL_PAGE_RIGHT:
4373 case GTK_SCROLL_END:
4374 found = tree_last (combo_box, combo_box->priv->model, &new_iter, FALSE);
4377 case GTK_SCROLL_STEP_FORWARD:
4378 case GTK_SCROLL_STEP_DOWN:
4379 case GTK_SCROLL_STEP_RIGHT:
4382 found = tree_next (combo_box, combo_box->priv->model,
4383 &iter, &new_iter, FALSE);
4386 /* else fall through */
4388 case GTK_SCROLL_PAGE_BACKWARD:
4389 case GTK_SCROLL_PAGE_UP:
4390 case GTK_SCROLL_PAGE_LEFT:
4391 case GTK_SCROLL_START:
4392 found = tree_first (combo_box, combo_box->priv->model, &new_iter, FALSE);
4399 if (found && active_iter)
4401 GtkTreePath *old_path;
4402 GtkTreePath *new_path;
4404 old_path = gtk_tree_model_get_path (combo_box->priv->model, &iter);
4405 new_path = gtk_tree_model_get_path (combo_box->priv->model, &new_iter);
4407 if (gtk_tree_path_compare (old_path, new_path) == 0)
4410 gtk_tree_path_free (old_path);
4411 gtk_tree_path_free (new_path);
4416 gtk_combo_box_set_active_iter (combo_box, &new_iter);
4420 gtk_widget_error_bell (GTK_WIDGET (combo_box));
4425 gtk_combo_box_mnemonic_activate (GtkWidget *widget,
4426 gboolean group_cycling)
4428 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4430 if (combo_box->priv->has_entry)
4434 child = gtk_bin_get_child (GTK_BIN (combo_box));
4436 gtk_widget_grab_focus (child);
4439 gtk_widget_grab_focus (combo_box->priv->button);
4445 gtk_combo_box_grab_focus (GtkWidget *widget)
4447 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4449 if (combo_box->priv->has_entry)
4453 child = gtk_bin_get_child (GTK_BIN (combo_box));
4455 gtk_widget_grab_focus (child);
4458 gtk_widget_grab_focus (combo_box->priv->button);
4462 gtk_combo_box_destroy (GtkWidget *widget)
4464 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
4466 if (combo_box->priv->popup_idle_id > 0)
4468 g_source_remove (combo_box->priv->popup_idle_id);
4469 combo_box->priv->popup_idle_id = 0;
4472 gtk_combo_box_popdown (combo_box);
4474 if (combo_box->priv->row_separator_destroy)
4475 combo_box->priv->row_separator_destroy (combo_box->priv->row_separator_data);
4477 combo_box->priv->row_separator_func = NULL;
4478 combo_box->priv->row_separator_data = NULL;
4479 combo_box->priv->row_separator_destroy = NULL;
4481 GTK_WIDGET_CLASS (gtk_combo_box_parent_class)->destroy (widget);
4482 combo_box->priv->cell_view = NULL;
4486 gtk_combo_box_entry_contents_changed (GtkEntry *entry,
4489 GtkComboBox *combo_box = GTK_COMBO_BOX (user_data);
4492 * Fixes regression reported in bug #574059. The old functionality relied on
4493 * bug #572478. As a bugfix, we now emit the "changed" signal ourselves
4494 * when the selection was already set to -1.
4496 if (gtk_combo_box_get_active(combo_box) == -1)
4497 g_signal_emit_by_name (combo_box, "changed");
4499 gtk_combo_box_set_active (combo_box, -1);
4503 gtk_combo_box_entry_active_changed (GtkComboBox *combo_box,
4506 GtkComboBoxPrivate *priv = combo_box->priv;
4507 GtkTreeModel *model;
4510 if (gtk_combo_box_get_active_iter (combo_box, &iter))
4512 GtkEntry *entry = GTK_ENTRY (gtk_bin_get_child (GTK_BIN (combo_box)));
4516 GValue value = {0,};
4518 g_signal_handlers_block_by_func (entry,
4519 gtk_combo_box_entry_contents_changed,
4522 model = gtk_combo_box_get_model (combo_box);
4524 gtk_tree_model_get_value (model, &iter,
4525 priv->text_column, &value);
4526 g_object_set_property (G_OBJECT (entry), "text", &value);
4527 g_value_unset (&value);
4529 g_signal_handlers_unblock_by_func (entry,
4530 gtk_combo_box_entry_contents_changed,
4537 gtk_combo_box_constructor (GType type,
4538 guint n_construct_properties,
4539 GObjectConstructParam *construct_properties)
4542 GtkComboBox *combo_box;
4543 GtkComboBoxPrivate *priv;
4544 GtkStyleContext *context;
4546 object = G_OBJECT_CLASS (gtk_combo_box_parent_class)->constructor
4547 (type, n_construct_properties, construct_properties);
4549 combo_box = GTK_COMBO_BOX (object);
4550 priv = combo_box->priv;
4554 GtkCellArea *area = gtk_cell_area_box_new ();
4556 priv->area = g_object_ref_sink (area);
4559 priv->cell_view = gtk_cell_view_new_with_context (priv->area, NULL);
4560 gtk_cell_view_set_fit_model (GTK_CELL_VIEW (priv->cell_view), TRUE);
4561 gtk_cell_view_set_model (GTK_CELL_VIEW (priv->cell_view), priv->model);
4562 gtk_widget_set_parent (priv->cell_view, GTK_WIDGET (combo_box));
4563 _gtk_bin_set_child (GTK_BIN (combo_box), priv->cell_view);
4564 gtk_widget_show (priv->cell_view);
4566 gtk_combo_box_check_appearance (combo_box);
4568 context = gtk_widget_get_style_context (GTK_WIDGET (combo_box));
4569 gtk_style_context_add_class (context, GTK_STYLE_CLASS_BUTTON);
4571 if (priv->has_entry)
4575 entry = gtk_entry_new ();
4576 gtk_widget_show (entry);
4577 gtk_container_add (GTK_CONTAINER (combo_box), entry);
4579 priv->text_renderer = gtk_cell_renderer_text_new ();
4580 gtk_cell_layout_pack_start (GTK_CELL_LAYOUT (combo_box),
4581 priv->text_renderer, TRUE);
4583 gtk_combo_box_set_active (GTK_COMBO_BOX (combo_box), -1);
4585 g_signal_connect (combo_box, "changed",
4586 G_CALLBACK (gtk_combo_box_entry_active_changed), NULL);
4594 gtk_combo_box_dispose(GObject* object)
4596 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
4598 if (GTK_IS_MENU (combo_box->priv->popup_widget))
4600 gtk_combo_box_menu_destroy (combo_box);
4601 gtk_menu_detach (GTK_MENU (combo_box->priv->popup_widget));
4602 combo_box->priv->popup_widget = NULL;
4605 if (combo_box->priv->area)
4607 g_object_unref (combo_box->priv->area);
4608 combo_box->priv->area = NULL;
4611 if (GTK_IS_TREE_VIEW (combo_box->priv->tree_view))
4612 gtk_combo_box_list_destroy (combo_box);
4614 if (combo_box->priv->popup_window)
4616 gtk_widget_destroy (combo_box->priv->popup_window);
4617 combo_box->priv->popup_window = NULL;
4620 gtk_combo_box_unset_model (combo_box);
4622 G_OBJECT_CLASS (gtk_combo_box_parent_class)->dispose (object);
4626 gtk_combo_box_finalize (GObject *object)
4628 GtkComboBox *combo_box = GTK_COMBO_BOX (object);
4630 g_free (combo_box->priv->tearoff_title);
4632 G_OBJECT_CLASS (gtk_combo_box_parent_class)->finalize (object);
4636 gtk_cell_editable_key_press (GtkWidget *widget,
4640 GtkComboBox *combo_box = GTK_COMBO_BOX (data);
4642 if (event->keyval == GDK_KEY_Escape)
4644 g_object_set (combo_box,
4645 "editing-canceled", TRUE,
4647 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
4648 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
4652 else if (event->keyval == GDK_KEY_Return ||
4653 event->keyval == GDK_KEY_ISO_Enter ||
4654 event->keyval == GDK_KEY_KP_Enter)
4656 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
4657 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
4666 popdown_idle (gpointer data)
4668 GtkComboBox *combo_box;
4670 combo_box = GTK_COMBO_BOX (data);
4672 gtk_cell_editable_editing_done (GTK_CELL_EDITABLE (combo_box));
4673 gtk_cell_editable_remove_widget (GTK_CELL_EDITABLE (combo_box));
4675 g_object_unref (combo_box);
4681 popdown_handler (GtkWidget *widget,
4684 gdk_threads_add_idle (popdown_idle, g_object_ref (data));
4688 popup_idle (gpointer data)
4690 GtkComboBox *combo_box;
4692 combo_box = GTK_COMBO_BOX (data);
4694 if (GTK_IS_MENU (combo_box->priv->popup_widget) &&
4695 combo_box->priv->cell_view)
4696 g_signal_connect_object (combo_box->priv->popup_widget,
4697 "unmap", G_CALLBACK (popdown_handler),
4700 /* we unset this if a menu item is activated */
4701 g_object_set (combo_box,
4702 "editing-canceled", TRUE,
4704 gtk_combo_box_popup (combo_box);
4706 combo_box->priv->popup_idle_id = 0;
4707 combo_box->priv->activate_button = 0;
4708 combo_box->priv->activate_time = 0;
4714 gtk_combo_box_start_editing (GtkCellEditable *cell_editable,
4717 GtkComboBox *combo_box = GTK_COMBO_BOX (cell_editable);
4720 combo_box->priv->is_cell_renderer = TRUE;
4722 if (combo_box->priv->cell_view)
4724 g_signal_connect_object (combo_box->priv->button, "key-press-event",
4725 G_CALLBACK (gtk_cell_editable_key_press),
4728 gtk_widget_grab_focus (combo_box->priv->button);
4732 child = gtk_bin_get_child (GTK_BIN (combo_box));
4734 g_signal_connect_object (child, "key-press-event",
4735 G_CALLBACK (gtk_cell_editable_key_press),
4738 gtk_widget_grab_focus (child);
4739 gtk_widget_set_can_focus (combo_box->priv->button, FALSE);
4742 /* we do the immediate popup only for the optionmenu-like
4745 if (combo_box->priv->is_cell_renderer &&
4746 combo_box->priv->cell_view && !combo_box->priv->tree_view)
4748 if (event && event->type == GDK_BUTTON_PRESS)
4750 GdkEventButton *event_button = (GdkEventButton *)event;
4752 combo_box->priv->activate_button = event_button->button;
4753 combo_box->priv->activate_time = event_button->time;
4756 combo_box->priv->popup_idle_id =
4757 gdk_threads_add_idle (popup_idle, combo_box);
4763 * gtk_combo_box_get_add_tearoffs:
4764 * @combo_box: a #GtkComboBox
4766 * Gets the current value of the :add-tearoffs property.
4768 * Return value: the current value of the :add-tearoffs property.
4771 gtk_combo_box_get_add_tearoffs (GtkComboBox *combo_box)
4773 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
4775 return combo_box->priv->add_tearoffs;
4779 * gtk_combo_box_set_add_tearoffs:
4780 * @combo_box: a #GtkComboBox
4781 * @add_tearoffs: %TRUE to add tearoff menu items
4783 * Sets whether the popup menu should have a tearoff
4789 gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box,
4790 gboolean add_tearoffs)
4792 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4794 add_tearoffs = add_tearoffs != FALSE;
4796 if (combo_box->priv->add_tearoffs != add_tearoffs)
4798 combo_box->priv->add_tearoffs = add_tearoffs;
4799 gtk_combo_box_check_appearance (combo_box);
4801 if (GTK_IS_TREE_MENU (combo_box->priv->popup_widget))
4802 _gtk_tree_menu_set_tearoff (GTK_TREE_MENU (combo_box->priv->popup_widget),
4803 combo_box->priv->add_tearoffs);
4805 g_object_notify (G_OBJECT (combo_box), "add-tearoffs");
4810 * gtk_combo_box_get_title:
4811 * @combo_box: a #GtkComboBox
4813 * Gets the current title of the menu in tearoff mode. See
4814 * gtk_combo_box_set_add_tearoffs().
4816 * Returns: the menu's title in tearoff mode. This is an internal copy of the
4817 * string which must not be freed.
4821 G_CONST_RETURN gchar*
4822 gtk_combo_box_get_title (GtkComboBox *combo_box)
4824 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4826 return combo_box->priv->tearoff_title;
4830 gtk_combo_box_update_title (GtkComboBox *combo_box)
4832 gtk_combo_box_check_appearance (combo_box);
4834 if (combo_box->priv->popup_widget &&
4835 GTK_IS_MENU (combo_box->priv->popup_widget))
4836 gtk_menu_set_title (GTK_MENU (combo_box->priv->popup_widget),
4837 combo_box->priv->tearoff_title);
4841 * gtk_combo_box_set_title:
4842 * @combo_box: a #GtkComboBox
4843 * @title: a title for the menu in tearoff mode
4845 * Sets the menu's title in tearoff mode.
4850 gtk_combo_box_set_title (GtkComboBox *combo_box,
4853 GtkComboBoxPrivate *priv;
4855 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4857 priv = combo_box->priv;
4859 if (strcmp (title ? title : "",
4860 priv->tearoff_title ? priv->tearoff_title : "") != 0)
4862 g_free (priv->tearoff_title);
4863 priv->tearoff_title = g_strdup (title);
4865 gtk_combo_box_update_title (combo_box);
4867 g_object_notify (G_OBJECT (combo_box), "tearoff-title");
4873 * gtk_combo_box_set_popup_fixed_width:
4874 * @combo_box: a #GtkComboBox
4875 * @fixed: whether to use a fixed popup width
4877 * Specifies whether the popup's width should be a fixed width
4878 * matching the allocated width of the combo box.
4883 gtk_combo_box_set_popup_fixed_width (GtkComboBox *combo_box,
4886 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4888 if (combo_box->priv->popup_fixed_width != fixed)
4890 combo_box->priv->popup_fixed_width = fixed;
4892 g_object_notify (G_OBJECT (combo_box), "popup-fixed-width");
4897 * gtk_combo_box_get_popup_fixed_width:
4898 * @combo_box: a #GtkComboBox
4900 * Gets whether the popup uses a fixed width matching
4901 * the allocated width of the combo box.
4903 * Returns: %TRUE if the popup uses a fixed width
4908 gtk_combo_box_get_popup_fixed_width (GtkComboBox *combo_box)
4910 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
4912 return combo_box->priv->popup_fixed_width;
4917 * gtk_combo_box_get_popup_accessible:
4918 * @combo_box: a #GtkComboBox
4920 * Gets the accessible object corresponding to the combo box's popup.
4922 * This function is mostly intended for use by accessibility technologies;
4923 * applications should have little use for it.
4925 * Returns: (transfer none): the accessible object corresponding
4926 * to the combo box's popup.
4931 gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box)
4935 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4937 if (combo_box->priv->popup_widget)
4939 atk_obj = gtk_widget_get_accessible (combo_box->priv->popup_widget);
4947 * gtk_combo_box_get_row_separator_func:
4948 * @combo_box: a #GtkComboBox
4950 * Returns the current row separator function.
4952 * Return value: the current row separator function.
4956 GtkTreeViewRowSeparatorFunc
4957 gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box)
4959 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), NULL);
4961 return combo_box->priv->row_separator_func;
4965 * gtk_combo_box_set_row_separator_func:
4966 * @combo_box: a #GtkComboBox
4967 * @func: a #GtkTreeViewRowSeparatorFunc
4968 * @data: (allow-none): user data to pass to @func, or %NULL
4969 * @destroy: (allow-none): destroy notifier for @data, or %NULL
4971 * Sets the row separator function, which is used to determine
4972 * whether a row should be drawn as a separator. If the row separator
4973 * function is %NULL, no separators are drawn. This is the default value.
4978 gtk_combo_box_set_row_separator_func (GtkComboBox *combo_box,
4979 GtkTreeViewRowSeparatorFunc func,
4981 GDestroyNotify destroy)
4983 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
4985 if (combo_box->priv->row_separator_destroy)
4986 combo_box->priv->row_separator_destroy (combo_box->priv->row_separator_data);
4988 combo_box->priv->row_separator_func = func;
4989 combo_box->priv->row_separator_data = data;
4990 combo_box->priv->row_separator_destroy = destroy;
4992 /* Provoke the underlying treeview/menu to rebuild themselves with the new separator func */
4993 if (combo_box->priv->tree_view)
4995 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view), NULL);
4996 gtk_tree_view_set_model (GTK_TREE_VIEW (combo_box->priv->tree_view), combo_box->priv->model);
4999 if (GTK_IS_TREE_MENU (combo_box->priv->popup_widget))
5001 _gtk_tree_menu_set_model (GTK_TREE_MENU (combo_box->priv->popup_widget), NULL);
5002 _gtk_tree_menu_set_model (GTK_TREE_MENU (combo_box->priv->popup_widget), combo_box->priv->model);
5005 gtk_widget_queue_draw (GTK_WIDGET (combo_box));
5009 * gtk_combo_box_set_button_sensitivity:
5010 * @combo_box: a #GtkComboBox
5011 * @sensitivity: specify the sensitivity of the dropdown button
5013 * Sets whether the dropdown button of the combo box should be
5014 * always sensitive (%GTK_SENSITIVITY_ON), never sensitive (%GTK_SENSITIVITY_OFF)
5015 * or only if there is at least one item to display (%GTK_SENSITIVITY_AUTO).
5020 gtk_combo_box_set_button_sensitivity (GtkComboBox *combo_box,
5021 GtkSensitivityType sensitivity)
5023 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5025 if (combo_box->priv->button_sensitivity != sensitivity)
5027 combo_box->priv->button_sensitivity = sensitivity;
5028 gtk_combo_box_update_sensitivity (combo_box);
5030 g_object_notify (G_OBJECT (combo_box), "button-sensitivity");
5035 * gtk_combo_box_get_button_sensitivity:
5036 * @combo_box: a #GtkComboBox
5038 * Returns whether the combo box sets the dropdown button
5039 * sensitive or not when there are no items in the model.
5041 * Return Value: %GTK_SENSITIVITY_ON if the dropdown button
5042 * is sensitive when the model is empty, %GTK_SENSITIVITY_OFF
5043 * if the button is always insensitive or
5044 * %GTK_SENSITIVITY_AUTO if it is only sensitive as long as
5045 * the model has one item to be selected.
5050 gtk_combo_box_get_button_sensitivity (GtkComboBox *combo_box)
5052 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5054 return combo_box->priv->button_sensitivity;
5059 * gtk_combo_box_get_has_entry:
5060 * @combo_box: a #GtkComboBox
5062 * Returns whether the combo box has an entry.
5064 * Return Value: whether there is an entry in @combo_box.
5069 gtk_combo_box_get_has_entry (GtkComboBox *combo_box)
5071 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5073 return combo_box->priv->has_entry;
5077 * gtk_combo_box_set_entry_text_column:
5078 * @combo_box: A #GtkComboBox
5079 * @text_column: A column in @model to get the strings from for
5080 * the internal entry
5082 * Sets the model column which @combo_box should use to get strings from
5083 * to be @text_column. The column @text_column in the model of @combo_box
5084 * must be of type %G_TYPE_STRING.
5086 * This is only relevant if @combo_box has been created with
5087 * #GtkComboBox:has-entry as %TRUE.
5092 gtk_combo_box_set_entry_text_column (GtkComboBox *combo_box,
5095 GtkComboBoxPrivate *priv = combo_box->priv;
5096 GtkTreeModel *model;
5098 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5100 model = gtk_combo_box_get_model (combo_box);
5102 g_return_if_fail (text_column >= 0);
5103 g_return_if_fail (model == NULL || text_column < gtk_tree_model_get_n_columns (model));
5105 priv->text_column = text_column;
5107 if (priv->text_renderer != NULL)
5108 gtk_cell_layout_set_attributes (GTK_CELL_LAYOUT (combo_box),
5109 priv->text_renderer,
5110 "text", text_column,
5115 * gtk_combo_box_get_entry_text_column:
5116 * @combo_box: A #GtkComboBox.
5118 * Returns the column which @combo_box is using to get the strings
5119 * from to display in the internal entry.
5121 * Return value: A column in the data source model of @combo_box.
5126 gtk_combo_box_get_entry_text_column (GtkComboBox *combo_box)
5128 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
5130 return combo_box->priv->text_column;
5134 * gtk_combo_box_set_focus_on_click:
5135 * @combo: a #GtkComboBox
5136 * @focus_on_click: whether the combo box grabs focus when clicked
5139 * Sets whether the combo box will grab focus when it is clicked with
5140 * the mouse. Making mouse clicks not grab focus is useful in places
5141 * like toolbars where you don't want the keyboard focus removed from
5142 * the main area of the application.
5147 gtk_combo_box_set_focus_on_click (GtkComboBox *combo_box,
5148 gboolean focus_on_click)
5150 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5152 focus_on_click = focus_on_click != FALSE;
5154 if (combo_box->priv->focus_on_click != focus_on_click)
5156 combo_box->priv->focus_on_click = focus_on_click;
5158 if (combo_box->priv->button)
5159 gtk_button_set_focus_on_click (GTK_BUTTON (combo_box->priv->button),
5162 g_object_notify (G_OBJECT (combo_box), "focus-on-click");
5167 * gtk_combo_box_get_focus_on_click:
5168 * @combo: a #GtkComboBox
5170 * Returns whether the combo box grabs focus when it is clicked
5171 * with the mouse. See gtk_combo_box_set_focus_on_click().
5173 * Return value: %TRUE if the combo box grabs focus when it is
5174 * clicked with the mouse.
5179 gtk_combo_box_get_focus_on_click (GtkComboBox *combo_box)
5181 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), FALSE);
5183 return combo_box->priv->focus_on_click;
5188 gtk_combo_box_buildable_custom_tag_start (GtkBuildable *buildable,
5189 GtkBuilder *builder,
5191 const gchar *tagname,
5192 GMarkupParser *parser,
5195 if (parent_buildable_iface->custom_tag_start (buildable, builder, child,
5196 tagname, parser, data))
5199 return _gtk_cell_layout_buildable_custom_tag_start (buildable, builder, child,
5200 tagname, parser, data);
5204 gtk_combo_box_buildable_custom_tag_end (GtkBuildable *buildable,
5205 GtkBuilder *builder,
5207 const gchar *tagname,
5210 if (!_gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname, data))
5211 parent_buildable_iface->custom_tag_end (buildable, builder, child, tagname, data);
5215 gtk_combo_box_buildable_get_internal_child (GtkBuildable *buildable,
5216 GtkBuilder *builder,
5217 const gchar *childname)
5219 GtkComboBox *combo_box = GTK_COMBO_BOX (buildable);
5221 if (combo_box->priv->has_entry && strcmp (childname, "entry") == 0)
5222 return G_OBJECT (gtk_bin_get_child (GTK_BIN (buildable)));
5224 return parent_buildable_iface->get_internal_child (buildable, builder, childname);
5228 gtk_combo_box_get_preferred_width (GtkWidget *widget,
5232 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
5233 GtkComboBoxPrivate *priv = combo_box->priv;
5234 gint focus_width, focus_pad;
5235 gint font_size, arrow_size;
5236 PangoContext *context;
5237 PangoFontMetrics *metrics;
5238 PangoFontDescription *font_desc;
5240 gint minimum_width = 0, natural_width = 0;
5241 gint child_min, child_nat;
5242 GtkStyleContext *style_context;
5243 GtkStateFlags state;
5246 child = gtk_bin_get_child (GTK_BIN (widget));
5249 gtk_widget_get_preferred_width (child, &child_min, &child_nat);
5251 gtk_widget_style_get (GTK_WIDGET (widget),
5252 "focus-line-width", &focus_width,
5253 "focus-padding", &focus_pad,
5254 "arrow-size", &arrow_size,
5257 style_context = gtk_widget_get_style_context (widget);
5258 state = gtk_widget_get_state_flags (widget);
5260 gtk_style_context_get (style_context, state,
5262 "border-width", &border,
5265 context = gtk_widget_get_pango_context (GTK_WIDGET (widget));
5266 metrics = pango_context_get_metrics (context, font_desc,
5267 pango_context_get_language (context));
5268 font_size = PANGO_PIXELS (pango_font_metrics_get_ascent (metrics) +
5269 pango_font_metrics_get_descent (metrics));
5270 pango_font_metrics_unref (metrics);
5271 pango_font_description_free (font_desc);
5273 arrow_size = MAX (arrow_size, font_size);
5275 gtk_widget_set_size_request (priv->arrow, arrow_size, arrow_size);
5277 if (!priv->tree_view)
5280 if (priv->cell_view)
5282 gint sep_width, arrow_width;
5283 gint border_width, xpad;
5284 GtkBorder button_border;
5286 border_width = gtk_container_get_border_width (GTK_CONTAINER (combo_box));
5287 get_widget_border (priv->button, &button_border);
5289 gtk_widget_get_preferred_width (priv->separator, &sep_width, NULL);
5290 gtk_widget_get_preferred_width (priv->arrow, &arrow_width, NULL);
5292 xpad = 2 * (border_width + focus_width + focus_pad) +
5293 button_border.left + button_border.right;
5295 minimum_width = child_min + sep_width + arrow_width + xpad;
5296 natural_width = child_nat + sep_width + arrow_width + xpad;
5300 gint but_width, but_nat_width;
5302 gtk_widget_get_preferred_width (priv->button,
5303 &but_width, &but_nat_width);
5305 minimum_width = child_min + but_width;
5306 natural_width = child_nat + but_nat_width;
5312 gint button_width, button_nat_width;
5314 /* sample + frame */
5315 minimum_width = child_min;
5316 natural_width = child_nat;
5318 minimum_width += 2 * focus_width;
5319 natural_width += 2 * focus_width;
5321 if (priv->cell_view_frame)
5323 if (priv->has_frame)
5325 gint border_width, xpad;
5326 GtkBorder frame_border;
5328 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->cell_view_frame));
5329 get_widget_border (priv->cell_view_frame, &frame_border);
5330 xpad = (2 * border_width) + frame_border.left + frame_border.right;
5332 minimum_width += xpad;
5333 natural_width += xpad;
5338 gtk_widget_get_preferred_width (priv->button,
5339 &button_width, &button_nat_width);
5341 minimum_width += button_width;
5342 natural_width += button_nat_width;
5345 minimum_width += border->left + border->right;
5346 natural_width += border->left + border->right;
5347 gtk_border_free (border);
5350 *minimum_size = minimum_width;
5353 *natural_size = natural_width;
5357 gtk_combo_box_get_preferred_height (GtkWidget *widget,
5363 /* Combo box is height-for-width only
5364 * (so we always just reserve enough height for the minimum width) */
5365 GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, &min_width, NULL);
5366 GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width (widget, min_width, minimum_size, natural_size);
5370 gtk_combo_box_get_preferred_width_for_height (GtkWidget *widget,
5375 /* Combo box is height-for-width only
5376 * (so we assume we always reserved enough height for the minimum width) */
5377 GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, minimum_size, natural_size);
5382 gtk_combo_box_get_preferred_height_for_width (GtkWidget *widget,
5387 GtkComboBox *combo_box = GTK_COMBO_BOX (widget);
5388 GtkComboBoxPrivate *priv = combo_box->priv;
5389 gint focus_width, focus_pad;
5390 gint min_height = 0, nat_height = 0;
5395 gtk_widget_style_get (GTK_WIDGET (widget),
5396 "focus-line-width", &focus_width,
5397 "focus-padding", &focus_pad,
5400 child = gtk_bin_get_child (GTK_BIN (widget));
5402 get_widget_border (widget, &border);
5403 size = avail_size - border.left;
5405 if (!priv->tree_view)
5408 if (priv->cell_view)
5410 /* calculate x/y padding and separator/arrow size */
5411 gint sep_width, arrow_width, sep_height, arrow_height;
5412 gint border_width, xpad, ypad;
5413 GtkBorder button_border;
5415 border_width = gtk_container_get_border_width (GTK_CONTAINER (combo_box));
5416 get_widget_border (priv->button, &button_border);
5418 gtk_widget_get_preferred_width (priv->separator, &sep_width, NULL);
5419 gtk_widget_get_preferred_width (priv->arrow, &arrow_width, NULL);
5420 gtk_widget_get_preferred_height_for_width (priv->separator,
5421 sep_width, &sep_height, NULL);
5422 gtk_widget_get_preferred_height_for_width (priv->arrow,
5423 arrow_width, &arrow_height, NULL);
5425 xpad = 2 * (border_width + focus_width + focus_pad) +
5426 button_border.left + button_border.right;
5427 ypad = 2 * (border_width + focus_width + focus_pad) +
5428 button_border.top + button_border.bottom;
5430 size -= sep_width + arrow_width + xpad;
5432 /* Get height-for-width of the child widget, usually a GtkCellArea calculating
5433 * and fitting the whole treemodel */
5434 gtk_widget_get_preferred_height_for_width (child, size, &min_height, &nat_height);
5436 arrow_height = MAX (arrow_height, sep_height);
5437 min_height = MAX (min_height, arrow_height);
5438 nat_height = MAX (nat_height, arrow_height);
5445 /* there is a custom child widget inside (no priv->cell_view) */
5446 gint but_width, but_height;
5448 gtk_widget_get_preferred_width (priv->button, &but_width, NULL);
5449 gtk_widget_get_preferred_height_for_width (priv->button,
5450 but_width, &but_height, NULL);
5454 /* Get height-for-width of the child widget, usually a GtkCellArea calculating
5455 * and fitting the whole treemodel */
5456 gtk_widget_get_preferred_height_for_width (child, size, &min_height, &nat_height);
5458 min_height = MAX (min_height, but_height);
5459 nat_height = MAX (nat_height, but_height);
5465 gint but_width, but_height;
5466 gint xpad = 0, ypad = 0;
5468 gtk_widget_get_preferred_width (priv->button, &but_width, NULL);
5469 gtk_widget_get_preferred_height_for_width (priv->button,
5470 but_width, &but_height, NULL);
5472 if (priv->cell_view_frame && priv->has_frame)
5474 GtkBorder frame_border;
5477 border_width = gtk_container_get_border_width (GTK_CONTAINER (priv->cell_view_frame));
5478 get_widget_border (GTK_WIDGET (priv->cell_view_frame), &frame_border);
5480 xpad = (2 * border_width) + border.left + frame_border.right;
5481 ypad = (2 * border_width) + border.top + frame_border.bottom;
5485 size -= 2 * focus_width;
5488 /* Get height-for-width of the child widget, usually a GtkCellArea calculating
5489 * and fitting the whole treemodel */
5490 gtk_widget_get_preferred_height_for_width (child, size, &min_height, &nat_height);
5492 min_height = MAX (min_height, but_height);
5493 nat_height = MAX (nat_height, but_height);
5499 min_height += border.top + border.bottom;
5500 nat_height += border.top + border.bottom;
5503 *minimum_size = min_height;
5506 *natural_size = nat_height;
5510 * gtk_combo_box_set_id_column:
5511 * @combo_box: A #GtkComboBox
5512 * @id_column: A column in @model to get string IDs for values from
5514 * Sets the model column which @combo_box should use to get string IDs
5515 * for values from. The column @id_column in the model of @combo_box
5516 * must be of type %G_TYPE_STRING.
5521 gtk_combo_box_set_id_column (GtkComboBox *combo_box,
5524 GtkComboBoxPrivate *priv = combo_box->priv;
5525 GtkTreeModel *model;
5527 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5529 if (id_column != priv->id_column)
5531 model = gtk_combo_box_get_model (combo_box);
5533 g_return_if_fail (id_column >= 0);
5534 g_return_if_fail (model == NULL ||
5535 id_column < gtk_tree_model_get_n_columns (model));
5537 priv->id_column = id_column;
5539 g_object_notify (G_OBJECT (combo_box), "id-column");
5540 g_object_notify (G_OBJECT (combo_box), "active-id");
5545 * gtk_combo_box_get_id_column:
5546 * @combo_box: A #GtkComboBox
5548 * Returns the column which @combo_box is using to get string IDs
5551 * Return value: A column in the data source model of @combo_box.
5556 gtk_combo_box_get_id_column (GtkComboBox *combo_box)
5558 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
5560 return combo_box->priv->id_column;
5564 * gtk_combo_box_get_active_id:
5565 * @combo_box: a #GtkComboBox
5567 * Returns the ID of the active row of @combo_box. This value is taken
5568 * from the active row and the column specified by the 'id-column'
5569 * property of @combo_box (see gtk_combo_box_set_id_column()).
5571 * The returned value is an interned string which means that you can
5572 * compare the pointer by value to other interned strings and that you
5575 * If the 'id-column' property of @combo_box is not set or if no row is
5576 * selected then %NULL is returned.
5578 * Return value: the ID of the active row, or %NULL
5583 gtk_combo_box_get_active_id (GtkComboBox *combo_box)
5585 GtkTreeModel *model;
5589 g_return_val_if_fail (GTK_IS_COMBO_BOX (combo_box), 0);
5591 column = combo_box->priv->id_column;
5596 model = gtk_combo_box_get_model (combo_box);
5597 g_return_val_if_fail (gtk_tree_model_get_column_type (model, column) ==
5598 G_TYPE_STRING, NULL);
5600 if (gtk_combo_box_get_active_iter (combo_box, &iter))
5602 const gchar *interned;
5605 gtk_tree_model_get (model, &iter, column, &id, -1);
5606 interned = g_intern_string (id);
5616 * gtk_combo_box_set_active_id:
5617 * @combo_box: a #GtkComboBox
5618 * @active_id: the ID of the row to select
5620 * Changes the active row of @combo_box to the one that has an ID equal to @id.
5622 * If the 'id-column' property of @combo_box is unset or if no row has
5623 * the given ID then nothing happens.
5628 gtk_combo_box_set_active_id (GtkComboBox *combo_box,
5629 const gchar *active_id)
5631 GtkTreeModel *model;
5635 g_return_if_fail (GTK_IS_COMBO_BOX (combo_box));
5637 column = combo_box->priv->id_column;
5642 model = gtk_combo_box_get_model (combo_box);
5643 g_return_if_fail (gtk_tree_model_get_column_type (model, column) ==
5646 if (gtk_tree_model_get_iter_first (model, &iter))
5651 gtk_tree_model_get (model, &iter, column, &id, -1);
5652 match = strcmp (id, active_id) == 0;
5657 gtk_combo_box_set_active_iter (combo_box, &iter);
5660 } while (gtk_tree_model_iter_next (model, &iter));