/* * Copyright (C) 2012 Alexander Larsson * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see . */ #include "config.h" #include "gtkadjustmentprivate.h" #include "gtkcssnodeprivate.h" #include "gtklistbox.h" #include "gtkwidget.h" #include "gtkmarshalers.h" #include "gtkprivate.h" #include "gtkintl.h" #include "gtkwidgetprivate.h" #include "gtkcontainerprivate.h" #include "gtkcsscustomgadgetprivate.h" #include #include #include #include "a11y/gtklistboxaccessibleprivate.h" #include "a11y/gtklistboxrowaccessible.h" /** * SECTION:gtklistbox * @Short_description: A list container * @Title: GtkListBox * @See_also: #GtkScrolledWindow * * A GtkListBox is a vertical container that contains GtkListBoxRow * children. These rows can by dynamically sorted and filtered, and * headers can be added dynamically depending on the row content. * It also allows keyboard and mouse navigation and selection like * a typical list. * * Using GtkListBox is often an alternative to #GtkTreeView, especially * when the list contents has a more complicated layout than what is allowed * by a #GtkCellRenderer, or when the contents is interactive (i.e. has a * button in it). * * Although a #GtkListBox must have only #GtkListBoxRow children you can * add any kind of widget to it via gtk_container_add(), and a #GtkListBoxRow * widget will automatically be inserted between the list and the widget. * * #GtkListBoxRows can be marked as activatable or selectable. If a row * is activatable, #GtkListBox::row-activated will be emitted for it when * the user tries to activate it. If it is selectable, the row will be marked * as selected when the user tries to select it. * * The GtkListBox widget was added in GTK+ 3.10. * * # CSS nodes * * GtkListBox uses a single CSS node with name list. GtkListBoxRow uses * a single CSS node with name row. The row nodes get the .activatable * style class added when appropriate. */ typedef struct { GSequence *children; GHashTable *header_hash; GtkWidget *placeholder; GtkCssGadget *gadget; GtkListBoxSortFunc sort_func; gpointer sort_func_target; GDestroyNotify sort_func_target_destroy_notify; GtkListBoxFilterFunc filter_func; gpointer filter_func_target; GDestroyNotify filter_func_target_destroy_notify; GtkListBoxUpdateHeaderFunc update_header_func; gpointer update_header_func_target; GDestroyNotify update_header_func_target_destroy_notify; GtkListBoxRow *selected_row; GtkListBoxRow *prelight_row; GtkListBoxRow *cursor_row; gboolean active_row_active; GtkListBoxRow *active_row; GtkSelectionMode selection_mode; GtkAdjustment *adjustment; gboolean activate_single_click; GtkGesture *multipress_gesture; /* DnD */ GtkListBoxRow *drag_highlighted_row; int n_visible_rows; gboolean in_widget; GListModel *bound_model; GtkListBoxCreateWidgetFunc create_widget_func; gpointer create_widget_func_data; GDestroyNotify create_widget_func_data_destroy; } GtkListBoxPrivate; typedef struct { GSequenceIter *iter; GtkWidget *header; GtkCssGadget *gadget; gint y; gint height; guint visible :1; guint selected :1; guint activatable :1; guint selectable :1; } GtkListBoxRowPrivate; enum { ROW_SELECTED, ROW_ACTIVATED, ACTIVATE_CURSOR_ROW, TOGGLE_CURSOR_ROW, MOVE_CURSOR, SELECTED_ROWS_CHANGED, SELECT_ALL, UNSELECT_ALL, LAST_SIGNAL }; enum { ROW__ACTIVATE, ROW__LAST_SIGNAL }; enum { PROP_0, PROP_SELECTION_MODE, PROP_ACTIVATE_ON_SINGLE_CLICK, LAST_PROPERTY }; enum { ROW_PROP_0, ROW_PROP_ACTIVATABLE, ROW_PROP_SELECTABLE, LAST_ROW_PROPERTY }; #define BOX_PRIV(box) ((GtkListBoxPrivate*)gtk_list_box_get_instance_private ((GtkListBox*)(box))) #define ROW_PRIV(row) ((GtkListBoxRowPrivate*)gtk_list_box_row_get_instance_private ((GtkListBoxRow*)(row))) static void gtk_list_box_buildable_interface_init (GtkBuildableIface *iface); G_DEFINE_TYPE_WITH_CODE (GtkListBox, gtk_list_box, GTK_TYPE_CONTAINER, G_ADD_PRIVATE (GtkListBox) G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE, gtk_list_box_buildable_interface_init)) G_DEFINE_TYPE_WITH_PRIVATE (GtkListBoxRow, gtk_list_box_row, GTK_TYPE_BIN) static void gtk_list_box_apply_filter_all (GtkListBox *box); static void gtk_list_box_update_header (GtkListBox *box, GSequenceIter *iter); static GSequenceIter * gtk_list_box_get_next_visible (GtkListBox *box, GSequenceIter *iter); static void gtk_list_box_apply_filter (GtkListBox *box, GtkListBoxRow *row); static void gtk_list_box_add_move_binding (GtkBindingSet *binding_set, guint keyval, GdkModifierType modmask, GtkMovementStep step, gint count); static void gtk_list_box_update_cursor (GtkListBox *box, GtkListBoxRow *row, gboolean grab_focus); static void gtk_list_box_update_prelight (GtkListBox *box, GtkListBoxRow *row); static void gtk_list_box_update_active (GtkListBox *box, GtkListBoxRow *row); static gboolean gtk_list_box_enter_notify_event (GtkWidget *widget, GdkEventCrossing *event); static gboolean gtk_list_box_leave_notify_event (GtkWidget *widget, GdkEventCrossing *event); static gboolean gtk_list_box_motion_notify_event (GtkWidget *widget, GdkEventMotion *event); static void gtk_list_box_show (GtkWidget *widget); static gboolean gtk_list_box_focus (GtkWidget *widget, GtkDirectionType direction); static GSequenceIter* gtk_list_box_get_previous_visible (GtkListBox *box, GSequenceIter *iter); static GtkListBoxRow *gtk_list_box_get_first_focusable (GtkListBox *box); static GtkListBoxRow *gtk_list_box_get_last_focusable (GtkListBox *box); static gboolean gtk_list_box_draw (GtkWidget *widget, cairo_t *cr); static void gtk_list_box_realize (GtkWidget *widget); static void gtk_list_box_add (GtkContainer *container, GtkWidget *widget); static void gtk_list_box_remove (GtkContainer *container, GtkWidget *widget); static void gtk_list_box_forall (GtkContainer *container, gboolean include_internals, GtkCallback callback, gpointer callback_target); static void gtk_list_box_compute_expand (GtkWidget *widget, gboolean *hexpand, gboolean *vexpand); static GType gtk_list_box_child_type (GtkContainer *container); static GtkSizeRequestMode gtk_list_box_get_request_mode (GtkWidget *widget); static void gtk_list_box_size_allocate (GtkWidget *widget, GtkAllocation *allocation); static void gtk_list_box_drag_leave (GtkWidget *widget, GdkDragContext *context, guint time_); static void gtk_list_box_activate_cursor_row (GtkListBox *box); static void gtk_list_box_toggle_cursor_row (GtkListBox *box); static void gtk_list_box_move_cursor (GtkListBox *box, GtkMovementStep step, gint count); static void gtk_list_box_finalize (GObject *obj); static void gtk_list_box_parent_set (GtkWidget *widget, GtkWidget *prev_parent); static void gtk_list_box_get_preferred_height (GtkWidget *widget, gint *minimum_height, gint *natural_height); static void gtk_list_box_get_preferred_height_for_width (GtkWidget *widget, gint width, gint *minimum_height, gint *natural_height); static void gtk_list_box_get_preferred_width (GtkWidget *widget, gint *minimum_width, gint *natural_width); static void gtk_list_box_get_preferred_width_for_height (GtkWidget *widget, gint height, gint *minimum_width, gint *natural_width); static void gtk_list_box_select_row_internal (GtkListBox *box, GtkListBoxRow *row); static void gtk_list_box_unselect_row_internal (GtkListBox *box, GtkListBoxRow *row); static void gtk_list_box_select_all_between (GtkListBox *box, GtkListBoxRow *row1, GtkListBoxRow *row2, gboolean modify); static gboolean gtk_list_box_unselect_all_internal (GtkListBox *box); static void gtk_list_box_selected_rows_changed (GtkListBox *box); static void gtk_list_box_multipress_gesture_pressed (GtkGestureMultiPress *gesture, guint n_press, gdouble x, gdouble y, GtkListBox *box); static void gtk_list_box_multipress_gesture_released (GtkGestureMultiPress *gesture, guint n_press, gdouble x, gdouble y, GtkListBox *box); static void gtk_list_box_update_row_styles (GtkListBox *box); static void gtk_list_box_update_row_style (GtkListBox *box, GtkListBoxRow *row); static void gtk_list_box_bound_model_changed (GListModel *list, guint position, guint removed, guint added, gpointer user_data); static void gtk_list_box_check_model_compat (GtkListBox *box); static void gtk_list_box_measure (GtkCssGadget *gadget, GtkOrientation orientation, gint for_size, gint *minimum_size, gint *natural_size, gint *minimum_baseline, gint *natural_baseline, gpointer data); static void gtk_list_box_allocate (GtkCssGadget *gadget, const GtkAllocation *allocation, int baseline, GtkAllocation *out_clip, gpointer data); static gboolean gtk_list_box_render (GtkCssGadget *gadget, cairo_t *cr, int x, int y, int width, int height, gpointer data); static GParamSpec *properties[LAST_PROPERTY] = { NULL, }; static guint signals[LAST_SIGNAL] = { 0 }; static GParamSpec *row_properties[LAST_ROW_PROPERTY] = { NULL, }; static guint row_signals[ROW__LAST_SIGNAL] = { 0 }; /** * gtk_list_box_new: * * Creates a new #GtkListBox container. * * Returns: a new #GtkListBox * * Since: 3.10 */ GtkWidget * gtk_list_box_new (void) { return g_object_new (GTK_TYPE_LIST_BOX, NULL); } static void gtk_list_box_get_property (GObject *obj, guint property_id, GValue *value, GParamSpec *pspec) { GtkListBoxPrivate *priv = BOX_PRIV (obj); switch (property_id) { case PROP_SELECTION_MODE: g_value_set_enum (value, priv->selection_mode); break; case PROP_ACTIVATE_ON_SINGLE_CLICK: g_value_set_boolean (value, priv->activate_single_click); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (obj, property_id, pspec); break; } } static void gtk_list_box_set_property (GObject *obj, guint property_id, const GValue *value, GParamSpec *pspec) { GtkListBox *box = GTK_LIST_BOX (obj); switch (property_id) { case PROP_SELECTION_MODE: gtk_list_box_set_selection_mode (box, g_value_get_enum (value)); break; case PROP_ACTIVATE_ON_SINGLE_CLICK: gtk_list_box_set_activate_on_single_click (box, g_value_get_boolean (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (obj, property_id, pspec); break; } } static void gtk_list_box_finalize (GObject *obj) { GtkListBoxPrivate *priv = BOX_PRIV (obj); if (priv->sort_func_target_destroy_notify != NULL) priv->sort_func_target_destroy_notify (priv->sort_func_target); if (priv->filter_func_target_destroy_notify != NULL) priv->filter_func_target_destroy_notify (priv->filter_func_target); if (priv->update_header_func_target_destroy_notify != NULL) priv->update_header_func_target_destroy_notify (priv->update_header_func_target); g_clear_object (&priv->adjustment); g_clear_object (&priv->drag_highlighted_row); g_clear_object (&priv->multipress_gesture); g_sequence_free (priv->children); g_hash_table_unref (priv->header_hash); if (priv->bound_model) { if (priv->create_widget_func_data_destroy) priv->create_widget_func_data_destroy (priv->create_widget_func_data); g_signal_handlers_disconnect_by_func (priv->bound_model, gtk_list_box_bound_model_changed, obj); g_clear_object (&priv->bound_model); } g_clear_object (&priv->gadget); G_OBJECT_CLASS (gtk_list_box_parent_class)->finalize (obj); } static void gtk_list_box_class_init (GtkListBoxClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass); GtkBindingSet *binding_set; gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_LIST_BOX_ACCESSIBLE); object_class->get_property = gtk_list_box_get_property; object_class->set_property = gtk_list_box_set_property; object_class->finalize = gtk_list_box_finalize; widget_class->enter_notify_event = gtk_list_box_enter_notify_event; widget_class->leave_notify_event = gtk_list_box_leave_notify_event; widget_class->motion_notify_event = gtk_list_box_motion_notify_event; widget_class->show = gtk_list_box_show; widget_class->focus = gtk_list_box_focus; widget_class->draw = gtk_list_box_draw; widget_class->realize = gtk_list_box_realize; widget_class->compute_expand = gtk_list_box_compute_expand; widget_class->get_request_mode = gtk_list_box_get_request_mode; widget_class->get_preferred_height = gtk_list_box_get_preferred_height; widget_class->get_preferred_height_for_width = gtk_list_box_get_preferred_height_for_width; widget_class->get_preferred_width = gtk_list_box_get_preferred_width; widget_class->get_preferred_width_for_height = gtk_list_box_get_preferred_width_for_height; widget_class->size_allocate = gtk_list_box_size_allocate; widget_class->drag_leave = gtk_list_box_drag_leave; widget_class->parent_set = gtk_list_box_parent_set; container_class->add = gtk_list_box_add; container_class->remove = gtk_list_box_remove; container_class->forall = gtk_list_box_forall; container_class->child_type = gtk_list_box_child_type; klass->activate_cursor_row = gtk_list_box_activate_cursor_row; klass->toggle_cursor_row = gtk_list_box_toggle_cursor_row; klass->move_cursor = gtk_list_box_move_cursor; klass->select_all = gtk_list_box_select_all; klass->unselect_all = gtk_list_box_unselect_all; klass->selected_rows_changed = gtk_list_box_selected_rows_changed; properties[PROP_SELECTION_MODE] = g_param_spec_enum ("selection-mode", P_("Selection mode"), P_("The selection mode"), GTK_TYPE_SELECTION_MODE, GTK_SELECTION_SINGLE, G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); properties[PROP_ACTIVATE_ON_SINGLE_CLICK] = g_param_spec_boolean ("activate-on-single-click", P_("Activate on Single Click"), P_("Activate row on a single click"), TRUE, G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); g_object_class_install_properties (object_class, LAST_PROPERTY, properties); /** * GtkListBox::row-selected: * @box: the #GtkListBox * @row: (nullable): the selected row * * The ::row-selected signal is emitted when a new row is selected, or * (with a %NULL @row) when the selection is cleared. * * When the @box is using #GTK_SELECTION_MULTIPLE, this signal will not * give you the full picture of selection changes, and you should use * the #GtkListBox::selected-rows-changed signal instead. * * Since: 3.10 */ signals[ROW_SELECTED] = g_signal_new (I_("row-selected"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkListBoxClass, row_selected), NULL, NULL, g_cclosure_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GTK_TYPE_LIST_BOX_ROW); /** * GtkListBox::selected-rows-changed: * @box: the #GtkListBox on wich the signal is emitted * * The ::selected-rows-changed signal is emitted when the * set of selected rows changes. * * Since: 3.14 */ signals[SELECTED_ROWS_CHANGED] = g_signal_new (I_("selected-rows-changed"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkListBoxClass, selected_rows_changed), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkListBox::select-all: * @box: the #GtkListBox on which the signal is emitted * * The ::select-all signal is a [keybinding signal][GtkBindingSignal] * which gets emitted to select all children of the box, if the selection * mode permits it. * * The default bindings for this signal is Ctrl-a. * * Since: 3.14 */ signals[SELECT_ALL] = g_signal_new (I_("select-all"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkListBoxClass, select_all), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkListBox::unselect-all: * @box: the #GtkListBox on which the signal is emitted * * The ::unselect-all signal is a [keybinding signal][GtkBindingSignal] * which gets emitted to unselect all children of the box, if the selection * mode permits it. * * The default bindings for this signal is Ctrl-Shift-a. * * Since: 3.14 */ signals[UNSELECT_ALL] = g_signal_new (I_("unselect-all"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkListBoxClass, unselect_all), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); /** * GtkListBox::row-activated: * @box: the #GtkListBox * @row: the activated row * * The ::row-activated signal is emitted when a row has been activated by the user. * * Since: 3.10 */ signals[ROW_ACTIVATED] = g_signal_new (I_("row-activated"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GtkListBoxClass, row_activated), NULL, NULL, g_cclosure_marshal_VOID__OBJECT, G_TYPE_NONE, 1, GTK_TYPE_LIST_BOX_ROW); signals[ACTIVATE_CURSOR_ROW] = g_signal_new (I_("activate-cursor-row"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkListBoxClass, activate_cursor_row), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); signals[TOGGLE_CURSOR_ROW] = g_signal_new (I_("toggle-cursor-row"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkListBoxClass, toggle_cursor_row), NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); signals[MOVE_CURSOR] = g_signal_new (I_("move-cursor"), GTK_TYPE_LIST_BOX, G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkListBoxClass, move_cursor), NULL, NULL, _gtk_marshal_VOID__ENUM_INT, G_TYPE_NONE, 2, GTK_TYPE_MOVEMENT_STEP, G_TYPE_INT); widget_class->activate_signal = signals[ACTIVATE_CURSOR_ROW]; binding_set = gtk_binding_set_by_class (klass); gtk_list_box_add_move_binding (binding_set, GDK_KEY_Home, 0, GTK_MOVEMENT_BUFFER_ENDS, -1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_KP_Home, 0, GTK_MOVEMENT_BUFFER_ENDS, -1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_End, 0, GTK_MOVEMENT_BUFFER_ENDS, 1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_KP_End, 0, GTK_MOVEMENT_BUFFER_ENDS, 1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_KP_Up, 0, GTK_MOVEMENT_DISPLAY_LINES, -1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_KP_Down, 0, GTK_MOVEMENT_DISPLAY_LINES, 1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_KP_Page_Up, 0, GTK_MOVEMENT_PAGES, -1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); gtk_list_box_add_move_binding (binding_set, GDK_KEY_KP_Page_Down, 0, GTK_MOVEMENT_PAGES, 1); gtk_binding_entry_add_signal (binding_set, GDK_KEY_space, GDK_CONTROL_MASK, "toggle-cursor-row", 0, NULL); gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Space, GDK_CONTROL_MASK, "toggle-cursor-row", 0, NULL); gtk_binding_entry_add_signal (binding_set, GDK_KEY_a, GDK_CONTROL_MASK, "select-all", 0); gtk_binding_entry_add_signal (binding_set, GDK_KEY_a, GDK_CONTROL_MASK | GDK_SHIFT_MASK, "unselect-all", 0); gtk_widget_class_set_css_name (widget_class, "list"); } static void gtk_list_box_init (GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); GtkWidget *widget = GTK_WIDGET (box); GtkCssNode *widget_node; gtk_widget_set_has_window (widget, TRUE); gtk_widget_set_redraw_on_allocate (widget, TRUE); priv->selection_mode = GTK_SELECTION_SINGLE; priv->activate_single_click = TRUE; priv->children = g_sequence_new (NULL); priv->header_hash = g_hash_table_new_full (g_direct_hash, g_direct_equal, NULL, NULL); priv->multipress_gesture = gtk_gesture_multi_press_new (widget); gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (priv->multipress_gesture), GTK_PHASE_BUBBLE); gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (priv->multipress_gesture), FALSE); gtk_gesture_single_set_button (GTK_GESTURE_SINGLE (priv->multipress_gesture), GDK_BUTTON_PRIMARY); g_signal_connect (priv->multipress_gesture, "pressed", G_CALLBACK (gtk_list_box_multipress_gesture_pressed), box); g_signal_connect (priv->multipress_gesture, "released", G_CALLBACK (gtk_list_box_multipress_gesture_released), box); widget_node = gtk_widget_get_css_node (GTK_WIDGET (box)); priv->gadget = gtk_css_custom_gadget_new_for_node (widget_node, GTK_WIDGET (box), gtk_list_box_measure, gtk_list_box_allocate, gtk_list_box_render, NULL, NULL); } /** * gtk_list_box_get_selected_row: * @box: a #GtkListBox * * Gets the selected row. * * Note that the box may allow multiple selection, in which * case you should use gtk_list_box_selected_foreach() to * find all selected rows. * * Returns: (transfer none): the selected row * * Since: 3.10 */ GtkListBoxRow * gtk_list_box_get_selected_row (GtkListBox *box) { g_return_val_if_fail (GTK_IS_LIST_BOX (box), NULL); return BOX_PRIV (box)->selected_row; } /** * gtk_list_box_get_row_at_index: * @box: a #GtkListBox * @index_: the index of the row * * Gets the n-th child in the list (not counting headers). * If @_index is negative or larger than the number of items in the * list, %NULL is returned. * * Returns: (transfer none) (nullable): the child #GtkWidget or %NULL * * Since: 3.10 */ GtkListBoxRow * gtk_list_box_get_row_at_index (GtkListBox *box, gint index_) { GSequenceIter *iter; g_return_val_if_fail (GTK_IS_LIST_BOX (box), NULL); iter = g_sequence_get_iter_at_pos (BOX_PRIV (box)->children, index_); if (!g_sequence_iter_is_end (iter)) return g_sequence_get (iter); return NULL; } /** * gtk_list_box_get_row_at_y: * @box: a #GtkListBox * @y: position * * Gets the row at the @y position. * * Returns: (transfer none): the row * * Since: 3.10 */ GtkListBoxRow * gtk_list_box_get_row_at_y (GtkListBox *box, gint y) { GtkListBoxRow *row, *found_row; GtkListBoxRowPrivate *row_priv; GSequenceIter *iter; g_return_val_if_fail (GTK_IS_LIST_BOX (box), NULL); /* TODO: This should use g_sequence_search */ found_row = NULL; for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = (GtkListBoxRow*) g_sequence_get (iter); row_priv = ROW_PRIV (row); if (y >= row_priv->y && y < (row_priv->y + row_priv->height)) { found_row = row; break; } } return found_row; } /** * gtk_list_box_select_row: * @box: a #GtkListBox * @row: (allow-none): The row to select or %NULL * * Make @row the currently selected row. * * Since: 3.10 */ void gtk_list_box_select_row (GtkListBox *box, GtkListBoxRow *row) { gboolean dirty = FALSE; g_return_if_fail (GTK_IS_LIST_BOX (box)); g_return_if_fail (row == NULL || GTK_IS_LIST_BOX_ROW (row)); if (row) gtk_list_box_select_row_internal (box, row); else dirty = gtk_list_box_unselect_all_internal (box); if (dirty) { g_signal_emit (box, signals[ROW_SELECTED], 0, NULL); g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } } /** * gtk_list_box_unselect_row: * @box: a #GtkListBox * @row: the row to unselected * * Unselects a single row of @box, if the selection mode allows it. * * Since: 3.14 */ void gtk_list_box_unselect_row (GtkListBox *box, GtkListBoxRow *row) { g_return_if_fail (GTK_IS_LIST_BOX (box)); g_return_if_fail (GTK_IS_LIST_BOX_ROW (row)); gtk_list_box_unselect_row_internal (box, row); } /** * gtk_list_box_select_all: * @box: a #GtkListBox * * Select all children of @box, if the selection mode allows it. * * Since: 3.14 */ void gtk_list_box_select_all (GtkListBox *box) { g_return_if_fail (GTK_IS_LIST_BOX (box)); if (BOX_PRIV (box)->selection_mode != GTK_SELECTION_MULTIPLE) return; if (g_sequence_get_length (BOX_PRIV (box)->children) > 0) { gtk_list_box_select_all_between (box, NULL, NULL, FALSE); g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } } /** * gtk_list_box_unselect_all: * @box: a #GtkListBox * * Unselect all children of @box, if the selection mode allows it. * * Since: 3.14 */ void gtk_list_box_unselect_all (GtkListBox *box) { gboolean dirty = FALSE; g_return_if_fail (GTK_IS_LIST_BOX (box)); if (BOX_PRIV (box)->selection_mode == GTK_SELECTION_BROWSE) return; dirty = gtk_list_box_unselect_all_internal (box); if (dirty) { g_signal_emit (box, signals[ROW_SELECTED], 0, NULL); g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } } static void gtk_list_box_selected_rows_changed (GtkListBox *box) { _gtk_list_box_accessible_selection_changed (box); } /** * GtkListBoxForeachFunc: * @box: a #GtkListBox * @row: a #GtkListBoxRow * @user_data: (closure): user data * * A function used by gtk_list_box_selected_foreach(). * It will be called on every selected child of the @box. * * Since: 3.14 */ /** * gtk_list_box_selected_foreach: * @box: a #GtkListBox * @func: (scope call): the function to call for each selected child * @data: user data to pass to the function * * Calls a function for each selected child. * * Note that the selection cannot be modified from within this function. * * Since: 3.14 */ void gtk_list_box_selected_foreach (GtkListBox *box, GtkListBoxForeachFunc func, gpointer data) { GtkListBoxRow *row; GSequenceIter *iter; g_return_if_fail (GTK_IS_LIST_BOX (box)); for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = g_sequence_get (iter); if (gtk_list_box_row_is_selected (row)) (*func) (box, row, data); } } /** * gtk_list_box_get_selected_rows: * @box: a #GtkListBox * * Creates a list of all selected children. * * Returns: (element-type GtkListBoxRow) (transfer container): * A #GList containing the #GtkWidget for each selected child. * Free with g_list_free() when done. * * Since: 3.14 */ GList * gtk_list_box_get_selected_rows (GtkListBox *box) { GtkListBoxRow *row; GSequenceIter *iter; GList *selected = NULL; g_return_val_if_fail (GTK_IS_LIST_BOX (box), NULL); for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = g_sequence_get (iter); if (gtk_list_box_row_is_selected (row)) selected = g_list_prepend (selected, row); } return g_list_reverse (selected); } /** * gtk_list_box_set_placeholder: * @box: a #GtkListBox * @placeholder: (allow-none): a #GtkWidget or %NULL * * Sets the placeholder widget that is shown in the list when * it doesn't display any visible children. * * Since: 3.10 */ void gtk_list_box_set_placeholder (GtkListBox *box, GtkWidget *placeholder) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); if (priv->placeholder) { gtk_widget_unparent (priv->placeholder); gtk_widget_queue_resize (GTK_WIDGET (box)); } priv->placeholder = placeholder; if (placeholder) { gtk_widget_set_parent (GTK_WIDGET (placeholder), GTK_WIDGET (box)); gtk_widget_set_child_visible (GTK_WIDGET (placeholder), priv->n_visible_rows == 0); } } /** * gtk_list_box_set_adjustment: * @box: a #GtkListBox * @adjustment: (allow-none): the adjustment, or %NULL * * Sets the adjustment (if any) that the widget uses to * for vertical scrolling. For instance, this is used * to get the page size for PageUp/Down key handling. * * In the normal case when the @box is packed inside * a #GtkScrolledWindow the adjustment from that will * be picked up automatically, so there is no need * to manually do that. * * Since: 3.10 */ void gtk_list_box_set_adjustment (GtkListBox *box, GtkAdjustment *adjustment) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); g_return_if_fail (adjustment == NULL || GTK_IS_ADJUSTMENT (adjustment)); if (adjustment) g_object_ref_sink (adjustment); if (priv->adjustment) g_object_unref (priv->adjustment); priv->adjustment = adjustment; } /** * gtk_list_box_get_adjustment: * @box: a #GtkListBox * * Gets the adjustment (if any) that the widget uses to * for vertical scrolling. * * Returns: (transfer none): the adjustment * * Since: 3.10 */ GtkAdjustment * gtk_list_box_get_adjustment (GtkListBox *box) { g_return_val_if_fail (GTK_IS_LIST_BOX (box), NULL); return BOX_PRIV (box)->adjustment; } static void adjustment_changed (GObject *object, GParamSpec *pspec, gpointer data) { GtkAdjustment *adjustment; adjustment = gtk_scrollable_get_vadjustment (GTK_SCROLLABLE (object)); gtk_list_box_set_adjustment (GTK_LIST_BOX (data), adjustment); } static void gtk_list_box_parent_set (GtkWidget *widget, GtkWidget *prev_parent) { GtkWidget *parent; parent = gtk_widget_get_parent (widget); if (prev_parent && GTK_IS_SCROLLABLE (prev_parent)) g_signal_handlers_disconnect_by_func (prev_parent, G_CALLBACK (adjustment_changed), widget); if (parent && GTK_IS_SCROLLABLE (parent)) { adjustment_changed (G_OBJECT (parent), NULL, widget); g_signal_connect (parent, "notify::vadjustment", G_CALLBACK (adjustment_changed), widget); } else gtk_list_box_set_adjustment (GTK_LIST_BOX (widget), NULL); } /** * gtk_list_box_set_selection_mode: * @box: a #GtkListBox * @mode: The #GtkSelectionMode * * Sets how selection works in the listbox. * See #GtkSelectionMode for details. * * Since: 3.10 */ void gtk_list_box_set_selection_mode (GtkListBox *box, GtkSelectionMode mode) { GtkListBoxPrivate *priv = BOX_PRIV (box); gboolean dirty = FALSE; g_return_if_fail (GTK_IS_LIST_BOX (box)); if (priv->selection_mode == mode) return; if (mode == GTK_SELECTION_NONE || priv->selection_mode == GTK_SELECTION_MULTIPLE) dirty = gtk_list_box_unselect_all_internal (box); priv->selection_mode = mode; gtk_list_box_update_row_styles (box); g_object_notify_by_pspec (G_OBJECT (box), properties[PROP_SELECTION_MODE]); if (dirty) { g_signal_emit (box, signals[ROW_SELECTED], 0, NULL); g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } } /** * gtk_list_box_get_selection_mode: * @box: a #GtkListBox * * Gets the selection mode of the listbox. * * Returns: a #GtkSelectionMode * * Since: 3.10 */ GtkSelectionMode gtk_list_box_get_selection_mode (GtkListBox *box) { g_return_val_if_fail (GTK_IS_LIST_BOX (box), GTK_SELECTION_NONE); return BOX_PRIV (box)->selection_mode; } /** * gtk_list_box_set_filter_func: * @box: a #GtkListBox * @filter_func: (closure user_data) (allow-none): callback that lets you filter which rows to show * @user_data: user data passed to @filter_func * @destroy: destroy notifier for @user_data * * By setting a filter function on the @box one can decide dynamically which * of the rows to show. For instance, to implement a search function on a list that * filters the original list to only show the matching rows. * * The @filter_func will be called for each row after the call, and it will * continue to be called each time a row changes (via gtk_list_box_row_changed()) or * when gtk_list_box_invalidate_filter() is called. * * Note that using a filter function is incompatible with using a model * (see gtk_list_box_bind_model()). * * Since: 3.10 */ void gtk_list_box_set_filter_func (GtkListBox *box, GtkListBoxFilterFunc filter_func, gpointer user_data, GDestroyNotify destroy) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); if (priv->filter_func_target_destroy_notify != NULL) priv->filter_func_target_destroy_notify (priv->filter_func_target); priv->filter_func = filter_func; priv->filter_func_target = user_data; priv->filter_func_target_destroy_notify = destroy; gtk_list_box_check_model_compat (box); gtk_list_box_invalidate_filter (box); } /** * gtk_list_box_set_header_func: * @box: a #GtkListBox * @update_header: (closure user_data) (allow-none): callback that lets you add row headers * @user_data: user data passed to @update_header * @destroy: destroy notifier for @user_data * * By setting a header function on the @box one can dynamically add headers * in front of rows, depending on the contents of the row and its position in the list. * For instance, one could use it to add headers in front of the first item of a * new kind, in a list sorted by the kind. * * The @update_header can look at the current header widget using gtk_list_box_row_get_header() * and either update the state of the widget as needed, or set a new one using * gtk_list_box_row_set_header(). If no header is needed, set the header to %NULL. * * Note that you may get many calls @update_header to this for a particular row when e.g. * changing things that don’t affect the header. In this case it is important for performance * to not blindly replace an existing header with an identical one. * * The @update_header function will be called for each row after the call, and it will * continue to be called each time a row changes (via gtk_list_box_row_changed()) and when * the row before changes (either by gtk_list_box_row_changed() on the previous row, or when * the previous row becomes a different row). It is also called for all rows when * gtk_list_box_invalidate_headers() is called. * * Since: 3.10 */ void gtk_list_box_set_header_func (GtkListBox *box, GtkListBoxUpdateHeaderFunc update_header, gpointer user_data, GDestroyNotify destroy) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); if (priv->update_header_func_target_destroy_notify != NULL) priv->update_header_func_target_destroy_notify (priv->update_header_func_target); priv->update_header_func = update_header; priv->update_header_func_target = user_data; priv->update_header_func_target_destroy_notify = destroy; gtk_list_box_invalidate_headers (box); } /** * gtk_list_box_invalidate_filter: * @box: a #GtkListBox * * Update the filtering for all rows. Call this when result * of the filter function on the @box is changed due * to an external factor. For instance, this would be used * if the filter function just looked for a specific search * string and the entry with the search string has changed. * * Since: 3.10 */ void gtk_list_box_invalidate_filter (GtkListBox *box) { g_return_if_fail (GTK_IS_LIST_BOX (box)); gtk_list_box_apply_filter_all (box); gtk_list_box_invalidate_headers (box); gtk_widget_queue_resize (GTK_WIDGET (box)); } static gint do_sort (GtkListBoxRow *a, GtkListBoxRow *b, GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); return priv->sort_func (a, b, priv->sort_func_target); } static void gtk_list_box_css_node_foreach (gpointer data, gpointer user_data) { GtkWidget **previous = user_data; GtkWidget *row = data; GtkCssNode *row_node; GtkCssNode *prev_node; if (*previous) { prev_node = gtk_widget_get_css_node (*previous); row_node = gtk_widget_get_css_node (row); gtk_css_node_insert_after (gtk_css_node_get_parent (row_node), row_node, prev_node); } *previous = row; } /** * gtk_list_box_invalidate_sort: * @box: a #GtkListBox * * Update the sorting for all rows. Call this when result * of the sort function on the @box is changed due * to an external factor. * * Since: 3.10 */ void gtk_list_box_invalidate_sort (GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); GtkWidget *previous = NULL; g_return_if_fail (GTK_IS_LIST_BOX (box)); g_sequence_sort (priv->children, (GCompareDataFunc)do_sort, box); g_sequence_foreach (priv->children, gtk_list_box_css_node_foreach, &previous); gtk_list_box_invalidate_headers (box); gtk_widget_queue_resize (GTK_WIDGET (box)); } static void gtk_list_box_do_reseparate (GtkListBox *box) { GSequenceIter *iter; for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) gtk_list_box_update_header (box, iter); gtk_widget_queue_resize (GTK_WIDGET (box)); } /** * gtk_list_box_invalidate_headers: * @box: a #GtkListBox * * Update the separators for all rows. Call this when result * of the header function on the @box is changed due * to an external factor. * * Since: 3.10 */ void gtk_list_box_invalidate_headers (GtkListBox *box) { g_return_if_fail (GTK_IS_LIST_BOX (box)); if (!gtk_widget_get_visible (GTK_WIDGET (box))) return; gtk_list_box_do_reseparate (box); } /** * gtk_list_box_set_sort_func: * @box: a #GtkListBox * @sort_func: (closure user_data) (allow-none): the sort function * @user_data: user data passed to @sort_func * @destroy: destroy notifier for @user_data * * By setting a sort function on the @box one can dynamically reorder the rows * of the list, based on the contents of the rows. * * The @sort_func will be called for each row after the call, and will continue to * be called each time a row changes (via gtk_list_box_row_changed()) and when * gtk_list_box_invalidate_sort() is called. * * Note that using a sort function is incompatible with using a model * (see gtk_list_box_bind_model()). * * Since: 3.10 */ void gtk_list_box_set_sort_func (GtkListBox *box, GtkListBoxSortFunc sort_func, gpointer user_data, GDestroyNotify destroy) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); if (priv->sort_func_target_destroy_notify != NULL) priv->sort_func_target_destroy_notify (priv->sort_func_target); priv->sort_func = sort_func; priv->sort_func_target = user_data; priv->sort_func_target_destroy_notify = destroy; gtk_list_box_check_model_compat (box); gtk_list_box_invalidate_sort (box); } static void gtk_list_box_got_row_changed (GtkListBox *box, GtkListBoxRow *row) { GtkListBoxPrivate *priv = BOX_PRIV (box); GtkListBoxRowPrivate *row_priv = ROW_PRIV (row); GSequenceIter *prev_next, *next; g_return_if_fail (GTK_IS_LIST_BOX (box)); g_return_if_fail (GTK_IS_LIST_BOX_ROW (row)); prev_next = gtk_list_box_get_next_visible (box, row_priv->iter); if (priv->sort_func != NULL) { g_sequence_sort_changed (row_priv->iter, (GCompareDataFunc)do_sort, box); gtk_widget_queue_resize (GTK_WIDGET (box)); } gtk_list_box_apply_filter (box, row); if (gtk_widget_get_visible (GTK_WIDGET (box))) { next = gtk_list_box_get_next_visible (box, row_priv->iter); gtk_list_box_update_header (box, row_priv->iter); gtk_list_box_update_header (box, next); gtk_list_box_update_header (box, prev_next); } } /** * gtk_list_box_set_activate_on_single_click: * @box: a #GtkListBox * @single: a boolean * * If @single is %TRUE, rows will be activated when you click on them, * otherwise you need to double-click. * * Since: 3.10 */ void gtk_list_box_set_activate_on_single_click (GtkListBox *box, gboolean single) { g_return_if_fail (GTK_IS_LIST_BOX (box)); single = single != FALSE; if (BOX_PRIV (box)->activate_single_click == single) return; BOX_PRIV (box)->activate_single_click = single; g_object_notify_by_pspec (G_OBJECT (box), properties[PROP_ACTIVATE_ON_SINGLE_CLICK]); } /** * gtk_list_box_get_activate_on_single_click: * @box: a #GtkListBox * * Returns whether rows activate on single clicks. * * Returns: %TRUE if rows are activated on single click, %FALSE otherwise * * Since: 3.10 */ gboolean gtk_list_box_get_activate_on_single_click (GtkListBox *box) { g_return_val_if_fail (GTK_IS_LIST_BOX (box), FALSE); return BOX_PRIV (box)->activate_single_click; } static void gtk_list_box_add_move_binding (GtkBindingSet *binding_set, guint keyval, GdkModifierType modmask, GtkMovementStep step, gint count) { GdkDisplay *display; GdkModifierType extend_mod_mask = GDK_SHIFT_MASK; GdkModifierType modify_mod_mask = GDK_CONTROL_MASK; display = gdk_display_get_default (); if (display) { extend_mod_mask = gdk_keymap_get_modifier_mask (gdk_keymap_get_for_display (display), GDK_MODIFIER_INTENT_EXTEND_SELECTION); modify_mod_mask = gdk_keymap_get_modifier_mask (gdk_keymap_get_for_display (display), GDK_MODIFIER_INTENT_MODIFY_SELECTION); } gtk_binding_entry_add_signal (binding_set, keyval, modmask, "move-cursor", 2, GTK_TYPE_MOVEMENT_STEP, step, G_TYPE_INT, count, NULL); gtk_binding_entry_add_signal (binding_set, keyval, modmask | extend_mod_mask, "move-cursor", 2, GTK_TYPE_MOVEMENT_STEP, step, G_TYPE_INT, count, NULL); gtk_binding_entry_add_signal (binding_set, keyval, modmask | modify_mod_mask, "move-cursor", 2, GTK_TYPE_MOVEMENT_STEP, step, G_TYPE_INT, count, NULL); gtk_binding_entry_add_signal (binding_set, keyval, modmask | extend_mod_mask | modify_mod_mask, "move-cursor", 2, GTK_TYPE_MOVEMENT_STEP, step, G_TYPE_INT, count, NULL); } static void ensure_row_visible (GtkListBox *box, GtkListBoxRow *row) { GtkListBoxPrivate *priv = BOX_PRIV (box); GtkWidget *header; gint y, height; GtkAllocation allocation; if (!priv->adjustment) return; gtk_widget_get_allocation (GTK_WIDGET (row), &allocation); y = allocation.y; height = allocation.height; /* If the row has a header, we want to ensure that it is visible as well. */ header = ROW_PRIV (row)->header; if (GTK_IS_WIDGET (header) && gtk_widget_is_drawable (header)) { gtk_widget_get_allocation (header, &allocation); y = allocation.y; height += allocation.height; } gtk_adjustment_clamp_page (priv->adjustment, y, y + height); } static void gtk_list_box_update_cursor (GtkListBox *box, GtkListBoxRow *row, gboolean grab_focus) { BOX_PRIV (box)->cursor_row = row; ensure_row_visible (box, row); if (grab_focus) gtk_widget_grab_focus (GTK_WIDGET (row)); gtk_widget_queue_draw (GTK_WIDGET (row)); _gtk_list_box_accessible_update_cursor (box, row); } static GtkListBox * gtk_list_box_row_get_box (GtkListBoxRow *row) { GtkWidget *parent; parent = gtk_widget_get_parent (GTK_WIDGET (row)); if (parent && GTK_IS_LIST_BOX (parent)) return GTK_LIST_BOX (parent); return NULL; } static gboolean row_is_visible (GtkListBoxRow *row) { return ROW_PRIV (row)->visible; } static gboolean gtk_list_box_row_set_selected (GtkListBoxRow *row, gboolean selected) { if (!ROW_PRIV (row)->selectable) return FALSE; if (ROW_PRIV (row)->selected != selected) { ROW_PRIV (row)->selected = selected; if (selected) gtk_widget_set_state_flags (GTK_WIDGET (row), GTK_STATE_FLAG_SELECTED, FALSE); else gtk_widget_unset_state_flags (GTK_WIDGET (row), GTK_STATE_FLAG_SELECTED); return TRUE; } return FALSE; } static gboolean gtk_list_box_unselect_all_internal (GtkListBox *box) { GtkListBoxRow *row; GSequenceIter *iter; gboolean dirty = FALSE; if (BOX_PRIV (box)->selection_mode == GTK_SELECTION_NONE) return FALSE; for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = g_sequence_get (iter); dirty |= gtk_list_box_row_set_selected (row, FALSE); } BOX_PRIV (box)->selected_row = NULL; return dirty; } static void gtk_list_box_unselect_row_internal (GtkListBox *box, GtkListBoxRow *row) { if (!ROW_PRIV (row)->selected) return; if (BOX_PRIV (box)->selection_mode == GTK_SELECTION_NONE) return; else if (BOX_PRIV (box)->selection_mode != GTK_SELECTION_MULTIPLE) gtk_list_box_unselect_all_internal (box); else gtk_list_box_row_set_selected (row, FALSE); g_signal_emit (box, signals[ROW_SELECTED], 0, NULL); g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } static void gtk_list_box_select_row_internal (GtkListBox *box, GtkListBoxRow *row) { if (!ROW_PRIV (row)->selectable) return; if (ROW_PRIV (row)->selected) return; if (BOX_PRIV (box)->selection_mode == GTK_SELECTION_NONE) return; if (BOX_PRIV (box)->selection_mode != GTK_SELECTION_MULTIPLE) gtk_list_box_unselect_all_internal (box); gtk_list_box_row_set_selected (row, TRUE); BOX_PRIV (box)->selected_row = row; g_signal_emit (box, signals[ROW_SELECTED], 0, row); g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } static void gtk_list_box_select_all_between (GtkListBox *box, GtkListBoxRow *row1, GtkListBoxRow *row2, gboolean modify) { GSequenceIter *iter, *iter1, *iter2; if (row1) iter1 = ROW_PRIV (row1)->iter; else iter1 = g_sequence_get_begin_iter (BOX_PRIV (box)->children); if (row2) iter2 = ROW_PRIV (row2)->iter; else iter2 = g_sequence_get_end_iter (BOX_PRIV (box)->children); if (g_sequence_iter_compare (iter2, iter1) < 0) { iter = iter1; iter1 = iter2; iter2 = iter; } for (iter = iter1; !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { GtkListBoxRow *row; row = GTK_LIST_BOX_ROW (g_sequence_get (iter)); if (row_is_visible (row)) { if (modify) gtk_list_box_row_set_selected (row, !ROW_PRIV (row)->selected); else gtk_list_box_row_set_selected (row, TRUE); } if (g_sequence_iter_compare (iter, iter2) == 0) break; } } #define gtk_list_box_update_selection(b,r,m,e) \ gtk_list_box_update_selection_full((b), (r), (m), (e), TRUE) static void gtk_list_box_update_selection_full (GtkListBox *box, GtkListBoxRow *row, gboolean modify, gboolean extend, gboolean grab_cursor) { GtkListBoxPrivate *priv = BOX_PRIV (box); gtk_list_box_update_cursor (box, row, grab_cursor); if (priv->selection_mode == GTK_SELECTION_NONE) return; if (!ROW_PRIV (row)->selectable) return; if (priv->selection_mode == GTK_SELECTION_BROWSE) { gtk_list_box_unselect_all_internal (box); gtk_list_box_row_set_selected (row, TRUE); g_signal_emit (box, signals[ROW_SELECTED], 0, row); priv->selected_row = row; } else if (priv->selection_mode == GTK_SELECTION_SINGLE) { gboolean was_selected; was_selected = ROW_PRIV (row)->selected; gtk_list_box_unselect_all_internal (box); gtk_list_box_row_set_selected (row, modify ? !was_selected : TRUE); priv->selected_row = ROW_PRIV (row)->selected ? row : NULL; g_signal_emit (box, signals[ROW_SELECTED], 0, priv->selected_row); } else /* GTK_SELECTION_MULTIPLE */ { if (extend) { GtkListBoxRow *selected_row; selected_row = priv->selected_row; gtk_list_box_unselect_all_internal (box); if (selected_row == NULL) { gtk_list_box_row_set_selected (row, TRUE); priv->selected_row = row; g_signal_emit (box, signals[ROW_SELECTED], 0, row); } else gtk_list_box_select_all_between (box, selected_row, row, FALSE); } else { if (modify) { gtk_list_box_row_set_selected (row, !ROW_PRIV (row)->selected); g_signal_emit (box, signals[ROW_SELECTED], 0, ROW_PRIV (row)->selected ? row : NULL); } else { gtk_list_box_unselect_all_internal (box); gtk_list_box_row_set_selected (row, !ROW_PRIV (row)->selected); priv->selected_row = row; g_signal_emit (box, signals[ROW_SELECTED], 0, row); } } } g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } static void gtk_list_box_activate (GtkListBox *box, GtkListBoxRow *row) { if (gtk_list_box_row_get_activatable (row)) g_signal_emit (box, signals[ROW_ACTIVATED], 0, row); } #define gtk_list_box_select_and_activate(b,r) \ gtk_list_box_select_and_activate_full ((b), (r), TRUE) static void gtk_list_box_select_and_activate_full (GtkListBox *box, GtkListBoxRow *row, gboolean grab_focus) { if (row != NULL) { gtk_list_box_select_row_internal (box, row); gtk_list_box_update_cursor (box, row, grab_focus); gtk_list_box_activate (box, row); } } static void gtk_list_box_update_prelight (GtkListBox *box, GtkListBoxRow *row) { GtkListBoxPrivate *priv = BOX_PRIV (box); if (row != priv->prelight_row) { if (priv->prelight_row) gtk_widget_unset_state_flags (GTK_WIDGET (priv->prelight_row), GTK_STATE_FLAG_PRELIGHT); if (row != NULL && gtk_widget_is_sensitive (GTK_WIDGET (row))) { priv->prelight_row = row; gtk_widget_set_state_flags (GTK_WIDGET (priv->prelight_row), GTK_STATE_FLAG_PRELIGHT, FALSE); } else { priv->prelight_row = NULL; } } } static void gtk_list_box_update_active (GtkListBox *box, GtkListBoxRow *row) { GtkListBoxPrivate *priv = BOX_PRIV (box); gboolean val; val = priv->active_row == row; if (priv->active_row != NULL && val != priv->active_row_active) { priv->active_row_active = val; if (priv->active_row_active) gtk_widget_set_state_flags (GTK_WIDGET (priv->active_row), GTK_STATE_FLAG_ACTIVE, FALSE); else gtk_widget_unset_state_flags (GTK_WIDGET (priv->active_row), GTK_STATE_FLAG_ACTIVE); } } static gboolean gtk_list_box_enter_notify_event (GtkWidget *widget, GdkEventCrossing *event) { GtkListBox *box = GTK_LIST_BOX (widget); GtkListBoxRow *row; if (event->window != gtk_widget_get_window (widget)) return FALSE; BOX_PRIV (box)->in_widget = TRUE; row = gtk_list_box_get_row_at_y (box, event->y); gtk_list_box_update_prelight (box, row); gtk_list_box_update_active (box, row); return FALSE; } static gboolean gtk_list_box_leave_notify_event (GtkWidget *widget, GdkEventCrossing *event) { GtkListBox *box = GTK_LIST_BOX (widget); GtkListBoxRow *row = NULL; if (event->window != gtk_widget_get_window (widget)) return FALSE; if (event->detail != GDK_NOTIFY_INFERIOR) { BOX_PRIV (box)->in_widget = FALSE; row = NULL; } else row = gtk_list_box_get_row_at_y (box, event->y); gtk_list_box_update_prelight (box, row); gtk_list_box_update_active (box, row); return FALSE; } static gboolean gtk_list_box_motion_notify_event (GtkWidget *widget, GdkEventMotion *event) { GtkListBox *box = GTK_LIST_BOX (widget); GtkListBoxRow *row; GdkWindow *window, *event_window; gint relative_y; gdouble parent_y; if (!BOX_PRIV (box)->in_widget) return FALSE; window = gtk_widget_get_window (widget); event_window = event->window; relative_y = event->y; while ((event_window != NULL) && (event_window != window)) { gdk_window_coords_to_parent (event_window, 0, relative_y, NULL, &parent_y); relative_y = parent_y; event_window = gdk_window_get_effective_parent (event_window); } row = gtk_list_box_get_row_at_y (box, relative_y); gtk_list_box_update_prelight (box, row); gtk_list_box_update_active (box, row); return FALSE; } static void gtk_list_box_multipress_gesture_pressed (GtkGestureMultiPress *gesture, guint n_press, gdouble x, gdouble y, GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); GtkListBoxRow *row; priv->active_row = NULL; row = gtk_list_box_get_row_at_y (box, y); if (row != NULL && gtk_widget_is_sensitive (GTK_WIDGET (row))) { priv->active_row = row; priv->active_row_active = TRUE; gtk_widget_set_state_flags (GTK_WIDGET (priv->active_row), GTK_STATE_FLAG_ACTIVE, FALSE); gtk_widget_queue_draw (GTK_WIDGET (box)); if (n_press == 2 && !priv->activate_single_click) gtk_list_box_activate (box, row); } } static void get_current_selection_modifiers (GtkWidget *widget, gboolean *modify, gboolean *extend) { GdkModifierType state = 0; GdkModifierType mask; *modify = FALSE; *extend = FALSE; if (gtk_get_current_event_state (&state)) { mask = gtk_widget_get_modifier_mask (widget, GDK_MODIFIER_INTENT_MODIFY_SELECTION); if ((state & mask) == mask) *modify = TRUE; mask = gtk_widget_get_modifier_mask (widget, GDK_MODIFIER_INTENT_EXTEND_SELECTION); if ((state & mask) == mask) *extend = TRUE; } } static void gtk_list_box_multipress_gesture_released (GtkGestureMultiPress *gesture, guint n_press, gdouble x, gdouble y, GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); /* Take a ref to protect against reentrancy * (the activation may destroy the widget) */ g_object_ref (box); if (priv->active_row != NULL && priv->active_row_active) { gboolean focus_on_click = gtk_widget_get_focus_on_click (GTK_WIDGET (priv->active_row)); gtk_widget_unset_state_flags (GTK_WIDGET (priv->active_row), GTK_STATE_FLAG_ACTIVE); if (n_press == 1 && priv->activate_single_click) gtk_list_box_select_and_activate_full (box, priv->active_row, focus_on_click); else { GdkEventSequence *sequence; GdkInputSource source; const GdkEvent *event; gboolean modify; gboolean extend; get_current_selection_modifiers (GTK_WIDGET (box), &modify, &extend); /* With touch, we default to modifying the selection. * You can still clear the selection and start over * by holding Ctrl. */ sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture)); event = gtk_gesture_get_last_event (GTK_GESTURE (gesture), sequence); source = gdk_device_get_source (gdk_event_get_source_device (event)); if (source == GDK_SOURCE_TOUCHSCREEN) modify = !modify; gtk_list_box_update_selection_full (box, priv->active_row, modify, extend, focus_on_click); } } priv->active_row = NULL; priv->active_row_active = FALSE; gtk_widget_queue_draw (GTK_WIDGET (box)); g_object_unref (box); } static void gtk_list_box_show (GtkWidget *widget) { gtk_list_box_do_reseparate (GTK_LIST_BOX (widget)); GTK_WIDGET_CLASS (gtk_list_box_parent_class)->show (widget); } static gboolean gtk_list_box_focus (GtkWidget *widget, GtkDirectionType direction) { GtkListBox *box = GTK_LIST_BOX (widget); GtkListBoxPrivate *priv = BOX_PRIV (box); GtkWidget *focus_child; GtkListBoxRow *next_focus_row; GtkWidget *row; GtkWidget *header; focus_child = gtk_container_get_focus_child ((GtkContainer *)box); next_focus_row = NULL; if (focus_child != NULL) { GSequenceIter *i; if (gtk_widget_child_focus (focus_child, direction)) return TRUE; if (direction == GTK_DIR_UP || direction == GTK_DIR_TAB_BACKWARD) { if (GTK_IS_LIST_BOX_ROW (focus_child)) { header = ROW_PRIV (GTK_LIST_BOX_ROW (focus_child))->header; if (header && gtk_widget_child_focus (header, direction)) return TRUE; } if (GTK_IS_LIST_BOX_ROW (focus_child)) row = focus_child; else row = g_hash_table_lookup (priv->header_hash, focus_child); if (GTK_IS_LIST_BOX_ROW (row)) i = gtk_list_box_get_previous_visible (box, ROW_PRIV (GTK_LIST_BOX_ROW (row))->iter); else i = NULL; while (i != NULL) { if (gtk_widget_get_sensitive (g_sequence_get (i))) { next_focus_row = g_sequence_get (i); break; } i = gtk_list_box_get_previous_visible (box, i); } } else if (direction == GTK_DIR_DOWN || direction == GTK_DIR_TAB_FORWARD) { if (GTK_IS_LIST_BOX_ROW (focus_child)) i = gtk_list_box_get_next_visible (box, ROW_PRIV (GTK_LIST_BOX_ROW (focus_child))->iter); else { row = g_hash_table_lookup (priv->header_hash, focus_child); if (GTK_IS_LIST_BOX_ROW (row)) i = ROW_PRIV (GTK_LIST_BOX_ROW (row))->iter; else i = NULL; } while (!g_sequence_iter_is_end (i)) { if (gtk_widget_get_sensitive (g_sequence_get (i))) { next_focus_row = g_sequence_get (i); break; } i = gtk_list_box_get_next_visible (box, i); } } } else { /* No current focus row */ switch (direction) { case GTK_DIR_UP: case GTK_DIR_TAB_BACKWARD: next_focus_row = priv->selected_row; if (next_focus_row == NULL) next_focus_row = gtk_list_box_get_last_focusable (box); break; default: next_focus_row = priv->selected_row; if (next_focus_row == NULL) next_focus_row = gtk_list_box_get_first_focusable (box); break; } } if (next_focus_row == NULL) { if (direction == GTK_DIR_UP || direction == GTK_DIR_DOWN) { if (gtk_widget_keynav_failed (GTK_WIDGET (box), direction)) return TRUE; } return FALSE; } if (direction == GTK_DIR_DOWN || direction == GTK_DIR_TAB_FORWARD) { header = ROW_PRIV (next_focus_row)->header; if (header && gtk_widget_child_focus (header, direction)) return TRUE; } if (gtk_widget_child_focus (GTK_WIDGET (next_focus_row), direction)) return TRUE; return FALSE; } static gboolean gtk_list_box_draw (GtkWidget *widget, cairo_t *cr) { gtk_css_gadget_draw (BOX_PRIV (widget)->gadget, cr); return FALSE; } static gboolean gtk_list_box_render (GtkCssGadget *gadget, cairo_t *cr, int x, int y, int width, int height, gpointer data) { GtkWidget *widget = gtk_css_gadget_get_owner (gadget); GTK_WIDGET_CLASS (gtk_list_box_parent_class)->draw (widget, cr); return FALSE; } static void gtk_list_box_realize (GtkWidget *widget) { GtkAllocation allocation; GdkWindowAttr attributes = { 0, }; GdkWindow *window; gtk_widget_get_allocation (widget, &allocation); gtk_widget_set_realized (widget, TRUE); attributes.x = allocation.x; attributes.y = allocation.y; attributes.width = allocation.width; attributes.height = allocation.height; attributes.window_type = GDK_WINDOW_CHILD; attributes.event_mask = gtk_widget_get_events (widget) | GDK_ENTER_NOTIFY_MASK | GDK_LEAVE_NOTIFY_MASK | GDK_POINTER_MOTION_MASK | GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK; attributes.wclass = GDK_INPUT_OUTPUT; window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, GDK_WA_X | GDK_WA_Y); gdk_window_set_user_data (window, (GObject*) widget); gtk_widget_set_window (widget, window); /* Passes ownership */ } static void list_box_add_visible_rows (GtkListBox *box, gint n) { GtkListBoxPrivate *priv = BOX_PRIV (box); int was_zero; was_zero = priv->n_visible_rows == 0; priv->n_visible_rows += n; if (priv->placeholder && (was_zero || priv->n_visible_rows == 0)) gtk_widget_set_child_visible (GTK_WIDGET (priv->placeholder), priv->n_visible_rows == 0); } /* Children are visible if they are shown by the app (visible) * and not filtered out (child_visible) by the listbox */ static void update_row_is_visible (GtkListBox *box, GtkListBoxRow *row) { GtkListBoxRowPrivate *row_priv = ROW_PRIV (row); gboolean was_visible; was_visible = row_priv->visible; row_priv->visible = gtk_widget_get_visible (GTK_WIDGET (row)) && gtk_widget_get_child_visible (GTK_WIDGET (row)); if (was_visible && !row_priv->visible) list_box_add_visible_rows (box, -1); if (!was_visible && row_priv->visible) list_box_add_visible_rows (box, 1); } static void gtk_list_box_apply_filter (GtkListBox *box, GtkListBoxRow *row) { GtkListBoxPrivate *priv = BOX_PRIV (box); gboolean do_show; do_show = TRUE; if (priv->filter_func != NULL) do_show = priv->filter_func (row, priv->filter_func_target); gtk_widget_set_child_visible (GTK_WIDGET (row), do_show); update_row_is_visible (box, row); } static void gtk_list_box_apply_filter_all (GtkListBox *box) { GtkListBoxRow *row; GSequenceIter *iter; for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = g_sequence_get (iter); gtk_list_box_apply_filter (box, row); } } static GtkListBoxRow * gtk_list_box_get_first_focusable (GtkListBox *box) { GtkListBoxRow *row; GSequenceIter *iter; for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = g_sequence_get (iter); if (row_is_visible (row) && gtk_widget_is_sensitive (GTK_WIDGET (row))) return row; } return NULL; } static GtkListBoxRow * gtk_list_box_get_last_focusable (GtkListBox *box) { GtkListBoxRow *row; GSequenceIter *iter; iter = g_sequence_get_end_iter (BOX_PRIV (box)->children); while (!g_sequence_iter_is_begin (iter)) { iter = g_sequence_iter_prev (iter); row = g_sequence_get (iter); if (row_is_visible (row) && gtk_widget_is_sensitive (GTK_WIDGET (row))) return row; } return NULL; } static GSequenceIter * gtk_list_box_get_previous_visible (GtkListBox *box, GSequenceIter *iter) { GtkListBoxRow *row; if (g_sequence_iter_is_begin (iter)) return NULL; do { iter = g_sequence_iter_prev (iter); row = g_sequence_get (iter); if (row_is_visible (row)) return iter; } while (!g_sequence_iter_is_begin (iter)); return NULL; } static GSequenceIter * gtk_list_box_get_next_visible (GtkListBox *box, GSequenceIter *iter) { GtkListBoxRow *row; if (g_sequence_iter_is_end (iter)) return iter; do { iter = g_sequence_iter_next (iter); if (!g_sequence_iter_is_end (iter)) { row = g_sequence_get (iter); if (row_is_visible (row)) return iter; } } while (!g_sequence_iter_is_end (iter)); return iter; } static void gtk_list_box_update_header (GtkListBox *box, GSequenceIter *iter) { GtkListBoxPrivate *priv = BOX_PRIV (box); GtkListBoxRow *row; GSequenceIter *before_iter; GtkListBoxRow *before_row; GtkWidget *old_header; if (iter == NULL || g_sequence_iter_is_end (iter)) return; row = g_sequence_get (iter); g_object_ref (row); before_iter = gtk_list_box_get_previous_visible (box, iter); before_row = NULL; if (before_iter != NULL) { before_row = g_sequence_get (before_iter); if (before_row) g_object_ref (before_row); } if (priv->update_header_func != NULL && row_is_visible (row)) { old_header = ROW_PRIV (row)->header; if (old_header) g_object_ref (old_header); priv->update_header_func (row, before_row, priv->update_header_func_target); if (old_header != ROW_PRIV (row)->header) { if (old_header != NULL) { gtk_widget_unparent (old_header); g_hash_table_remove (priv->header_hash, old_header); } if (ROW_PRIV (row)->header != NULL) { g_hash_table_insert (priv->header_hash, ROW_PRIV (row)->header, row); gtk_widget_set_parent (ROW_PRIV (row)->header, GTK_WIDGET (box)); gtk_widget_show (ROW_PRIV (row)->header); } gtk_widget_queue_resize (GTK_WIDGET (box)); } if (old_header) g_object_unref (old_header); } else { if (ROW_PRIV (row)->header != NULL) { g_hash_table_remove (priv->header_hash, ROW_PRIV (row)->header); gtk_widget_unparent (ROW_PRIV (row)->header); gtk_list_box_row_set_header (row, NULL); gtk_widget_queue_resize (GTK_WIDGET (box)); } } if (before_row) g_object_unref (before_row); g_object_unref (row); } static void gtk_list_box_row_visibility_changed (GtkListBox *box, GtkListBoxRow *row) { update_row_is_visible (box, row); if (gtk_widget_get_visible (GTK_WIDGET (box))) { gtk_list_box_update_header (box, ROW_PRIV (row)->iter); gtk_list_box_update_header (box, gtk_list_box_get_next_visible (box, ROW_PRIV (row)->iter)); } } static void gtk_list_box_add (GtkContainer *container, GtkWidget *child) { gtk_list_box_insert (GTK_LIST_BOX (container), child, -1); } static void gtk_list_box_remove (GtkContainer *container, GtkWidget *child) { GtkWidget *widget = GTK_WIDGET (container); GtkListBox *box = GTK_LIST_BOX (container); GtkListBoxPrivate *priv = BOX_PRIV (box); gboolean was_visible; gboolean was_selected; GtkListBoxRow *row; GSequenceIter *next; was_visible = gtk_widget_get_visible (child); if (!GTK_IS_LIST_BOX_ROW (child)) { row = g_hash_table_lookup (priv->header_hash, child); if (row != NULL) { g_hash_table_remove (priv->header_hash, child); g_clear_object (&ROW_PRIV (row)->header); gtk_widget_unparent (child); if (was_visible && gtk_widget_get_visible (widget)) gtk_widget_queue_resize (widget); } else { g_warning ("Tried to remove non-child %p\n", child); } return; } row = GTK_LIST_BOX_ROW (child); if (g_sequence_iter_get_sequence (ROW_PRIV (row)->iter) != priv->children) { g_warning ("Tried to remove non-child %p\n", child); return; } was_selected = ROW_PRIV (row)->selected; if (ROW_PRIV (row)->visible) list_box_add_visible_rows (box, -1); if (ROW_PRIV (row)->header != NULL) { g_hash_table_remove (priv->header_hash, ROW_PRIV (row)->header); gtk_widget_unparent (ROW_PRIV (row)->header); g_clear_object (&ROW_PRIV (row)->header); } if (row == priv->selected_row) priv->selected_row = NULL; if (row == priv->prelight_row) { gtk_widget_unset_state_flags (GTK_WIDGET (row), GTK_STATE_FLAG_PRELIGHT); priv->prelight_row = NULL; } if (row == priv->cursor_row) priv->cursor_row = NULL; if (row == priv->active_row) { gtk_widget_unset_state_flags (GTK_WIDGET (row), GTK_STATE_FLAG_ACTIVE); priv->active_row = NULL; } if (row == priv->drag_highlighted_row) gtk_list_box_drag_unhighlight_row (box); next = gtk_list_box_get_next_visible (box, ROW_PRIV (row)->iter); gtk_widget_unparent (child); g_sequence_remove (ROW_PRIV (row)->iter); if (gtk_widget_get_visible (widget)) gtk_list_box_update_header (box, next); if (was_visible && gtk_widget_get_visible (GTK_WIDGET (box))) gtk_widget_queue_resize (widget); if (was_selected) { g_signal_emit (box, signals[ROW_SELECTED], 0, NULL); g_signal_emit (box, signals[SELECTED_ROWS_CHANGED], 0); } } static void gtk_list_box_forall (GtkContainer *container, gboolean include_internals, GtkCallback callback, gpointer callback_target) { GtkListBoxPrivate *priv = BOX_PRIV (container); GSequenceIter *iter; GtkListBoxRow *row; if (priv->placeholder != NULL && include_internals) callback (priv->placeholder, callback_target); iter = g_sequence_get_begin_iter (priv->children); while (!g_sequence_iter_is_end (iter)) { row = g_sequence_get (iter); iter = g_sequence_iter_next (iter); if (ROW_PRIV (row)->header != NULL && include_internals) callback (ROW_PRIV (row)->header, callback_target); callback (GTK_WIDGET (row), callback_target); } } static void gtk_list_box_compute_expand (GtkWidget *widget, gboolean *hexpand, gboolean *vexpand) { GTK_WIDGET_CLASS (gtk_list_box_parent_class)->compute_expand (widget, hexpand, vexpand); /* We don't expand vertically beyound the minimum size */ if (vexpand) *vexpand = FALSE; } static GType gtk_list_box_child_type (GtkContainer *container) { /* We really support any type but we wrap it in a row. But that is * more like a C helper function, in an abstract sense we only support * row children, so that is what tools accessing this should use. */ return GTK_TYPE_LIST_BOX_ROW; } static GtkSizeRequestMode gtk_list_box_get_request_mode (GtkWidget *widget) { return GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH; } static void gtk_list_box_get_preferred_height (GtkWidget *widget, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (BOX_PRIV (widget)->gadget, GTK_ORIENTATION_VERTICAL, -1, minimum, natural, NULL, NULL); } static void gtk_list_box_get_preferred_height_for_width (GtkWidget *widget, gint width, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (BOX_PRIV (widget)->gadget, GTK_ORIENTATION_VERTICAL, width, minimum, natural, NULL, NULL); } static void gtk_list_box_get_preferred_width (GtkWidget *widget, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (BOX_PRIV (widget)->gadget, GTK_ORIENTATION_HORIZONTAL, -1, minimum, natural, NULL, NULL); } static void gtk_list_box_get_preferred_width_for_height (GtkWidget *widget, gint height, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (BOX_PRIV (widget)->gadget, GTK_ORIENTATION_HORIZONTAL, height, minimum, natural, NULL, NULL); } static void gtk_list_box_measure (GtkCssGadget *gadget, GtkOrientation orientation, gint for_size, gint *minimum, gint *natural, gint *minimum_baseline, gint *natural_baseline, gpointer unused) { GtkWidget *widget = gtk_css_gadget_get_owner (gadget); GtkListBoxPrivate *priv = BOX_PRIV (widget); GSequenceIter *iter; if (orientation == GTK_ORIENTATION_HORIZONTAL) { *minimum = 0; *natural = 0; if (priv->placeholder && gtk_widget_get_child_visible (priv->placeholder)) gtk_widget_get_preferred_width (priv->placeholder, minimum, natural); for (iter = g_sequence_get_begin_iter (priv->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { GtkListBoxRow *row; gint row_min; gint row_nat; row = g_sequence_get (iter); /* We *do* take visible but filtered rows into account here so that * the list width doesn't change during filtering */ if (!gtk_widget_get_visible (GTK_WIDGET (row))) continue; gtk_widget_get_preferred_width (GTK_WIDGET (row), &row_min, &row_nat); *minimum = MAX (*minimum, row_min); *natural = MAX (*natural, row_nat); if (ROW_PRIV (row)->header != NULL) { gtk_widget_get_preferred_width (ROW_PRIV (row)->header, &row_min, &row_nat); *minimum = MAX (*minimum, row_min); *natural = MAX (*natural, row_nat); } } } else { if (for_size < 0) gtk_css_gadget_get_preferred_size (priv->gadget, GTK_ORIENTATION_HORIZONTAL, -1, NULL, &for_size, NULL, NULL); *minimum = 0; if (priv->placeholder && gtk_widget_get_child_visible (priv->placeholder)) gtk_widget_get_preferred_height_for_width (priv->placeholder, for_size, minimum, NULL); for (iter = g_sequence_get_begin_iter (priv->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { GtkListBoxRow *row; gint row_min = 0; row = g_sequence_get (iter); if (!row_is_visible (row)) continue; if (ROW_PRIV (row)->header != NULL) { gtk_widget_get_preferred_height_for_width (ROW_PRIV (row)->header, for_size, &row_min, NULL); *minimum += row_min; } gtk_widget_get_preferred_height_for_width (GTK_WIDGET (row), for_size, &row_min, NULL); *minimum += row_min; } /* We always allocate the minimum height, since handling expanding rows * is way too costly, and unlikely to be used, as lists are generally put * inside a scrolling window anyway. */ *natural = *minimum; } } static void gtk_list_box_size_allocate (GtkWidget *widget, GtkAllocation *allocation) { GtkAllocation clip; GdkWindow *window; GtkAllocation child_allocation; gtk_widget_set_allocation (widget, allocation); window = gtk_widget_get_window (widget); if (window != NULL) gdk_window_move_resize (window, allocation->x, allocation->y, allocation->width, allocation->height); child_allocation.x = 0; child_allocation.y = 0; child_allocation.width = allocation->width; child_allocation.height = allocation->height; gtk_css_gadget_allocate (BOX_PRIV (widget)->gadget, &child_allocation, gtk_widget_get_allocated_baseline (widget), &clip); _gtk_widget_set_simple_clip (widget, &clip); } static void gtk_list_box_allocate (GtkCssGadget *gadget, const GtkAllocation *allocation, int baseline, GtkAllocation *out_clip, gpointer unused) { GtkWidget *widget = gtk_css_gadget_get_owner (gadget); GtkListBoxPrivate *priv = BOX_PRIV (widget); GtkAllocation child_allocation; GtkAllocation header_allocation; GtkListBoxRow *row; GSequenceIter *iter; int child_min; child_allocation.x = allocation->x; child_allocation.y = allocation->y; child_allocation.width = allocation->width; child_allocation.height = 0; header_allocation.x = allocation->x; header_allocation.y = allocation->y; header_allocation.width = allocation->width; header_allocation.height = 0; if (priv->placeholder && gtk_widget_get_child_visible (priv->placeholder)) { gtk_widget_get_preferred_height_for_width (priv->placeholder, allocation->width, &child_min, NULL); header_allocation.height = allocation->height; header_allocation.y = child_allocation.y; gtk_widget_size_allocate (priv->placeholder, &header_allocation); child_allocation.y += child_min; } for (iter = g_sequence_get_begin_iter (priv->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = g_sequence_get (iter); if (!row_is_visible (row)) { ROW_PRIV (row)->y = child_allocation.y; ROW_PRIV (row)->height = 0; continue; } if (ROW_PRIV (row)->header != NULL) { gtk_widget_get_preferred_height_for_width (ROW_PRIV (row)->header, allocation->width, &child_min, NULL); header_allocation.height = child_min; header_allocation.y = child_allocation.y; gtk_widget_size_allocate (ROW_PRIV (row)->header, &header_allocation); child_allocation.y += child_min; } ROW_PRIV (row)->y = child_allocation.y; gtk_widget_get_preferred_height_for_width (GTK_WIDGET (row), child_allocation.width, &child_min, NULL); child_allocation.height = child_min; ROW_PRIV (row)->height = child_allocation.height; gtk_widget_size_allocate (GTK_WIDGET (row), &child_allocation); child_allocation.y += child_min; } gtk_container_get_children_clip (GTK_CONTAINER (widget), out_clip); } /** * gtk_list_box_prepend: * @box: a #GtkListBox * @child: the #GtkWidget to add * * Prepend a widget to the list. If a sort function is set, the widget will * actually be inserted at the calculated position and this function has the * same effect of gtk_container_add(). * * Since: 3.10 */ void gtk_list_box_prepend (GtkListBox *box, GtkWidget *child) { gtk_list_box_insert (box, child, 0); } static void gtk_list_box_insert_css_node (GtkListBox *box, GtkWidget *child, GSequenceIter *iter) { GSequenceIter *prev_iter; GtkWidget *sibling; prev_iter = g_sequence_iter_prev (iter); if (prev_iter != iter) { sibling = g_sequence_get (prev_iter); gtk_css_node_insert_after (gtk_widget_get_css_node (GTK_WIDGET (box)), gtk_widget_get_css_node (child), gtk_widget_get_css_node (sibling)); } } /** * gtk_list_box_insert: * @box: a #GtkListBox * @child: the #GtkWidget to add * @position: the position to insert @child in * * Insert the @child into the @box at @position. If a sort function is * set, the widget will actually be inserted at the calculated position and * this function has the same effect of gtk_container_add(). * * If @position is -1, or larger than the total number of items in the * @box, then the @child will be appended to the end. * * Since: 3.10 */ void gtk_list_box_insert (GtkListBox *box, GtkWidget *child, gint position) { GtkListBoxPrivate *priv = BOX_PRIV (box); GtkListBoxRow *row; GSequenceIter *iter = NULL; g_return_if_fail (GTK_IS_LIST_BOX (box)); g_return_if_fail (GTK_IS_WIDGET (child)); if (GTK_IS_LIST_BOX_ROW (child)) row = GTK_LIST_BOX_ROW (child); else { row = GTK_LIST_BOX_ROW (gtk_list_box_row_new ()); gtk_widget_show (GTK_WIDGET (row)); gtk_container_add (GTK_CONTAINER (row), child); } if (priv->sort_func != NULL) iter = g_sequence_insert_sorted (priv->children, row, (GCompareDataFunc)do_sort, box); else if (position == 0) iter = g_sequence_prepend (priv->children, row); else if (position == -1) iter = g_sequence_append (priv->children, row); else { GSequenceIter *current_iter; current_iter = g_sequence_get_iter_at_pos (priv->children, position); iter = g_sequence_insert_before (current_iter, row); } gtk_list_box_insert_css_node (box, GTK_WIDGET (row), iter); ROW_PRIV (row)->iter = iter; gtk_widget_set_parent (GTK_WIDGET (row), GTK_WIDGET (box)); gtk_widget_set_child_visible (GTK_WIDGET (row), TRUE); ROW_PRIV (row)->visible = gtk_widget_get_visible (GTK_WIDGET (row)); if (ROW_PRIV (row)->visible) list_box_add_visible_rows (box, 1); gtk_list_box_apply_filter (box, row); gtk_list_box_update_row_style (box, row); if (gtk_widget_get_visible (GTK_WIDGET (box))) { gtk_list_box_update_header (box, ROW_PRIV (row)->iter); gtk_list_box_update_header (box, gtk_list_box_get_next_visible (box, ROW_PRIV (row)->iter)); } } /** * gtk_list_box_drag_unhighlight_row: * @box: a #GtkListBox * * If a row has previously been highlighted via gtk_list_box_drag_highlight_row() * it will have the highlight removed. * * Since: 3.10 */ void gtk_list_box_drag_unhighlight_row (GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); if (priv->drag_highlighted_row == NULL) return; gtk_drag_unhighlight (GTK_WIDGET (priv->drag_highlighted_row)); g_clear_object (&priv->drag_highlighted_row); } /** * gtk_list_box_drag_highlight_row: * @box: a #GtkListBox * @row: a #GtkListBoxRow * * This is a helper function for implementing DnD onto a #GtkListBox. * The passed in @row will be highlighted via gtk_drag_highlight(), * and any previously highlighted row will be unhighlighted. * * The row will also be unhighlighted when the widget gets * a drag leave event. * * Since: 3.10 */ void gtk_list_box_drag_highlight_row (GtkListBox *box, GtkListBoxRow *row) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); g_return_if_fail (GTK_IS_LIST_BOX_ROW (row)); if (priv->drag_highlighted_row == row) return; gtk_list_box_drag_unhighlight_row (box); gtk_drag_highlight (GTK_WIDGET (row)); priv->drag_highlighted_row = g_object_ref (row); } static void gtk_list_box_drag_leave (GtkWidget *widget, GdkDragContext *context, guint time_) { gtk_list_box_drag_unhighlight_row (GTK_LIST_BOX (widget)); } static void gtk_list_box_activate_cursor_row (GtkListBox *box) { gtk_list_box_select_and_activate (box, BOX_PRIV (box)->cursor_row); } static void gtk_list_box_toggle_cursor_row (GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); if (priv->cursor_row == NULL) return; if ((priv->selection_mode == GTK_SELECTION_SINGLE || priv->selection_mode == GTK_SELECTION_MULTIPLE) && ROW_PRIV (priv->cursor_row)->selected) gtk_list_box_unselect_row_internal (box, priv->cursor_row); else gtk_list_box_select_and_activate (box, priv->cursor_row); } static void gtk_list_box_move_cursor (GtkListBox *box, GtkMovementStep step, gint count) { GtkListBoxPrivate *priv = BOX_PRIV (box); gboolean modify; gboolean extend; GtkListBoxRow *row; GtkListBoxRow *prev; GtkListBoxRow *next; gint page_size; GSequenceIter *iter; gint start_y; gint end_y; row = NULL; switch (step) { case GTK_MOVEMENT_BUFFER_ENDS: if (count < 0) row = gtk_list_box_get_first_focusable (box); else row = gtk_list_box_get_last_focusable (box); break; case GTK_MOVEMENT_DISPLAY_LINES: if (priv->cursor_row != NULL) { gint i = count; iter = ROW_PRIV (priv->cursor_row)->iter; while (i < 0 && iter != NULL) { iter = gtk_list_box_get_previous_visible (box, iter); i = i + 1; } while (i > 0 && iter != NULL) { iter = gtk_list_box_get_next_visible (box, iter); i = i - 1; } if (iter != NULL && !g_sequence_iter_is_end (iter)) row = g_sequence_get (iter); } break; case GTK_MOVEMENT_PAGES: page_size = 100; if (priv->adjustment != NULL) page_size = gtk_adjustment_get_page_increment (priv->adjustment); if (priv->cursor_row != NULL) { start_y = ROW_PRIV (priv->cursor_row)->y; end_y = start_y; iter = ROW_PRIV (priv->cursor_row)->iter; row = priv->cursor_row; if (count < 0) { /* Up */ while (iter != NULL && !g_sequence_iter_is_begin (iter)) { iter = gtk_list_box_get_previous_visible (box, iter); if (iter == NULL) break; prev = g_sequence_get (iter); if (ROW_PRIV (prev)->y < start_y - page_size) break; row = prev; } } else { /* Down */ while (iter != NULL && !g_sequence_iter_is_end (iter)) { iter = gtk_list_box_get_next_visible (box, iter); if (g_sequence_iter_is_end (iter)) break; next = g_sequence_get (iter); if (ROW_PRIV (next)->y > start_y + page_size) break; row = next; } } end_y = ROW_PRIV (row)->y; if (end_y != start_y && priv->adjustment != NULL) gtk_adjustment_animate_to_value (priv->adjustment, gtk_adjustment_get_value (priv->adjustment) + end_y - start_y); } break; default: return; } if (row == NULL || row == priv->cursor_row) { GtkDirectionType direction = count < 0 ? GTK_DIR_UP : GTK_DIR_DOWN; if (!gtk_widget_keynav_failed (GTK_WIDGET (box), direction)) { GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (box)); if (toplevel) gtk_widget_child_focus (toplevel, direction == GTK_DIR_UP ? GTK_DIR_TAB_BACKWARD : GTK_DIR_TAB_FORWARD); } return; } get_current_selection_modifiers (GTK_WIDGET (box), &modify, &extend); gtk_list_box_update_cursor (box, row, TRUE); if (!modify) gtk_list_box_update_selection (box, row, FALSE, extend); } /** * gtk_list_box_row_new: * * Creates a new #GtkListBoxRow, to be used as a child of a #GtkListBox. * * Returns: a new #GtkListBoxRow * * Since: 3.10 */ GtkWidget * gtk_list_box_row_new (void) { return g_object_new (GTK_TYPE_LIST_BOX_ROW, NULL); } static void gtk_list_box_row_set_focus (GtkListBoxRow *row) { GtkListBox *box = gtk_list_box_row_get_box (row); gboolean modify; gboolean extend; if (!box) return; get_current_selection_modifiers (GTK_WIDGET (row), &modify, &extend); if (modify) gtk_list_box_update_cursor (box, row, TRUE); else gtk_list_box_update_selection (box, row, FALSE, FALSE); } static gboolean gtk_list_box_row_focus (GtkWidget *widget, GtkDirectionType direction) { GtkListBoxRow *row = GTK_LIST_BOX_ROW (widget); gboolean had_focus = FALSE; GtkWidget *child; child = gtk_bin_get_child (GTK_BIN (widget)); g_object_get (widget, "has-focus", &had_focus, NULL); if (had_focus) { /* If on row, going right, enter into possible container */ if (child && (direction == GTK_DIR_RIGHT || direction == GTK_DIR_TAB_FORWARD)) { if (gtk_widget_child_focus (GTK_WIDGET (child), direction)) return TRUE; } return FALSE; } else if (gtk_container_get_focus_child (GTK_CONTAINER (row)) != NULL) { /* Child has focus, always navigate inside it first */ if (gtk_widget_child_focus (child, direction)) return TRUE; /* If exiting child container to the left, select row */ if (direction == GTK_DIR_LEFT || direction == GTK_DIR_TAB_BACKWARD) { gtk_list_box_row_set_focus (row); return TRUE; } return FALSE; } else { /* If coming from the left, enter into possible container */ if (child && (direction == GTK_DIR_LEFT || direction == GTK_DIR_TAB_BACKWARD)) { if (gtk_widget_child_focus (child, direction)) return TRUE; } gtk_list_box_row_set_focus (row); return TRUE; } } static void gtk_list_box_row_activate (GtkListBoxRow *row) { GtkListBox *box; box = gtk_list_box_row_get_box (row); if (box) gtk_list_box_select_and_activate (box, row); } static void gtk_list_box_row_show (GtkWidget *widget) { GtkListBoxRow *row = GTK_LIST_BOX_ROW (widget); GtkListBox *box; GTK_WIDGET_CLASS (gtk_list_box_row_parent_class)->show (widget); box = gtk_list_box_row_get_box (row); if (box) gtk_list_box_row_visibility_changed (box, row); } static void gtk_list_box_row_hide (GtkWidget *widget) { GtkListBoxRow *row = GTK_LIST_BOX_ROW (widget); GtkListBox *box; GTK_WIDGET_CLASS (gtk_list_box_row_parent_class)->hide (widget); box = gtk_list_box_row_get_box (row); if (box) gtk_list_box_row_visibility_changed (box, row); } static gboolean gtk_list_box_row_draw (GtkWidget *widget, cairo_t *cr) { gtk_css_gadget_draw (ROW_PRIV (GTK_LIST_BOX_ROW (widget))->gadget, cr); return GDK_EVENT_PROPAGATE; } static gboolean gtk_list_box_row_render (GtkCssGadget *gadget, cairo_t *cr, int x, int y, int width, int height, gpointer data) { GtkWidget *widget; widget = gtk_css_gadget_get_owner (gadget); GTK_WIDGET_CLASS (gtk_list_box_row_parent_class)->draw (widget, cr); return gtk_widget_has_visible_focus (widget); } static void gtk_list_box_row_measure (GtkCssGadget *gadget, GtkOrientation orientation, int for_size, int *minimum, int *natural, int *minimum_baseline, int *natural_baseline, gpointer data) { GtkWidget *widget; GtkWidget *child; widget = gtk_css_gadget_get_owner (gadget); child = gtk_bin_get_child (GTK_BIN (widget)); if (orientation == GTK_ORIENTATION_VERTICAL) { if (child && gtk_widget_get_visible (child)) { if (for_size < 0) gtk_widget_get_preferred_height (child, minimum, natural); else gtk_widget_get_preferred_height_for_width (child, for_size, minimum, natural); } else *minimum = *natural = 0; } else { if (child && gtk_widget_get_visible (child)) gtk_widget_get_preferred_width (child, minimum, natural); else *minimum = *natural = 0; } } static void gtk_list_box_row_get_preferred_height (GtkWidget *widget, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (ROW_PRIV (GTK_LIST_BOX_ROW (widget))->gadget, GTK_ORIENTATION_VERTICAL, -1, minimum, natural, NULL, NULL); } static void gtk_list_box_row_get_preferred_height_for_width (GtkWidget *widget, gint width, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (ROW_PRIV (GTK_LIST_BOX_ROW (widget))->gadget, GTK_ORIENTATION_VERTICAL, width, minimum, natural, NULL, NULL); } static void gtk_list_box_row_get_preferred_width (GtkWidget *widget, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (ROW_PRIV (GTK_LIST_BOX_ROW (widget))->gadget, GTK_ORIENTATION_HORIZONTAL, -1, minimum, natural, NULL, NULL); } static void gtk_list_box_row_get_preferred_width_for_height (GtkWidget *widget, gint height, gint *minimum, gint *natural) { gtk_css_gadget_get_preferred_size (ROW_PRIV (GTK_LIST_BOX_ROW (widget))->gadget, GTK_ORIENTATION_HORIZONTAL, height, minimum, natural, NULL, NULL); } static void gtk_list_box_row_size_allocate (GtkWidget *widget, GtkAllocation *allocation) { GtkAllocation clip; gtk_widget_set_allocation (widget, allocation); gtk_css_gadget_allocate (ROW_PRIV (GTK_LIST_BOX_ROW (widget))->gadget, allocation, gtk_widget_get_allocated_baseline (widget), &clip); gtk_widget_set_clip (widget, &clip); } static void gtk_list_box_row_allocate (GtkCssGadget *gadget, const GtkAllocation *allocation, int baseline, GtkAllocation *out_clip, gpointer data) { GtkWidget *widget; GtkWidget *child; widget = gtk_css_gadget_get_owner (gadget); child = gtk_bin_get_child (GTK_BIN (widget)); if (child && gtk_widget_get_visible (child)) gtk_widget_size_allocate (child, (GtkAllocation *)allocation); gtk_container_get_children_clip (GTK_CONTAINER (widget), out_clip); } /** * gtk_list_box_row_changed: * @row: a #GtkListBoxRow * * Marks @row as changed, causing any state that depends on this * to be updated. This affects sorting, filtering and headers. * * Note that calls to this method must be in sync with the data * used for the row functions. For instance, if the list is * mirroring some external data set, and *two* rows changed in the * external data set then when you call gtk_list_box_row_changed() * on the first row the sort function must only read the new data * for the first of the two changed rows, otherwise the resorting * of the rows will be wrong. * * This generally means that if you don’t fully control the data * model you have to duplicate the data that affects the listbox * row functions into the row widgets themselves. Another alternative * is to call gtk_list_box_invalidate_sort() on any model change, * but that is more expensive. * * Since: 3.10 */ void gtk_list_box_row_changed (GtkListBoxRow *row) { GtkListBox *box; g_return_if_fail (GTK_IS_LIST_BOX_ROW (row)); box = gtk_list_box_row_get_box (row); if (box) gtk_list_box_got_row_changed (box, row); } /** * gtk_list_box_row_get_header: * @row: a #GtkListBoxRow * * Returns the current header of the @row. This can be used * in a #GtkListBoxUpdateHeaderFunc to see if there is a header * set already, and if so to update the state of it. * * Returns: (transfer none) (nullable): the current header, or %NULL if none * * Since: 3.10 */ GtkWidget * gtk_list_box_row_get_header (GtkListBoxRow *row) { g_return_val_if_fail (GTK_IS_LIST_BOX_ROW (row), NULL); return ROW_PRIV (row)->header; } /** * gtk_list_box_row_set_header: * @row: a #GtkListBoxRow * @header: (allow-none): the header, or %NULL * * Sets the current header of the @row. This is only allowed to be called * from a #GtkListBoxUpdateHeaderFunc. It will replace any existing * header in the row, and be shown in front of the row in the listbox. * * Since: 3.10 */ void gtk_list_box_row_set_header (GtkListBoxRow *row, GtkWidget *header) { GtkListBoxRowPrivate *priv; g_return_if_fail (GTK_IS_LIST_BOX_ROW (row)); g_return_if_fail (header == NULL || GTK_IS_WIDGET (header)); priv = ROW_PRIV (row); if (priv->header) g_object_unref (priv->header); priv->header = header; if (header) g_object_ref_sink (header); } /** * gtk_list_box_row_get_index: * @row: a #GtkListBoxRow * * Gets the current index of the @row in its #GtkListBox container. * * Returns: the index of the @row, or -1 if the @row is not in a listbox * * Since: 3.10 */ gint gtk_list_box_row_get_index (GtkListBoxRow *row) { GtkListBoxRowPrivate *priv; g_return_val_if_fail (GTK_IS_LIST_BOX_ROW (row), -1); priv = ROW_PRIV (row); if (priv->iter != NULL) return g_sequence_iter_get_position (priv->iter); return -1; } /** * gtk_list_box_row_is_selected: * @row: a #GtkListBoxRow * * Returns whether the child is currently selected in its * #GtkListBox container. * * Returns: %TRUE if @row is selected * * Since: 3.14 */ gboolean gtk_list_box_row_is_selected (GtkListBoxRow *row) { g_return_val_if_fail (GTK_IS_LIST_BOX_ROW (row), FALSE); return ROW_PRIV (row)->selected; } static void gtk_list_box_update_row_style (GtkListBox *box, GtkListBoxRow *row) { GtkStyleContext *context; gboolean can_select; if (box && BOX_PRIV (box)->selection_mode != GTK_SELECTION_NONE) can_select = TRUE; else can_select = FALSE; context = gtk_widget_get_style_context (GTK_WIDGET (row)); if (ROW_PRIV (row)->activatable || (ROW_PRIV (row)->selectable && can_select)) gtk_style_context_add_class (context, "activatable"); else gtk_style_context_remove_class (context, "activatable"); } static void gtk_list_box_update_row_styles (GtkListBox *box) { GSequenceIter *iter; GtkListBoxRow *row; for (iter = g_sequence_get_begin_iter (BOX_PRIV (box)->children); !g_sequence_iter_is_end (iter); iter = g_sequence_iter_next (iter)) { row = g_sequence_get (iter); gtk_list_box_update_row_style (box, row); } } /** * gtk_list_box_row_set_activatable: * @row: a #GtkListBoxRow * @activatable: %TRUE to mark the row as activatable * * Set the #GtkListBoxRow:activatable property for this row. * * Since: 3.14 */ void gtk_list_box_row_set_activatable (GtkListBoxRow *row, gboolean activatable) { g_return_if_fail (GTK_IS_LIST_BOX_ROW (row)); activatable = activatable != FALSE; if (ROW_PRIV (row)->activatable != activatable) { ROW_PRIV (row)->activatable = activatable; gtk_list_box_update_row_style (gtk_list_box_row_get_box (row), row); g_object_notify_by_pspec (G_OBJECT (row), row_properties[ROW_PROP_ACTIVATABLE]); } } /** * gtk_list_box_row_get_activatable: * @row: a #GtkListBoxRow * * Gets the value of the #GtkListBoxRow:activatable property * for this row. * * Returns: %TRUE if the row is activatable * * Since: 3.14 */ gboolean gtk_list_box_row_get_activatable (GtkListBoxRow *row) { g_return_val_if_fail (GTK_IS_LIST_BOX_ROW (row), TRUE); return ROW_PRIV (row)->activatable; } /** * gtk_list_box_row_set_selectable: * @row: a #GTkListBoxrow * @selectable: %TRUE to mark the row as selectable * * Set the #GtkListBoxRow:selectable property for this row. * * Since: 3.14 */ void gtk_list_box_row_set_selectable (GtkListBoxRow *row, gboolean selectable) { g_return_if_fail (GTK_IS_LIST_BOX_ROW (row)); selectable = selectable != FALSE; if (ROW_PRIV (row)->selectable != selectable) { if (!selectable) gtk_list_box_row_set_selected (row, FALSE); ROW_PRIV (row)->selectable = selectable; gtk_list_box_update_row_style (gtk_list_box_row_get_box (row), row); g_object_notify_by_pspec (G_OBJECT (row), row_properties[ROW_PROP_SELECTABLE]); } } /** * gtk_list_box_row_get_selectable: * @row: a #GtkListBoxRow * * Gets the value of the #GtkListBoxRow:selectable property * for this row. * * Returns: %TRUE if the row is selectable * * Since: 3.14 */ gboolean gtk_list_box_row_get_selectable (GtkListBoxRow *row) { g_return_val_if_fail (GTK_IS_LIST_BOX_ROW (row), TRUE); return ROW_PRIV (row)->selectable; } static void gtk_list_box_row_get_property (GObject *obj, guint property_id, GValue *value, GParamSpec *pspec) { GtkListBoxRow *row = GTK_LIST_BOX_ROW (obj); switch (property_id) { case ROW_PROP_ACTIVATABLE: g_value_set_boolean (value, gtk_list_box_row_get_activatable (row)); break; case ROW_PROP_SELECTABLE: g_value_set_boolean (value, gtk_list_box_row_get_selectable (row)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (obj, property_id, pspec); break; } } static void gtk_list_box_row_set_property (GObject *obj, guint property_id, const GValue *value, GParamSpec *pspec) { GtkListBoxRow *row = GTK_LIST_BOX_ROW (obj); switch (property_id) { case ROW_PROP_ACTIVATABLE: gtk_list_box_row_set_activatable (row, g_value_get_boolean (value)); break; case ROW_PROP_SELECTABLE: gtk_list_box_row_set_selectable (row, g_value_get_boolean (value)); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (obj, property_id, pspec); break; } } static void gtk_list_box_row_finalize (GObject *obj) { g_clear_object (&ROW_PRIV (GTK_LIST_BOX_ROW (obj))->header); g_clear_object (&ROW_PRIV (GTK_LIST_BOX_ROW (obj))->gadget); G_OBJECT_CLASS (gtk_list_box_row_parent_class)->finalize (obj); } static void gtk_list_box_row_grab_focus (GtkWidget *widget) { GtkListBoxRow *row = GTK_LIST_BOX_ROW (widget); GtkListBox *box = gtk_list_box_row_get_box (row); g_return_if_fail (box != NULL); if (BOX_PRIV (box)->cursor_row != row) gtk_list_box_update_cursor (box, row, FALSE); GTK_WIDGET_CLASS (gtk_list_box_row_parent_class)->grab_focus (widget); } static void gtk_list_box_row_class_init (GtkListBoxRowClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass); gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_LIST_BOX_ROW_ACCESSIBLE); object_class->get_property = gtk_list_box_row_get_property; object_class->set_property = gtk_list_box_row_set_property; object_class->finalize = gtk_list_box_row_finalize; widget_class->show = gtk_list_box_row_show; widget_class->hide = gtk_list_box_row_hide; widget_class->draw = gtk_list_box_row_draw; widget_class->get_preferred_height = gtk_list_box_row_get_preferred_height; widget_class->get_preferred_height_for_width = gtk_list_box_row_get_preferred_height_for_width; widget_class->get_preferred_width = gtk_list_box_row_get_preferred_width; widget_class->get_preferred_width_for_height = gtk_list_box_row_get_preferred_width_for_height; widget_class->size_allocate = gtk_list_box_row_size_allocate; widget_class->focus = gtk_list_box_row_focus; widget_class->grab_focus = gtk_list_box_row_grab_focus; klass->activate = gtk_list_box_row_activate; row_signals[ROW__ACTIVATE] = g_signal_new (I_("activate"), G_OBJECT_CLASS_TYPE (object_class), G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION, G_STRUCT_OFFSET (GtkListBoxRowClass, activate), NULL, NULL, _gtk_marshal_VOID__VOID, G_TYPE_NONE, 0); widget_class->activate_signal = row_signals[ROW__ACTIVATE]; /** * GtkListBoxRow:activatable: * * The property determines whether the #GtkListBox::row-activated * signal will be emitted for this row. * * Since: 3.14 */ row_properties[ROW_PROP_ACTIVATABLE] = g_param_spec_boolean ("activatable", P_("Activatable"), P_("Whether this row can be activated"), TRUE, G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); /** * GtkListBoxRow:selectable: * * The property determines whether this row can be selected. * * Since: 3.14 */ row_properties[ROW_PROP_SELECTABLE] = g_param_spec_boolean ("selectable", P_("Selectable"), P_("Whether this row can be selected"), TRUE, G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY); g_object_class_install_properties (object_class, LAST_ROW_PROPERTY, row_properties); gtk_widget_class_set_css_name (widget_class, "row"); } static void gtk_list_box_row_init (GtkListBoxRow *row) { gtk_widget_set_can_focus (GTK_WIDGET (row), TRUE); gtk_widget_set_redraw_on_allocate (GTK_WIDGET (row), TRUE); ROW_PRIV (row)->activatable = TRUE; ROW_PRIV (row)->selectable = TRUE; ROW_PRIV (row)->gadget = gtk_css_custom_gadget_new_for_node (gtk_widget_get_css_node (GTK_WIDGET (row)), GTK_WIDGET (row), gtk_list_box_row_measure, gtk_list_box_row_allocate, gtk_list_box_row_render, NULL, NULL); gtk_css_gadget_add_class (ROW_PRIV (row)->gadget, "activatable"); } static void gtk_list_box_buildable_add_child (GtkBuildable *buildable, GtkBuilder *builder, GObject *child, const gchar *type) { if (type && strcmp (type, "placeholder") == 0) gtk_list_box_set_placeholder (GTK_LIST_BOX (buildable), GTK_WIDGET (child)); else if (!type) gtk_container_add (GTK_CONTAINER (buildable), GTK_WIDGET (child)); else GTK_BUILDER_WARN_INVALID_CHILD_TYPE (buildable, type); } static void gtk_list_box_buildable_interface_init (GtkBuildableIface *iface) { iface->add_child = gtk_list_box_buildable_add_child; } static void gtk_list_box_bound_model_changed (GListModel *list, guint position, guint removed, guint added, gpointer user_data) { GtkListBox *box = user_data; GtkListBoxPrivate *priv = BOX_PRIV (user_data); gint i; while (removed--) { GtkListBoxRow *row; row = gtk_list_box_get_row_at_index (box, position); gtk_widget_destroy (GTK_WIDGET (row)); } for (i = 0; i < added; i++) { GObject *item; GtkWidget *widget; item = g_list_model_get_item (list, position + i); widget = priv->create_widget_func (item, priv->create_widget_func_data); /* We allow the create_widget_func to either return a full * reference or a floating reference. If we got the floating * reference, then turn it into a full reference now. That means * that gtk_list_box_insert() will take another full reference. * Finally, we'll release this full reference below, leaving only * the one held by the box. */ if (g_object_is_floating (widget)) g_object_ref_sink (widget); gtk_widget_show (widget); gtk_list_box_insert (box, widget, position + i); g_object_unref (widget); g_object_unref (item); } } static void gtk_list_box_check_model_compat (GtkListBox *box) { GtkListBoxPrivate *priv = BOX_PRIV (box); if (priv->bound_model && (priv->sort_func || priv->filter_func)) g_warning ("GtkListBox with a model will ignore sort and filter functions"); } /** * gtk_list_box_bind_model: * @box: a #GtkListBox * @model: (nullable): the #GListModel to be bound to @box * @create_widget_func: (nullable): a function that creates widgets for items * or %NULL in case you also passed %NULL as @model * @user_data: user data passed to @create_widget_func * @user_data_free_func: function for freeing @user_data * * Binds @model to @box. * * If @box was already bound to a model, that previous binding is * destroyed. * * The contents of @box are cleared and then filled with widgets that * represent items from @model. @box is updated whenever @model changes. * If @model is %NULL, @box is left empty. * * It is undefined to add or remove widgets directly (for example, with * gtk_list_box_insert() or gtk_container_add()) while @box is bound to a * model. * * Note that using a model is incompatible with the filtering and sorting * functionality in GtkListBox. When using a model, filtering and sorting * should be implemented by the model. * * Since: 3.16 */ void gtk_list_box_bind_model (GtkListBox *box, GListModel *model, GtkListBoxCreateWidgetFunc create_widget_func, gpointer user_data, GDestroyNotify user_data_free_func) { GtkListBoxPrivate *priv = BOX_PRIV (box); g_return_if_fail (GTK_IS_LIST_BOX (box)); g_return_if_fail (model == NULL || G_IS_LIST_MODEL (model)); g_return_if_fail (model == NULL || create_widget_func != NULL); if (priv->bound_model) { if (priv->create_widget_func_data_destroy) priv->create_widget_func_data_destroy (priv->create_widget_func_data); g_signal_handlers_disconnect_by_func (priv->bound_model, gtk_list_box_bound_model_changed, box); g_clear_object (&priv->bound_model); } gtk_list_box_forall (GTK_CONTAINER (box), FALSE, (GtkCallback) gtk_widget_destroy, NULL); if (model == NULL) return; priv->bound_model = g_object_ref (model); priv->create_widget_func = create_widget_func; priv->create_widget_func_data = user_data; priv->create_widget_func_data_destroy = user_data_free_func; gtk_list_box_check_model_compat (box); g_signal_connect (priv->bound_model, "items-changed", G_CALLBACK (gtk_list_box_bound_model_changed), box); gtk_list_box_bound_model_changed (model, 0, 0, g_list_model_get_n_items (model), box); }