@gtkx/ffi 0.1.45 → 0.1.46

package/dist/generated/gtk/print-settings.js

@@ -3,10 +3,36 @@ import { NativeError, getObject } from "@gtkx/ffi";
 import { PaperSize } from "./paper-size.js";
 import * as GLib from "../glib/index.js";
 import * as GObject from "../gobject/index.js";
+/**
+ * Collects the settings of a print dialog in a system-independent way.
+ *
+ * The main use for this object is that once you’ve printed you can get a
+ * settings object that represents the settings the user chose, and the next
+ * time you print you can pass that object in so that the user doesn’t have
+ * to re-set all his settings.
+ *
+ * Its also possible to enumerate the settings so that you can easily save
+ * the settings for the next time your app runs, or even store them in a
+ * document. The predefined keys try to use shared values as much as possible
+ * so that moving such a document between systems still works.
+ */
 export class PrintSettings extends GObject.GObject {
+    /**
+     * Creates a new `GtkPrintSettings` object.
+     */
     constructor(...args) {
         super(...args);
     }
+    /**
+     * Reads the print settings from @file_name.
+     *
+     * Returns a new `GtkPrintSettings` object with the restored settings,
+     * or %NULL if an error occurred. If the file could not be loaded then
+     * error is set to either a `GFileError` or `GKeyFileError`.
+     *
+     * See [method@Gtk.PrintSettings.to_file].
+     * @param fileName - the filename to read the settings from
+     */
     static settingsNewFromFile(fileName) {
         const ptr = call("libgtk-4.so.1", "gtk_print_settings_new_from_file", [
             {
@@ -16,6 +42,13 @@ export class PrintSettings extends GObject.GObject {
         ], { type: "gobject", borrowed: false });
         return getObject(ptr, PrintSettings);
     }
+    /**
+     * Deserialize print settings from an a{sv} variant.
+     *
+     * The variant must be in the format produced by
+     * [method@Gtk.PrintSettings.to_gvariant].
+     * @param variant - an a{sv} `GVariant`
+     */
     static settingsNewFromGvariant(variant) {
         const ptr = call("libgtk-4.so.1", "gtk_print_settings_new_from_gvariant", [
             {
@@ -30,6 +63,15 @@ export class PrintSettings extends GObject.GObject {
         ], { type: "gobject", borrowed: false });
         return getObject(ptr, PrintSettings);
     }
+    /**
+     * Reads the print settings from the group `group_name` in @key_file.
+     *
+     * Returns a new `GtkPrintSettings` object with the restored settings,
+     * or %NULL if an error occurred. If the file could not be loaded then
+     * error is set to either `GFileError` or `GKeyFileError`.
+     * @param keyFile - the `GKeyFile` to retrieve the settings from
+     * @param groupName - the name of the group to use, or %NULL to use
+     */
     static settingsNewFromKeyFile(keyFile, groupName) {
         const ptr = call("libgtk-4.so.1", "gtk_print_settings_new_from_key_file", [
             {
@@ -55,6 +97,9 @@ export class PrintSettings extends GObject.GObject {
             borrowed: false,
         });
     }
+    /**
+     * Copies a `GtkPrintSettings` object.
+     */
     copy() {
         const ptr = call("libgtk-4.so.1", "gtk_print_settings_copy", [
             {
@@ -64,6 +109,11 @@ export class PrintSettings extends GObject.GObject {
         ], { type: "gobject", borrowed: true });
         return getObject(ptr, PrintSettings);
     }
+    /**
+     * Calls `func` for each key-value pair of @settings.
+     * @param func - the function to call
+     * @param userData - user data for @func
+     */
     foreach(func, userData) {
         call("libgtk-4.so.1", "gtk_print_settings_foreach", [
             {
@@ -81,6 +131,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Looks up the string value associated with @key.
+     * @param key - a key
+     */
     get(key) {
         return call("libgtk-4.so.1", "gtk_print_settings_get", [
             {
@@ -93,6 +147,14 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Returns the boolean represented by the value
+     * that is associated with @key.
+     *
+     * The string “true” represents %TRUE, any other
+     * string %FALSE.
+     * @param key - a key
+     */
     getBool(key) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_bool", [
             {
@@ -105,6 +167,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_COLLATE.
+     */
     getCollate() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_collate", [
             {
@@ -113,6 +178,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_DEFAULT_SOURCE.
+     */
     getDefaultSource() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_default_source", [
             {
@@ -121,6 +189,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_DITHER.
+     */
     getDither() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_dither", [
             {
@@ -129,6 +200,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Returns the double value associated with @key, or 0.
+     * @param key - a key
+     */
     getDouble(key) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_double", [
             {
@@ -141,6 +216,14 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Returns the floating point number represented by
+     * the value that is associated with @key, or `default_val` if the value does not represent a floating point number.
+     *
+     * Floating point numbers are parsed with g_ascii_strtod().
+     * @param key - a key
+     * @param def - the default value
+     */
     getDoubleWithDefault(key, def) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_double_with_default", [
             {
@@ -157,6 +240,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_DUPLEX.
+     */
     getDuplex() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_duplex", [
             {
@@ -165,6 +251,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_FINISHINGS.
+     */
     getFinishings() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_finishings", [
             {
@@ -173,6 +262,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Returns the integer value of @key, or 0.
+     * @param key - a key
+     */
     getInt(key) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_int", [
             {
@@ -185,6 +278,12 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value of @key, interpreted as
+     * an integer, or the default value.
+     * @param key - a key
+     * @param def - the default value
+     */
     getIntWithDefault(key, def) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_int_with_default", [
             {
@@ -201,6 +300,14 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Returns the value associated with @key, interpreted
+     * as a length.
+     *
+     * The returned value is converted to @units.
+     * @param key - a key
+     * @param unit - the unit of the return value
+     */
     getLength(key, unit) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_length", [
             {
@@ -217,6 +324,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_MEDIA_TYPE.
+     *
+     * The set of media types is defined in PWG 5101.1-2002 PWG.
+     */
     getMediaType() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_media_type", [
             {
@@ -225,6 +337,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_N_COPIES.
+     */
     getNCopies() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_n_copies", [
             {
@@ -233,6 +348,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_NUMBER_UP.
+     */
     getNumberUp() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_number_up", [
             {
@@ -241,6 +359,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.
+     */
     getNumberUpLayout() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_number_up_layout", [
             {
@@ -249,6 +370,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Get the value of %GTK_PRINT_SETTINGS_ORIENTATION,
+     * converted to a `GtkPageOrientation`.
+     */
     getOrientation() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_orientation", [
             {
@@ -257,6 +382,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_OUTPUT_BIN.
+     */
     getOutputBin() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_output_bin", [
             {
@@ -265,6 +393,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_PAGE_RANGES.
+     * @param numRanges - return location for the length of the returned array
+     */
     getPageRanges(numRanges) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_page_ranges", [
             {
@@ -280,6 +412,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "array", itemType: { type: "int", size: 64, unsigned: true } });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_PAGE_SET.
+     */
     getPageSet() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_page_set", [
             {
@@ -288,6 +423,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_PAPER_HEIGHT,
+     * converted to @unit.
+     * @param unit - the unit for the return value
+     */
     getPaperHeight(unit) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_paper_height", [
             {
@@ -300,6 +440,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_PAPER_FORMAT,
+     * converted to a `GtkPaperSize`.
+     */
     getPaperSize() {
         const ptr = call("libgtk-4.so.1", "gtk_print_settings_get_paper_size", [
             {
@@ -316,6 +460,11 @@ export class PrintSettings extends GObject.GObject {
             return null;
         return getObject(ptr, PaperSize);
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_PAPER_WIDTH,
+     * converted to @unit.
+     * @param unit - the unit for the return value
+     */
     getPaperWidth(unit) {
         return call("libgtk-4.so.1", "gtk_print_settings_get_paper_width", [
             {
@@ -328,6 +477,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_PRINT_PAGES.
+     */
     getPrintPages() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_print_pages", [
             {
@@ -336,6 +488,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Convenience function to obtain the value of
+     * %GTK_PRINT_SETTINGS_PRINTER.
+     */
     getPrinter() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_printer", [
             {
@@ -344,6 +500,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "string", borrowed: true });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_PRINTER_LPI.
+     */
     getPrinterLpi() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_printer_lpi", [
             {
@@ -352,6 +511,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_QUALITY.
+     */
     getQuality() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_quality", [
             {
@@ -360,6 +522,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_RESOLUTION.
+     */
     getResolution() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_resolution", [
             {
@@ -368,6 +533,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_RESOLUTION_X.
+     */
     getResolutionX() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_resolution_x", [
             {
@@ -376,6 +544,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_RESOLUTION_Y.
+     */
     getResolutionY() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_resolution_y", [
             {
@@ -384,6 +555,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "int", size: 32, unsigned: false });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_REVERSE.
+     */
     getReverse() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_reverse", [
             {
@@ -392,6 +566,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_SCALE.
+     */
     getScale() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_scale", [
             {
@@ -400,6 +577,9 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "float", size: 64 });
     }
+    /**
+     * Gets the value of %GTK_PRINT_SETTINGS_USE_COLOR.
+     */
     getUseColor() {
         return call("libgtk-4.so.1", "gtk_print_settings_get_use_color", [
             {
@@ -408,6 +588,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Returns %TRUE, if a value is associated with @key.
+     * @param key - a key
+     */
     hasKey(key) {
         return call("libgtk-4.so.1", "gtk_print_settings_has_key", [
             {
@@ -420,6 +604,15 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "boolean" });
     }
+    /**
+     * Reads the print settings from @file_name.
+     *
+     * If the file could not be loaded then error is set to either
+     * a `GFileError` or `GKeyFileError`.
+     *
+     * See [method@Gtk.PrintSettings.to_file].
+     * @param fileName - the filename to read the settings from
+     */
     loadFile(fileName) {
         const error = { value: null };
         const result = call("libgtk-4.so.1", "gtk_print_settings_load_file", [
@@ -448,6 +641,14 @@ export class PrintSettings extends GObject.GObject {
         }
         return result;
     }
+    /**
+     * Reads the print settings from the group `group_name` in @key_file.
+     *
+     * If the file could not be loaded then error is set to either a
+     * `GFileError` or `GKeyFileError`.
+     * @param keyFile - the `GKeyFile` to retrieve the settings from
+     * @param groupName - the name of the group to use, or %NULL
+     */
     loadKeyFile(keyFile, groupName) {
         const error = { value: null };
         const result = call("libgtk-4.so.1", "gtk_print_settings_load_key_file", [
@@ -486,6 +687,11 @@ export class PrintSettings extends GObject.GObject {
         }
         return result;
     }
+    /**
+     * Associates `value` with @key.
+     * @param key - a key
+     * @param value - a string value
+     */
     set(key, value) {
         call("libgtk-4.so.1", "gtk_print_settings_set", [
             {
@@ -503,6 +709,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `key` to a boolean value.
+     * @param key - a key
+     * @param value - a boolean
+     */
     setBool(key, value) {
         call("libgtk-4.so.1", "gtk_print_settings_set_bool", [
             {
@@ -519,6 +730,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_COLLATE.
+     * @param collate - whether to collate the output
+     */
     setCollate(collate) {
         call("libgtk-4.so.1", "gtk_print_settings_set_collate", [
             {
@@ -531,6 +746,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_DEFAULT_SOURCE.
+     * @param defaultSource - the default source
+     */
     setDefaultSource(defaultSource) {
         call("libgtk-4.so.1", "gtk_print_settings_set_default_source", [
             {
@@ -543,6 +762,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_DITHER.
+     * @param dither - the dithering that is used
+     */
     setDither(dither) {
         call("libgtk-4.so.1", "gtk_print_settings_set_dither", [
             {
@@ -555,6 +778,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `key` to a double value.
+     * @param key - a key
+     * @param value - a double value
+     */
     setDouble(key, value) {
         call("libgtk-4.so.1", "gtk_print_settings_set_double", [
             {
@@ -571,6 +799,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_DUPLEX.
+     * @param duplex - a `GtkPrintDuplex` value
+     */
     setDuplex(duplex) {
         call("libgtk-4.so.1", "gtk_print_settings_set_duplex", [
             {
@@ -583,6 +815,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_FINISHINGS.
+     * @param finishings - the finishings
+     */
     setFinishings(finishings) {
         call("libgtk-4.so.1", "gtk_print_settings_set_finishings", [
             {
@@ -595,6 +831,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets `key` to an integer value.
+     * @param key - a key
+     * @param value - an integer
+     */
     setInt(key, value) {
         call("libgtk-4.so.1", "gtk_print_settings_set_int", [
             {
@@ -611,6 +852,12 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Associates a length in units of `unit` with @key.
+     * @param key - a key
+     * @param value - a length
+     * @param unit - the unit of @length
+     */
     setLength(key, value, unit) {
         call("libgtk-4.so.1", "gtk_print_settings_set_length", [
             {
@@ -631,6 +878,12 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_MEDIA_TYPE.
+     *
+     * The set of media types is defined in PWG 5101.1-2002 PWG.
+     * @param mediaType - the media type
+     */
     setMediaType(mediaType) {
         call("libgtk-4.so.1", "gtk_print_settings_set_media_type", [
             {
@@ -643,6 +896,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_N_COPIES.
+     * @param numCopies - the number of copies
+     */
     setNCopies(numCopies) {
         call("libgtk-4.so.1", "gtk_print_settings_set_n_copies", [
             {
@@ -655,6 +912,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_NUMBER_UP.
+     * @param numberUp - the number of pages per sheet
+     */
     setNumberUp(numberUp) {
         call("libgtk-4.so.1", "gtk_print_settings_set_number_up", [
             {
@@ -667,6 +928,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.
+     * @param numberUpLayout - a `GtkNumberUpLayout` value
+     */
     setNumberUpLayout(numberUpLayout) {
         call("libgtk-4.so.1", "gtk_print_settings_set_number_up_layout", [
             {
@@ -679,6 +944,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_ORIENTATION.
+     * @param orientation - a page orientation
+     */
     setOrientation(orientation) {
         call("libgtk-4.so.1", "gtk_print_settings_set_orientation", [
             {
@@ -691,6 +960,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_OUTPUT_BIN.
+     * @param outputBin - the output bin
+     */
     setOutputBin(outputBin) {
         call("libgtk-4.so.1", "gtk_print_settings_set_output_bin", [
             {
@@ -703,6 +976,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_PAGE_RANGES.
+     * @param pageRanges - an array of `GtkPageRange`s
+     * @param numRanges - the length of @page_ranges
+     */
     setPageRanges(pageRanges, numRanges) {
         call("libgtk-4.so.1", "gtk_print_settings_set_page_ranges", [
             {
@@ -722,6 +1000,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_PAGE_SET.
+     * @param pageSet - a `GtkPageSet` value
+     */
     setPageSet(pageSet) {
         call("libgtk-4.so.1", "gtk_print_settings_set_page_set", [
             {
@@ -734,6 +1016,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_PAPER_HEIGHT.
+     * @param height - the paper height
+     * @param unit - the units of @height
+     */
     setPaperHeight(height, unit) {
         call("libgtk-4.so.1", "gtk_print_settings_set_paper_height", [
             {
@@ -750,6 +1037,12 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_PAPER_FORMAT,
+     * %GTK_PRINT_SETTINGS_PAPER_WIDTH and
+     * %GTK_PRINT_SETTINGS_PAPER_HEIGHT.
+     * @param paperSize - a paper size
+     */
     setPaperSize(paperSize) {
         call("libgtk-4.so.1", "gtk_print_settings_set_paper_size", [
             {
@@ -767,6 +1060,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_PAPER_WIDTH.
+     * @param width - the paper width
+     * @param unit - the units of @width
+     */
     setPaperWidth(width, unit) {
         call("libgtk-4.so.1", "gtk_print_settings_set_paper_width", [
             {
@@ -783,6 +1081,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_PRINT_PAGES.
+     * @param pages - a `GtkPrintPages` value
+     */
     setPrintPages(pages) {
         call("libgtk-4.so.1", "gtk_print_settings_set_print_pages", [
             {
@@ -795,6 +1097,11 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Convenience function to set %GTK_PRINT_SETTINGS_PRINTER
+     * to @printer.
+     * @param printer - the printer name
+     */
     setPrinter(printer) {
         call("libgtk-4.so.1", "gtk_print_settings_set_printer", [
             {
@@ -807,6 +1114,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_PRINTER_LPI.
+     * @param lpi - the resolution in lpi (lines per inch)
+     */
     setPrinterLpi(lpi) {
         call("libgtk-4.so.1", "gtk_print_settings_set_printer_lpi", [
             {
@@ -819,6 +1130,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_QUALITY.
+     * @param quality - a `GtkPrintQuality` value
+     */
     setQuality(quality) {
         call("libgtk-4.so.1", "gtk_print_settings_set_quality", [
             {
@@ -831,6 +1146,12 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the values of %GTK_PRINT_SETTINGS_RESOLUTION,
+     * %GTK_PRINT_SETTINGS_RESOLUTION_X and
+     * %GTK_PRINT_SETTINGS_RESOLUTION_Y.
+     * @param resolution - the resolution in dpi
+     */
     setResolution(resolution) {
         call("libgtk-4.so.1", "gtk_print_settings_set_resolution", [
             {
@@ -843,6 +1164,13 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the values of %GTK_PRINT_SETTINGS_RESOLUTION,
+     * %GTK_PRINT_SETTINGS_RESOLUTION_X and
+     * %GTK_PRINT_SETTINGS_RESOLUTION_Y.
+     * @param resolutionX - the horizontal resolution in dpi
+     * @param resolutionY - the vertical resolution in dpi
+     */
     setResolutionXy(resolutionX, resolutionY) {
         call("libgtk-4.so.1", "gtk_print_settings_set_resolution_xy", [
             {
@@ -859,6 +1187,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_REVERSE.
+     * @param reverse - whether to reverse the output
+     */
     setReverse(reverse) {
         call("libgtk-4.so.1", "gtk_print_settings_set_reverse", [
             {
@@ -871,6 +1203,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_SCALE.
+     * @param scale - the scale in percent
+     */
     setScale(scale) {
         call("libgtk-4.so.1", "gtk_print_settings_set_scale", [
             {
@@ -883,6 +1219,10 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Sets the value of %GTK_PRINT_SETTINGS_USE_COLOR.
+     * @param useColor - whether to use color
+     */
     setUseColor(useColor) {
         call("libgtk-4.so.1", "gtk_print_settings_set_use_color", [
             {
@@ -895,6 +1235,13 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * This function saves the print settings from `settings` to @file_name.
+     *
+     * If the file could not be written then error is set to either a
+     * `GFileError` or `GKeyFileError`.
+     * @param fileName - the file to save to
+     */
     toFile(fileName) {
         const error = { value: null };
         const result = call("libgtk-4.so.1", "gtk_print_settings_to_file", [
@@ -923,6 +1270,9 @@ export class PrintSettings extends GObject.GObject {
         }
         return result;
     }
+    /**
+     * Serialize print settings to an a{sv} variant.
+     */
     toGvariant() {
         const ptr = call("libgtk-4.so.1", "gtk_print_settings_to_gvariant", [
             {
@@ -937,6 +1287,11 @@ export class PrintSettings extends GObject.GObject {
         });
         return getObject(ptr, GLib.Variant);
     }
+    /**
+     * This function adds the print settings from `settings` to @key_file.
+     * @param keyFile - the `GKeyFile` to save the print settings to
+     * @param groupName - the group to add the settings to in @key_file, or
+     */
     toKeyFile(keyFile, groupName) {
         call("libgtk-4.so.1", "gtk_print_settings_to_key_file", [
             {
@@ -959,6 +1314,12 @@ export class PrintSettings extends GObject.GObject {
             },
         ], { type: "undefined" });
     }
+    /**
+     * Removes any value associated with @key.
+     *
+     * This has the same effect as setting the value to %NULL.
+     * @param key - a key
+     */
     unset(key) {
         call("libgtk-4.so.1", "gtk_print_settings_unset", [
             {