// 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::Widget;
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, fmt, mem::transmute};

glib::wrapper! {
    /// [`ListItem`][crate::ListItem] is used by list widgets to represent items in a `GListModel`.
    ///
    /// The [`ListItem`][crate::ListItem]s are managed by the list widget (with its factory)
    /// and cannot be created by applications, but they need to be populated
    /// by application code. This is done by calling [`set_child()`][Self::set_child()].
    ///
    /// [`ListItem`][crate::ListItem]s exist in 2 stages:
    ///
    /// 1. The unbound stage where the listitem is not currently connected to
    ///    an item in the list. In that case, the [`item`][struct@crate::ListItem#item]
    ///    property is set to [`None`].
    ///
    /// 2. The bound stage where the listitem references an item from the list.
    ///    The [`item`][struct@crate::ListItem#item] property is not [`None`].
    ///
    /// ## Properties
    ///
    ///
    /// #### `activatable`
    ///  If the item can be activated by the user.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `child`
    ///  Widget used for display.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `item`
    ///  Displayed item.
    ///
    /// Readable
    ///
    ///
    /// #### `position`
    ///  Position of the item.
    ///
    /// Readable
    ///
    ///
    /// #### `selectable`
    ///  If the item can be selected by the user.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `selected`
    ///  If the item is currently selected.
    ///
    /// Readable
    ///
    /// # Implements
    ///
    /// [`trait@glib::ObjectExt`]
    #[doc(alias = "GtkListItem")]
    pub struct ListItem(Object<ffi::GtkListItem, ffi::GtkListItemClass>);

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

impl ListItem {
    /// Checks if a list item has been set to be activatable via
    /// gtk_list_item_set_activatable().
    ///
    /// # Returns
    ///
    /// [`true`] if the item is activatable
    #[doc(alias = "gtk_list_item_get_activatable")]
    #[doc(alias = "get_activatable")]
    pub fn is_activatable(&self) -> bool {
        unsafe { from_glib(ffi::gtk_list_item_get_activatable(self.to_glib_none().0)) }
    }

    /// Gets the child previously set via gtk_list_item_set_child() or
    /// [`None`] if none was set.
    ///
    /// # Returns
    ///
    /// The child
    #[doc(alias = "gtk_list_item_get_child")]
    #[doc(alias = "get_child")]
    pub fn child(&self) -> Option<Widget> {
        unsafe { from_glib_none(ffi::gtk_list_item_get_child(self.to_glib_none().0)) }
    }

    /// Gets the model item that associated with @self.
    ///
    /// If @self is unbound, this function returns [`None`].
    ///
    /// # Returns
    ///
    /// The item displayed
    #[doc(alias = "gtk_list_item_get_item")]
    #[doc(alias = "get_item")]
    pub fn item(&self) -> Option<glib::Object> {
        unsafe { from_glib_none(ffi::gtk_list_item_get_item(self.to_glib_none().0)) }
    }

    /// Gets the position in the model that @self currently displays.
    ///
    /// If @self is unbound, `GTK_INVALID_LIST_POSITION` is returned.
    ///
    /// # Returns
    ///
    /// The position of this item
    #[doc(alias = "gtk_list_item_get_position")]
    #[doc(alias = "get_position")]
    pub fn position(&self) -> u32 {
        unsafe { ffi::gtk_list_item_get_position(self.to_glib_none().0) }
    }

    /// Checks if a list item has been set to be selectable via
    /// gtk_list_item_set_selectable().
    ///
    /// Do not confuse this function with [`is_selected()`][Self::is_selected()].
    ///
    /// # Returns
    ///
    /// [`true`] if the item is selectable
    #[doc(alias = "gtk_list_item_get_selectable")]
    #[doc(alias = "get_selectable")]
    pub fn is_selectable(&self) -> bool {
        unsafe { from_glib(ffi::gtk_list_item_get_selectable(self.to_glib_none().0)) }
    }

    /// Checks if the item is displayed as selected.
    ///
    /// The selected state is maintained by the liste widget and its model
    /// and cannot be set otherwise.
    ///
    /// # Returns
    ///
    /// [`true`] if the item is selected.
    #[doc(alias = "gtk_list_item_get_selected")]
    #[doc(alias = "get_selected")]
    pub fn is_selected(&self) -> bool {
        unsafe { from_glib(ffi::gtk_list_item_get_selected(self.to_glib_none().0)) }
    }

    /// Sets @self to be activatable.
    ///
    /// If an item is activatable, double-clicking on the item, using
    /// the Return key or calling gtk_widget_activate() will activate
    /// the item. Activating instructs the containing view to handle
    /// activation. [`ListView`][crate::ListView] for example will be emitting the
    /// [`activate`][struct@crate::ListView#activate] signal.
    ///
    /// By default, list items are activatable.
    /// ## `activatable`
    /// if the item should be activatable
    #[doc(alias = "gtk_list_item_set_activatable")]
    pub fn set_activatable(&self, activatable: bool) {
        unsafe {
            ffi::gtk_list_item_set_activatable(self.to_glib_none().0, activatable.into_glib());
        }
    }

    /// Sets the child to be used for this listitem.
    ///
    /// This function is typically called by applications when
    /// setting up a listitem so that the widget can be reused when
    /// binding it multiple times.
    /// ## `child`
    /// The list item's child or [`None`] to unset
    #[doc(alias = "gtk_list_item_set_child")]
    pub fn set_child(&self, child: Option<&impl IsA<Widget>>) {
        unsafe {
            ffi::gtk_list_item_set_child(
                self.to_glib_none().0,
                child.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// Sets @self to be selectable.
    ///
    /// If an item is selectable, clicking on the item or using the keyboard
    /// will try to select or unselect the item. If this succeeds is up to
    /// the model to determine, as it is managing the selected state.
    ///
    /// Note that this means that making an item non-selectable has no
    /// influence on the selected state at all. A non-selectable item
    /// may still be selected.
    ///
    /// By default, list items are selectable. When rebinding them to
    /// a new item, they will also be reset to be selectable by GTK.
    /// ## `selectable`
    /// if the item should be selectable
    #[doc(alias = "gtk_list_item_set_selectable")]
    pub fn set_selectable(&self, selectable: bool) {
        unsafe {
            ffi::gtk_list_item_set_selectable(self.to_glib_none().0, selectable.into_glib());
        }
    }

    #[doc(alias = "activatable")]
    pub fn connect_activatable_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_activatable_trampoline<F: Fn(&ListItem) + 'static>(
            this: *mut ffi::GtkListItem,
            _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::activatable\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_activatable_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "child")]
    pub fn connect_child_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_child_trampoline<F: Fn(&ListItem) + 'static>(
            this: *mut ffi::GtkListItem,
            _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::child\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_child_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "item")]
    pub fn connect_item_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_item_trampoline<F: Fn(&ListItem) + 'static>(
            this: *mut ffi::GtkListItem,
            _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::item\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_item_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "position")]
    pub fn connect_position_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_position_trampoline<F: Fn(&ListItem) + 'static>(
            this: *mut ffi::GtkListItem,
            _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::position\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_position_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "selectable")]
    pub fn connect_selectable_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_selectable_trampoline<F: Fn(&ListItem) + 'static>(
            this: *mut ffi::GtkListItem,
            _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::selectable\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_selectable_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "selected")]
    pub fn connect_selected_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_selected_trampoline<F: Fn(&ListItem) + 'static>(
            this: *mut ffi::GtkListItem,
            _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::selected\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_selected_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

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