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

glib::wrapper! {
    /// A request to open a file chooser.
    ///
    /// Whenever the user interacts with an <input type='file' />
    /// HTML element, WebKit will need to show a dialog to choose one or
    /// more files to be uploaded to the server along with the rest of the
    /// form data. For that to happen in a general way, instead of just
    /// opening a `GtkFileChooserDialog` (which might be not desirable in
    /// some cases, which could prefer to use their own file chooser
    /// dialog), WebKit will fire the `signal::WebView::run-file-chooser`
    /// signal with a [`FileChooserRequest`][crate::FileChooserRequest] object, which will allow
    /// the client application to specify the files to be selected, to
    /// inspect the details of the request (e.g. if multiple selection
    /// should be allowed) and to cancel the request, in case nothing was
    /// selected.
    ///
    /// In case the client application does not wish to handle this signal,
    /// WebKit will provide a default handler which will asynchronously run
    /// a regular `GtkFileChooserDialog` for the user to interact with.
    ///
    /// # Implements
    ///
    /// [`FileChooserRequestExt`][trait@crate::prelude::FileChooserRequestExt], [`trait@glib::ObjectExt`]
    #[doc(alias = "WebKitFileChooserRequest")]
    pub struct FileChooserRequest(Object<ffi::WebKitFileChooserRequest, ffi::WebKitFileChooserRequestClass>);

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

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

/// Trait containing all [`struct@FileChooserRequest`] methods.
///
/// # Implementors
///
/// [`FileChooserRequest`][struct@crate::FileChooserRequest]
pub trait FileChooserRequestExt: 'static {
    /// Ask WebKit to cancel the request.
    ///
    /// It's important to do this in case
    /// no selection has been made in the client, otherwise the request
    /// won't be properly completed and the browser will keep the request
    /// pending forever, which might cause the browser to hang.
    #[doc(alias = "webkit_file_chooser_request_cancel")]
    fn cancel(&self);

    /// Get the list of MIME types the file chooser dialog should handle.
    ///
    /// Get the list of MIME types the file chooser dialog should handle,
    /// in the format specified in RFC 2046 for "media types". Its contents
    /// depend on the value of the 'accept' attribute for HTML input
    /// elements. This function should normally be called before presenting
    /// the file chooser dialog to the user, to decide whether to allow the
    /// user to select multiple files at once or only one.
    ///
    /// # Returns
    ///
    /// a
    /// [`None`]-terminated array of strings if a list of accepted MIME types
    /// is defined or [`None`] otherwise, meaning that any MIME type should be
    /// accepted. This array and its contents are owned by WebKit and
    /// should not be modified or freed.
    #[doc(alias = "webkit_file_chooser_request_get_mime_types")]
    #[doc(alias = "get_mime_types")]
    fn mime_types(&self) -> Vec<glib::GString>;

    /// Get the filter currently associated with the request.
    ///
    /// Get the filter currently associated with the request, ready to be
    /// used by `GtkFileChooser`. This function should normally be called
    /// before presenting the file chooser dialog to the user, to decide
    /// whether to apply a filter so the user would not be allowed to
    /// select files with other MIME types.
    ///
    /// See [`mime_types()`][Self::mime_types()] if you are
    /// interested in getting the list of accepted MIME types.
    ///
    /// # Returns
    ///
    /// a [`gtk::FileFilter`][crate::gtk::FileFilter] if a list of accepted
    /// MIME types is defined or [`None`] otherwise. The returned object is
    /// owned by WebKit should not be modified or freed.
    #[doc(alias = "webkit_file_chooser_request_get_mime_types_filter")]
    #[doc(alias = "get_mime_types_filter")]
    fn mime_types_filter(&self) -> Option<gtk::FileFilter>;

    /// Whether the file chooser should allow selecting multiple files.
    ///
    /// Determine whether the file chooser associated to this
    /// [`FileChooserRequest`][crate::FileChooserRequest] should allow selecting multiple files,
    /// which depends on the HTML input element having a 'multiple'
    /// attribute defined.
    ///
    /// # Returns
    ///
    /// [`true`] if the file chooser should allow selecting multiple files or [`false`] otherwise.
    #[doc(alias = "webkit_file_chooser_request_get_select_multiple")]
    #[doc(alias = "get_select_multiple")]
    fn selects_multiple(&self) -> bool;

    /// Get the list of selected files associated to the request.
    ///
    /// Get the list of selected files currently associated to the
    /// request. Initially, the return value of this method contains any
    /// files selected in previous file chooser requests for this HTML
    /// input element. Once webkit_file_chooser_request_select_files, the
    /// value will reflect whatever files are given.
    ///
    /// This function should normally be called only before presenting the
    /// file chooser dialog to the user, to decide whether to perform some
    /// extra action, like pre-selecting the files from a previous request.
    ///
    /// # Returns
    ///
    /// a
    /// [`None`]-terminated array of strings if there are selected files
    /// associated with the request or [`None`] otherwise. This array and its
    /// contents are owned by WebKit and should not be modified or
    /// freed.
    #[doc(alias = "webkit_file_chooser_request_get_selected_files")]
    #[doc(alias = "get_selected_files")]
    fn selected_files(&self) -> Vec<glib::GString>;

    /// Ask WebKit to select local files for upload and complete the
    /// request.
    /// ## `files`
    /// a
    /// [`None`]-terminated array of strings, containing paths to local files.
    #[doc(alias = "webkit_file_chooser_request_select_files")]
    fn select_files(&self, files: &[&str]);

    /// The filter currently associated with the request. See
    /// [`mime_types_filter()`][Self::mime_types_filter()] for more
    /// details.
    fn filter(&self) -> Option<gtk::FileFilter>;

    #[doc(alias = "filter")]
    fn connect_filter_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    #[doc(alias = "mime-types")]
    fn connect_mime_types_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    #[doc(alias = "select-multiple")]
    fn connect_select_multiple_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;

    #[doc(alias = "selected-files")]
    fn connect_selected_files_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;
}

impl<O: IsA<FileChooserRequest>> FileChooserRequestExt for O {
    fn cancel(&self) {
        unsafe {
            ffi::webkit_file_chooser_request_cancel(self.as_ref().to_glib_none().0);
        }
    }

    fn mime_types(&self) -> Vec<glib::GString> {
        unsafe {
            FromGlibPtrContainer::from_glib_none(ffi::webkit_file_chooser_request_get_mime_types(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn mime_types_filter(&self) -> Option<gtk::FileFilter> {
        unsafe {
            from_glib_none(ffi::webkit_file_chooser_request_get_mime_types_filter(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

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

    fn selected_files(&self) -> Vec<glib::GString> {
        unsafe {
            FromGlibPtrContainer::from_glib_none(
                ffi::webkit_file_chooser_request_get_selected_files(self.as_ref().to_glib_none().0),
            )
        }
    }

    fn select_files(&self, files: &[&str]) {
        unsafe {
            ffi::webkit_file_chooser_request_select_files(
                self.as_ref().to_glib_none().0,
                files.to_glib_none().0,
            );
        }
    }

    fn filter(&self) -> Option<gtk::FileFilter> {
        glib::ObjectExt::property(self.as_ref(), "filter")
    }

    fn connect_filter_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_filter_trampoline<
            P: IsA<FileChooserRequest>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::WebKitFileChooserRequest,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(FileChooserRequest::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::filter\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_filter_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_mime_types_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_mime_types_trampoline<
            P: IsA<FileChooserRequest>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::WebKitFileChooserRequest,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(FileChooserRequest::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::mime-types\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_mime_types_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_select_multiple_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_select_multiple_trampoline<
            P: IsA<FileChooserRequest>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::WebKitFileChooserRequest,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(FileChooserRequest::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::select-multiple\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_select_multiple_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    fn connect_selected_files_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_selected_files_trampoline<
            P: IsA<FileChooserRequest>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::WebKitFileChooserRequest,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(FileChooserRequest::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::selected-files\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_selected_files_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

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