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

use glib;
use glib::translate::*;
use glib::GString;
use gtk_sys;
use std::ptr;
use Unit;

glib_wrapper! {
    /// `PaperSize` handles paper sizes. It uses the standard called
    /// [PWG 5101.1-2002 PWG: Standard for Media Standardized Names](http://www.pwg.org/standards.html)
    /// to name the paper sizes (and to get the data for the page sizes).
    /// In addition to standard paper sizes, `PaperSize` allows to
    /// construct custom paper sizes with arbitrary dimensions.
    ///
    /// The `PaperSize` object stores not only the dimensions (width
    /// and height) of a paper size and its name, it also provides
    /// default [print margins][print-margins].
    ///
    /// Printing support has been added in GTK+ 2.10.
    #[derive(Debug, PartialOrd, Ord, Hash)]
    pub struct PaperSize(Boxed<gtk_sys::GtkPaperSize>);

    match fn {
        copy => |ptr| gtk_sys::gtk_paper_size_copy(mut_override(ptr)),
        free => |ptr| gtk_sys::gtk_paper_size_free(ptr),
        get_type => || gtk_sys::gtk_paper_size_get_type(),
    }
}

impl PaperSize {
    /// Creates a new `PaperSize` object by parsing a
    /// [PWG 5101.1-2002](ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf)
    /// paper name.
    ///
    /// If `name` is `None`, the default paper size is returned,
    /// see `PaperSize::get_default`.
    /// ## `name`
    /// a paper size name, or `None`
    ///
    /// # Returns
    ///
    /// a new `PaperSize`, use `PaperSize::free`
    /// to free it
    pub fn new(name: Option<&str>) -> PaperSize {
        assert_initialized_main_thread!();
        unsafe { from_glib_full(gtk_sys::gtk_paper_size_new(name.to_glib_none().0)) }
    }

    /// Creates a new `PaperSize` object with the
    /// given parameters.
    /// ## `name`
    /// the paper name
    /// ## `display_name`
    /// the human-readable name
    /// ## `width`
    /// the paper width, in units of `unit`
    /// ## `height`
    /// the paper height, in units of `unit`
    /// ## `unit`
    /// the unit for `width` and `height`. not `Unit::None`.
    ///
    /// # Returns
    ///
    /// a new `PaperSize` object, use `PaperSize::free`
    /// to free it
    pub fn new_custom(
        name: &str,
        display_name: &str,
        width: f64,
        height: f64,
        unit: Unit,
    ) -> PaperSize {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(gtk_sys::gtk_paper_size_new_custom(
                name.to_glib_none().0,
                display_name.to_glib_none().0,
                width,
                height,
                unit.to_glib(),
            ))
        }
    }

    #[cfg(any(feature = "v3_22", feature = "dox"))]
    pub fn from_gvariant(variant: &glib::Variant) -> PaperSize {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(gtk_sys::gtk_paper_size_new_from_gvariant(
                variant.to_glib_none().0,
            ))
        }
    }

    #[cfg(any(feature = "v3_16", feature = "dox"))]
    pub fn from_ipp(ipp_name: &str, width: f64, height: f64) -> PaperSize {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(gtk_sys::gtk_paper_size_new_from_ipp(
                ipp_name.to_glib_none().0,
                width,
                height,
            ))
        }
    }

    pub fn from_key_file(
        key_file: &glib::KeyFile,
        group_name: Option<&str>,
    ) -> Result<PaperSize, glib::Error> {
        assert_initialized_main_thread!();
        unsafe {
            let mut error = ptr::null_mut();
            let ret = gtk_sys::gtk_paper_size_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))
            }
        }
    }

    pub fn from_ppd(ppd_name: &str, ppd_display_name: &str, width: f64, height: f64) -> PaperSize {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(gtk_sys::gtk_paper_size_new_from_ppd(
                ppd_name.to_glib_none().0,
                ppd_display_name.to_glib_none().0,
                width,
                height,
            ))
        }
    }

    /// Gets the default bottom margin for the `PaperSize`.
    /// ## `unit`
    /// the unit for the return value, not `Unit::None`
    ///
    /// # Returns
    ///
    /// the default bottom margin
    pub fn get_default_bottom_margin(&self, unit: Unit) -> f64 {
        unsafe {
            gtk_sys::gtk_paper_size_get_default_bottom_margin(
                mut_override(self.to_glib_none().0),
                unit.to_glib(),
            )
        }
    }

    /// Gets the default left margin for the `PaperSize`.
    /// ## `unit`
    /// the unit for the return value, not `Unit::None`
    ///
    /// # Returns
    ///
    /// the default left margin
    pub fn get_default_left_margin(&self, unit: Unit) -> f64 {
        unsafe {
            gtk_sys::gtk_paper_size_get_default_left_margin(
                mut_override(self.to_glib_none().0),
                unit.to_glib(),
            )
        }
    }

    /// Gets the default right margin for the `PaperSize`.
    /// ## `unit`
    /// the unit for the return value, not `Unit::None`
    ///
    /// # Returns
    ///
    /// the default right margin
    pub fn get_default_right_margin(&self, unit: Unit) -> f64 {
        unsafe {
            gtk_sys::gtk_paper_size_get_default_right_margin(
                mut_override(self.to_glib_none().0),
                unit.to_glib(),
            )
        }
    }

    /// Gets the default top margin for the `PaperSize`.
    /// ## `unit`
    /// the unit for the return value, not `Unit::None`
    ///
    /// # Returns
    ///
    /// the default top margin
    pub fn get_default_top_margin(&self, unit: Unit) -> f64 {
        unsafe {
            gtk_sys::gtk_paper_size_get_default_top_margin(
                mut_override(self.to_glib_none().0),
                unit.to_glib(),
            )
        }
    }

    /// Gets the human-readable name of the `PaperSize`.
    ///
    /// # Returns
    ///
    /// the human-readable name of `self`
    pub fn get_display_name(&self) -> Option<GString> {
        unsafe {
            from_glib_none(gtk_sys::gtk_paper_size_get_display_name(mut_override(
                self.to_glib_none().0,
            )))
        }
    }

    /// Gets the paper height of the `PaperSize`, in
    /// units of `unit`.
    /// ## `unit`
    /// the unit for the return value, not `Unit::None`
    ///
    /// # Returns
    ///
    /// the paper height
    pub fn get_height(&self, unit: Unit) -> f64 {
        unsafe {
            gtk_sys::gtk_paper_size_get_height(mut_override(self.to_glib_none().0), unit.to_glib())
        }
    }

    /// Gets the name of the `PaperSize`.
    ///
    /// # Returns
    ///
    /// the name of `self`
    pub fn get_name(&self) -> Option<GString> {
        unsafe {
            from_glib_none(gtk_sys::gtk_paper_size_get_name(mut_override(
                self.to_glib_none().0,
            )))
        }
    }

    /// Gets the PPD name of the `PaperSize`, which
    /// may be `None`.
    ///
    /// # Returns
    ///
    /// the PPD name of `self`
    pub fn get_ppd_name(&self) -> Option<GString> {
        unsafe {
            from_glib_none(gtk_sys::gtk_paper_size_get_ppd_name(mut_override(
                self.to_glib_none().0,
            )))
        }
    }

    /// Gets the paper width of the `PaperSize`, in
    /// units of `unit`.
    /// ## `unit`
    /// the unit for the return value, not `Unit::None`
    ///
    /// # Returns
    ///
    /// the paper width
    pub fn get_width(&self, unit: Unit) -> f64 {
        unsafe {
            gtk_sys::gtk_paper_size_get_width(mut_override(self.to_glib_none().0), unit.to_glib())
        }
    }

    /// Returns `true` if `self` is not a standard paper size.
    ///
    /// # Returns
    ///
    /// whether `self` is a custom paper size.
    pub fn is_custom(&self) -> bool {
        unsafe {
            from_glib(gtk_sys::gtk_paper_size_is_custom(mut_override(
                self.to_glib_none().0,
            )))
        }
    }

    /// Compares two `PaperSize` objects.
    /// ## `size2`
    /// another `PaperSize` object
    ///
    /// # Returns
    ///
    /// `true`, if `self` and `size2`
    /// represent the same paper size
    fn is_equal(&self, size2: &PaperSize) -> bool {
        unsafe {
            from_glib(gtk_sys::gtk_paper_size_is_equal(
                mut_override(self.to_glib_none().0),
                mut_override(size2.to_glib_none().0),
            ))
        }
    }

    /// Returns `true` if `self` is an IPP standard paper size.
    ///
    /// # Returns
    ///
    /// whether `self` is not an IPP custom paper size.
    #[cfg(any(feature = "v3_16", feature = "dox"))]
    pub fn is_ipp(&self) -> bool {
        unsafe {
            from_glib(gtk_sys::gtk_paper_size_is_ipp(mut_override(
                self.to_glib_none().0,
            )))
        }
    }

    /// Changes the dimensions of a `self` to `width` x `height`.
    /// ## `width`
    /// the new width in units of `unit`
    /// ## `height`
    /// the new height in units of `unit`
    /// ## `unit`
    /// the unit for `width` and `height`
    pub fn set_size(&mut self, width: f64, height: f64, unit: Unit) {
        unsafe {
            gtk_sys::gtk_paper_size_set_size(
                self.to_glib_none_mut().0,
                width,
                height,
                unit.to_glib(),
            );
        }
    }

    /// Serialize a paper size to an a{sv} variant.
    ///
    /// Feature: `v3_22`
    ///
    ///
    /// # Returns
    ///
    /// a new, floating, `glib::Variant`
    #[cfg(any(feature = "v3_22", feature = "dox"))]
    pub fn to_gvariant(&mut self) -> Option<glib::Variant> {
        unsafe {
            from_glib_none(gtk_sys::gtk_paper_size_to_gvariant(
                self.to_glib_none_mut().0,
            ))
        }
    }

    /// This function adds the paper size from `self` to `key_file`.
    /// ## `key_file`
    /// the `glib::KeyFile` to save the paper size to
    /// ## `group_name`
    /// the group to add the settings to in `key_file`
    pub fn to_key_file(&mut self, key_file: &glib::KeyFile, group_name: &str) {
        unsafe {
            gtk_sys::gtk_paper_size_to_key_file(
                self.to_glib_none_mut().0,
                key_file.to_glib_none().0,
                group_name.to_glib_none().0,
            );
        }
    }

    /// Returns the name of the default paper size, which
    /// depends on the current locale.
    ///
    /// # Returns
    ///
    /// the name of the default paper size. The string
    /// is owned by GTK+ and should not be modified.
    pub fn get_default() -> Option<GString> {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(gtk_sys::gtk_paper_size_get_default()) }
    }

    /// Creates a list of known paper sizes.
    /// ## `include_custom`
    /// whether to include custom paper sizes
    ///  as defined in the page setup dialog
    ///
    /// # Returns
    ///
    /// a newly allocated list of newly
    ///  allocated `PaperSize` objects
    pub fn get_paper_sizes(include_custom: bool) -> Vec<PaperSize> {
        assert_initialized_main_thread!();
        unsafe {
            FromGlibPtrContainer::from_glib_full(gtk_sys::gtk_paper_size_get_paper_sizes(
                include_custom.to_glib(),
            ))
        }
    }
}

impl PartialEq for PaperSize {
    #[inline]
    fn eq(&self, other: &Self) -> bool {
        self.is_equal(other)
    }
}

impl Eq for PaperSize {}