// This file was generated by gir (https://github.com/gtk-rs/gir)
// from
// from gir-files (https://github.com/gtk-rs/gir-files.git)
// DO NOT EDIT

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

glib::wrapper! {
    /// A layout manager constraining its children to a given size.
    ///
    /// <picture>
    ///   <source srcset="latch-wide-dark.png" media="(prefers-color-scheme: dark)">
    ///   <img src="latch-wide.png" alt="latch-wide">
    /// </picture>
    /// <picture>
    ///   <source srcset="latch-narrow-dark.png" media="(prefers-color-scheme: dark)">
    ///   <img src="latch-narrow.png" alt="latch-narrow">
    /// </picture>
    ///
    /// `BisLatchLayout` constraints the size of the widgets it contains to a given
    /// maximum size. It will constrain the width if it is horizontal, or the height
    /// if it is vertical. The expansion of the children from their minimum to their
    /// maximum size is eased out for a smooth transition.
    ///
    /// If a child requires more than the requested maximum size, it will be
    /// allocated the minimum size it can fit in instead.
    ///
    /// Each child will get the style  classes .large when it reached its maximum
    /// size, .small when it's allocated the full size, .medium in-between, or none
    /// if it hasn't been allocated yet.
    ///
    /// ## Properties
    ///
    ///
    /// #### `maximum-size`
    ///  The maximum size to allocate to the children.
    ///
    /// It is the width if the layout is horizontal, or the height if it is
    /// vertical.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tightening-threshold`
    ///  The size above which the children are latched.
    ///
    /// Starting from this size, the layout will tighten its grip on the children,
    /// slowly allocating less and less of the available size up to the maximum
    /// allocated size. Below that threshold and below the maximum size, the
    /// children will be allocated all the available size.
    ///
    /// If the threshold is greater than the maximum size to allocate to the
    /// children, they will be allocated the whole size up to the maximum. If the
    /// threshold is lower than the minimum size to allocate to the children, that
    /// size will be used as the tightening threshold.
    ///
    /// Effectively, tightening the grip on a child before it reaches its maximum
    /// size makes transitions to and from the maximum size smoother when resizing.
    ///
    /// Readable | Writeable
    /// <details><summary><h4>Orientable</h4></summary>
    ///
    ///
    /// #### `orientation`
    ///  The orientation of the orientable.
    ///
    /// Readable | Writeable
    /// </details>
    ///
    /// # Implements
    ///
    /// [`trait@gtk::prelude::LayoutManagerExt`], [`trait@glib::ObjectExt`], [`trait@gtk::prelude::OrientableExt`]
    #[doc(alias = "BisLatchLayout")]
    pub struct LatchLayout(Object<ffi::BisLatchLayout, ffi::BisLatchLayoutClass>) @extends gtk::LayoutManager, @implements gtk::Orientable;

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

impl LatchLayout {
    /// Creates a new `BisLatchLayout`.
    ///
    /// # Returns
    ///
    /// the newly created `BisLatchLayout`
    #[doc(alias = "bis_latch_layout_new")]
    pub fn new() -> LatchLayout {
        assert_initialized_main_thread!();
        unsafe { gtk::LayoutManager::from_glib_full(ffi::bis_latch_layout_new()).unsafe_cast() }
    }

    // rustdoc-stripper-ignore-next
    /// Creates a new builder-pattern struct instance to construct [`LatchLayout`] objects.
    ///
    /// This method returns an instance of [`LatchLayoutBuilder`](crate::builders::LatchLayoutBuilder) which can be used to create [`LatchLayout`] objects.
    pub fn builder() -> LatchLayoutBuilder {
        LatchLayoutBuilder::new()
    }

    /// Gets the maximum size allocated to the children.
    ///
    /// # Returns
    ///
    /// the maximum size to allocate to the children
    #[doc(alias = "bis_latch_layout_get_maximum_size")]
    #[doc(alias = "get_maximum_size")]
    #[doc(alias = "maximum-size")]
    pub fn maximum_size(&self) -> i32 {
        unsafe { ffi::bis_latch_layout_get_maximum_size(self.to_glib_none().0) }
    }

    /// Gets the size above which the children are latched.
    ///
    /// # Returns
    ///
    /// the size above which the children are latched
    #[doc(alias = "bis_latch_layout_get_tightening_threshold")]
    #[doc(alias = "get_tightening_threshold")]
    #[doc(alias = "tightening-threshold")]
    pub fn tightening_threshold(&self) -> i32 {
        unsafe { ffi::bis_latch_layout_get_tightening_threshold(self.to_glib_none().0) }
    }

    /// Sets the maximum size allocated to the children.
    ///
    /// It is the width if the layout is horizontal, or the height if it is vertical.
    /// ## `maximum_size`
    /// the maximum size
    #[doc(alias = "bis_latch_layout_set_maximum_size")]
    #[doc(alias = "maximum-size")]
    pub fn set_maximum_size(&self, maximum_size: i32) {
        unsafe {
            ffi::bis_latch_layout_set_maximum_size(self.to_glib_none().0, maximum_size);
        }
    }

    /// Sets the size above which the children are latched.
    ///
    /// Starting from this size, the layout will tighten its grip on the children,
    /// slowly allocating less and less of the available size up to the maximum
    /// allocated size. Below that threshold and below the maximum size, the children
    /// will be allocated all the available size.
    ///
    /// If the threshold is greater than the maximum size to allocate to the
    /// children, they will be allocated the whole size up to the maximum. If the
    /// threshold is lower than the minimum size to allocate to the children, that
    /// size will be used as the tightening threshold.
    ///
    /// Effectively, tightening the grip on a child before it reaches its maximum
    /// size makes transitions to and from the maximum size smoother when resizing.
    /// ## `tightening_threshold`
    /// the tightening threshold
    #[doc(alias = "bis_latch_layout_set_tightening_threshold")]
    #[doc(alias = "tightening-threshold")]
    pub fn set_tightening_threshold(&self, tightening_threshold: i32) {
        unsafe {
            ffi::bis_latch_layout_set_tightening_threshold(
                self.to_glib_none().0,
                tightening_threshold,
            );
        }
    }

    #[doc(alias = "maximum-size")]
    pub fn connect_maximum_size_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_maximum_size_trampoline<F: Fn(&LatchLayout) + 'static>(
            this: *mut ffi::BisLatchLayout,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::maximum-size\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_maximum_size_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "tightening-threshold")]
    pub fn connect_tightening_threshold_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_tightening_threshold_trampoline<
            F: Fn(&LatchLayout) + 'static,
        >(
            this: *mut ffi::BisLatchLayout,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::tightening-threshold\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_tightening_threshold_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl Default for LatchLayout {
    fn default() -> Self {
        Self::new()
    }
}

// rustdoc-stripper-ignore-next
/// A [builder-pattern] type to construct [`LatchLayout`] objects.
///
/// [builder-pattern]: https://doc.rust-lang.org/1.0.0/style/ownership/builders.html
#[must_use = "The builder must be built to be used"]
pub struct LatchLayoutBuilder {
    builder: glib::object::ObjectBuilder<'static, LatchLayout>,
}

impl LatchLayoutBuilder {
    fn new() -> Self {
        Self {
            builder: glib::object::Object::builder(),
        }
    }

    /// The maximum size to allocate to the children.
    ///
    /// It is the width if the layout is horizontal, or the height if it is
    /// vertical.
    pub fn maximum_size(self, maximum_size: i32) -> Self {
        Self {
            builder: self.builder.property("maximum-size", maximum_size),
        }
    }

    /// The size above which the children are latched.
    ///
    /// Starting from this size, the layout will tighten its grip on the children,
    /// slowly allocating less and less of the available size up to the maximum
    /// allocated size. Below that threshold and below the maximum size, the
    /// children will be allocated all the available size.
    ///
    /// If the threshold is greater than the maximum size to allocate to the
    /// children, they will be allocated the whole size up to the maximum. If the
    /// threshold is lower than the minimum size to allocate to the children, that
    /// size will be used as the tightening threshold.
    ///
    /// Effectively, tightening the grip on a child before it reaches its maximum
    /// size makes transitions to and from the maximum size smoother when resizing.
    pub fn tightening_threshold(self, tightening_threshold: i32) -> Self {
        Self {
            builder: self
                .builder
                .property("tightening-threshold", tightening_threshold),
        }
    }

    //pub fn orientation(self, orientation: /*Ignored*/gtk::Orientation) -> Self {
    //    Self { builder: self.builder.property("orientation", orientation), }
    //}

    // rustdoc-stripper-ignore-next
    /// Build the [`LatchLayout`].
    #[must_use = "Building the object from the builder is usually expensive and is not expected to have side effects"]
    pub fn build(self) -> LatchLayout {
        self.builder.build()
    }
}