@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gtk/icon-view.js

@@ -7,6 +7,33 @@ import { CellRenderer } from "./cell-renderer.js";
 import { TreeModel } from "./tree-model.js";
 import * as Gdk from "../gdk/index.js";
 import { Widget } from "./widget.js";
+/**
+ * `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
+ * [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
+ * opposed to a flat list where the mapping to icons is obvious),
+ * `GtkIconView` will only display the first level of the tree and
+ * ignore the tree’s branches.
+ *
+ * ## CSS nodes
+ *
+ * ```
+ * iconview.view
+ * ╰── [rubberband]
+ * ```
+ *
+ * `GtkIconView` has a single CSS node with name iconview and style class .view.
+ * For rubberband selection, a subnode with name rubberband is used.
+ */
 const SIGNAL_META = {
     "activate-cursor-item": { params: [], returnType: { type: "boolean" } },
     "item-activated": {
@@ -31,9 +58,17 @@ const SIGNAL_META = {
     "unselect-all": { params: [], returnType: { type: "undefined" } },
 };
 export class IconView extends Widget {
+    /**
+     * Creates a new `GtkIconView` widget
+     */
     constructor(...args) {
         super(...args);
     }
+    /**
+     * Creates a new `GtkIconView` widget using the
+     * specified `area` to layout cells inside the icons.
+     * @param area - the `GtkCellArea` to use to layout cells
+     */
     static viewNewWithArea(area) {
         const ptr = call("libgtk-4.so.1", "gtk_icon_view_new_with_area", [
             {
@@ -43,6 +78,10 @@ export class IconView extends Widget {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, IconView);
     }
+    /**
+     * Creates a new `GtkIconView` widget with the model @model.
+     * @param model - The model.
+     */
     static viewNewWithModel(model) {
         const ptr = call("libgtk-4.so.1", "gtk_icon_view_new_with_model", [
             {
@@ -58,6 +97,11 @@ export class IconView extends Widget {
             borrowed: true,
         });
     }
+    /**
+     * Creates a `GdkPaintable` representation of the item at @path.
+     * This image is used for a drag icon.
+     * @param path - a `GtkTreePath` in @icon_view
+     */
     createDragIcon(path) {
         const ptr = call("libgtk-4.so.1", "gtk_icon_view_create_drag_icon", [
             {
@@ -78,6 +122,12 @@ export class IconView extends Widget {
             return null;
         return getObject(ptr, Gdk.Paintable);
     }
+    /**
+     * Turns `icon_view` into a drop destination for automatic DND. Calling this
+     * method sets `GtkIconView`:reorderable to %FALSE.
+     * @param formats - the formats that the drag will support
+     * @param actions - the bitmask of possible actions for a drag to this
+     */
     enableModelDragDest(formats, actions) {
         call("libgtk-4.so.1", "gtk_icon_view_enable_model_drag_dest", [
             {
@@ -99,6 +149,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Turns `icon_view` into a drag source for automatic DND. Calling this
+     * method sets `GtkIconView`:reorderable to %FALSE.
+     * @param startButtonMask - Mask of allowed buttons to start drag
+     * @param formats - the formats that the drag will support
+     * @param actions - the bitmask of possible actions for a drag from this
+     */
     enableModelDragSource(startButtonMask, formats, actions) {
         call("libgtk-4.so.1", "gtk_icon_view_enable_model_drag_source", [
             {
@@ -124,6 +181,9 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Gets the setting set by gtk_icon_view_set_activate_on_single_click().
+     */
     getActivateOnSingleClick() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_activate_on_single_click", [
             {
@@ -132,6 +192,15 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Fills the bounding rectangle in widget coordinates for the cell specified by
+     * `path` and @cell. If `cell` is %NULL the main cell area is used.
+     *
+     * This function is only valid if `icon_view` is realized.
+     * @param path - a `GtkTreePath`
+     * @param cell - a `GtkCellRenderer`
+     * @param rect - rectangle to fill with cell rect
+     */
     getCellRect(path, rect, cell) {
         return call("libgtk-4.so.1", "gtk_icon_view_get_cell_rect", [
             {
@@ -165,6 +234,9 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns the value of the ::column-spacing property.
+     */
     getColumnSpacing() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_column_spacing", [
             {
@@ -173,6 +245,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value of the ::columns property.
+     */
     getColumns() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_columns", [
             {
@@ -181,6 +256,13 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Determines the destination item for a given position.
+     * @param dragX - the position to determine the destination item for
+     * @param dragY - the position to determine the destination item for
+     * @param path - Return location for the path of the item
+     * @param pos - Return location for the drop position
+     */
     getDestItemAtPos(dragX, dragY, path, pos) {
         return call("libgtk-4.so.1", "gtk_icon_view_get_dest_item_at_pos", [
             {
@@ -217,6 +299,11 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets information about the item that is highlighted for feedback.
+     * @param path - Return location for the path of
+     * @param pos - Return location for the drop position
+     */
     getDragDestItem(path, pos) {
         call("libgtk-4.so.1", "gtk_icon_view_get_drag_dest_item", [
             {
@@ -245,6 +332,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Gets the path and cell for the icon at the given position.
+     * @param x - The x position to be identified
+     * @param y - The y position to be identified
+     * @param path - Return location for the path
+     * @param cell - Return location for the renderer
+     */
     getItemAtPos(x, y, path, cell) {
         return call("libgtk-4.so.1", "gtk_icon_view_get_item_at_pos", [
             {
@@ -278,6 +372,11 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the column in which the item `path` is currently
+     * displayed. Column numbers start at 0.
+     * @param path - the `GtkTreePath` of the item
+     */
     getItemColumn(path) {
         return call("libgtk-4.so.1", "gtk_icon_view_get_item_column", [
             {
@@ -295,6 +394,10 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value of the ::item-orientation property which determines
+     * whether the labels are drawn beside the icons instead of below.
+     */
     getItemOrientation() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_item_orientation", [
             {
@@ -303,6 +406,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value of the ::item-padding property.
+     */
     getItemPadding() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_item_padding", [
             {
@@ -311,6 +417,11 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the row in which the item `path` is currently
+     * displayed. Row numbers start at 0.
+     * @param path - the `GtkTreePath` of the item
+     */
     getItemRow(path) {
         return call("libgtk-4.so.1", "gtk_icon_view_get_item_row", [
             {
@@ -328,6 +439,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value of the ::item-width property.
+     */
     getItemWidth() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_item_width", [
             {
@@ -336,6 +450,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value of the ::margin property.
+     */
     getMargin() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_margin", [
             {
@@ -344,6 +461,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the column with markup text for @icon_view.
+     */
     getMarkupColumn() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_markup_column", [
             {
@@ -352,6 +472,10 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the model the `GtkIconView` is based on.  Returns %NULL if the
+     * model is unset.
+     */
     getModel() {
         const ptr = call("libgtk-4.so.1", "gtk_icon_view_get_model", [
             {
@@ -363,6 +487,11 @@ export class IconView extends Widget {
             return null;
         return getObject(ptr, TreeModel);
     }
+    /**
+     * Gets the path for the icon at the given position.
+     * @param x - The x position to be identified
+     * @param y - The y position to be identified
+     */
     getPathAtPos(x, y) {
         const ptr = call("libgtk-4.so.1", "gtk_icon_view_get_path_at_pos", [
             {
@@ -387,6 +516,9 @@ export class IconView extends Widget {
             return null;
         return getObject(ptr, TreePath);
     }
+    /**
+     * Returns the column with pixbufs for @icon_view.
+     */
     getPixbufColumn() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_pixbuf_column", [
             {
@@ -395,6 +527,10 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Retrieves whether the user can reorder the list via drag-and-drop.
+     * See gtk_icon_view_set_reorderable().
+     */
     getReorderable() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_reorderable", [
             {
@@ -403,6 +539,9 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns the value of the ::row-spacing property.
+     */
     getRowSpacing() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_row_spacing", [
             {
@@ -411,6 +550,25 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Creates a list of paths of all selected items. Additionally, if you are
+     * planning on modifying the model after calling this function, you may
+     * want to convert the returned list into a list of `GtkTreeRowReferences`.
+     * To do this, you can use gtk_tree_row_reference_new().
+     *
+     * To free the return value, use `g_list_free_full`:
+     *
+     * ```c
+     * GtkWidget *icon_view = gtk_icon_view_new ();
+     * // Use icon_view
+     *
+     * GList *list = gtk_icon_view_get_selected_items (GTK_ICON_VIEW (icon_view));
+     *
+     * // use list
+     *
+     * g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
+     * ```
+     */
     getSelectedItems() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_selected_items", [
             {
@@ -428,6 +586,9 @@ export class IconView extends Widget {
             borrowed: true,
         });
     }
+    /**
+     * Gets the selection mode of the @icon_view.
+     */
     getSelectionMode() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_selection_mode", [
             {
@@ -436,6 +597,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value of the ::spacing property.
+     */
     getSpacing() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_spacing", [
             {
@@ -444,6 +608,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the column with text for @icon_view.
+     */
     getTextColumn() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_text_column", [
             {
@@ -452,6 +619,10 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the column of @icon_view’s model which is being used for
+     * displaying tooltips on @icon_view’s rows.
+     */
     getTooltipColumn() {
         return call("libgtk-4.so.1", "gtk_icon_view_get_tooltip_column", [
             {
@@ -460,6 +631,24 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * This function is supposed to be used in a `GtkWidget::query-tooltip`
+     * signal handler for `GtkIconView`. The @x, `y` and `keyboard_tip` values
+     * which are received in the signal handler, should be passed to this
+     * function without modification.
+     *
+     * The return value indicates whether there is an icon view item at the given
+     * coordinates (%TRUE) or not (%FALSE) for mouse tooltips. For keyboard
+     * tooltips the item returned will be the cursor item. When %TRUE, then any of
+     * @model, `path` and `iter` which have been provided will be set to point to
+     * that row and the corresponding model.
+     * @param x - the x coordinate (relative to widget coordinates)
+     * @param y - the y coordinate (relative to widget coordinates)
+     * @param keyboardTip - whether this is a keyboard tooltip or not
+     * @param model - a pointer to receive a `GtkTreeModel`
+     * @param path - a pointer to receive a `GtkTreePath`
+     * @param iter - a pointer to receive a `GtkTreeIter`
+     */
     getTooltipContext(x, y, keyboardTip, model, path, iter) {
         return call("libgtk-4.so.1", "gtk_icon_view_get_tooltip_context", [
             {
@@ -509,6 +698,14 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Sets `start_path` and `end_path` to be the first and last visible path.
+     * Note that there may be invisible paths in between.
+     *
+     * Both paths should be freed with gtk_tree_path_free() after use.
+     * @param startPath - Return location for start of region
+     * @param endPath - Return location for end of region
+     */
     getVisibleRange(startPath, endPath) {
         return call("libgtk-4.so.1", "gtk_icon_view_get_visible_range", [
             {
@@ -541,6 +738,10 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Activates the item determined by @path.
+     * @param path - The `GtkTreePath` to be activated
+     */
     itemActivated(path) {
         call("libgtk-4.so.1", "gtk_icon_view_item_activated", [
             {
@@ -558,6 +759,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Returns %TRUE if the icon pointed to by `path` is currently
+     * selected. If `path` does not point to a valid location, %FALSE is returned.
+     * @param path - A `GtkTreePath` to check selection on.
+     */
     pathIsSelected(path) {
         return call("libgtk-4.so.1", "gtk_icon_view_path_is_selected", [
             {
@@ -575,6 +781,26 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Moves the alignments of `icon_view` to the position specified by @path.
+     * `row_align` determines where the row is placed, and `col_align` determines
+     * where `column` is placed.  Both are expected to be between 0.0 and 1.0.
+     * 0.0 means left/top alignment, 1.0 means right/bottom alignment, 0.5 means
+     * center.
+     *
+     * If `use_align` is %FALSE, then the alignment arguments are ignored, and the
+     * tree does the minimum amount of work to scroll the item onto the screen.
+     * This means that the item will be scrolled to the edge closest to its current
+     * position.  If the item is currently visible on the screen, nothing is done.
+     *
+     * This function only works if the model is set, and `path` is a valid row on
+     * the model. If the model changes before the `icon_view` is realized, the
+     * centered path will be modified to reflect this change.
+     * @param path - The path of the item to move to.
+     * @param useAlign - whether to use alignment arguments, or %FALSE.
+     * @param rowAlign - The vertical alignment of the item specified by @path.
+     * @param colAlign - The horizontal alignment of the item specified by @path.
+     */
     scrollToPath(path, useAlign, rowAlign, colAlign) {
         call("libgtk-4.so.1", "gtk_icon_view_scroll_to_path", [
             {
@@ -604,6 +830,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Selects all the icons. `icon_view` must has its selection mode set
+     * to %GTK_SELECTION_MULTIPLE.
+     */
     selectAll() {
         call("libgtk-4.so.1", "gtk_icon_view_select_all", [
             {
@@ -612,6 +842,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Selects the row at @path.
+     * @param path - The `GtkTreePath` to be selected.
+     */
     selectPath(path) {
         call("libgtk-4.so.1", "gtk_icon_view_select_path", [
             {
@@ -629,6 +863,12 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Calls a function for each selected icon. Note that the model or
+     * selection cannot be modified from within this function.
+     * @param func - The function to call for each selected icon.
+     * @param data - User data to pass to the function.
+     */
     selectedForeach(func, data) {
         call("libgtk-4.so.1", "gtk_icon_view_selected_foreach", [
             {
@@ -646,6 +886,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Causes the `GtkIconView`::item-activated signal to be emitted on
+     * a single click instead of a double click.
+     * @param single - %TRUE to emit item-activated on a single click
+     */
     setActivateOnSingleClick(single) {
         call("libgtk-4.so.1", "gtk_icon_view_set_activate_on_single_click", [
             {
@@ -658,6 +903,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the ::column-spacing property which specifies the space
+     * which is inserted between the columns of the icon view.
+     * @param columnSpacing - the column spacing
+     */
     setColumnSpacing(columnSpacing) {
         call("libgtk-4.so.1", "gtk_icon_view_set_column_spacing", [
             {
@@ -670,6 +920,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the ::columns property which determines in how
+     * many columns the icons are arranged. If `columns` is
+     * -1, the number of columns will be chosen automatically
+     * to fill the available area.
+     * @param columns - the number of columns
+     */
     setColumns(columns) {
         call("libgtk-4.so.1", "gtk_icon_view_set_columns", [
             {
@@ -682,6 +939,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the item that is highlighted for feedback.
+     * @param path - The path of the item to highlight
+     * @param pos - Specifies where to drop, relative to the item
+     */
     setDragDestItem(pos, path) {
         call("libgtk-4.so.1", "gtk_icon_view_set_drag_dest_item", [
             {
@@ -704,6 +966,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the ::item-orientation property which determines whether the labels
+     * are drawn beside the icons instead of below.
+     * @param orientation - the relative position of texts and icons
+     */
     setItemOrientation(orientation) {
         call("libgtk-4.so.1", "gtk_icon_view_set_item_orientation", [
             {
@@ -716,6 +983,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `GtkIconView`:item-padding property which specifies the padding
+     * around each of the icon view’s items.
+     * @param itemPadding - the item padding
+     */
     setItemPadding(itemPadding) {
         call("libgtk-4.so.1", "gtk_icon_view_set_item_padding", [
             {
@@ -728,6 +1000,12 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the ::item-width property which specifies the width
+     * to use for each item. If it is set to -1, the icon view will
+     * automatically determine a suitable item size.
+     * @param itemWidth - the width for each item
+     */
     setItemWidth(itemWidth) {
         call("libgtk-4.so.1", "gtk_icon_view_set_item_width", [
             {
@@ -740,6 +1018,12 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the ::margin property which specifies the space
+     * which is inserted at the top, bottom, left and right
+     * of the icon view.
+     * @param margin - the margin
+     */
     setMargin(margin) {
         call("libgtk-4.so.1", "gtk_icon_view_set_margin", [
             {
@@ -752,6 +1036,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the column with markup information for `icon_view` to be
+     * @column. The markup column must be of type `G_TYPE_STRING`.
+     * If the markup column is set to something, it overrides
+     * the text column set by gtk_icon_view_set_text_column().
+     * @param column - A column in the currently used model, or -1 to display no text
+     */
     setMarkupColumn(column) {
         call("libgtk-4.so.1", "gtk_icon_view_set_markup_column", [
             {
@@ -764,6 +1055,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the model for a `GtkIconView`.
+     * If the `icon_view` already has a model set, it will remove
+     * it before setting the new model.  If `model` is %NULL, then
+     * it will unset the old model.
+     * @param model - The model.
+     */
     setModel(model) {
         call("libgtk-4.so.1", "gtk_icon_view_set_model", [
             {
@@ -777,6 +1075,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the column with pixbufs for `icon_view` to be @column. The pixbuf
+     * column must be of type `GDK_TYPE_PIXBUF`
+     * @param column - A column in the currently used model, or -1 to disable
+     */
     setPixbufColumn(column) {
         call("libgtk-4.so.1", "gtk_icon_view_set_pixbuf_column", [
             {
@@ -789,6 +1092,21 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * This function is a convenience function to allow you to reorder models that
+     * support the `GtkTreeDragSourceIface` and the `GtkTreeDragDestIface`. Both
+     * `GtkTreeStore` and `GtkListStore` support these. If `reorderable` is %TRUE, then
+     * the user can reorder the model by dragging and dropping rows.  The
+     * developer can listen to these changes by connecting to the model's
+     * row_inserted and row_deleted signals. The reordering is implemented by setting up
+     * the icon view as a drag source and destination. Therefore, drag and
+     * drop can not be used in a reorderable view for any other purpose.
+     *
+     * This function does not give you any degree of control over the order -- any
+     * reordering is allowed.  If more control is needed, you should probably
+     * handle drag and drop manually.
+     * @param reorderable - %TRUE, if the list of items can be reordered.
+     */
     setReorderable(reorderable) {
         call("libgtk-4.so.1", "gtk_icon_view_set_reorderable", [
             {
@@ -801,6 +1119,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the ::row-spacing property which specifies the space
+     * which is inserted between the rows of the icon view.
+     * @param rowSpacing - the row spacing
+     */
     setRowSpacing(rowSpacing) {
         call("libgtk-4.so.1", "gtk_icon_view_set_row_spacing", [
             {
@@ -813,6 +1136,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the selection mode of the @icon_view.
+     * @param mode - The selection mode
+     */
     setSelectionMode(mode) {
         call("libgtk-4.so.1", "gtk_icon_view_set_selection_mode", [
             {
@@ -825,6 +1152,12 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the ::spacing property which specifies the space
+     * which is inserted between the cells (i.e. the icon and
+     * the text) of an item.
+     * @param spacing - the spacing
+     */
     setSpacing(spacing) {
         call("libgtk-4.so.1", "gtk_icon_view_set_spacing", [
             {
@@ -837,6 +1170,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the column with text for `icon_view` to be @column. The text
+     * column must be of type `G_TYPE_STRING`.
+     * @param column - A column in the currently used model, or -1 to display no text
+     */
     setTextColumn(column) {
         call("libgtk-4.so.1", "gtk_icon_view_set_text_column", [
             {
@@ -849,6 +1187,15 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the tip area of `tooltip` to the area which `cell` occupies in
+     * the item pointed to by @path. See also gtk_tooltip_set_tip_area().
+     *
+     * See also gtk_icon_view_set_tooltip_column() for a simpler alternative.
+     * @param tooltip - a `GtkTooltip`
+     * @param path - a `GtkTreePath`
+     * @param cell - a `GtkCellRenderer`
+     */
     setTooltipCell(tooltip, path, cell) {
         call("libgtk-4.so.1", "gtk_icon_view_set_tooltip_cell", [
             {
@@ -875,6 +1222,19 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * If you only plan to have simple (text-only) tooltips on full items, you
+     * can use this function to have `GtkIconView` handle these automatically
+     * for you. `column` should be set to the column in @icon_view’s model
+     * containing the tooltip texts, or -1 to disable this feature.
+     *
+     * When enabled, `GtkWidget:has-tooltip` will be set to %TRUE and
+     * `icon_view` will connect a `GtkWidget::query-tooltip` signal handler.
+     *
+     * Note that the signal handler sets the text with gtk_tooltip_set_markup(),
+     * so &, <, etc have to be escaped in the text.
+     * @param column - an integer, which is a valid column number for @icon_view’s model
+     */
     setTooltipColumn(column) {
         call("libgtk-4.so.1", "gtk_icon_view_set_tooltip_column", [
             {
@@ -887,6 +1247,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the tip area of `tooltip` to be the area covered by the item at @path.
+     * See also gtk_icon_view_set_tooltip_column() for a simpler alternative.
+     * See also gtk_tooltip_set_tip_area().
+     * @param tooltip - a `GtkTooltip`
+     * @param path - a `GtkTreePath`
+     */
     setTooltipItem(tooltip, path) {
         call("libgtk-4.so.1", "gtk_icon_view_set_tooltip_item", [
             {
@@ -908,6 +1275,9 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Unselects all the icons.
+     */
     unselectAll() {
         call("libgtk-4.so.1", "gtk_icon_view_unselect_all", [
             {
@@ -916,6 +1286,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Unselects the row at @path.
+     * @param path - The `GtkTreePath` to be unselected.
+     */
     unselectPath(path) {
         call("libgtk-4.so.1", "gtk_icon_view_unselect_path", [
             {
@@ -933,6 +1307,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Undoes the effect of gtk_icon_view_enable_model_drag_dest(). Calling this
+     * method sets `GtkIconView`:reorderable to %FALSE.
+     */
     unsetModelDragDest() {
         call("libgtk-4.so.1", "gtk_icon_view_unset_model_drag_dest", [
             {
@@ -941,6 +1319,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Undoes the effect of gtk_icon_view_enable_model_drag_source(). Calling this
+     * method sets `GtkIconView`:reorderable to %FALSE.
+     */
     unsetModelDragSource() {
         call("libgtk-4.so.1", "gtk_icon_view_unset_model_drag_source", [
             {
@@ -949,6 +1331,18 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Adds an attribute mapping to the list in @cell_layout.
+     *
+     * The `column` is the column of the model to get a value from, and the
+     * `attribute` is the property on `cell` to be set from that value. So for
+     * example if column 2 of the model contains strings, you could have the
+     * “text” attribute of a `GtkCellRendererText` get its values from column 2.
+     * In this context "attribute" and "property" are used interchangeably.
+     * @param cell - a `GtkCellRenderer`
+     * @param attribute - a property on the renderer
+     * @param column - the column position on the model to get the attribute from
+     */
     addAttribute(cell, attribute, column) {
         call("libgtk-4.so.1", "gtk_cell_layout_add_attribute", [
             {
@@ -969,6 +1363,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Unsets all the mappings on all renderers on `cell_layout` and
+     * removes all renderers from @cell_layout.
+     */
     clear() {
         call("libgtk-4.so.1", "gtk_cell_layout_clear", [
             {
@@ -977,6 +1375,11 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Clears all existing attributes previously set with
+     * gtk_cell_layout_set_attributes().
+     * @param cell - a `GtkCellRenderer` to clear the attribute mapping on
+     */
     clearAttributes(cell) {
         call("libgtk-4.so.1", "gtk_cell_layout_clear_attributes", [
             {
@@ -989,6 +1392,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Returns the underlying `GtkCellArea` which might be `cell_layout` if called on a `GtkCellArea` or might be %NULL if no `GtkCellArea`
+     * is used by @cell_layout.
+     */
     getArea() {
         const ptr = call("libgtk-4.so.1", "gtk_cell_layout_get_area", [
             {
@@ -1000,6 +1407,9 @@ export class IconView extends Widget {
             return null;
         return getObject(ptr, CellArea);
     }
+    /**
+     * Returns the cell renderers which have been added to @cell_layout.
+     */
     getCells() {
         const ptrs = call("libgtk-4.so.1", "gtk_cell_layout_get_cells", [
             {
@@ -1014,6 +1424,15 @@ export class IconView extends Widget {
         });
         return ptrs.map((ptr) => getObject(ptr, CellRenderer));
     }
+    /**
+     * Adds the `cell` to the end of @cell_layout. If `expand` is %FALSE, then the
+     * `cell` is allocated no more space than it needs. Any unused space is
+     * divided evenly between cells for which `expand` is %TRUE.
+     *
+     * Note that reusing the same cell renderer is not supported.
+     * @param cell - a `GtkCellRenderer`
+     * @param expand - %TRUE if `cell` is to be given extra space allocated to @cell_layout
+     */
     packEnd(cell, expand) {
         call("libgtk-4.so.1", "gtk_cell_layout_pack_end", [
             {
@@ -1030,6 +1449,15 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Packs the `cell` into the beginning of @cell_layout. If `expand` is %FALSE,
+     * then the `cell` is allocated no more space than it needs. Any unused space
+     * is divided evenly between cells for which `expand` is %TRUE.
+     *
+     * Note that reusing the same cell renderer is not supported.
+     * @param cell - a `GtkCellRenderer`
+     * @param expand - %TRUE if `cell` is to be given extra space allocated to @cell_layout
+     */
     packStart(cell, expand) {
         call("libgtk-4.so.1", "gtk_cell_layout_pack_start", [
             {
@@ -1046,6 +1474,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Re-inserts `cell` at @position.
+     *
+     * Note that `cell` has already to be packed into `cell_layout` for this to function properly.
+     * @param cell - a `GtkCellRenderer` to reorder
+     * @param position - new position to insert `cell` at
+     */
     reorder(cell, position) {
         call("libgtk-4.so.1", "gtk_cell_layout_reorder", [
             {
@@ -1062,6 +1497,19 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `GtkCellLayout`DataFunc to use for @cell_layout.
+     *
+     * This function is used instead of the standard attributes mapping
+     * for setting the column value, and should set the value of @cell_layout’s
+     * cell renderer(s) as appropriate.
+     *
+     * `func` may be %NULL to remove a previously set function.
+     * @param cell - a `GtkCellRenderer`
+     * @param func - the `GtkCellLayout`DataFunc to use
+     * @param funcData - user data for @func
+     * @param destroy - destroy notify for @func_data
+     */
     setCellDataFunc(cell, destroy, func, funcData) {
         call("libgtk-4.so.1", "gtk_cell_layout_set_cell_data_func", [
             {
@@ -1088,6 +1536,15 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Returns the size of a non-scrolling border around the
+     * outside of the scrollable.
+     *
+     * An example for this would be treeview headers. GTK can use
+     * this information to display overlaid graphics, like the
+     * overshoot indication, at the right position.
+     * @param border - return location for the results
+     */
     getBorder(border) {
         return call("libgtk-4.so.1", "gtk_scrollable_get_border", [
             {
@@ -1107,6 +1564,9 @@ export class IconView extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Retrieves the `GtkAdjustment` used for horizontal scrolling.
+     */
     getHadjustment() {
         const ptr = call("libgtk-4.so.1", "gtk_scrollable_get_hadjustment", [
             {
@@ -1118,6 +1578,9 @@ export class IconView extends Widget {
             return null;
         return getObject(ptr, Adjustment);
     }
+    /**
+     * Gets the horizontal `GtkScrollablePolicy`.
+     */
     getHscrollPolicy() {
         return call("libgtk-4.so.1", "gtk_scrollable_get_hscroll_policy", [
             {
@@ -1126,6 +1589,9 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Retrieves the `GtkAdjustment` used for vertical scrolling.
+     */
     getVadjustment() {
         const ptr = call("libgtk-4.so.1", "gtk_scrollable_get_vadjustment", [
             {
@@ -1137,6 +1603,9 @@ export class IconView extends Widget {
             return null;
         return getObject(ptr, Adjustment);
     }
+    /**
+     * Gets the vertical `GtkScrollablePolicy`.
+     */
     getVscrollPolicy() {
         return call("libgtk-4.so.1", "gtk_scrollable_get_vscroll_policy", [
             {
@@ -1145,6 +1614,10 @@ export class IconView extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Sets the horizontal adjustment of the `GtkScrollable`.
+     * @param hadjustment - a `GtkAdjustment`
+     */
     setHadjustment(hadjustment) {
         call("libgtk-4.so.1", "gtk_scrollable_set_hadjustment", [
             {
@@ -1158,6 +1631,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `GtkScrollablePolicy`.
+     *
+     * The policy determines whether horizontal scrolling should start
+     * below the minimum width or below the natural width.
+     * @param policy - the horizontal `GtkScrollablePolicy`
+     */
     setHscrollPolicy(policy) {
         call("libgtk-4.so.1", "gtk_scrollable_set_hscroll_policy", [
             {
@@ -1170,6 +1650,10 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the vertical adjustment of the `GtkScrollable`.
+     * @param vadjustment - a `GtkAdjustment`
+     */
     setVadjustment(vadjustment) {
         call("libgtk-4.so.1", "gtk_scrollable_set_vadjustment", [
             {
@@ -1183,6 +1667,13 @@ export class IconView extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the `GtkScrollablePolicy`.
+     *
+     * The policy determines whether vertical scrolling should start
+     * below the minimum height or below the natural height.
+     * @param policy - the vertical `GtkScrollablePolicy`
+     */
     setVscrollPolicy(policy) {
         call("libgtk-4.so.1", "gtk_scrollable_set_vscroll_policy", [
             {