iconview: Add a summary

This commit is contained in:
Matthias Clasen 2021-03-01 22:47:38 -05:00 committed by Emmanuele Bassi
parent ef429c587b
commit 86d2a44850
2 changed files with 13 additions and 11 deletions

View File

@ -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.
*/

View File

@ -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,