gridlayout: Convert docs

This commit is contained in:
Matthias Clasen 2021-02-27 18:19:00 -05:00 committed by Emmanuele Bassi
parent 79417d8d40
commit d65a98f828
2 changed files with 70 additions and 76 deletions

View File

@ -18,28 +18,29 @@
*/
/**
* SECTION:gtkgridlayout
* @Short_description: Layout manager for grid-like widgets
* @Title: GtkGridLayout
* @See_also: #GtkBoxLayout
* GtkGridLayout:
*
* GtkGridLayout is a layout manager which arranges child widgets in
* rows and columns, with arbitrary positions and horizontal/vertical
* spans.
* `GtkGridLayout` is a layout manager which arranges child widgets in
* rows and columns.
*
* Children have an "attach point" defined by the horizontal and vertical
* index of the cell they occupy; children can span multiple rows or columns.
* The layout properties for setting the attach points and spans are set
* using the #GtkGridLayoutChild associated to each child widget.
* using the [class@Gtk.GridLayoutChild] associated to each child widget.
*
* The behaviour of GtkGrid when several children occupy the same grid cell
* is undefined.
* The behaviour of `GtkGridLayout` when several children occupy the same
* grid cell is undefined.
*
* GtkGridLayout can be used like a #GtkBoxLayout if all children are attached
* to the same row or column; however, if you only ever need a single row or
* column, you should consider using #GtkBoxLayout.
* `GtkGridLayout` can be used like a `GtkBoxLayout` if all children are
* attached to the same row or column; however, if you only ever need a
* single row or column, you should consider using `GtkBoxLayout`.
*/
/**
* GtkGridLayoutChild:
*
* `GtkLayoutChild` subclass for children in a `GtkGridLayout`.
*/
#include "config.h"
#include "gtkgridlayout.h"
@ -158,7 +159,7 @@ gtk_grid_layout_child_class_init (GtkGridLayoutChildClass *klass)
gobject_class->get_property = gtk_grid_layout_child_get_property;
/**
* GtkGridLayoutChild:column:
* GtkGridLayoutChild:column: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_column org.gtk.Property.set=gtk_grid_layout_child_set_column)
*
* The column to place the child in.
*/
@ -170,7 +171,7 @@ gtk_grid_layout_child_class_init (GtkGridLayoutChildClass *klass)
GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkGridLayoutChild:row:
* GtkGridLayoutChild:row: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_row org.gtk.Property.set=gtk_grid_layout_child_set_row)
*
* The row to place the child in.
*/
@ -182,7 +183,7 @@ gtk_grid_layout_child_class_init (GtkGridLayoutChildClass *klass)
GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkGridLayoutChild:column-span:
* GtkGridLayoutChild:column-span: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_column_span org.gtk.Property.set=gtk_grid_layout_child_set_column_span)
*
* The number of columns the child spans to.
*/
@ -194,7 +195,7 @@ gtk_grid_layout_child_class_init (GtkGridLayoutChildClass *klass)
GTK_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkGridLayoutChild:row-span:
* GtkGridLayoutChild:row-span: (attributes org.gtk.Property.get=gtk_grid_layout_child_get_row_span org.gtk.Property.set=gtk_grid_layout_child_set_row_span)
*
* The number of rows the child spans to.
*/
@ -216,8 +217,8 @@ gtk_grid_layout_child_init (GtkGridLayoutChild *self)
}
/**
* gtk_grid_layout_child_set_row:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_set_row: (attributes org.gtk.Method.set_property=row)
* @child: a `GtkGridLayoutChild`
* @row: the row for @child
*
* Sets the row to place @child in.
@ -239,8 +240,8 @@ gtk_grid_layout_child_set_row (GtkGridLayoutChild *child,
}
/**
* gtk_grid_layout_child_get_row:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_get_row: (attributes org.gtk.Method.get_property=row)
* @child: a `GtkGridLayoutChild`
*
* Retrieves the row number to which @child attaches its top side.
*
@ -255,8 +256,8 @@ gtk_grid_layout_child_get_row (GtkGridLayoutChild *child)
}
/**
* gtk_grid_layout_child_set_column:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_set_column: (attributes org.gtk.Method.set_property=column)
* @child: a `GtkGridLayoutChild`
* @column: the attach point for @child
*
* Sets the column number to attach the left side of @child.
@ -278,8 +279,8 @@ gtk_grid_layout_child_set_column (GtkGridLayoutChild *child,
}
/**
* gtk_grid_layout_child_get_column:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_get_column: (attributes org.gtk.Method.get_property=column)
* @child: a `GtkGridLayoutChild`
*
* Retrieves the column number to which @child attaches its left side.
*
@ -294,8 +295,8 @@ gtk_grid_layout_child_get_column (GtkGridLayoutChild *child)
}
/**
* gtk_grid_layout_child_set_column_span:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_set_column_span: (attributes org.gtk.Method.set_property=column-span)
* @child: a `GtkGridLayoutChild`
* @span: the span of @child
*
* Sets the number of columns @child spans to.
@ -317,8 +318,8 @@ gtk_grid_layout_child_set_column_span (GtkGridLayoutChild *child,
}
/**
* gtk_grid_layout_child_get_column_span:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_get_column_span: (attributes org.gtk.Method.get_property=column-span)
* @child: a `GtkGridLayoutChild`
*
* Retrieves the number of columns that @child spans to.
*
@ -333,8 +334,8 @@ gtk_grid_layout_child_get_column_span (GtkGridLayoutChild *child)
}
/**
* gtk_grid_layout_child_set_row_span:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_set_row_span: (attributes org.gtk.Method.set_property=row-span)
* @child: a `GtkGridLayoutChild`
* @span: the span of @child
*
* Sets the number of rows @child spans to.
@ -356,8 +357,8 @@ gtk_grid_layout_child_set_row_span (GtkGridLayoutChild *child,
}
/**
* gtk_grid_layout_child_get_row_span:
* @child: a #GtkGridLayoutChild
* gtk_grid_layout_child_get_row_span: (attributes org.gtk.Method.get_property=row-span)
* @child: a `GtkGridLayoutChild`
*
* Retrieves the number of rows that @child spans to.
*
@ -1660,7 +1661,7 @@ gtk_grid_layout_class_init (GtkGridLayoutClass *klass)
gobject_class->finalize = gtk_grid_layout_finalize;
/**
* GtkGridLayout:row-spacing:
* GtkGridLayout:row-spacing: (attributes org.gtk.Property.get=gtk_grid_layout_get_row_spacing org.gtk.Property.set=gtk_grid_layout_set_row_spacing)
*
* The amount of space between to consecutive rows.
*/
@ -1672,7 +1673,7 @@ gtk_grid_layout_class_init (GtkGridLayoutClass *klass)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkGridLayout:column-spacing:
* GtkGridLayout:column-spacing: (attributes org.gtk.Property.get=gtk_grid_layout_get_column_spacing org.gtk.Property.set=gtk_grid_layout_set_column_spacing)
*
* The amount of space between to consecutive columns.
*/
@ -1684,7 +1685,7 @@ gtk_grid_layout_class_init (GtkGridLayoutClass *klass)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkGridLayout:row-homogeneous:
* GtkGridLayout:row-homogeneous: (attributes org.gtk.Property.get=gtk_grid_layout_get_row_homogeneous org.gtk.Property.set=gtk_grid_layout_set_row_homogeneous)
*
* Whether all the rows in the grid have the same height.
*/
@ -1696,7 +1697,7 @@ gtk_grid_layout_class_init (GtkGridLayoutClass *klass)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkGridLayout:column-homogeneous:
* GtkGridLayout:column-homogeneous: (attributes org.gtk.Property.get=gtk_grid_layout_get_column_homogeneous org.gtk.Property.set=gtk_grid_layout_set_column_homogeneous)
*
* Whether all the columns in the grid have the same width.
*/
@ -1708,7 +1709,7 @@ gtk_grid_layout_class_init (GtkGridLayoutClass *klass)
GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkGridLayout:baseline-row:
* GtkGridLayout:baseline-row: (attributes org.gtk.Property.get=gtk_grid_layout_get_baseline_row org.gtk.Property.set=gtk_grid_layout_set_baseline_row)
*
* The row to align to the baseline, when #GtkWidget:valign is set
* to %GTK_ALIGN_BASELINE.
@ -1731,9 +1732,9 @@ gtk_grid_layout_init (GtkGridLayout *self)
/**
* gtk_grid_layout_new:
*
* Creates a new #GtkGridLayout.
* Creates a new `GtkGridLayout`.
*
* Returns: the newly created #GtkGridLayout
* Returns: the newly created `GtkGridLayout`
*/
GtkLayoutManager *
gtk_grid_layout_new (void)
@ -1742,8 +1743,8 @@ gtk_grid_layout_new (void)
}
/**
* gtk_grid_layout_set_row_homogeneous:
* @grid: a #GtkGridLayout
* gtk_grid_layout_set_row_homogeneous: (attributes org.gtk.Method.set_property=row-homogeneous)
* @grid: a `GtkGridLayout`
* @homogeneous: %TRUE to make rows homogeneous
*
* Sets whether all rows of @grid should have the same height.
@ -1765,8 +1766,8 @@ gtk_grid_layout_set_row_homogeneous (GtkGridLayout *grid,
}
/**
* gtk_grid_layout_get_row_homogeneous:
* @grid: a #GtkGridLayout
* gtk_grid_layout_get_row_homogeneous: (attributes org.gtk.Method.get_property=row-homogeneous)
* @grid: a `GtkGridLayout`
*
* Checks whether all rows of @grid should have the same height.
*
@ -1781,8 +1782,8 @@ gtk_grid_layout_get_row_homogeneous (GtkGridLayout *grid)
}
/**
* gtk_grid_layout_set_row_spacing:
* @grid: a #GtkGridLayout
* gtk_grid_layout_set_row_spacing: (attributes org.gtk.Method.set_property=row-spacing)
* @grid: a `GtkGridLayout`
* @spacing: the amount of space between rows, in pixels
*
* Sets the amount of space to insert between consecutive rows.
@ -1804,8 +1805,8 @@ gtk_grid_layout_set_row_spacing (GtkGridLayout *grid,
}
/**
* gtk_grid_layout_get_row_spacing:
* @grid: a #GtkGridLayout
* gtk_grid_layout_get_row_spacing: (attributes org.gtk.Method.get_property=row-spacing)
* @grid: a `GtkGridLayout`
*
* Retrieves the spacing set with gtk_grid_layout_set_row_spacing().
*
@ -1820,8 +1821,8 @@ gtk_grid_layout_get_row_spacing (GtkGridLayout *grid)
}
/**
* gtk_grid_layout_set_column_homogeneous:
* @grid: a #GtkGridLayout
* gtk_grid_layout_set_column_homogeneous: (attributes org.gtk.Method.set_property=column-homogeneous)
* @grid: a `GtkGridLayout`
* @homogeneous: %TRUE to make columns homogeneous
*
* Sets whether all columns of @grid should have the same width.
@ -1843,8 +1844,8 @@ gtk_grid_layout_set_column_homogeneous (GtkGridLayout *grid,
}
/**
* gtk_grid_layout_get_column_homogeneous:
* @grid: a #GtkGridLayout
* gtk_grid_layout_get_column_homogeneous: (attributes org.gtk.Method.get_property=column-homogeneous)
* @grid: a `GtkGridLayout`
*
* Checks whether all columns of @grid should have the same width.
*
@ -1859,8 +1860,8 @@ gtk_grid_layout_get_column_homogeneous (GtkGridLayout *grid)
}
/**
* gtk_grid_layout_set_column_spacing:
* @grid: a #GtkGridLayout
* gtk_grid_layout_set_column_spacing: (attributes org.gtk.Method.set_property=column-spacing)
* @grid: a `GtkGridLayout`
* @spacing: the amount of space between columns, in pixels
*
* Sets the amount of space to insert between consecutive columns.
@ -1882,8 +1883,8 @@ gtk_grid_layout_set_column_spacing (GtkGridLayout *grid,
}
/**
* gtk_grid_layout_get_column_spacing:
* @grid: a #GtkGridLayout
* gtk_grid_layout_get_column_spacing: (attributes org.gtk.Method.get_property=column-spacing)
* @grid: a `GtkGridLayout`
*
* Retrieves the spacing set with gtk_grid_layout_set_column_spacing().
*
@ -1956,9 +1957,9 @@ get_row_properties_or_default (GtkGridLayout *self,
/**
* gtk_grid_layout_set_row_baseline_position:
* @grid: a #GtkGridLayout
* @grid: a `GtkGridLayout`
* @row: a row index
* @pos: a #GtkBaselinePosition
* @pos: a `GtkBaselinePosition`
*
* Sets how the baseline should be positioned on @row of the
* grid, in case that row is assigned more space than is requested.
@ -1983,12 +1984,15 @@ gtk_grid_layout_set_row_baseline_position (GtkGridLayout *grid,
/**
* gtk_grid_layout_get_row_baseline_position:
* @grid: a #GtkGridLayout
* @grid: a `GtkGridLayout`
* @row: a row index
*
* Returns the baseline position of @row as set by
* gtk_grid_layout_set_row_baseline_position(), or the default value
* of %GTK_BASELINE_POSITION_CENTER.
* Returns the baseline position of @row.
*
* If no value has been set with
* [method@Gtk.GridLayout.set_row_baseline_position],
* the default value of %GTK_BASELINE_POSITION_CENTER
* is returned.
*
* Returns: the baseline position of @row
*/
@ -2006,8 +2010,8 @@ gtk_grid_layout_get_row_baseline_position (GtkGridLayout *grid,
}
/**
* gtk_grid_layout_set_baseline_row:
* @grid: a #GtkGridLayout
* gtk_grid_layout_set_baseline_row: (attributes org.gtk.Method.set_property=baseline-row)
* @grid: a `GtkGridLayout`
* @row: the row index
*
* Sets which row defines the global baseline for the entire grid.
@ -2031,8 +2035,8 @@ gtk_grid_layout_set_baseline_row (GtkGridLayout *grid,
}
/**
* gtk_grid_layout_get_baseline_row:
* @grid: a #GtkGridLayout
* gtk_grid_layout_get_baseline_row: (attributes org.gtk.Method.get_property=baseline-row)
* @grid: a `GtkGridLayout`
*
* Retrieves the row set with gtk_grid_layout_set_baseline_row().
*

View File

@ -25,11 +25,6 @@ G_BEGIN_DECLS
#define GTK_TYPE_GRID_LAYOUT (gtk_grid_layout_get_type ())
#define GTK_TYPE_GRID_LAYOUT_CHILD (gtk_grid_layout_child_get_type ())
/**
* GtkGridLayout:
*
* Layout manager for grid-like widgets.
*/
GDK_AVAILABLE_IN_ALL
G_DECLARE_FINAL_TYPE (GtkGridLayout, gtk_grid_layout, GTK, GRID_LAYOUT, GtkLayoutManager)
@ -69,11 +64,6 @@ void gtk_grid_layout_set_baseline_row (GtkGrid
GDK_AVAILABLE_IN_ALL
int gtk_grid_layout_get_baseline_row (GtkGridLayout *grid);
/**
* GtkGridLayoutChild:
*
* Layout properties for children of #GtkGridLayout.
*/
GDK_AVAILABLE_IN_ALL
G_DECLARE_FINAL_TYPE (GtkGridLayoutChild, gtk_grid_layout_child, GTK, GRID_LAYOUT_CHILD, GtkLayoutChild)