diff options
author | Matthias Clasen <mclasen@redhat.com> | 2021-03-01 22:47:38 -0500 |
---|---|---|
committer | Emmanuele Bassi <ebassi@gnome.org> | 2021-03-11 16:37:37 +0000 |
commit | 86d2a448501bc5a4308447d4bbc3d16ba576897b (patch) | |
tree | ed67ffc7cedc37e27a21df656ce2054b11d47f88 | |
parent | ef429c587bc3e0c1fb5032fd15b16afb5e8905f0 (diff) | |
download | gtk+-86d2a448501bc5a4308447d4bbc3d16ba576897b.tar.gz |
iconview: Add a summary
-rw-r--r-- | gtk/gtkiconview.c | 20 | ||||
-rw-r--r-- | gtk/gtkiconview.h | 4 |
2 files changed, 13 insertions, 11 deletions
diff --git a/gtk/gtkiconview.c b/gtk/gtkiconview.c index cce12cc45d..1d7cb97fcf 100644 --- a/gtk/gtkiconview.c +++ b/gtk/gtkiconview.c @@ -49,15 +49,15 @@ #include <string.h> /** - * SECTION:gtkiconview - * @title: GtkIconView - * @short_description: A widget which displays a list of icons in a grid + * GtkIconView: * - * #GtkIconView provides an alternative view on a #GtkTreeModel. + * `GtkIconView` is a widget which displays data in a grid of icons. + * + * `GtkIconView` provides an alternative view on a `GtkTreeModel`. * It displays the model as a grid of icons with labels. Like - * #GtkTreeView, it allows to select one or multiple items - * (depending on the selection mode, see gtk_icon_view_set_selection_mode()). - * In addition to selection with the arrow keys, #GtkIconView supports + * [class@Gtk.TreeView], it allows to select one or multiple items + * (depending on the selection mode, see [method@Gtk.IconView.set_selection_mode]). + * In addition to selection with the arrow keys, `GtkIconView` supports * rubberband selection, which is controlled by dragging the pointer. * * Note that if the tree model is backed by an actual tree store (as @@ -67,12 +67,12 @@ * * # CSS nodes * - * |[<!-- language="plain" --> + * ``` * iconview.view * ╰── [rubberband] - * ]| + * ``` * - * GtkIconView has a single CSS node with name iconview and style class .view. + * `GtkIconView` has a single CSS node with name iconview and style class .view. * For rubberband selection, a subnode with name rubberband is used. */ diff --git a/gtk/gtkiconview.h b/gtk/gtkiconview.h index 7a204b54d9..3bdf57f0c8 100644 --- a/gtk/gtkiconview.h +++ b/gtk/gtkiconview.h @@ -43,7 +43,9 @@ typedef struct _GtkIconView GtkIconView; * @data: (closure): user data * * A function used by gtk_icon_view_selected_foreach() to map all - * selected rows. It will be called on every selected row in the view. + * selected rows. + * + * It will be called on every selected row in the view. */ typedef void (* GtkIconViewForeachFunc) (GtkIconView *icon_view, GtkTreePath *path, |