gtk2/gtk/gtklistbox.h

278 lines
12 KiB
C
Raw Normal View History

/*
* 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 <alexl@redhat.com>
*
*/
#ifndef __GTK_LIST_BOX_H__
#define __GTK_LIST_BOX_H__
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif
2020-05-08 12:48:00 +00:00
#include <gtk/gtkwidget.h>
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.
2017-01-19 09:02:04 +00:00
* @activate:
*/
struct _GtkListBoxRowClass
{
GtkWidgetClass parent_class;
/*< public >*/
void (* activate) (GtkListBoxRow *row);
/*< private >*/
gpointer padding[8];
};
2013-06-11 10:59:32 +00:00
/**
* GtkListBoxFilterFunc:
* @row: the row that may be filtered
* @user_data: (closure): user data
2013-06-11 10:59:32 +00:00
*
* 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);
2013-06-11 10:59:32 +00:00
/**
* GtkListBoxSortFunc:
* @row1: the first row
* @row2: the second row
* @user_data: (closure): user data
2013-06-11 10:59:32 +00:00
*
2013-09-21 00:16:00 +00:00
* Compare two rows to determine which should be first.
2013-06-11 10:59:32 +00:00
*
* Returns: < 0 if @row1 should be before @row2, 0 if they are
* equal and > 0 otherwise
2013-06-11 10:59:32 +00:00
*/
2020-07-24 13:54:49 +00:00
typedef int (*GtkListBoxSortFunc) (GtkListBoxRow *row1,
GtkListBoxRow *row2,
gpointer user_data);
2013-06-11 10:59:32 +00:00
/**
* GtkListBoxUpdateHeaderFunc:
* @row: the row to update
* @before: (nullable): the row before @row, or %NULL if it is first
* @user_data: (closure): user data
2013-06-11 10:59:32 +00:00
*
* Whenever @row changes or which row is before @row changes this
2021-03-02 03:47:51 +00:00
* 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.
2013-06-11 10:59:32 +00:00
*/
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
*
2021-03-02 03:47:51 +00:00
* 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.
*
2021-03-02 03:47:51 +00:00
* 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
2020-07-24 13:54:49 +00:00
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,
2020-07-24 13:54:49 +00:00
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,
2020-07-24 13:54:49 +00:00
int index_);
GDK_AVAILABLE_IN_ALL
GtkListBoxRow* gtk_list_box_get_row_at_y (GtkListBox *box,
2020-07-24 13:54:49 +00:00
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