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

use crate::OptionMenuItem;
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! {
    /// Represents the dropdown menu of a `select` element in a [`WebView`][crate::WebView].
    ///
    /// When a select element in a [`WebView`][crate::WebView] needs to display a dropdown menu, the signal
    /// `signal::WebView::show-option-menu` is emitted, providing a WebKitOptionMenu with the
    /// [`OptionMenuItem`][crate::OptionMenuItem]<!-- -->s that should be displayed.
    ///
    /// # Implements
    ///
    /// [`OptionMenuExt`][trait@crate::prelude::OptionMenuExt], [`trait@glib::ObjectExt`]
    #[doc(alias = "WebKitOptionMenu")]
    pub struct OptionMenu(Object<ffi::WebKitOptionMenu, ffi::WebKitOptionMenuClass>);

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

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

/// Trait containing all [`struct@OptionMenu`] methods.
///
/// # Implementors
///
/// [`OptionMenu`][struct@crate::OptionMenu]
pub trait OptionMenuExt: 'static {
    /// Activates the [`OptionMenuItem`][crate::OptionMenuItem] at `index` in `self`.
    ///
    /// Activating an item changes the value
    /// of the element making the item the active one. You are expected to close the menu with
    /// [`close()`][Self::close()] after activating an item, calling this function again will have no
    /// effect.
    /// ## `index`
    /// the index of the item
    #[doc(alias = "webkit_option_menu_activate_item")]
    fn activate_item(&self, index: u32);

    /// Request to close a [`OptionMenu`][crate::OptionMenu].
    ///
    /// This emits WebKitOptionMenu::close signal.
    /// This function should always be called to notify WebKit that the associated
    /// menu has been closed. If the menu is closed and neither [`select_item()`][Self::select_item()]
    /// nor [`activate_item()`][Self::activate_item()] have been called, the element value remains
    /// unchanged.
    #[doc(alias = "webkit_option_menu_close")]
    fn close(&self);

    /// Returns the [`OptionMenuItem`][crate::OptionMenuItem] at `index` in `self`.
    /// ## `index`
    /// the index of the item
    ///
    /// # Returns
    ///
    /// a [`OptionMenuItem`][crate::OptionMenuItem] of `self`.
    #[doc(alias = "webkit_option_menu_get_item")]
    #[doc(alias = "get_item")]
    fn item(&self, index: u32) -> Option<OptionMenuItem>;

    /// Gets the length of the `self`.
    ///
    /// # Returns
    ///
    /// the number of [`OptionMenuItem`][crate::OptionMenuItem]<!-- -->s in `self`
    #[doc(alias = "webkit_option_menu_get_n_items")]
    #[doc(alias = "get_n_items")]
    fn n_items(&self) -> u32;

    /// Selects the [`OptionMenuItem`][crate::OptionMenuItem] at `index` in `self`.
    ///
    /// Selecting an item changes the
    /// text shown by the combo button, but it doesn't change the value of the element. You need to
    /// explicitly activate the item with [`select_item()`][Self::select_item()] or close the menu with
    /// [`close()`][Self::close()] in which case the currently selected item will be activated.
    /// ## `index`
    /// the index of the item
    #[doc(alias = "webkit_option_menu_select_item")]
    fn select_item(&self, index: u32);

    /// Emitted when closing a [`OptionMenu`][crate::OptionMenu] is requested. This can happen
    /// when the user explicitly calls [`close()`][Self::close()] or when the
    /// element is detached from the current page.
    #[cfg(any(feature = "v2_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v2_18")))]
    #[doc(alias = "close")]
    fn connect_close<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;
}

impl<O: IsA<OptionMenu>> OptionMenuExt for O {
    fn activate_item(&self, index: u32) {
        unsafe {
            ffi::webkit_option_menu_activate_item(self.as_ref().to_glib_none().0, index);
        }
    }

    fn close(&self) {
        unsafe {
            ffi::webkit_option_menu_close(self.as_ref().to_glib_none().0);
        }
    }

    fn item(&self, index: u32) -> Option<OptionMenuItem> {
        unsafe {
            from_glib_none(ffi::webkit_option_menu_get_item(
                self.as_ref().to_glib_none().0,
                index,
            ))
        }
    }

    fn n_items(&self) -> u32 {
        unsafe { ffi::webkit_option_menu_get_n_items(self.as_ref().to_glib_none().0) }
    }

    fn select_item(&self, index: u32) {
        unsafe {
            ffi::webkit_option_menu_select_item(self.as_ref().to_glib_none().0, index);
        }
    }

    #[cfg(any(feature = "v2_18", feature = "dox"))]
    #[cfg_attr(feature = "dox", doc(cfg(feature = "v2_18")))]
    fn connect_close<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn close_trampoline<P: IsA<OptionMenu>, F: Fn(&P) + 'static>(
            this: *mut ffi::WebKitOptionMenu,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(OptionMenu::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"close\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    close_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

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