// 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 crate::Object;
use glib::object::Cast;
use glib::object::IsA;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use std::boxed::Box as Box_;
use std::fmt;
use std::mem::transmute;

glib::wrapper! {
    /// [`Selection`][crate::Selection] should be implemented by UI components with children
    /// which are exposed by `atk_object_ref_child` and
    /// `atk_object_get_n_children`, if the use of the parent UI component
    /// ordinarily involves selection of one or more of the objects
    /// corresponding to those [`Object`][crate::Object] children - for example,
    /// selectable lists.
    ///
    /// Note that other types of "selection" (for instance text selection)
    /// are accomplished a other ATK interfaces - [`Selection`][crate::Selection] is limited
    /// to the selection/deselection of children.
    ///
    /// # Implements
    ///
    /// [`SelectionExt`][trait@crate::prelude::SelectionExt]
    #[doc(alias = "AtkSelection")]
    pub struct Selection(Interface<ffi::AtkSelection, ffi::AtkSelectionIface>);

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

pub const NONE_SELECTION: Option<&Selection> = None;

/// Trait containing all [`struct@Selection`] methods.
///
/// # Implementors
///
/// [`NoOpObject`][struct@crate::NoOpObject], [`Selection`][struct@crate::Selection]
pub trait SelectionExt: 'static {
    /// Adds the specified accessible child of the object to the
    /// object's selection.
    /// ## `i`
    /// a `gint` specifying the child index.
    ///
    /// # Returns
    ///
    /// TRUE if success, FALSE otherwise.
    #[doc(alias = "atk_selection_add_selection")]
    fn add_selection(&self, i: i32) -> bool;

    /// Clears the selection in the object so that no children in the object
    /// are selected.
    ///
    /// # Returns
    ///
    /// TRUE if success, FALSE otherwise.
    #[doc(alias = "atk_selection_clear_selection")]
    fn clear_selection(&self) -> bool;

    /// Gets the number of accessible children currently selected.
    /// Note: callers should not rely on [`None`] or on a zero value for
    /// indication of whether AtkSelectionIface is implemented, they should
    /// use type checking/interface checking macros or the
    /// `atk_get_accessible_value()` convenience method.
    ///
    /// # Returns
    ///
    /// a gint representing the number of items selected, or 0
    /// if `self` does not implement this interface.
    #[doc(alias = "atk_selection_get_selection_count")]
    #[doc(alias = "get_selection_count")]
    fn selection_count(&self) -> i32;

    /// Determines if the current child of this object is selected
    /// Note: callers should not rely on [`None`] or on a zero value for
    /// indication of whether AtkSelectionIface is implemented, they should
    /// use type checking/interface checking macros or the
    /// `atk_get_accessible_value()` convenience method.
    /// ## `i`
    /// a `gint` specifying the child index.
    ///
    /// # Returns
    ///
    /// a gboolean representing the specified child is selected, or 0
    /// if `self` does not implement this interface.
    #[doc(alias = "atk_selection_is_child_selected")]
    fn is_child_selected(&self, i: i32) -> bool;

    /// Gets a reference to the accessible object representing the specified
    /// selected child of the object.
    /// Note: callers should not rely on [`None`] or on a zero value for
    /// indication of whether AtkSelectionIface is implemented, they should
    /// use type checking/interface checking macros or the
    /// `atk_get_accessible_value()` convenience method.
    /// ## `i`
    /// a `gint` specifying the index in the selection set. (e.g. the
    /// ith selection as opposed to the ith child).
    ///
    /// # Returns
    ///
    /// an [`Object`][crate::Object] representing the
    /// selected accessible, or [`None`] if `self` does not implement this
    /// interface.
    #[doc(alias = "atk_selection_ref_selection")]
    fn ref_selection(&self, i: i32) -> Option<Object>;

    /// Removes the specified child of the object from the object's selection.
    /// ## `i`
    /// a `gint` specifying the index in the selection set. (e.g. the
    /// ith selection as opposed to the ith child).
    ///
    /// # Returns
    ///
    /// TRUE if success, FALSE otherwise.
    #[doc(alias = "atk_selection_remove_selection")]
    fn remove_selection(&self, i: i32) -> bool;

    /// Causes every child of the object to be selected if the object
    /// supports multiple selections.
    ///
    /// # Returns
    ///
    /// TRUE if success, FALSE otherwise.
    #[doc(alias = "atk_selection_select_all_selection")]
    fn select_all_selection(&self) -> bool;

    /// The "selection-changed" signal is emitted by an object which
    /// implements AtkSelection interface when the selection changes.
    #[doc(alias = "selection-changed")]
    fn connect_selection_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;
}

impl<O: IsA<Selection>> SelectionExt for O {
    fn add_selection(&self, i: i32) -> bool {
        unsafe {
            from_glib(ffi::atk_selection_add_selection(
                self.as_ref().to_glib_none().0,
                i,
            ))
        }
    }

    fn clear_selection(&self) -> bool {
        unsafe {
            from_glib(ffi::atk_selection_clear_selection(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn selection_count(&self) -> i32 {
        unsafe { ffi::atk_selection_get_selection_count(self.as_ref().to_glib_none().0) }
    }

    fn is_child_selected(&self, i: i32) -> bool {
        unsafe {
            from_glib(ffi::atk_selection_is_child_selected(
                self.as_ref().to_glib_none().0,
                i,
            ))
        }
    }

    fn ref_selection(&self, i: i32) -> Option<Object> {
        unsafe {
            from_glib_full(ffi::atk_selection_ref_selection(
                self.as_ref().to_glib_none().0,
                i,
            ))
        }
    }

    fn remove_selection(&self, i: i32) -> bool {
        unsafe {
            from_glib(ffi::atk_selection_remove_selection(
                self.as_ref().to_glib_none().0,
                i,
            ))
        }
    }

    fn select_all_selection(&self) -> bool {
        unsafe {
            from_glib(ffi::atk_selection_select_all_selection(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn connect_selection_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn selection_changed_trampoline<
            P: IsA<Selection>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::AtkSelection,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Selection::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"selection-changed\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    selection_changed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl fmt::Display for Selection {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str("Selection")
    }
}