@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gtk/list-store.js

@@ -4,6 +4,151 @@ import { TreePath } from "./tree-path.js";
 import { TreeModel } from "./tree-model.js";
 import * as GObject from "../gobject/index.js";
 import * as Gdk from "../gdk/index.js";
+/**
+ * A list-like data structure that can be used with the [class@Gtk.TreeView].
+ *
+ * The `GtkListStore` object is a list model for use with a `GtkTreeView`
+ * widget.  It implements the `GtkTreeModel` interface, and consequentialy,
+ * can use all of the methods available there.  It also implements the
+ * `GtkTreeSortable` interface so it can be sorted by the view.
+ * Finally, it also implements the tree
+ * drag and drop
+ * interfaces.
+ *
+ * The `GtkListStore` can accept most `GType`s as a column type, though
+ * it can’t accept all custom types.  Internally, it will keep a copy of
+ * data passed in (such as a string or a boxed pointer).  Columns that
+ * accept `GObject`s are handled a little differently.  The
+ * `GtkListStore` will keep a reference to the object instead of copying the
+ * value.  As a result, if the object is modified, it is up to the
+ * application writer to call [method@Gtk.TreeModel.row_changed] to emit the
+ * [signal@Gtk.TreeModel::row_changed] signal. This most commonly affects lists
+ * with [class@Gdk.Texture]s stored.
+ *
+ * An example for creating a simple list store:
+ *
+ * ```c
+ * enum {
+ * COLUMN_STRING,
+ * COLUMN_INT,
+ * COLUMN_BOOLEAN,
+ * N_COLUMNS
+ * };
+ *
+ * {
+ * GtkListStore *list_store;
+ * GtkTreePath *path;
+ * GtkTreeIter iter;
+ * int i;
+ *
+ * list_store = gtk_list_store_new (N_COLUMNS,
+ * G_TYPE_STRING,
+ * G_TYPE_INT,
+ * G_TYPE_BOOLEAN);
+ *
+ * for (i = 0; i < 10; i++)
+ * {
+ * char *some_data;
+ *
+ * some_data = get_some_data (i);
+ *
+ * // Add a new row to the model
+ * gtk_list_store_append (list_store, &iter);
+ * gtk_list_store_set (list_store, &iter,
+ * COLUMN_STRING, some_data,
+ * COLUMN_INT, i,
+ * COLUMN_BOOLEAN,  FALSE,
+ * -1);
+ *
+ * // As the store will keep a copy of the string internally,
+ * // we free some_data.
+ * g_free (some_data);
+ * }
+ *
+ * // Modify a particular row
+ * path = gtk_tree_path_new_from_string ("4");
+ * gtk_tree_model_get_iter (GTK_TREE_MODEL (list_store),
+ * &iter,
+ * path);
+ * gtk_tree_path_free (path);
+ * gtk_list_store_set (list_store, &iter,
+ * COLUMN_BOOLEAN, TRUE,
+ * -1);
+ * }
+ * ```
+ *
+ * `GtkListStore` is deprecated since GTK 4.10, and should not be used in newly
+ * written code. You should use [class@Gio.ListStore] instead, and the various
+ * list models provided by GTK.
+ *
+ * ## Performance Considerations
+ *
+ * Internally, the `GtkListStore` was originally implemented with a linked list
+ * with a tail pointer.  As a result, it was fast at data insertion and deletion,
+ * and not fast at random data access.  The `GtkListStore` sets the
+ * `GTK_TREE_MODEL_ITERS_PERSIST` flag, which means that `GtkTreeIter`s can be
+ * cached while the row exists.  Thus, if access to a particular row is needed
+ * often and your code is expected to run on older versions of GTK, it is worth
+ * keeping the iter around.
+ *
+ * ## Atomic Operations
+ *
+ * It is important to note that only the methods
+ * gtk_list_store_insert_with_values() and gtk_list_store_insert_with_valuesv()
+ * are atomic, in the sense that the row is being appended to the store and the
+ * values filled in in a single operation with regard to `GtkTreeModel` signaling.
+ * In contrast, using e.g. gtk_list_store_append() and then gtk_list_store_set()
+ * will first create a row, which triggers the `GtkTreeModel::row-inserted` signal
+ * on `GtkListStore`. The row, however, is still empty, and any signal handler
+ * connecting to `GtkTreeModel::row-inserted` on this particular store should be prepared
+ * for the situation that the row might be empty. This is especially important
+ * if you are wrapping the `GtkListStore` inside a `GtkTreeModel`Filter and are
+ * using a `GtkTreeModel`FilterVisibleFunc. Using any of the non-atomic operations
+ * to append rows to the `GtkListStore` will cause the
+ * `GtkTreeModel`FilterVisibleFunc to be visited with an empty row first; the
+ * function must be prepared for that.
+ *
+ * ## GtkListStore as GtkBuildable
+ *
+ * The GtkListStore implementation of the [iface@Gtk.Buildable] interface allows
+ * to specify the model columns with a `<columns>` element that may contain
+ * multiple `<column>` elements, each specifying one model column. The “type”
+ * attribute specifies the data type for the column.
+ *
+ * Additionally, it is possible to specify content for the list store
+ * in the UI definition, with the `<data>` element. It can contain multiple
+ * `<row>` elements, each specifying to content for one row of the list model.
+ * Inside a `<row>`, the `<col>` elements specify the content for individual cells.
+ *
+ * Note that it is probably more common to define your models in the code,
+ * and one might consider it a layering violation to specify the content of
+ * a list store in a UI definition, data, not presentation, and common wisdom
+ * is to separate the two, as far as possible.
+ *
+ * An example of a UI Definition fragment for a list store:
+ *
+ * ```xml
+ * <object class="GtkListStore">
+ * <columns>
+ * <column type="gchararray"/>
+ * <column type="gchararray"/>
+ * <column type="gint"/>
+ * </columns>
+ * <data>
+ * <row>
+ * <col id="0">John</col>
+ * <col id="1">Doe</col>
+ * <col id="2">25</col>
+ * </row>
+ * <row>
+ * <col id="0">Johan</col>
+ * <col id="1">Dahlin</col>
+ * <col id="2">50</col>
+ * </row>
+ * </data>
+ * </object>
+ * ```
+ */
 export class ListStore extends GObject.GObject {
     constructor(...args) {
         super(...args);
@@ -24,6 +169,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "gobject", borrowed: false });
     }
+    /**
+     * Appends a new row to @list_store.  `iter` will be changed to point to this new
+     * row.  The row will be empty after this function is called.  To fill in
+     * values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
+     * @param iter - An unset `GtkTreeIter` to set to the appended row
+     */
     append(iter) {
         call("libgtk-4.so.1", "gtk_list_store_append", [
             {
@@ -43,6 +194,9 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Removes all rows from the list store.
+     */
     clear() {
         call("libgtk-4.so.1", "gtk_list_store_clear", [
             {
@@ -51,6 +205,15 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Creates a new row at @position.  `iter` will be changed to point to this new
+     * row.  If `position` is -1 or is larger than the number of rows on the list,
+     * then the new row will be appended to the list. The row will be empty after
+     * this function is called.  To fill in values, you need to call
+     * gtk_list_store_set() or gtk_list_store_set_value().
+     * @param iter - An unset `GtkTreeIter` to set to the new row
+     * @param position - position to insert the new row, or -1 for last
+     */
     insert(iter, position) {
         call("libgtk-4.so.1", "gtk_list_store_insert", [
             {
@@ -74,6 +237,14 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Inserts a new row after @sibling. If `sibling` is %NULL, then the row will be
+     * prepended to the beginning of the list. `iter` will be changed to point to
+     * this new row. The row will be empty after this function is called. To fill
+     * in values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
+     * @param iter - An unset `GtkTreeIter` to set to the new row
+     * @param sibling - A valid `GtkTreeIter`
+     */
     insertAfter(iter, sibling) {
         call("libgtk-4.so.1", "gtk_list_store_insert_after", [
             {
@@ -103,6 +274,14 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Inserts a new row before @sibling. If `sibling` is %NULL, then the row will
+     * be appended to the end of the list. `iter` will be changed to point to this
+     * new row. The row will be empty after this function is called. To fill in
+     * values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
+     * @param iter - An unset `GtkTreeIter` to set to the new row
+     * @param sibling - A valid `GtkTreeIter`
+     */
     insertBefore(iter, sibling) {
         call("libgtk-4.so.1", "gtk_list_store_insert_before", [
             {
@@ -132,6 +311,18 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * A variant of gtk_list_store_insert_with_values() which
+     * takes the columns and values as two arrays, instead of
+     * varargs.
+     *
+     * This function is mainly intended for language-bindings.
+     * @param iter - An unset `GtkTreeIter` to set to the new row
+     * @param position - position to insert the new row, or -1 for last
+     * @param columns - an array of column numbers
+     * @param values - an array of GValues
+     * @param nValues - the length of the `columns` and `values` arrays
+     */
     insertWithValuesv(position, columns, values, nValues, iter) {
         call("libgtk-4.so.1", "gtk_list_store_insert_with_valuesv", [
             {
@@ -178,6 +369,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Checks if the given iter is a valid iter for this `GtkListStore`.
+     *
+     * This function is slow. Only use it for debugging and/or testing
+     * purposes.
+     * @param iter - the iterator to check
+     */
     iterIsValid(iter) {
         return call("libgtk-4.so.1", "gtk_list_store_iter_is_valid", [
             {
@@ -195,6 +393,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Moves `iter` in `store` to the position after @position. Note that this
+     * function only works with unsorted stores. If `position` is %NULL, `iter` will be moved to the start of the list.
+     * @param iter - A `GtkTreeIter`
+     * @param position - A `GtkTreeIter`
+     */
     moveAfter(iter, position) {
         call("libgtk-4.so.1", "gtk_list_store_move_after", [
             {
@@ -222,6 +426,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Moves `iter` in `store` to the position before @position. Note that this
+     * function only works with unsorted stores. If `position` is %NULL, `iter` will be moved to the end of the list.
+     * @param iter - A `GtkTreeIter`
+     * @param position - A `GtkTreeIter`
+     */
     moveBefore(iter, position) {
         call("libgtk-4.so.1", "gtk_list_store_move_before", [
             {
@@ -249,6 +459,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Prepends a new row to @list_store. `iter` will be changed to point to this new
+     * row. The row will be empty after this function is called. To fill in
+     * values, you need to call gtk_list_store_set() or gtk_list_store_set_value().
+     * @param iter - An unset `GtkTreeIter` to set to the prepend row
+     */
     prepend(iter) {
         call("libgtk-4.so.1", "gtk_list_store_prepend", [
             {
@@ -268,6 +484,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Removes the given row from the list store.  After being removed,
+     * `iter` is set to be the next valid row, or invalidated if it pointed
+     * to the last row in @list_store.
+     * @param iter - A valid `GtkTreeIter`
+     */
     remove(iter) {
         return call("libgtk-4.so.1", "gtk_list_store_remove", [
             {
@@ -285,6 +507,11 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Reorders `store` to follow the order indicated by @new_order. Note that
+     * this function only works with unsorted stores.
+     * @param newOrder - an array of integers mapping the new
+     */
     reorder(newOrder) {
         call("libgtk-4.so.1", "gtk_list_store_reorder", [
             {
@@ -300,6 +527,18 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the types of the columns of a list store.
+     *
+     * This function is meant primarily for objects that inherit
+     * from `GtkListStore`, and should only be used when constructing
+     * a new instance.
+     *
+     * This function cannot be called after a row has been added, or
+     * a method on the `GtkTreeModel` interface is called.
+     * @param nColumns - Number of columns for the list store
+     * @param types - An array length n of `GType`s
+     */
     setColumnTypes(nColumns, types) {
         call("libgtk-4.so.1", "gtk_list_store_set_column_types", [
             {
@@ -319,6 +558,14 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the data in the cell specified by `iter` and @column.
+     * The type of `value` must be convertible to the type of the
+     * column.
+     * @param iter - A valid `GtkTreeIter` for the row being modified
+     * @param column - column number to modify
+     * @param value - new value for the cell
+     */
     setValue(iter, column, value) {
         call("libgtk-4.so.1", "gtk_list_store_set_value", [
             {
@@ -349,6 +596,17 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * A variant of gtk_list_store_set_valist() which
+     * takes the columns and values as two arrays, instead of
+     * varargs. This function is mainly intended for
+     * language-bindings and in case the number of columns to
+     * change is not known until run-time.
+     * @param iter - A valid `GtkTreeIter` for the row being modified
+     * @param columns - an array of column numbers
+     * @param values - an array of GValues
+     * @param nValues - the length of the `columns` and `values` arrays
+     */
     setValuesv(iter, columns, values, nValues) {
         call("libgtk-4.so.1", "gtk_list_store_set_valuesv", [
             {
@@ -388,6 +646,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Swaps `a` and `b` in @store. Note that this function only works with
+     * unsorted stores.
+     * @param a - A `GtkTreeIter`
+     * @param b - Another `GtkTreeIter`
+     */
     swap(a, b) {
         call("libgtk-4.so.1", "gtk_list_store_swap", [
             {
@@ -414,6 +678,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Gets the ID of the `buildable` object.
+     *
+     * `GtkBuilder` sets the name based on the ID attribute
+     * of the `<object>` tag used to construct the @buildable.
+     */
     getBuildableId() {
         return call("libgtk-4.so.1", "gtk_buildable_get_buildable_id", [
             {
@@ -422,6 +692,16 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Asks the `GtkTreeDragDest` to insert a row before the path @dest,
+     * deriving the contents of the row from @value. If `dest` is
+     * outside the tree so that inserting before it is impossible, %FALSE
+     * will be returned. Also, %FALSE may be returned if the new row is
+     * not created for some model-specific reason.  Should robustly handle
+     * a `dest` no longer found in the model!
+     * @param dest - row to drop in front of
+     * @param value - data to drop
+     */
     dragDataReceived(dest, value) {
         return call("libgtk-4.so.1", "gtk_tree_drag_dest_drag_data_received", [
             {
@@ -448,6 +728,15 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Determines whether a drop is possible before the given @dest_path,
+     * at the same depth as @dest_path. i.e., can we drop the data in
+     * `value` at that location. `dest_path` does not have to
+     * exist; the return value will almost certainly be %FALSE if the
+     * parent of `dest_path` doesn’t exist, though.
+     * @param destPath - destination row
+     * @param value - the data being dropped
+     */
     rowDropPossible(destPath, value) {
         return call("libgtk-4.so.1", "gtk_tree_drag_dest_row_drop_possible", [
             {
@@ -474,6 +763,14 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Asks the `GtkTreeDragSource` to delete the row at @path, because
+     * it was moved somewhere else via drag-and-drop. Returns %FALSE
+     * if the deletion fails because `path` no longer exists, or for
+     * some model-specific reason. Should robustly handle a `path` no
+     * longer found in the model!
+     * @param path - row that was being dragged
+     */
     dragDataDelete(path) {
         return call("libgtk-4.so.1", "gtk_tree_drag_source_drag_data_delete", [
             {
@@ -491,6 +788,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Asks the `GtkTreeDragSource` to return a `GdkContentProvider` representing
+     * the row at @path. Should robustly handle a `path` no
+     * longer found in the model!
+     * @param path - row that was dragged
+     */
     dragDataGet(path) {
         const ptr = call("libgtk-4.so.1", "gtk_tree_drag_source_drag_data_get", [
             {
@@ -511,6 +814,12 @@ export class ListStore extends GObject.GObject {
             return null;
         return getObject(ptr, Gdk.ContentProvider);
     }
+    /**
+     * Asks the `GtkTreeDragSource` whether a particular row can be used as
+     * the source of a DND operation. If the source doesn’t implement
+     * this interface, the row is assumed draggable.
+     * @param path - row on which user is initiating a drag
+     */
     rowDraggable(path) {
         return call("libgtk-4.so.1", "gtk_tree_drag_source_row_draggable", [
             {
@@ -528,6 +837,11 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Creates a new `GtkTreeModel`, with `child_model` as the child_model
+     * and `root` as the virtual root.
+     * @param root - A `GtkTreePath`
+     */
     filterNew(root) {
         const ptr = call("libgtk-4.so.1", "gtk_tree_model_filter_new", [
             {
@@ -547,6 +861,14 @@ export class ListStore extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, TreeModel);
     }
+    /**
+     * Calls `func` on each node in model in a depth-first fashion.
+     *
+     * If `func` returns %TRUE, then the tree ceases to be walked,
+     * and gtk_tree_model_foreach() returns.
+     * @param func - a function to be called on each row
+     * @param userData - user data to passed to @func
+     */
     foreach(func, userData) {
         call("libgtk-4.so.1", "gtk_tree_model_foreach", [
             {
@@ -564,6 +886,10 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Returns the type of the column.
+     * @param index_ - the column index
+     */
     getColumnType(index_) {
         return call("libgtk-4.so.1", "gtk_tree_model_get_column_type", [
             {
@@ -576,6 +902,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "int", size: 64, unsigned: true });
     }
+    /**
+     * Returns a set of flags supported by this interface.
+     *
+     * The flags are a bitwise combination of `GtkTreeModel`Flags.
+     * The flags supported should not change during the lifetime
+     * of the @tree_model.
+     */
     getFlags() {
         return call("libgtk-4.so.1", "gtk_tree_model_get_flags", [
             {
@@ -584,6 +917,14 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Sets `iter` to a valid iterator pointing to @path.
+     *
+     * If `path` does not exist, `iter` is set to an invalid
+     * iterator and %FALSE is returned.
+     * @param iter - the uninitialized `GtkTreeIter`
+     * @param path - the `GtkTreePath`
+     */
     getIter(iter, path) {
         return call("libgtk-4.so.1", "gtk_tree_model_get_iter", [
             {
@@ -612,6 +953,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Initializes `iter` with the first iterator in the tree
+     * (the one at the path "0").
+     *
+     * Returns %FALSE if the tree is empty, %TRUE otherwise.
+     * @param iter - the uninitialized `GtkTreeIter`
+     */
     getIterFirst(iter) {
         return call("libgtk-4.so.1", "gtk_tree_model_get_iter_first", [
             {
@@ -631,6 +979,14 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Sets `iter` to a valid iterator pointing to @path_string, if it
+     * exists.
+     *
+     * Otherwise, `iter` is left invalid and %FALSE is returned.
+     * @param iter - an uninitialized `GtkTreeIter`
+     * @param pathString - a string representation of a `GtkTreePath`
+     */
     getIterFromString(iter, pathString) {
         return call("libgtk-4.so.1", "gtk_tree_model_get_iter_from_string", [
             {
@@ -654,6 +1010,9 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns the number of columns supported by @tree_model.
+     */
     getNColumns() {
         return call("libgtk-4.so.1", "gtk_tree_model_get_n_columns", [
             {
@@ -662,6 +1021,12 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns a newly-created `GtkTreePath` referenced by @iter.
+     *
+     * This path should be freed with gtk_tree_path_free().
+     * @param iter - the `GtkTreeIter`
+     */
     getPath(iter) {
         const ptr = call("libgtk-4.so.1", "gtk_tree_model_get_path", [
             {
@@ -685,6 +1050,14 @@ export class ListStore extends GObject.GObject {
         });
         return getObject(ptr, TreePath);
     }
+    /**
+     * Generates a string representation of the iter.
+     *
+     * This string is a “:” separated list of numbers.
+     * For example, “4:10:0:3” would be an acceptable
+     * return value for this string.
+     * @param iter - a `GtkTreeIter`
+     */
     getStringFromIter(iter) {
         return call("libgtk-4.so.1", "gtk_tree_model_get_string_from_iter", [
             {
@@ -702,6 +1075,15 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "string" });
     }
+    /**
+     * Initializes and sets `value` to that at @column.
+     *
+     * When done with @value, g_value_unset() needs to be called
+     * to free any allocated memory.
+     * @param iter - the `GtkTreeIter`
+     * @param column - the column to lookup the value at
+     * @param value - an empty `GValue` to set
+     */
     getValue(iter, column, value) {
         call("libgtk-4.so.1", "gtk_tree_model_get_value", [
             {
@@ -734,6 +1116,18 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `iter` to point to the first child of @parent.
+     *
+     * If `parent` has no children, %FALSE is returned and `iter` is
+     * set to be invalid. `parent` will remain a valid node after this
+     * function has been called.
+     *
+     * If `parent` is %NULL returns the first node, equivalent to
+     * `gtk_tree_model_get_iter_first (tree_model, iter);`
+     * @param iter - the new `GtkTreeIter` to be set to the child
+     * @param parent - the `GtkTreeIter`
+     */
     iterChildren(iter, parent) {
         return call("libgtk-4.so.1", "gtk_tree_model_iter_children", [
             {
@@ -763,6 +1157,10 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns %TRUE if `iter` has children, %FALSE otherwise.
+     * @param iter - the `GtkTreeIter` to test for children
+     */
     iterHasChild(iter) {
         return call("libgtk-4.so.1", "gtk_tree_model_iter_has_child", [
             {
@@ -780,6 +1178,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns the number of children that `iter` has.
+     *
+     * As a special case, if `iter` is %NULL, then the number
+     * of toplevel nodes is returned.
+     * @param iter - the `GtkTreeIter`
+     */
     iterNChildren(iter) {
         return call("libgtk-4.so.1", "gtk_tree_model_iter_n_children", [
             {
@@ -798,6 +1203,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Sets `iter` to point to the node following it at the current level.
+     *
+     * If there is no next @iter, %FALSE is returned and `iter` is set
+     * to be invalid.
+     * @param iter - the `GtkTreeIter`
+     */
     iterNext(iter) {
         return call("libgtk-4.so.1", "gtk_tree_model_iter_next", [
             {
@@ -815,6 +1227,17 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Sets `iter` to be the child of @parent, using the given index.
+     *
+     * The first index is 0. If `n` is too big, or `parent` has no children,
+     * `iter` is set to an invalid iterator and %FALSE is returned. `parent` will remain a valid node after this function has been called. As a
+     * special case, if `parent` is %NULL, then the @n-th root node
+     * is set.
+     * @param iter - the `GtkTreeIter` to set to the nth child
+     * @param parent - the `GtkTreeIter` to get the child from
+     * @param n - the index of the desired child
+     */
     iterNthChild(iter, n, parent) {
         return call("libgtk-4.so.1", "gtk_tree_model_iter_nth_child", [
             {
@@ -848,6 +1271,18 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Sets `iter` to be the parent of @child.
+     *
+     * If `child` is at the toplevel, and doesn’t have a parent, then
+     * `iter` is set to an invalid iterator and %FALSE is returned.
+     * `child` will remain a valid node after this function has been
+     * called.
+     *
+     * `iter` will be initialized before the lookup is performed, so `child` and `iter` cannot point to the same memory location.
+     * @param iter - the new `GtkTreeIter` to set to the parent
+     * @param child - the `GtkTreeIter`
+     */
     iterParent(iter, child) {
         return call("libgtk-4.so.1", "gtk_tree_model_iter_parent", [
             {
@@ -876,6 +1311,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Sets `iter` to point to the previous node at the current level.
+     *
+     * If there is no previous @iter, %FALSE is returned and `iter` is
+     * set to be invalid.
+     * @param iter - the `GtkTreeIter`
+     */
     iterPrevious(iter) {
         return call("libgtk-4.so.1", "gtk_tree_model_iter_previous", [
             {
@@ -893,6 +1335,26 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Lets the tree ref the node.
+     *
+     * This is an optional method for models to implement.
+     * To be more specific, models may ignore this call as it exists
+     * primarily for performance reasons.
+     *
+     * This function is primarily meant as a way for views to let
+     * caching models know when nodes are being displayed (and hence,
+     * whether or not to cache that node). Being displayed means a node
+     * is in an expanded branch, regardless of whether the node is currently
+     * visible in the viewport. For example, a file-system based model
+     * would not want to keep the entire file-hierarchy in memory,
+     * just the sections that are currently being displayed by
+     * every current view.
+     *
+     * A model should be expected to be able to get an iter independent
+     * of its reffed state.
+     * @param iter - the `GtkTreeIter`
+     */
     refNode(iter) {
         call("libgtk-4.so.1", "gtk_tree_model_ref_node", [
             {
@@ -910,6 +1372,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the ::row-changed signal on @tree_model.
+     *
+     * See [signal@Gtk.TreeModel::row-changed].
+     * @param path - a `GtkTreePath` pointing to the changed row
+     * @param iter - a valid `GtkTreeIter` pointing to the changed row
+     */
     rowChanged(path, iter) {
         call("libgtk-4.so.1", "gtk_tree_model_row_changed", [
             {
@@ -936,6 +1405,19 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the ::row-deleted signal on @tree_model.
+     *
+     * See [signal@Gtk.TreeModel::row-deleted].
+     *
+     * This should be called by models after a row has been removed.
+     * The location pointed to by `path` should be the location that
+     * the row previously was at. It may not be a valid location anymore.
+     *
+     * Nodes that are deleted are not unreffed, this means that any
+     * outstanding references on the deleted node should not be released.
+     * @param path - a `GtkTreePath` pointing to the previous location of
+     */
     rowDeleted(path) {
         call("libgtk-4.so.1", "gtk_tree_model_row_deleted", [
             {
@@ -953,6 +1435,16 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the ::row-has-child-toggled signal on @tree_model.
+     *
+     * See [signal@Gtk.TreeModel::row-has-child-toggled].
+     *
+     * This should be called by models after the child
+     * state of a node changes.
+     * @param path - a `GtkTreePath` pointing to the changed row
+     * @param iter - a valid `GtkTreeIter` pointing to the changed row
+     */
     rowHasChildToggled(path, iter) {
         call("libgtk-4.so.1", "gtk_tree_model_row_has_child_toggled", [
             {
@@ -979,6 +1471,13 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the ::row-inserted signal on @tree_model.
+     *
+     * See [signal@Gtk.TreeModel::row-inserted].
+     * @param path - a `GtkTreePath` pointing to the inserted row
+     * @param iter - a valid `GtkTreeIter` pointing to the inserted row
+     */
     rowInserted(path, iter) {
         call("libgtk-4.so.1", "gtk_tree_model_row_inserted", [
             {
@@ -1005,6 +1504,18 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits the ::rows-reordered signal on @tree_model.
+     *
+     * See [signal@Gtk.TreeModel::rows-reordered].
+     *
+     * This should be called by models when their rows have been
+     * reordered.
+     * @param path - a `GtkTreePath` pointing to the tree node whose children
+     * @param iter - a valid `GtkTreeIter` pointing to the node
+     * @param newOrder - an array of integers
+     * @param length - length of `new_order` array
+     */
     rowsReorderedWithLength(path, newOrder, length, iter) {
         call("libgtk-4.so.1", "gtk_tree_model_rows_reordered_with_length", [
             {
@@ -1043,6 +1554,17 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Lets the tree unref the node.
+     *
+     * This is an optional method for models to implement.
+     * To be more specific, models may ignore this call as it exists
+     * primarily for performance reasons. For more information on what
+     * this means, see gtk_tree_model_ref_node().
+     *
+     * Please note that nodes that are deleted are not unreffed.
+     * @param iter - the `GtkTreeIter`
+     */
     unrefNode(iter) {
         call("libgtk-4.so.1", "gtk_tree_model_unref_node", [
             {
@@ -1060,6 +1582,14 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Fills in `sort_column_id` and `order` with the current sort column and the
+     * order. It returns %TRUE unless the `sort_column_id` is
+     * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID or
+     * %GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID.
+     * @param sortColumnId - The sort column id to be filled in
+     * @param order - The `GtkSortType` to be filled in
+     */
     getSortColumnId(sortColumnId, order) {
         return call("libgtk-4.so.1", "gtk_tree_sortable_get_sort_column_id", [
             {
@@ -1082,6 +1612,11 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns %TRUE if the model has a default sort function. This is used
+     * primarily by GtkTreeViewColumns in order to determine if a model can
+     * go back to the default state, or not.
+     */
     hasDefaultSortFunc() {
         return call("libgtk-4.so.1", "gtk_tree_sortable_has_default_sort_func", [
             {
@@ -1090,6 +1625,19 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Sets the default comparison function used when sorting to be @sort_func.
+     * If the current sort column id of `sortable` is
+     * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort using
+     * this function.
+     *
+     * If `sort_func` is %NULL, then there will be no default comparison function.
+     * This means that once the model  has been sorted, it can’t go back to the
+     * default state. In this case, when the current sort column id of `sortable` is %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.
+     * @param sortFunc - The comparison function
+     * @param userData - User data to pass to @sort_func
+     * @param destroy - Destroy notifier of @user_data
+     */
     setDefaultSortFunc(sortFunc, userData, destroy) {
         call("libgtk-4.so.1", "gtk_tree_sortable_set_default_sort_func", [
             {
@@ -1112,6 +1660,19 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the current sort column to be @sort_column_id. The `sortable` will
+     * resort itself to reflect this change, after emitting a
+     * `GtkTreeSortable::sort-column-changed` signal. `sort_column_id` may either be
+     * a regular column id, or one of the following special values:
+     *
+     * - %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID: the default sort function
+     * will be used, if it is set
+     *
+     * - %GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID: no sorting will occur
+     * @param sortColumnId - the sort column id to set
+     * @param order - The sort order of the column
+     */
     setSortColumnId(sortColumnId, order) {
         call("libgtk-4.so.1", "gtk_tree_sortable_set_sort_column_id", [
             {
@@ -1128,6 +1689,15 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the comparison function used when sorting to be @sort_func. If the
+     * current sort column id of `sortable` is the same as @sort_column_id, then
+     * the model will sort using this function.
+     * @param sortColumnId - the sort column id to set the function for
+     * @param sortFunc - The comparison function
+     * @param userData - User data to pass to @sort_func
+     * @param destroy - Destroy notifier of @user_data
+     */
     setSortFunc(sortColumnId, sortFunc, userData, destroy) {
         call("libgtk-4.so.1", "gtk_tree_sortable_set_sort_func", [
             {
@@ -1154,6 +1724,9 @@ export class ListStore extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Emits a `GtkTreeSortable::sort-column-changed` signal on @sortable.
+     */
     sortColumnChanged() {
         call("libgtk-4.so.1", "gtk_tree_sortable_sort_column_changed", [
             {