Rust GTK 4 Bindings

https://docs.rs/gtk4/0.10.0/
Admin
Rust GTK 4 Bindings provide safe Rust language bindings for GTK 4, a multi-platform graphical user...
Tokens:4,531,209
Snippets:26,006
Trust Score:9.7
Update:3 months ago
Show doc for...
Tokens:
Raw
### Setup Print Operation (Callback)

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PrintDialog.html

Configures and initiates a print setup operation using a callback. This is used to get the PrintSetup object.

```rust
pub fn setup<P: FnOnce(Result<PrintSetup, Error>) + 'static>( &self, parent: Option<&impl IsA<Window>>, cancellable: Option<&impl IsA<Cancellable>>, callback: P, )
```

--------------------------------

### Get Page Setup

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PrintDialog.html

Retrieves the page setup configuration for the PrintDialog.

```rust
pub fn page_setup(&self) -> Option<PageSetup>
```

--------------------------------

### Get Page Setup

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PrintContext.html

Retrieves the PageSetup object associated with the PrintContext, which contains page-related settings.

```rust
pub fn page_setup(&self) -> PageSetup
```

--------------------------------

### Get page setup from GtkPrintUnixDialog

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_unix_dialog.rs.html

Retrieves the current page setup configuration from the print dialog. This is essential for applying user-defined page settings.

```rust
impl PrintUnixDialog {
    #[doc(alias = "gtk_print_unix_dialog_get_page_setup")]
    #[doc(alias = "get_page_setup")]
    #[doc(alias = "page-setup")]
    pub fn page_setup(&self) -> PageSetup {
        unsafe {
            from_glib_none(ffi::gtk_print_unix_dialog_get_page_setup(
                self.to_glib_none().0,
            ))
        }
    }
}
```

--------------------------------

### Load Page Setup from KeyFile

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Loads page setup settings from a GLib KeyFile object. Returns an error if loading fails.

```rust
unsafe {
            let mut error = std::ptr::null_mut();
            let is_ok = ffi::gtk_page_setup_load_key_file(
                self.to_glib_none().0,
                key_file.to_glib_none().0,
                group_name.to_glib_none().0,
                &mut error,
            );
            debug_assert_eq!(is_ok == glib::ffi::GFALSE, !error.is_null());
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
```

--------------------------------

### Get start location of CssSection

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.CssSection.html

Returns the starting CssLocation of the CssSection.

```rust
pub fn start_location(&self) -> CssLocation
```

--------------------------------

### Get Start Position

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.AccessibleTextRange.html

Retrieves the starting character index of the AccessibleTextRange.

```rust
pub fn start(&self) -> usize
```

--------------------------------

### setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_dialog.rs.html

Initiates the print setup process, allowing the user to configure print options. This is an asynchronous operation that returns the result via a callback.

```APIDOC
## setup

### Description
Initiates the print setup process asynchronously.

### Method
`setup`

### Parameters
* `parent` (*Option<&impl IsA<Window>>*) - The parent window for the dialog.
* `cancellable` (*Option<&impl IsA<gio::Cancellable>>*) - A cancellable object to allow cancellation of the operation.
* `callback` (*P*) - A closure that will be called with the result of the print setup operation.
```

--------------------------------

### Load Page Setup from File

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Loads page setup settings from a file. Returns an error if loading fails.

```rust
unsafe {
            let mut error = std::ptr::null_mut();
            let is_ok = ffi::gtk_page_setup_load_file(
                self.to_glib_none().0,
                file_name.as_ref().to_glib_none().0,
                &mut error,
            );
            debug_assert_eq!(is_ok == glib::ffi::GFALSE, !error.is_null());
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
```

--------------------------------

### Create GtkPageSetup from KeyFile

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Creates a new GtkPageSetup object from a glib::KeyFile. Returns a Result containing the PageSetup or a glib::Error. Requires the GTK+ main thread to be initialized.

```rust
assert_initialized_main_thread!();
unsafe {
    let mut error = std::ptr::null_mut();
    let ret = ffi::gtk_page_setup_new_from_key_file(
        key_file.to_glib_none().0,
        group_name.to_glib_none().0,
        &mut error,
    );
    if error.is_null() {
        Ok(from_glib_full(ret))
    } else {
        Err(from_glib_full(error))
    }
}
```

--------------------------------

### Get GestureDrag Start Point

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/gesture_drag.rs.html

Retrieves the starting point of the drag gesture. Returns `Some((x, y))` if the drag has started, otherwise `None`.

```rust
unsafe {
    let mut x = std::mem::MaybeUninit::uninit();
    let mut y = std::mem::MaybeUninit::uninit();
    let ret = from_glib(ffi::gtk_gesture_drag_get_start_point(
        self.as_ref().to_glib_none().0,
        x.as_mut_ptr(),
        y.as_mut_ptr(),
    ));
    if ret {
        Some((x.assume_init(), y.assume_init()))
    } else {
        None
    }
}
```

--------------------------------

### Get Start Widget

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/center_layout.rs.html

Retrieves the widget currently set as the start widget in the GtkCenterLayout. Returns None if no start widget is set.

```rust
impl CenterLayout {
    #[doc(alias = "gtk_center_layout_get_start_widget")]
    #[doc(alias = "get_start_widget")]
    pub fn start_widget(&self) -> Option<Widget> {
        unsafe {
            from_glib_none(ffi::gtk_center_layout_get_start_widget(
                self.to_glib_none().0,
            ))
        }
    }
}
```

--------------------------------

### PrintDialog::setup

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PrintDialog.html

Initiates a page setup operation asynchronously.

```APIDOC
## PrintDialog::setup

### Description
Initiates a page setup operation asynchronously. This method takes a callback that will be invoked with the result of the page setup operation.

### Arguments
* `parent`: An optional parent window.
* `cancellable`: An optional `Cancellable` object.
* `callback`: A closure that accepts a `Result<PrintSetup, Error>`.
```

--------------------------------

### PageSetup::from_key_file

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Creates a new GtkPageSetup object from a glib::KeyFile.

```APIDOC
## PageSetup::from_key_file

### Description
Creates a new GtkPageSetup object from a glib::KeyFile.

### Method
Rust function call

### Endpoint
N/A

### Parameters
- **key_file** (*glib::KeyFile*) - Required - The glib::KeyFile to load the page setup from.
- **group_name** (*str*) - Optional - The name of the group in the key file to load.

### Request Example
```rust
let key_file = glib::KeyFile::new();
// Populate key_file with data...
match PageSetup::from_key_file(&key_file, Some("PageSetupGroup")) {
    Ok(page_setup) => {
        // Use the loaded page setup
    },
    Err(error) => {
        eprintln!("Error loading page setup: {}", error);
    }
}
```

### Response
#### Success Response (200)
- **PageSetup** (PageSetup) - A new GtkPageSetup object loaded from the key file.
#### Error Response
- **glib::Error** - An error if the key file cannot be read or parsed.
```

--------------------------------

### Get CenterLayout Start Widget

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.CenterLayout.html

Retrieves the widget currently set as the start widget in the CenterLayout. Returns None if no start widget is set.

```rust
pub fn start_widget(&self) -> Option<Widget>
```

--------------------------------

### Get Start Child Widget

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.Paned.html

Retrieves the widget currently set as the start child of the Paned widget. Returns None if no start child is set.

```rust
pub fn start_child(&self) -> Option<Widget>
```

--------------------------------

### Save Page Setup to KeyFile

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Saves the current page setup configuration to a GLib KeyFile object.

```rust
unsafe {
            ffi::gtk_page_setup_to_key_file(
                self.to_glib_none().0,
                key_file.to_glib_none().0,
                group_name.to_glib_none().0,
            );
        }
```

--------------------------------

### Get Top Margin of Page Setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Retrieves the top margin of the page setup. Requires the unit for measurement.

```rust
unsafe { ffi::gtk_page_setup_get_top_margin(self.to_glib_none().0, unit.into_glib()) }
```

--------------------------------

### Asynchronous Print Setup with Callback

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_dialog.rs.html

Initiates the print setup process asynchronously. A callback function is provided to handle the result, which can be either a successful PrintSetup or a glib::Error.

```rust
pub fn setup<P: FnOnce(Result<PrintSetup, glib::Error>) + 'static>(
        &self,
        parent: Option<&impl IsA<Window>>,
        cancellable: Option<&impl IsA<gio::Cancellable>>,
        callback: P,
    ) {
        let main_context = glib::MainContext::ref_thread_default();
        let is_main_context_owner = main_context.is_owner();
        let has_acquired_main_context = (!is_main_context_owner)
            .then(|| main_context.acquire().ok())
            .flatten();
        assert!(
            is_main_context_owner || has_acquired_main_context.is_some(),
            "Async operations only allowed if the thread is owning the MainContext"
        );

        let user_data: Box_<glib::thread_guard::ThreadGuard<P>> = 
            Box_::new(glib::thread_guard::ThreadGuard::new(callback));
        unsafe extern "C" fn setup_trampoline< 
            P: FnOnce(Result<PrintSetup, glib::Error>) + 'static,
        >(
            _source_object: *mut glib::gobject_ffi::GObject,
            res: *mut gio::ffi::GAsyncResult,
            user_data: glib::ffi::gpointer,
        ) {
            let mut error = std::ptr::null_mut();
            let ret = ffi::gtk_print_dialog_setup_finish(_source_object as *mut _, res, &mut error);
            let result = if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            };
            let callback: Box_<glib::thread_guard::ThreadGuard<P>> = 
                Box_::from_raw(user_data as *mut _);
            let callback: P = callback.into_inner();
            callback(result);
        }
        let callback = setup_trampoline::<P>;
        unsafe {
            ffi::gtk_print_dialog_setup(
                self.to_glib_none().0,
                parent.map(|p| p.as_ref()).to_glib_none().0,
                cancellable.map(|p| p.as_ref()).to_glib_none().0,
                Some(callback),
                Box_::into_raw(user_data) as *mut _,
            );
        }
    }
```

--------------------------------

### Get Right Margin of Page Setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Retrieves the right margin of the page setup. Requires the unit for measurement.

```rust
unsafe { ffi::gtk_page_setup_get_right_margin(self.to_glib_none().0, unit.into_glib()) }
```

--------------------------------

### gtk4 print_run_page_setup_dialog_async Signature

Source: https://docs.rs/gtk4/0.10.0/gtk4/fn.print_run_page_setup_dialog_async.html

This is the function signature for `print_run_page_setup_dialog_async`. It outlines the parameters required to initiate an asynchronous page setup dialog, including optional parent window, initial page setup, print settings, and a callback function to be executed upon completion.

```rust
pub fn print_run_page_setup_dialog_async<P: FnOnce(&PageSetup) + Send + Sync + 'static>(
    parent: Option<&impl IsA<Window>>,
    page_setup: Option<&PageSetup>,
    settings: &PrintSettings,
    done_cb: P,
)
```

--------------------------------

### margin_start

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.CellView.html

Gets the start margin of the widget.

```APIDOC
## margin_start

### Description
Gets the start margin of the widget.

### Method
`margin_start(&self) -> i32`

### Returns
- `i32`: The start margin.
```

--------------------------------

### Get Default Page Setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_operation.rs.html

Retrieves the default page setup for the print operation. This method is part of the PrintOperationExt trait.

```rust
fn default_page_setup(&self) -> PageSetup {
        unsafe {
            from_glib_none(ffi::gtk_print_operation_get_default_page_setup(
                self.as_ref().to_glib_none().0,
            ))
        }
    }
```

--------------------------------

### PageSetup::new

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Creates a new GtkPageSetup object with default values.

```APIDOC
## PageSetup::new

### Description
Creates a new GtkPageSetup object with default values.

### Method
Rust function call

### Endpoint
N/A

### Parameters
None

### Request Example
```rust
let page_setup = PageSetup::new();
```

### Response
#### Success Response
- **PageSetup** (PageSetup) - A new GtkPageSetup object.
```

--------------------------------

### Save Page Setup to File

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Saves the current page setup configuration to a file. Returns an error if saving fails.

```rust
unsafe {
            let mut error = std::ptr::null_mut();
            let is_ok = ffi::gtk_page_setup_to_file(
                self.to_glib_none().0,
                file_name.as_ref().to_glib_none().0,
                &mut error,
            );
            debug_assert_eq!(is_ok == glib::ffi::GFALSE, !error.is_null());
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
```

--------------------------------

### Get Section Start and End

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/section_model.rs.html

Retrieves the start and end positions of a section within the model. This method is part of the SectionModelExt trait.

```rust
pub trait SectionModelExt: IsA<SectionModel> + 'static {
    #[doc(alias = "gtk_section_model_get_section")]
    #[doc(alias = "get_section")]
    fn section(&self, position: u32) -> (u32, u32) {
        unsafe {
            let mut out_start = std::mem::MaybeUninit::uninit();
            let mut out_end = std::mem::MaybeUninit::uninit();
            ffi::gtk_section_model_get_section(
                self.as_ref().to_glib_none().0,
                position,
                out_start.as_mut_ptr(),
                out_end.as_mut_ptr(),
            );
            (out_start.assume_init(), out_end.assume_init())
        }
    }
// ... other methods
```

--------------------------------

### Get Start Index of GtkListHeader

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/list_header.rs.html

Retrieves the start index of the GtkListHeader. This value indicates the lower bound of items managed by the header.

```rust
impl ListHeader {
    #[doc(alias = "gtk_list_header_get_start")]
    #[doc(alias = "get_start")]
    pub fn start(&self) -> u32 {
        unsafe { ffi::gtk_list_header_get_start(self.to_glib_none().0) }
    }
}
```

--------------------------------

### Create GtkPageSetup from File

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Creates a new GtkPageSetup object from a file. Returns a Result containing the PageSetup or a glib::Error. Requires the GTK+ main thread to be initialized.

```rust
assert_initialized_main_thread!();
unsafe {
    let mut error = std::ptr::null_mut();
    let ret =
        ffi::gtk_page_setup_new_from_file(file_name.as_ref().to_glib_none().0, &mut error);
    if error.is_null() {
        Ok(from_glib_full(ret))
    } else {
        Err(from_glib_full(error))
    }
}
```

--------------------------------

### PageSetup Methods

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PageSetup.html

This section provides documentation for the various methods available on the PageSetup struct, enabling users to create, load, save, and modify page setup configurations.

```APIDOC
## PageSetup

### Description
Represents page setup settings, including margins, orientation, and paper size.

### Methods

#### `new()`
Creates a new PageSetup instance.

#### `from_file(file_name: impl AsRef<Path>) -> Result<PageSetup, Error>`
Loads page setup settings from a file.

#### `from_gvariant(variant: &Variant) -> PageSetup`
Creates a PageSetup instance from a GVariant.

#### `from_key_file(key_file: &KeyFile, group_name: Option<&str>) -> Result<PageSetup, Error>`
Loads page setup settings from a KeyFile.

#### `copy(&self) -> PageSetup`
Creates a copy of the PageSetup instance.

#### `bottom_margin(&self, unit: Unit) -> f64`
Gets the bottom margin of the page setup.

#### `left_margin(&self, unit: Unit) -> f64`
Gets the left margin of the page setup.

#### `orientation(&self) -> PageOrientation`
Gets the page orientation.

#### `page_height(&self, unit: Unit) -> f64`
Gets the page height.

#### `page_width(&self, unit: Unit) -> f64`
Gets the page width.

#### `paper_height(&self, unit: Unit) -> f64`
Gets the paper height.

#### `paper_size(&self) -> PaperSize`
Gets the paper size.

#### `paper_width(&self, unit: Unit) -> f64`
Gets the paper width.

#### `right_margin(&self, unit: Unit) -> f64`
Gets the right margin of the page setup.

#### `top_margin(&self, unit: Unit) -> f64`
Gets the top margin of the page setup.

#### `load_file(&self, file_name: impl AsRef<Path>) -> Result<(), Error>`
Loads page setup settings from a file into the current instance.

#### `load_key_file(&self, key_file: &KeyFile, group_name: Option<&str>) -> Result<(), Error>`
Loads page setup settings from a KeyFile into the current instance.

#### `set_bottom_margin(&self, margin: f64, unit: Unit)`
Sets the bottom margin.

#### `set_left_margin(&self, margin: f64, unit: Unit)`
Sets the left margin.

#### `set_orientation(&self, orientation: PageOrientation)`
Sets the page orientation.

#### `set_paper_size(&self, size: &PaperSize)`
Sets the paper size.

#### `set_paper_size_and_default_margins(&self, size: &PaperSize)`
Sets the paper size and default margins.

#### `set_right_margin(&self, margin: f64, unit: Unit)`
Sets the right margin.

#### `set_top_margin(&self, margin: f64, unit: Unit)`
Sets the top margin.

#### `to_file(&self, file_name: impl AsRef<Path>) -> Result<(), Error>`
Saves the page setup settings to a file.

#### `to_gvariant(&self) -> Variant`
Converts the PageSetup instance to a GVariant.

#### `to_key_file(&self, key_file: &KeyFile, group_name: Option<&str>)`
Saves the page setup settings to a KeyFile.
```

--------------------------------

### PrintDialog::setup_future

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PrintDialog.html

Initiates a page setup operation and returns a future.

```APIDOC
## PrintDialog::setup_future

### Description
Initiates a page setup operation and returns a `Future` that resolves with the result.

### Arguments
* `parent`: An optional parent window.

### Returns
A `Pin<Box<dyn Future<Output = Result<PrintSetup, Error>>>>` representing the asynchronous page setup operation.
```

--------------------------------

### AccessibleTextRange::start

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.AccessibleTextRange.html

Gets the starting position of the text range.

```APIDOC
## AccessibleTextRange::start

### Description
Gets the starting position of the text range.

### Method
`AccessibleTextRange::start(&self) -> usize`

### Returns
The starting position (`usize`) of the text range.
```

--------------------------------

### PageSetup::from_file

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Creates a new GtkPageSetup object from a file.

```APIDOC
## PageSetup::from_file

### Description
Creates a new GtkPageSetup object from a file.

### Method
Rust function call

### Endpoint
N/A

### Parameters
- **file_name** (*std::path::Path*) - Required - The path to the file to load the page setup from.

### Request Example
```rust
use std::path::Path;

match PageSetup::from_file("path/to/page_setup.cfg") {
    Ok(page_setup) => {
        // Use the loaded page setup
    },
    Err(error) => {
        eprintln!("Error loading page setup: {}", error);
    }
}
```

### Response
#### Success Response (200)
- **PageSetup** (PageSetup) - A new GtkPageSetup object loaded from the file.
#### Error Response
- **glib::Error** - An error if the file cannot be read or parsed.
```

--------------------------------

### PageSetup::right_margin

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Gets the right margin of the page setup.

```APIDOC
## PageSetup::right_margin

### Description
Gets the right margin of the page setup.

### Method
Rust function call

### Endpoint
N/A

### Parameters
- **unit** (*Unit*) - Required - The unit of measurement for the margin.

### Request Example
```rust
let page_setup = PageSetup::new();
let right_margin = page_setup.right_margin(Unit::Inches);
println!("Right margin: {}", right_margin);
```

### Response
#### Success Response
- **f64** - The value of the right margin in the specified unit.
```

--------------------------------

### FileLauncher::new

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.FileLauncher.html

Creates a new FileLauncher instance. It can optionally be initialized with a file.

```APIDOC
## FileLauncher::new

### Description
Creates a new `FileLauncher` instance. It can optionally be initialized with a file.

### Signature
```rust
pub fn new(file: Option<&impl IsA<File>>) -> FileLauncher
```

### Parameters
* `file` (Option<&impl IsA<File>>) - An optional file to initialize the launcher with.
```

--------------------------------

### PageSetup::paper_size

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Gets the paper size of the page setup.

```APIDOC
## PageSetup::paper_size

### Description
Gets the paper size of the page setup.

### Method
Rust function call

### Endpoint
N/A

### Parameters
None

### Request Example
```rust
let page_setup = PageSetup::new();
let paper_size = page_setup.paper_size();
println!("Paper size: {:?}", paper_size);
```

### Response
#### Success Response
- **PaperSize** (PaperSize) - The paper size (e.g., A4, Letter).
```

--------------------------------

### PrintSetup Methods

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PrintSetup.html

Provides access to the underlying C pointer and related print settings.

```APIDOC
## PrintSetup Methods

### `as_ptr`

- **Signature**: `pub fn as_ptr(&self) -> *mut GtkPrintSetup`
- **Description**: Returns the inner pointer to the underlying C value.

### `page_setup`

- **Signature**: `pub fn page_setup(&self) -> PageSetup`
- **Description**: Retrieves the PageSetup associated with this PrintSetup.

### `print_settings`

- **Signature**: `pub fn print_settings(&self) -> PrintSettings`
- **Description**: Retrieves the PrintSettings associated with this PrintSetup.
```

--------------------------------

### PageSetup::orientation

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Gets the page orientation of the page setup.

```APIDOC
## PageSetup::orientation

### Description
Gets the page orientation of the page setup.

### Method
Rust function call

### Endpoint
N/A

### Parameters
None

### Request Example
```rust
let page_setup = PageSetup::new();
let orientation = page_setup.orientation();
println!("Orientation: {:?}", orientation);
```

### Response
#### Success Response
- **PageOrientation** (PageOrientation) - The page orientation (e.g., Portrait, Landscape).
```

--------------------------------

### PrintSetup Methods

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_setup.rs.html

Provides access to methods for retrieving page setup and print settings from a PrintSetup object.

```APIDOC
## PrintSetup

### Description
Represents print setup information for GTK4 applications.

### Methods

#### `page_setup`

- **Description**: Retrieves the associated PageSetup object.
- **Returns**: A `PageSetup` object.

#### `print_settings`

- **Description**: Retrieves the associated PrintSettings object.
- **Returns**: A `PrintSettings` object.
```

--------------------------------

### PageSetup::left_margin

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Gets the left margin of the page setup.

```APIDOC
## PageSetup::left_margin

### Description
Gets the left margin of the page setup.

### Method
Rust function call

### Endpoint
N/A

### Parameters
- **unit** (*Unit*) - Required - The unit of measurement for the margin.

### Request Example
```rust
let page_setup = PageSetup::new();
let left_margin = page_setup.left_margin(Unit::Inches);
println!("Left margin: {}", left_margin);
```

### Response
#### Success Response
- **f64** - The value of the left margin in the specified unit.
```

--------------------------------

### PageSetup::bottom_margin

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Gets the bottom margin of the page setup.

```APIDOC
## PageSetup::bottom_margin

### Description
Gets the bottom margin of the page setup.

### Method
Rust function call

### Endpoint
N/A

### Parameters
- **unit** (*Unit*) - Required - The unit of measurement for the margin.

### Request Example
```rust
let page_setup = PageSetup::new();
let bottom_margin = page_setup.bottom_margin(Unit::Inches);
println!("Bottom margin: {}", bottom_margin);
```

### Response
#### Success Response
- **f64** - The value of the bottom margin in the specified unit.
```

--------------------------------

### ConstraintGuide::new

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/constraint_guide.rs.html

Creates a new GtkConstraintGuide. This is the primary constructor for creating constraint guides.

```APIDOC
## ConstraintGuide::new

### Description
Creates a new GtkConstraintGuide.

### Method
```rust
pub fn new() -> ConstraintGuide
```

### Returns
A new `ConstraintGuide` instance.
```

--------------------------------

### GtkListHeader Methods

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/list_header.rs.html

Provides methods to get and set the child widget, retrieve the end and start indices, and get the item associated with the GtkListHeader.

```APIDOC
## GtkListHeader Methods

### `child(&self) -> Option<Widget>`

Gets the child widget of the `GtkListHeader`.

### `end(&self) -> u32`

Returns the end index of the header.

### `item(&self) -> Option<glib::Object>`

Gets the item associated with the `GtkListHeader`.

### `n_items(&self) -> u32`

Returns the number of items in the header.

### `start(&self) -> u32`

Returns the start index of the header.

### `set_child(&self, child: Option<&impl IsA<Widget>>)`

Sets the child widget for the `GtkListHeader`.
```

--------------------------------

### Run Page Setup Dialog Synchronously

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/functions.rs.html

Runs the GTK page setup dialog and returns the result. This function blocks until the dialog is closed.

```rust
pub fn print_run_page_setup_dialog(
    parent: Option<&impl IsA<Window>>,
    page_setup: Option<&PageSetup>,
    settings: &PrintSettings,
) -> PageSetup {
    skip_assert_initialized!();
    unsafe {
        from_glib_full(ffi::gtk_print_run_page_setup_dialog(
            parent.map(|p| p.as_ref()).to_glib_none().0,
            page_setup.to_glib_none().0,
            settings.to_glib_none().0,
        ))
    }
}
```

--------------------------------

### Get Widget Margin Start

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/widget.rs.html

Retrieves the start margin of a widget. Use this when you need to know the widget's spacing from its leading edge.

```rust
fn margin_start(&self) -> i32 {
        unsafe { ffi::gtk_widget_get_margin_start(self.as_ref().to_glib_none().0) }
    }
```

--------------------------------

### gtk_print_run_page_setup_dialog

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/functions.rs.html

Runs the page setup dialog synchronously.

Parameters:
- parent (Option<&impl IsA<Window>>): The parent window.
- page_setup (Option<&PageSetup>): The initial page setup.
- settings (PrintSettings): The print settings.

Returns:
A new PageSetup object configured by the user.

```APIDOC
## gtk_print_run_page_setup_dialog

### Description
Runs the page setup dialog synchronously, allowing the user to configure page settings.

### Parameters
- **parent** (Option<&impl IsA<Window>>) - Description: The parent window for the dialog.
- **page_setup** (Option<&PageSetup>) - Description: The initial page setup configuration.
- **settings** (PrintSettings) - Description: The print settings to be used.

### Returns
- **PageSetup** - A new PageSetup object reflecting the user's choices.
```

--------------------------------

### Window::new

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.Window.html

Creates a new Gtk4 Window instance.

```APIDOC
## Window::new

### Description
Creates a new Gtk4 Window instance.

### Method
`new()`

### Returns
A new `Window` object.
```

--------------------------------

### Get the start widget of Gtk4 CenterBox

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/center_box.rs.html

Retrieves the widget currently set as the start child of the CenterBox. Returns None if no widget is set.

```rust
#[doc(alias = "gtk_center_box_get_start_widget")]
#[doc(alias = "get_start_widget")]
#[doc(alias = "start-widget")]
pub fn start_widget(&self) -> Option<Widget> {
    unsafe { from_glib_none(ffi::gtk_center_box_get_start_widget(self.to_glib_none().0)) }
}
```

--------------------------------

### Setup Print Operation (Future)

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PrintDialog.html

Configures and initiates a print setup operation, returning a future for the result. This provides an asynchronous way to obtain the PrintSetup.

```rust
pub fn setup_future( &self, parent: Option<&(impl IsA<Window> + Clone + 'static)>, ) -> Pin<Box_<dyn Future<Output = Result<PrintSetup, Error>> + 'static>>
```

--------------------------------

### Get Start Page of PageRange

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PageRange.html

Retrieves the starting page number from a PageRange instance. This is useful for determining the beginning of a defined page range.

```rust
pub fn start(&self) -> i32
```

--------------------------------

### ConstraintGuide::new

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.ConstraintGuide.html

Creates a new `ConstraintGuide` object.

```APIDOC
## ConstraintGuide::new

### Description
Creates a new `ConstraintGuide` object.

### Method
`pub fn new() -> ConstraintGuide`
```

--------------------------------

### gtk_print_run_page_setup_dialog_async

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/functions.rs.html

Runs the page setup dialog asynchronously.

Parameters:
- parent (Option<&impl IsA<Window>>): The parent window.
- page_setup (Option<&PageSetup>): The initial page setup.
- settings (PrintSettings): The print settings.
- done_cb (P): A callback function to be called when the dialog is closed.

This function is asynchronous and will return immediately. The `done_cb` will be invoked with the resulting `PageSetup` object when the user finishes with the dialog.

```APIDOC
## gtk_print_run_page_setup_dialog_async

### Description
Runs the page setup dialog asynchronously. The result is delivered via a callback.

### Parameters
- **parent** (Option<&impl IsA<Window>>) - Description: The parent window for the dialog.
- **page_setup** (Option<&PageSetup>) - Description: The initial page setup configuration.
- **settings** (PrintSettings) - Description: The print settings to be used.
- **done_cb** (P) - Description: A callback function that will be invoked with the final `PageSetup` object once the dialog is closed by the user.
```

--------------------------------

### CenterBox::start_widget

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/center_box.rs.html

Gets the widget that is set as the start child of the GtkCenterBox.

```APIDOC
## CenterBox::start_widget

### Description
Gets the widget that is set as the start child of the `CenterBox`.

### Method
```rust
fn start_widget(&self) -> Option<Widget>
```

### Returns
The start widget, or `None` if no widget is set.
```

--------------------------------

### init

Source: https://docs.rs/gtk4/0.10.0/index.html

Tries to initialize GTK. This function should be called before any other GTK functions.

```APIDOC
## init

### Description
Tries to initialize GTK. This function should be called before any other GTK functions.

### Method
N/A (Function call)

### Endpoint
N/A

### Parameters
None

### Request Example
N/A

### Response
#### Success Response
N/A

#### Response Example
N/A
```

--------------------------------

### selection_bounds

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.PasswordEntry.html

Gets the start and end positions of the current text selection.

```APIDOC
## selection_bounds

### Description
Gets the start and end positions of the current text selection.

### Returns
* `Option<(i32, i32)>` - A tuple containing the start and end positions of the selection, or None if no text is selected.
```

--------------------------------

### print_run_page_setup_dialog_async

Source: https://docs.rs/gtk4/0.10.0/gtk4/fn.print_run_page_setup_dialog_async.html

Asynchronously runs the print setup dialog. This function displays the dialog to the user, allowing them to adjust page setup and print settings. The provided callback `done_cb` is invoked once the dialog is closed, receiving the final `PageSetup` configuration.

```APIDOC
## Function print_run_page_setup_dialog_async

### Description
Runs the print setup dialog asynchronously. This function displays the dialog to the user, allowing them to adjust page setup and print settings. The provided callback `done_cb` is invoked once the dialog is closed, receiving the final `PageSetup` configuration.

### Signature
```rust
pub fn print_run_page_setup_dialog_async<P: FnOnce(&PageSetup) + Send + Sync + 'static>(
    parent: Option<&impl IsA<Window>>,
    page_setup: Option<&PageSetup>,
    settings: &PrintSettings,
    done_cb: P,
)
```

### Parameters
* `parent`: An optional reference to a `Window` which is the parent of the dialog. If `None`, the dialog has no parent.
* `page_setup`: An optional reference to a `PageSetup` object to initialize the dialog with. If `None`, default settings are used.
* `settings`: A reference to a `PrintSettings` object that holds the current print settings.
* `done_cb`: A closure that will be called once the dialog is closed. It takes a reference to the final `PageSetup` object as an argument. The closure must be `Send`, `Sync`, and `'static`.
```

--------------------------------

### Get Right Margin of GtkPageSetup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Retrieves the right margin of the page setup in the specified unit.

```rust
unsafe {
    ffi::gtk_page_setup_get_right_margin(self.to_glib_none().0, unit.into_glib())
}
```

--------------------------------

### Get Left Margin of GtkPageSetup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Retrieves the left margin of the page setup in the specified unit.

```rust
unsafe {
    ffi::gtk_page_setup_get_left_margin(self.to_glib_none().0, unit.into_glib())
}
```

--------------------------------

### connect_setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/signal_list_item_factory.rs.html

Connects a closure to the 'setup' signal of the SignalListItemFactory. This signal is emitted when an item is being set up for use.

```APIDOC
## connect_setup

### Description
Connects a closure to the 'setup' signal. This signal is emitted when an item is being set up for use.

### Method
`connect_setup`

### Parameters
- `f` (Fn(&Self, &ListItem) + 'static) - The closure to connect to the signal.

### Returns
- `SignalHandlerId` - The ID of the signal handler, which can be used to disconnect the signal.
```

--------------------------------

### Create Gtk EntryBuffer with Builder

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/entry_buffer.rs.html

Demonstrates how to create a new EntryBuffer using the builder pattern, setting properties like max_length and text.

```rust
use gtk4::prelude::*;

fn main() {
    let entry_buffer = gtk4::EntryBuffer::builder()
        .max_length(10)
        .text("Initial text")
        .build();
}
```

--------------------------------

### Get Bottom Margin of GtkPageSetup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Retrieves the bottom margin of the page setup in the specified unit.

```rust
unsafe {
    ffi::gtk_page_setup_get_bottom_margin(self.to_glib_none().0, unit.into_glib())
}
```

--------------------------------

### Get Binary Age

Source: https://docs.rs/gtk4/0.10.0/gtk4/fn.binary_age.html

This function returns the binary age as a u32. No setup or imports are required.

```rust
pub fn binary_age() -> u32
```

--------------------------------

### FileLauncher::new

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/file_launcher.rs.html

Creates a new GtkFileLauncher for the given file. If `file` is `None`, a default file will be used.

```APIDOC
## FileLauncher::new

### Description
Creates a new GtkFileLauncher for the given file. If `file` is `None`, a default file will be used.

### Method
`FileLauncher::new(file: Option<&impl IsA<gio::File>>)`

### Parameters
* `file` (Option<&impl IsA<gio::File>>) - The file to associate with the launcher. Can be `None`.

### Returns
A new `FileLauncher` instance.
```

--------------------------------

### Get input hints

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.Text.html

Retrieves the input hints for the Text widget. These hints guide the input method.

```rust
pub fn input_hints(&self) -> InputHints
```

--------------------------------

### ShortcutController::new

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/shortcut_controller.rs.html

Creates a new GtkShortcutController.

```APIDOC
## ShortcutController::new

### Description
Creates a new GtkShortcutController.

### Method
```
pub fn new() -> ShortcutController
```

### Returns
A new `ShortcutController` instance.
```

--------------------------------

### Run Page Setup Dialog Asynchronously

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/functions.rs.html

Runs the GTK page setup dialog asynchronously. A callback is invoked when the dialog is closed.

```rust
pub fn print_run_page_setup_dialog_async<P: FnOnce(&PageSetup) + Send + Sync + 'static>(
    parent: Option<&impl IsA<Window>>,
    page_setup: Option<&PageSetup>,
    settings: &PrintSettings,
    done_cb: P,
) {
    skip_assert_initialized!();
    let done_cb_data: Box_<P> = Box_::new(done_cb);
    unsafe extern "C" fn done_cb_func<P: FnOnce(&PageSetup) + Send + Sync + 'static>(
        page_setup: *mut ffi::GtkPageSetup,
        data: glib::ffi::gpointer,
    ) {
        let page_setup = from_glib_borrow(page_setup);
        let callback = Box_::from_raw(data as *mut P);
        (*callback)(&page_setup)
    }
    let done_cb = Some(done_cb_func::<P> as _);
    let super_callback0: Box_<P> = done_cb_data;
    unsafe {
        ffi::gtk_print_run_page_setup_dialog_async(
            parent.map(|p| p.as_ref()).to_glib_none().0,
            page_setup.to_glib_none().0,
            settings.to_glib_none().0,
            done_cb,
            Box_::into_raw(super_callback0) as *mut _,
        );
    }
}
```

--------------------------------

### Get Page Orientation of GtkPageSetup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Retrieves the page orientation (e.g., portrait, landscape) of the page setup.

```rust
unsafe {
    from_glib(ffi::gtk_page_setup_get_orientation(self.to_glib_none().0))
}
```

--------------------------------

### page_setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_context.rs.html

Retrieves the `PageSetup` object associated with the print context. This object contains information about the page size, orientation, and other printing-related settings.

```APIDOC
## page_setup

### Description
Retrieves the `PageSetup` object associated with the print context.

### Method
`PrintContext::page_setup()`

### Returns
A `PageSetup` object.
```

--------------------------------

### Get Button for GestureSingle

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/gesture_single.rs.html

Retrieves the button that is used to start the gesture. This is useful for distinguishing between different mouse buttons.

```rust
impl GestureSingleExt {
    #[doc(alias = "gtk_gesture_single_get_button")]
    #[doc(alias = "get_button")]
    fn button(&self) -> u32 {
        unsafe { ffi::gtk_gesture_single_get_button(self.as_ref().to_glib_none().0) }
    }
}
```

--------------------------------

### Get GTK Cursor Blink Timeout

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.Settings.html

Retrieves the 'gtk-cursor-blink-timeout' setting, which defines the timeout before the cursor starts blinking.

```rust
pub fn gtk_cursor_blink_timeout(&self) -> i32
```

--------------------------------

### Building a Window with WindowBuilder

Source: https://docs.rs/gtk4/0.10.0/gtk4/builders/struct.WindowBuilder.html

Demonstrates the final step of using WindowBuilder to construct a Window object after all desired properties have been set.

```rust
pub fn build(self) -> Window
```

--------------------------------

### Get the Divider Position

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/paned.rs.html

Retrieves the current position of the divider in the GtkPaned widget. The position is measured in pixels from the start of the widget.

```rust
#[doc(alias = "gtk_paned_get_position")]
    #[doc(alias = "get_position")]
    pub fn position(&self) -> i32 {
        unsafe { ffi::gtk_paned_get_position(self.to_glib_none().0) }
    }
```

--------------------------------

### Get Current Position

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.Paned.html

Returns the current position of the separator in the Paned widget. The position is measured in pixels from the start of the widget.

```rust
pub fn position(&self) -> i32
```

--------------------------------

### FileDialog Creation and Configuration

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.FileDialog.html

Demonstrates how to create a FileDialog instance and set its properties like title, filters, and initial file/folder.

```APIDOC
## FileDialog::new()

### Description
Creates a new `FileDialog` instance.

### Returns
A new `FileDialog` object.

## FileDialog::builder()

### Description
Creates a new builder-pattern struct instance to construct `FileDialog` objects.

### Returns
An instance of `FileDialogBuilder`.

## FileDialog::set_title(title: &str)

### Description
Sets the title of the file dialog.

## FileDialog::set_accept_label(accept_label: Option<&str>)

### Description
Sets the label for the accept button.

## FileDialog::set_modal(modal: bool)

### Description
Sets whether the file dialog is modal.

## FileDialog::set_default_filter(filter: Option<&FileFilter>)

### Description
Sets the default file filter for the dialog.

## FileDialog::set_filters(filters: Option<&impl IsA<ListModel>>)

### Description
Sets the list of file filters for the dialog.

## FileDialog::set_initial_file(file: Option<&impl IsA<File>>)

### Description
Sets the initial file to be displayed in the dialog.

## FileDialog::set_initial_folder(folder: Option<&impl IsA<File>>)

### Description
Sets the initial folder to be displayed in the dialog.

## FileDialog::set_initial_name(name: Option<&str>)

### Description
Sets the initial name for a file to be saved.
```

--------------------------------

### Get Section Information

Source: https://docs.rs/gtk4/0.10.0/gtk4/struct.FlattenListModel.html

Retrieves the start position and number of items for a specific section in a SectionModel. Requires the 'v4_12' feature.

```rust
self.section(position)
```

--------------------------------

### Create GtkVideo from scratch

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/video.rs.html

Instantiates a new GtkVideo widget. Ensure the main thread is initialized before calling.

```rust
impl Video {
    #[doc(alias = "gtk_video_new")]
    pub fn new() -> Video {
        assert_initialized_main_thread!();
        unsafe { Widget::from_glib_none(ffi::gtk_video_new()).unsafe_cast() }
    }
// ...
}
```

--------------------------------

### Convert Page Setup to GVariant

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup.rs.html

Serializes the page setup configuration into a GLib Variant.

```rust
unsafe { from_glib_none(ffi::gtk_page_setup_to_gvariant(self.to_glib_none().0)) }
```

--------------------------------

### GTK4 PrintSetup Get Page Setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_setup.rs.html

Retrieves the PageSetup associated with the PrintSetup. This method is part of the auto-generated bindings for GTK4.

```rust
20    #[doc(alias = "gtk_print_setup_get_page_setup")]
21    #[doc(alias = "get_page_setup")]
22    pub fn page_setup(&self) -> PageSetup {
23        unsafe { from_glib_none(ffi::gtk_print_setup_get_page_setup(self.to_glib_none().0)) }
24    }

```

--------------------------------

### setup_future

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/print_dialog.rs.html

Returns a `gio::GioFuture` that resolves with the result of the print setup operation. This provides a more idiomatic way to handle asynchronous operations in Rust.

```APIDOC
## setup_future

### Description
Returns a `gio::GioFuture` for the asynchronous print setup operation.

### Method
`setup_future`

### Parameters
* `parent` (*Option<&(impl IsA<Window> + Clone + 'static)>*) - The parent window for the dialog.
```

--------------------------------

### Get PageSetupUnixDialog Page Setup

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/page_setup_unix_dialog.rs.html

Retrieves the current PageSetup configuration from the dialog. The returned PageSetup object is owned by the caller.

```rust
impl PageSetupUnixDialog {
    // ... other methods
    #[doc(alias = "gtk_page_setup_unix_dialog_get_page_setup")]
    #[doc(alias = "get_page_setup")]
    pub fn page_setup(&self) -> PageSetup {
        unsafe {
            from_glib_none(ffi::gtk_page_setup_unix_dialog_get_page_setup(
                self.to_glib_none().0,
            ))
        }
    }
// ... other methods
```

--------------------------------

### Get initial folder of FileDialog

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/file_dialog.rs.html

Retrieves the initial folder that is displayed when the file dialog is opened. This sets the starting directory for the user.

```rust
unsafe {
    from_glib_none(
        ffi::gtk_file_dialog_get_initial_folder(
            self.to_glib_none().0,
        )
    )
}
```

--------------------------------

### Creating a new GTK4 Builder instance

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/builder.rs.html

Demonstrates how to create a new instance of a GTK4 Builder.

```rust
impl Builder {
    fn new() -> Self {
        Self::new()
    }
}
```

--------------------------------

### PrintOperation begin_print Callback

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/subclass/print_operation.rs.html

Handles the beginning of the print operation. This callback is invoked when the print operation starts and can be used for initial setup.

```rust
unsafe extern "C" fn print_operation_begin_print<T: PrintOperationImpl>(
    ptr: *mut ffi::GtkPrintOperation,
    contextptr: *mut ffi::GtkPrintContext,
) {
    let instance = &*(ptr as *mut T::Instance);
    let imp = instance.imp();
    let context: Borrowed<PrintContext> = from_glib_borrow(contextptr);

    imp.begin_print(&context)
}
```

--------------------------------

### Create a new GtkFileLauncher

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/file_launcher.rs.html

Instantiates a new GtkFileLauncher for a given gio::File. Ensure the main thread is initialized before calling this.

```rust
use crate::{ffi, Window};
use glib::{prelude::*, signal::{connect_raw, SignalHandlerId}, translate::*};
use std::{boxed::Box as Box_, pin::Pin};

glib::wrapper! {
    #[doc(alias = "GtkFileLauncher")]
    pub struct FileLauncher(Object<ffi::GtkFileLauncher, ffi::GtkFileLauncherClass>);

    match fn {
        type_ => || ffi::gtk_file_launcher_get_type(),
    }
}

impl FileLauncher {
    #[doc(alias = "gtk_file_launcher_new")]
    pub fn new(file: Option<&impl IsA<gio::File>>) -> FileLauncher {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(ffi::gtk_file_launcher_new(
                file.map(|p| p.as_ref()).to_glib_none().0,
            ))
        }
    }

```

--------------------------------

### Create a new GtkConstraintGuide

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/constraint_guide.rs.html

Instantiates a new GtkConstraintGuide object. This function requires the GTK+ main thread to be initialized.

```rust
assert_initialized_main_thread!();
unsafe { from_glib_full(ffi::gtk_constraint_guide_new()) }
```

--------------------------------

### Get Default Page Size

Source: https://docs.rs/gtk4/0.10.0/src/gtk4/auto/printer.rs.html

Retrieves the default page setup for the printer. This method is a binding to `gtk_printer_get_default_page_size` and returns a `PageSetup` object.

```rust
impl Printer {
    #[doc(alias = "gtk_printer_get_default_page_size")]
    #[doc(alias = "get_default_page_size")]
    pub fn default_page_size(&self) -> PageSetup {
        unsafe {
            from_glib_full(ffi::gtk_printer_get_default_page_size(
                self.to_glib_none().0,
            ))
        }
    }
}
```
Tokens:
Raw