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

use crate::CompletionProposal;
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, fmt, mem::transmute};

glib::wrapper! {
    ///
    ///
    /// ## Properties
    ///
    ///
    /// #### `gicon`
    ///  The [`gio::Icon`][crate::gio::Icon] for the icon to be shown for this proposal.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `icon`
    ///  The [`gdk_pixbuf::Pixbuf`][crate::gdk_pixbuf::Pixbuf] for the icon to be shown for this proposal.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `icon-name`
    ///  The icon name for the icon to be shown for this proposal.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `info`
    ///  Optional extra information to be shown for this proposal.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `label`
    ///  Label to be shown for this proposal.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `markup`
    ///  Label with markup to be shown for this proposal.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `text`
    ///  Proposal text.
    ///
    /// Readable | Writeable
    ///
    /// # Implements
    ///
    /// [`CompletionItemExt`][trait@crate::prelude::CompletionItemExt], [`CompletionProposalExt`][trait@crate::prelude::CompletionProposalExt]
    #[doc(alias = "GtkSourceCompletionItem")]
    pub struct CompletionItem(Object<ffi::GtkSourceCompletionItem, ffi::GtkSourceCompletionItemClass>) @implements CompletionProposal;

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

impl CompletionItem {
    pub const NONE: Option<&'static CompletionItem> = None;

    /// Creates a new [`CompletionItem`][crate::CompletionItem]. The desired properties need to be set
    /// afterwards.
    ///
    /// # Returns
    ///
    /// a new [`CompletionItem`][crate::CompletionItem].
    #[doc(alias = "gtk_source_completion_item_new")]
    pub fn new() -> CompletionItem {
        assert_initialized_main_thread!();
        unsafe { from_glib_full(ffi::gtk_source_completion_item_new()) }
    }

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

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

// rustdoc-stripper-ignore-next
/// A [builder-pattern] type to construct [`CompletionItem`] 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 CompletionItemBuilder {
    builder: glib::object::ObjectBuilder<'static, CompletionItem>,
}

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

    /// The [`gio::Icon`][crate::gio::Icon] for the icon to be shown for this proposal.
    pub fn gicon(self, gicon: &impl IsA<gio::Icon>) -> Self {
        Self {
            builder: self.builder.property("gicon", gicon.clone().upcast()),
        }
    }

    /// The [`gdk_pixbuf::Pixbuf`][crate::gdk_pixbuf::Pixbuf] for the icon to be shown for this proposal.
    pub fn icon(self, icon: &gdk_pixbuf::Pixbuf) -> Self {
        Self {
            builder: self.builder.property("icon", icon.clone()),
        }
    }

    /// The icon name for the icon to be shown for this proposal.
    pub fn icon_name(self, icon_name: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("icon-name", icon_name.into()),
        }
    }

    /// Optional extra information to be shown for this proposal.
    pub fn info(self, info: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("info", info.into()),
        }
    }

    /// Label to be shown for this proposal.
    pub fn label(self, label: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("label", label.into()),
        }
    }

    /// Label with markup to be shown for this proposal.
    pub fn markup(self, markup: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("markup", markup.into()),
        }
    }

    /// Proposal text.
    pub fn text(self, text: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("text", text.into()),
        }
    }

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

mod sealed {
    pub trait Sealed {}
    impl<T: super::IsA<super::CompletionItem>> Sealed for T {}
}

/// Trait containing all [`struct@CompletionItem`] methods.
///
/// # Implementors
///
/// [`CompletionItem`][struct@crate::CompletionItem]
pub trait CompletionItemExt: IsA<CompletionItem> + sealed::Sealed + 'static {
    /// ## `gicon`
    /// the [`gio::Icon`][crate::gio::Icon], or [`None`].
    #[doc(alias = "gtk_source_completion_item_set_gicon")]
    fn set_gicon(&self, gicon: Option<&impl IsA<gio::Icon>>) {
        unsafe {
            ffi::gtk_source_completion_item_set_gicon(
                self.as_ref().to_glib_none().0,
                gicon.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// ## `icon`
    /// the [`gdk_pixbuf::Pixbuf`][crate::gdk_pixbuf::Pixbuf], or [`None`].
    #[doc(alias = "gtk_source_completion_item_set_icon")]
    fn set_icon(&self, icon: Option<&gdk_pixbuf::Pixbuf>) {
        unsafe {
            ffi::gtk_source_completion_item_set_icon(
                self.as_ref().to_glib_none().0,
                icon.to_glib_none().0,
            );
        }
    }

    /// ## `icon_name`
    /// the icon name, or [`None`].
    #[doc(alias = "gtk_source_completion_item_set_icon_name")]
    fn set_icon_name(&self, icon_name: Option<&str>) {
        unsafe {
            ffi::gtk_source_completion_item_set_icon_name(
                self.as_ref().to_glib_none().0,
                icon_name.to_glib_none().0,
            );
        }
    }

    /// ## `info`
    /// the info, or [`None`].
    #[doc(alias = "gtk_source_completion_item_set_info")]
    fn set_info(&self, info: Option<&str>) {
        unsafe {
            ffi::gtk_source_completion_item_set_info(
                self.as_ref().to_glib_none().0,
                info.to_glib_none().0,
            );
        }
    }

    /// ## `label`
    /// the label, or [`None`].
    #[doc(alias = "gtk_source_completion_item_set_label")]
    fn set_label(&self, label: Option<&str>) {
        unsafe {
            ffi::gtk_source_completion_item_set_label(
                self.as_ref().to_glib_none().0,
                label.to_glib_none().0,
            );
        }
    }

    /// ## `markup`
    /// the markup, or [`None`].
    #[doc(alias = "gtk_source_completion_item_set_markup")]
    fn set_markup(&self, markup: Option<&str>) {
        unsafe {
            ffi::gtk_source_completion_item_set_markup(
                self.as_ref().to_glib_none().0,
                markup.to_glib_none().0,
            );
        }
    }

    /// ## `text`
    /// the text, or [`None`].
    #[doc(alias = "gtk_source_completion_item_set_text")]
    fn set_text(&self, text: Option<&str>) {
        unsafe {
            ffi::gtk_source_completion_item_set_text(
                self.as_ref().to_glib_none().0,
                text.to_glib_none().0,
            );
        }
    }

    #[doc(alias = "gicon")]
    fn connect_gicon_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_gicon_trampoline<
            P: IsA<CompletionItem>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GtkSourceCompletionItem,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(CompletionItem::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::gicon\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_gicon_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "icon")]
    fn connect_icon_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_icon_trampoline<P: IsA<CompletionItem>, F: Fn(&P) + 'static>(
            this: *mut ffi::GtkSourceCompletionItem,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(CompletionItem::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::icon\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_icon_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "icon-name")]
    fn connect_icon_name_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_icon_name_trampoline<
            P: IsA<CompletionItem>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GtkSourceCompletionItem,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(CompletionItem::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::icon-name\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_icon_name_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "info")]
    fn connect_info_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_info_trampoline<P: IsA<CompletionItem>, F: Fn(&P) + 'static>(
            this: *mut ffi::GtkSourceCompletionItem,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(CompletionItem::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::info\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_info_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "label")]
    fn connect_label_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_label_trampoline<
            P: IsA<CompletionItem>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GtkSourceCompletionItem,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(CompletionItem::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::label\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_label_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "markup")]
    fn connect_markup_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_markup_trampoline<
            P: IsA<CompletionItem>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GtkSourceCompletionItem,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(CompletionItem::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::markup\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_markup_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "text")]
    fn connect_text_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_text_trampoline<P: IsA<CompletionItem>, F: Fn(&P) + 'static>(
            this: *mut ffi::GtkSourceCompletionItem,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(CompletionItem::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::text\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_text_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<CompletionItem>> CompletionItemExt for O {}

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