/* * Copyright (c) 2013 Red Hat, Inc. * * This program 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 program 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 program; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA * * Author: Alexander Larsson * */ #ifndef __GTK_LIST_BOX_H__ #define __GTK_LIST_BOX_H__ #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) #error "Only can be included directly." #endif #include G_BEGIN_DECLS #define GTK_TYPE_LIST_BOX (gtk_list_box_get_type ()) #define GTK_LIST_BOX(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_LIST_BOX, GtkListBox)) #define GTK_IS_LIST_BOX(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_LIST_BOX)) typedef struct _GtkListBox GtkListBox; typedef struct _GtkListBoxRow GtkListBoxRow; typedef struct _GtkListBoxRowClass GtkListBoxRowClass; #define GTK_TYPE_LIST_BOX_ROW (gtk_list_box_row_get_type ()) #define GTK_LIST_BOX_ROW(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_LIST_BOX_ROW, GtkListBoxRow)) #define GTK_LIST_BOX_ROW_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_LIST_BOX_ROW, GtkListBoxRowClass)) #define GTK_IS_LIST_BOX_ROW(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_LIST_BOX_ROW)) #define GTK_IS_LIST_BOX_ROW_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_LIST_BOX_ROW)) #define GTK_LIST_BOX_ROW_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_LIST_BOX_ROW, GtkListBoxRowClass)) struct _GtkListBoxRow { GtkWidget parent_instance; }; /** * GtkListBoxRowClass: * @parent_class: The parent class. * @activate: */ struct _GtkListBoxRowClass { GtkWidgetClass parent_class; /*< public >*/ void (* activate) (GtkListBoxRow *row); /*< private >*/ gpointer padding[8]; }; /** * GtkListBoxFilterFunc: * @row: the row that may be filtered * @user_data: (closure): user data * * Will be called whenever the row changes or is added and lets you control * if the row should be visible or not. * * Returns: %TRUE if the row should be visible, %FALSE otherwise */ typedef gboolean (*GtkListBoxFilterFunc) (GtkListBoxRow *row, gpointer user_data); /** * GtkListBoxSortFunc: * @row1: the first row * @row2: the second row * @user_data: (closure): user data * * Compare two rows to determine which should be first. * * Returns: < 0 if @row1 should be before @row2, 0 if they are * equal and > 0 otherwise */ typedef int (*GtkListBoxSortFunc) (GtkListBoxRow *row1, GtkListBoxRow *row2, gpointer user_data); /** * GtkListBoxUpdateHeaderFunc: * @row: the row to update * @before: (nullable): the row before @row, or %NULL if it is first * @user_data: (closure): user data * * Whenever @row changes or which row is before @row changes this * is called, which lets you update the header on @row. * * You may remove or set a new one via [method@Gtk.ListBoxRow.set_header] * or just change the state of the current header widget. */ typedef void (*GtkListBoxUpdateHeaderFunc) (GtkListBoxRow *row, GtkListBoxRow *before, gpointer user_data); /** * GtkListBoxCreateWidgetFunc: * @item: (type GObject): the item from the model for which to create a widget for * @user_data: (closure): user data * * Called for list boxes that are bound to a `GListModel` with * gtk_list_box_bind_model() for each item that gets added to the model. * * If the widget returned is not a #GtkListBoxRow widget, then the widget * will be inserted as the child of an intermediate #GtkListBoxRow. * * Returns: (transfer full): a `GtkWidget` that represents @item */ typedef GtkWidget * (*GtkListBoxCreateWidgetFunc) (gpointer item, gpointer user_data); GDK_AVAILABLE_IN_ALL GType gtk_list_box_row_get_type (void) G_GNUC_CONST; GDK_AVAILABLE_IN_ALL GtkWidget* gtk_list_box_row_new (void); GDK_AVAILABLE_IN_ALL void gtk_list_box_row_set_child (GtkListBoxRow *row, GtkWidget *child); GDK_AVAILABLE_IN_ALL GtkWidget *gtk_list_box_row_get_child (GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL GtkWidget* gtk_list_box_row_get_header (GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL void gtk_list_box_row_set_header (GtkListBoxRow *row, GtkWidget *header); GDK_AVAILABLE_IN_ALL int gtk_list_box_row_get_index (GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL void gtk_list_box_row_changed (GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL gboolean gtk_list_box_row_is_selected (GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL void gtk_list_box_row_set_selectable (GtkListBoxRow *row, gboolean selectable); GDK_AVAILABLE_IN_ALL gboolean gtk_list_box_row_get_selectable (GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL void gtk_list_box_row_set_activatable (GtkListBoxRow *row, gboolean activatable); GDK_AVAILABLE_IN_ALL gboolean gtk_list_box_row_get_activatable (GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL GType gtk_list_box_get_type (void) G_GNUC_CONST; GDK_AVAILABLE_IN_ALL void gtk_list_box_prepend (GtkListBox *box, GtkWidget *child); GDK_AVAILABLE_IN_ALL void gtk_list_box_append (GtkListBox *box, GtkWidget *child); GDK_AVAILABLE_IN_ALL void gtk_list_box_insert (GtkListBox *box, GtkWidget *child, int position); GDK_AVAILABLE_IN_ALL void gtk_list_box_remove (GtkListBox *box, GtkWidget *child); GDK_AVAILABLE_IN_ALL GtkListBoxRow* gtk_list_box_get_selected_row (GtkListBox *box); GDK_AVAILABLE_IN_ALL GtkListBoxRow* gtk_list_box_get_row_at_index (GtkListBox *box, int index_); GDK_AVAILABLE_IN_ALL GtkListBoxRow* gtk_list_box_get_row_at_y (GtkListBox *box, int y); GDK_AVAILABLE_IN_ALL void gtk_list_box_select_row (GtkListBox *box, GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_placeholder (GtkListBox *box, GtkWidget *placeholder); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_adjustment (GtkListBox *box, GtkAdjustment *adjustment); GDK_AVAILABLE_IN_ALL GtkAdjustment *gtk_list_box_get_adjustment (GtkListBox *box); typedef void (* GtkListBoxForeachFunc) (GtkListBox *box, GtkListBoxRow *row, gpointer user_data); GDK_AVAILABLE_IN_ALL void gtk_list_box_selected_foreach (GtkListBox *box, GtkListBoxForeachFunc func, gpointer data); GDK_AVAILABLE_IN_ALL GList *gtk_list_box_get_selected_rows (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_unselect_row (GtkListBox *box, GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL void gtk_list_box_select_all (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_unselect_all (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_selection_mode (GtkListBox *box, GtkSelectionMode mode); GDK_AVAILABLE_IN_ALL GtkSelectionMode gtk_list_box_get_selection_mode (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_filter_func (GtkListBox *box, GtkListBoxFilterFunc filter_func, gpointer user_data, GDestroyNotify destroy); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_header_func (GtkListBox *box, GtkListBoxUpdateHeaderFunc update_header, gpointer user_data, GDestroyNotify destroy); GDK_AVAILABLE_IN_ALL void gtk_list_box_invalidate_filter (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_invalidate_sort (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_invalidate_headers (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_sort_func (GtkListBox *box, GtkListBoxSortFunc sort_func, gpointer user_data, GDestroyNotify destroy); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_activate_on_single_click (GtkListBox *box, gboolean single); GDK_AVAILABLE_IN_ALL gboolean gtk_list_box_get_activate_on_single_click (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_drag_unhighlight_row (GtkListBox *box); GDK_AVAILABLE_IN_ALL void gtk_list_box_drag_highlight_row (GtkListBox *box, GtkListBoxRow *row); GDK_AVAILABLE_IN_ALL GtkWidget* gtk_list_box_new (void); GDK_AVAILABLE_IN_ALL void gtk_list_box_bind_model (GtkListBox *box, GListModel *model, GtkListBoxCreateWidgetFunc create_widget_func, gpointer user_data, GDestroyNotify user_data_free_func); GDK_AVAILABLE_IN_ALL void gtk_list_box_set_show_separators (GtkListBox *box, gboolean show_separators); GDK_AVAILABLE_IN_ALL gboolean gtk_list_box_get_show_separators (GtkListBox *box); G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkListBox, g_object_unref) G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkListBoxRow, g_object_unref) G_END_DECLS #endif