diff --git a/gtk/gtkgrid.c b/gtk/gtkgrid.c index f5909b7f2f..00ffd6643e 100644 --- a/gtk/gtkgrid.c +++ b/gtk/gtkgrid.c @@ -48,6 +48,65 @@ * from the grid, use gtk_grid_remove(). The behaviour of GtkGrid when * several children occupy the same grid cell is undefined. * + * # GtkGrid as GtkBuildable + * + * Every child in a GtkGrid has access to a custom #GtkBuildable element, called ´´. + * It can by used to specify a position in the grid and optionally spans. + * All properties that can be used in the ´´ element are implemented by #GtkGridLayoutChild. + * + * It is implemented by #GtkWidget using #GtkLayoutManager. + * + * To showcase it, here is a simple example: + * + * |[ + * + * + * + * Button 1 + * + * 0 + * 0 + * + * + * + * + * + * Button 2 + * + * 1 + * 0 + * + * + * + * + * + * Button 3 + * + * 2 + * 0 + * 2 + * + * + * + * + * + * Button 4 + * + * 0 + * 1 + * 2 + * + * + * + * + * ]| + * + * It organizes the first two buttons side-by-side in one cell each. + * The third button is in the last column but spans across two rows. + * This is defined by the ´row-span´ property. + * The last button is located in the second row and spans across two columns, + * which is defined by the ´column-span´ property. + * * # CSS nodes * * GtkGrid uses a single CSS node with name `grid`. diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c index ba02a6af93..990d7c27ab 100644 --- a/gtk/gtkwidget.c +++ b/gtk/gtkwidget.c @@ -257,7 +257,7 @@ * custom `` element, used to define layout properties: * * |[ - * + * * * * Description