@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gtk/notebook.js

@@ -3,6 +3,124 @@ import { getObject } from "@gtkx/ffi";
 import { NotebookPage } from "./notebook-page.js";
 import * as Gio from "../gio/index.js";
 import { Widget } from "./widget.js";
+/**
+ * Switches between children using tabs.
+ *
+ *
+ *
+ * There are many configuration options for `GtkNotebook`. Among
+ * other things, you can choose on which edge the tabs appear
+ * (see [method@Gtk.Notebook.set_tab_pos]), whether, if there are
+ * too many tabs to fit the notebook should be made bigger or scrolling
+ * arrows added (see [method@Gtk.Notebook.set_scrollable]), and whether
+ * there will be a popup menu allowing the users to switch pages.
+ * (see [method@Gtk.Notebook.popup_enable]).
+ *
+ * # GtkNotebook as GtkBuildable
+ *
+ * The `GtkNotebook` implementation of the `GtkBuildable` interface
+ * supports placing children into tabs by specifying “tab” as the
+ * “type” attribute of a `<child>` element. Note that the content
+ * of the tab must be created before the tab can be filled.
+ * A tab child can be specified without specifying a `<child>`
+ * type attribute.
+ *
+ * To add a child widget in the notebooks action area, specify
+ * "action-start" or “action-end” as the “type” attribute of the
+ * `<child>` element.
+ *
+ * An example of a UI definition fragment with `GtkNotebook`:
+ *
+ * ```xml
+ * <object class="GtkNotebook">
+ * <child>
+ * <object class="GtkLabel" id="notebook-content">
+ * <property name="label">Content</property>
+ * </object>
+ * </child>
+ * <child type="tab">
+ * <object class="GtkLabel" id="notebook-tab">
+ * <property name="label">Tab</property>
+ * </object>
+ * </child>
+ * </object>
+ * ```
+ *
+ * # Shortcuts and Gestures
+ *
+ * `GtkNotebook` supports the following keyboard shortcuts:
+ *
+ * - `Shift`+`F10` or `Menu` opens the context menu.
+ * - `Home` moves the focus to the first tab.
+ * - `End` moves the focus to the last tab.
+ *
+ * Additionally, the following signals have default keybindings:
+ *
+ * - [signal@Gtk.Notebook::change-current-page]
+ * - [signal@Gtk.Notebook::focus-tab]
+ * - [signal@Gtk.Notebook::move-focus-out]
+ * - [signal@Gtk.Notebook::reorder-tab]
+ * - [signal@Gtk.Notebook::select-page]
+ *
+ * Tabs support drag-and-drop between notebooks sharing the same `group-name`,
+ * or to new windows by handling the `::create-window` signal.
+ *
+ * # Actions
+ *
+ * `GtkNotebook` defines a set of built-in actions:
+ *
+ * - `menu.popup` opens the tabs context menu.
+ *
+ * # CSS nodes
+ *
+ * ```
+ * notebook
+ * ├── header.top
+ * │   ├── [<action widget>]
+ * │   ├── tabs
+ * │   │   ├── [arrow]
+ * │   │   ├── tab
+ * │   │   │   ╰── <tab label>
+ * ┊   ┊   ┊
+ * │   │   ├── tab[.reorderable-page]
+ * │   │   │   ╰── <tab label>
+ * │   │   ╰── [arrow]
+ * │   ╰── [<action widget>]
+ * │
+ * ╰── stack
+ * ├── <child>
+ * ┊
+ * ╰── <child>
+ * ```
+ *
+ * `GtkNotebook` has a main CSS node with name `notebook`, a subnode
+ * with name `header` and below that a subnode with name `tabs` which
+ * contains one subnode per tab with name `tab`.
+ *
+ * If action widgets are present, their CSS nodes are placed next
+ * to the `tabs` node. If the notebook is scrollable, CSS nodes with
+ * name `arrow` are placed as first and last child of the `tabs` node.
+ *
+ * The main node gets the `.frame` style class when the notebook
+ * has a border (see [method@Gtk.Notebook.set_show_border]).
+ *
+ * The header node gets one of the style class `.top`, `.bottom`,
+ * `.left` or `.right`, depending on where the tabs are placed. For
+ * reorderable pages, the tab node gets the `.reorderable-page` class.
+ *
+ * A `tab` node gets the `.dnd` style class while it is moved with drag-and-drop.
+ *
+ * The nodes are always arranged from left-to-right, regardless of text direction.
+ *
+ * # Accessibility
+ *
+ * `GtkNotebook` uses the following roles:
+ *
+ * - [enum@Gtk.AccessibleRole.group] for the notebook widget
+ * - [enum@Gtk.AccessibleRole.tab_list] for the list of tabs
+ * - [enum@Gtk.AccessibleRole.tab] role for each tab
+ * - [enum@Gtk.AccessibleRole.tab_panel] for each page
+ */
 const SIGNAL_META = {
     "change-current-page": {
         params: [{ type: { type: "int", size: 32, unsigned: false } }],
@@ -63,6 +181,9 @@ const SIGNAL_META = {
     },
 };
 export class Notebook extends Widget {
+    /**
+     * Creates a new `GtkNotebook` widget with no pages.
+     */
     constructor(...args) {
         super(...args);
     }
@@ -72,6 +193,11 @@ export class Notebook extends Widget {
             borrowed: true,
         });
     }
+    /**
+     * Appends a page to @notebook.
+     * @param child - the `GtkWidget` to use as the contents of the page
+     * @param tabLabel - the `GtkWidget` to be used as the label
+     */
     appendPage(child, tabLabel) {
         return call("libgtk-4.so.1", "gtk_notebook_append_page", [
             {
@@ -89,6 +215,13 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Appends a page to @notebook, specifying the widget to use as the
+     * label in the popup menu.
+     * @param child - the `GtkWidget` to use as the contents of the page
+     * @param tabLabel - the `GtkWidget` to be used as the label
+     * @param menuLabel - the widget to use as a label for the
+     */
     appendPageMenu(child, tabLabel, menuLabel) {
         return call("libgtk-4.so.1", "gtk_notebook_append_page_menu", [
             {
@@ -111,6 +244,15 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Removes the child from the notebook.
+     *
+     * This function is very similar to [method@Gtk.Notebook.remove_page],
+     * but additionally informs the notebook that the removal
+     * is happening as part of a tab DND operation, which should
+     * not be cancelled.
+     * @param child - a child
+     */
     detachTab(child) {
         call("libgtk-4.so.1", "gtk_notebook_detach_tab", [
             {
@@ -123,6 +265,12 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Gets one of the action widgets.
+     *
+     * See [method@Gtk.Notebook.set_action_widget].
+     * @param packType - pack type of the action widget to receive
+     */
     getActionWidget(packType) {
         const ptr = call("libgtk-4.so.1", "gtk_notebook_get_action_widget", [
             {
@@ -138,6 +286,9 @@ export class Notebook extends Widget {
             return null;
         return getObject(ptr, Widget);
     }
+    /**
+     * Returns the page number of the current page.
+     */
     getCurrentPage() {
         return call("libgtk-4.so.1", "gtk_notebook_get_current_page", [
             {
@@ -146,6 +297,9 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the current group name for @notebook.
+     */
     getGroupName() {
         return call("libgtk-4.so.1", "gtk_notebook_get_group_name", [
             {
@@ -154,6 +308,10 @@ export class Notebook extends Widget {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Retrieves the menu label widget of the page containing @child.
+     * @param child - a widget contained in a page of @notebook
+     */
     getMenuLabel(child) {
         const ptr = call("libgtk-4.so.1", "gtk_notebook_get_menu_label", [
             {
@@ -169,6 +327,11 @@ export class Notebook extends Widget {
             return null;
         return getObject(ptr, Widget);
     }
+    /**
+     * Retrieves the text of the menu label for the page containing
+     * @child.
+     * @param child - the child widget of a page of the notebook.
+     */
     getMenuLabelText(child) {
         return call("libgtk-4.so.1", "gtk_notebook_get_menu_label_text", [
             {
@@ -181,6 +344,9 @@ export class Notebook extends Widget {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the number of pages in a notebook.
+     */
     getNPages() {
         return call("libgtk-4.so.1", "gtk_notebook_get_n_pages", [
             {
@@ -189,6 +355,10 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the child widget contained in page number @page_num.
+     * @param pageNum - the index of a page in the notebook, or -1
+     */
     getNthPage(pageNum) {
         const ptr = call("libgtk-4.so.1", "gtk_notebook_get_nth_page", [
             {
@@ -204,6 +374,10 @@ export class Notebook extends Widget {
             return null;
         return getObject(ptr, Widget);
     }
+    /**
+     * Returns the `GtkNotebookPage` for @child.
+     * @param child - a child of @notebook
+     */
     getPage(child) {
         const ptr = call("libgtk-4.so.1", "gtk_notebook_get_page", [
             {
@@ -217,6 +391,13 @@ export class Notebook extends Widget {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, NotebookPage);
     }
+    /**
+     * Returns a `GListModel` that contains the pages of the notebook.
+     *
+     * This can be used to keep an up-to-date view. The model also
+     * implements [iface@Gtk.SelectionModel] and can be used to track
+     * and modify the visible page.
+     */
     getPages() {
         const ptr = call("libgtk-4.so.1", "gtk_notebook_get_pages", [
             {
@@ -226,6 +407,9 @@ export class Notebook extends Widget {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, Gio.ListModel);
     }
+    /**
+     * Returns whether the tab label area has arrows for scrolling.
+     */
     getScrollable() {
         return call("libgtk-4.so.1", "gtk_notebook_get_scrollable", [
             {
@@ -234,6 +418,9 @@ export class Notebook extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns whether a bevel will be drawn around the notebook pages.
+     */
     getShowBorder() {
         return call("libgtk-4.so.1", "gtk_notebook_get_show_border", [
             {
@@ -242,6 +429,9 @@ export class Notebook extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns whether the tabs of the notebook are shown.
+     */
     getShowTabs() {
         return call("libgtk-4.so.1", "gtk_notebook_get_show_tabs", [
             {
@@ -250,6 +440,10 @@ export class Notebook extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns whether the tab contents can be detached from @notebook.
+     * @param child - a child `GtkWidget`
+     */
     getTabDetachable(child) {
         return call("libgtk-4.so.1", "gtk_notebook_get_tab_detachable", [
             {
@@ -262,6 +456,13 @@ export class Notebook extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns the tab label widget for the page @child.
+     *
+     * %NULL is returned if `child` is not in `notebook` or
+     * if no tab label has specifically been set for @child.
+     * @param child - the page
+     */
     getTabLabel(child) {
         const ptr = call("libgtk-4.so.1", "gtk_notebook_get_tab_label", [
             {
@@ -277,6 +478,11 @@ export class Notebook extends Widget {
             return null;
         return getObject(ptr, Widget);
     }
+    /**
+     * Retrieves the text of the tab label for the page containing
+     * @child.
+     * @param child - a widget contained in a page of @notebook
+     */
     getTabLabelText(child) {
         return call("libgtk-4.so.1", "gtk_notebook_get_tab_label_text", [
             {
@@ -289,6 +495,9 @@ export class Notebook extends Widget {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the edge at which the tabs are drawn.
+     */
     getTabPos() {
         return call("libgtk-4.so.1", "gtk_notebook_get_tab_pos", [
             {
@@ -297,6 +506,10 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets whether the tab can be reordered via drag and drop or not.
+     * @param child - a child `GtkWidget`
+     */
     getTabReorderable(child) {
         return call("libgtk-4.so.1", "gtk_notebook_get_tab_reorderable", [
             {
@@ -309,6 +522,12 @@ export class Notebook extends Widget {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Insert a page into `notebook` at the given position.
+     * @param child - the `GtkWidget` to use as the contents of the page
+     * @param tabLabel - the `GtkWidget` to be used as the label
+     * @param position - the index (starting at 0) at which to insert the page,
+     */
     insertPage(child, position, tabLabel) {
         return call("libgtk-4.so.1", "gtk_notebook_insert_page", [
             {
@@ -330,6 +549,14 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Insert a page into `notebook` at the given position, specifying
+     * the widget to use as the label in the popup menu.
+     * @param child - the `GtkWidget` to use as the contents of the page
+     * @param tabLabel - the `GtkWidget` to be used as the label
+     * @param menuLabel - the widget to use as a label for the
+     * @param position - the index (starting at 0) at which to insert the page,
+     */
     insertPageMenu(child, position, tabLabel, menuLabel) {
         return call("libgtk-4.so.1", "gtk_notebook_insert_page_menu", [
             {
@@ -356,6 +583,11 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Switches to the next page.
+     *
+     * Nothing happens if the current page is the last page.
+     */
     nextPage() {
         call("libgtk-4.so.1", "gtk_notebook_next_page", [
             {
@@ -364,6 +596,11 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Finds the index of the page which contains the given child
+     * widget.
+     * @param child - a `GtkWidget`
+     */
     pageNum(child) {
         return call("libgtk-4.so.1", "gtk_notebook_page_num", [
             {
@@ -376,6 +613,9 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Disables the popup menu.
+     */
     popupDisable() {
         call("libgtk-4.so.1", "gtk_notebook_popup_disable", [
             {
@@ -384,6 +624,12 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Enables the popup menu.
+     *
+     * If the user clicks with the right mouse button on the tab labels,
+     * a menu with all the pages will be popped up.
+     */
     popupEnable() {
         call("libgtk-4.so.1", "gtk_notebook_popup_enable", [
             {
@@ -392,6 +638,11 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Prepends a page to @notebook.
+     * @param child - the `GtkWidget` to use as the contents of the page
+     * @param tabLabel - the `GtkWidget` to be used as the label
+     */
     prependPage(child, tabLabel) {
         return call("libgtk-4.so.1", "gtk_notebook_prepend_page", [
             {
@@ -409,6 +660,13 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Prepends a page to @notebook, specifying the widget to use as the
+     * label in the popup menu.
+     * @param child - the `GtkWidget` to use as the contents of the page
+     * @param tabLabel - the `GtkWidget` to be used as the label
+     * @param menuLabel - the widget to use as a label for the
+     */
     prependPageMenu(child, tabLabel, menuLabel) {
         return call("libgtk-4.so.1", "gtk_notebook_prepend_page_menu", [
             {
@@ -431,6 +689,11 @@ export class Notebook extends Widget {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Switches to the previous page.
+     *
+     * Nothing happens if the current page is the first page.
+     */
     prevPage() {
         call("libgtk-4.so.1", "gtk_notebook_prev_page", [
             {
@@ -439,6 +702,11 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Removes a page from the notebook given its index
+     * in the notebook.
+     * @param pageNum - the index of a notebook page, starting
+     */
     removePage(pageNum) {
         call("libgtk-4.so.1", "gtk_notebook_remove_page", [
             {
@@ -451,6 +719,15 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Reorders the page containing @child, so that it appears in position
+     * @position.
+     *
+     * If `position` is greater than or equal to the number of children in
+     * the list or negative, `child` will be moved to the end of the list.
+     * @param child - the child to move
+     * @param position - the new position, or -1 to move to the end
+     */
     reorderChild(child, position) {
         call("libgtk-4.so.1", "gtk_notebook_reorder_child", [
             {
@@ -467,6 +744,15 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `widget` as one of the action widgets.
+     *
+     * Depending on the pack type the widget will be placed before
+     * or after the tabs. You can use a `GtkBox` if you need to pack
+     * more than one widget on the same side.
+     * @param widget - a `GtkWidget`
+     * @param packType - pack type of the action widget
+     */
     setActionWidget(widget, packType) {
         call("libgtk-4.so.1", "gtk_notebook_set_action_widget", [
             {
@@ -483,6 +769,15 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Switches to the page number @page_num.
+     *
+     * Note that due to historical reasons, GtkNotebook refuses
+     * to switch to a page unless the child widget is visible.
+     * Therefore, it is recommended to show child widgets before
+     * adding them to a notebook.
+     * @param pageNum - index of the page to switch to, starting from 0.
+     */
     setCurrentPage(pageNum) {
         call("libgtk-4.so.1", "gtk_notebook_set_current_page", [
             {
@@ -495,6 +790,14 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets a group name for @notebook.
+     *
+     * Notebooks with the same name will be able to exchange tabs
+     * via drag and drop. A notebook with a %NULL group name will
+     * not be able to exchange tabs with any other notebook.
+     * @param groupName - the name of the notebook group,
+     */
     setGroupName(groupName) {
         call("libgtk-4.so.1", "gtk_notebook_set_group_name", [
             {
@@ -508,6 +811,11 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Changes the menu label for the page containing @child.
+     * @param child - the child widget
+     * @param menuLabel - the menu label, or %NULL for default
+     */
     setMenuLabel(child, menuLabel) {
         call("libgtk-4.so.1", "gtk_notebook_set_menu_label", [
             {
@@ -525,6 +833,11 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Creates a new label and sets it as the menu label of @child.
+     * @param child - the child widget
+     * @param menuText - the label text
+     */
     setMenuLabelText(child, menuText) {
         call("libgtk-4.so.1", "gtk_notebook_set_menu_label_text", [
             {
@@ -541,6 +854,11 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets whether the tab label area will have arrows for
+     * scrolling if there are too many tabs to fit in the area.
+     * @param scrollable - %TRUE if scroll arrows should be added
+     */
     setScrollable(scrollable) {
         call("libgtk-4.so.1", "gtk_notebook_set_scrollable", [
             {
@@ -553,6 +871,12 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets whether a bevel will be drawn around the notebook pages.
+     *
+     * This only has a visual effect when the tabs are not shown.
+     * @param showBorder - %TRUE if a bevel should be drawn around the notebook
+     */
     setShowBorder(showBorder) {
         call("libgtk-4.so.1", "gtk_notebook_set_show_border", [
             {
@@ -565,6 +889,10 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets whether to show the tabs for the notebook or not.
+     * @param showTabs - %TRUE if the tabs should be shown
+     */
     setShowTabs(showTabs) {
         call("libgtk-4.so.1", "gtk_notebook_set_show_tabs", [
             {
@@ -577,6 +905,55 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets whether the tab can be detached from `notebook` to another
+     * notebook or widget.
+     *
+     * Note that two notebooks must share a common group identifier
+     * (see [method@Gtk.Notebook.set_group_name]) to allow automatic tabs
+     * interchange between them.
+     *
+     * If you want a widget to interact with a notebook through DnD
+     * (i.e.: accept dragged tabs from it) it must be set as a drop
+     * destination by adding to it a [class@Gtk.DropTarget] controller that accepts
+     * the GType `GTK_TYPE_NOTEBOOK_PAGE`. The `:value` of said drop target will be
+     * preloaded with a [class@Gtk.NotebookPage] object that corresponds to the
+     * dropped tab, so you can process the value via `::accept` or `::drop` signals.
+     *
+     * Note that you should use [method@Gtk.Notebook.detach_tab] instead
+     * of [method@Gtk.Notebook.remove_page] if you want to remove the tab
+     * from the source notebook as part of accepting a drop. Otherwise,
+     * the source notebook will think that the dragged tab was removed
+     * from underneath the ongoing drag operation, and will initiate a
+     * drag cancel animation.
+     *
+     * ```c
+     * static void
+     * on_drag_data_received (GtkWidget        *widget,
+     * GdkDrop          *drop,
+     * GtkSelectionData *data,
+     * guint             time,
+     * gpointer          user_data)
+     * {
+     * GtkDrag *drag;
+     * GtkWidget *notebook;
+     * GtkWidget **child;
+     *
+     * drag = gtk_drop_get_drag (drop);
+     * notebook = g_object_get_data (drag, "gtk-notebook-drag-origin");
+     * child = (void*) gtk_selection_data_get_data (data);
+     *
+     * // process_widget (*child);
+     *
+     * gtk_notebook_detach_tab (GTK_NOTEBOOK (notebook), *child);
+     * }
+     * ```
+     *
+     * If you want a notebook to accept drags from other widgets,
+     * you will have to set your own DnD code to do it.
+     * @param child - a child `GtkWidget`
+     * @param detachable - whether the tab is detachable or not
+     */
     setTabDetachable(child, detachable) {
         call("libgtk-4.so.1", "gtk_notebook_set_tab_detachable", [
             {
@@ -593,6 +970,14 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Changes the tab label for @child.
+     *
+     * If %NULL is specified for @tab_label, then the page will
+     * have the label “page N”.
+     * @param child - the page
+     * @param tabLabel - the tab label widget to use, or %NULL
+     */
     setTabLabel(child, tabLabel) {
         call("libgtk-4.so.1", "gtk_notebook_set_tab_label", [
             {
@@ -610,6 +995,12 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Creates a new label and sets it as the tab label for the page
+     * containing @child.
+     * @param child - the page
+     * @param tabText - the label text
+     */
     setTabLabelText(child, tabText) {
         call("libgtk-4.so.1", "gtk_notebook_set_tab_label_text", [
             {
@@ -626,6 +1017,10 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the edge at which the tabs are drawn.
+     * @param pos - the edge to draw the tabs at
+     */
     setTabPos(pos) {
         call("libgtk-4.so.1", "gtk_notebook_set_tab_pos", [
             {
@@ -638,6 +1033,12 @@ export class Notebook extends Widget {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets whether the notebook tab can be reordered
+     * via drag and drop or not.
+     * @param child - a child `GtkWidget`
+     * @param reorderable - whether the tab is reorderable or not
+     */
     setTabReorderable(child, reorderable) {
         call("libgtk-4.so.1", "gtk_notebook_set_tab_reorderable", [
             {