// 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::Accessible;
use crate::AppChooser;
use crate::Buildable;
use crate::ConstraintTarget;
use crate::Dialog;
use crate::DialogFlags;
use crate::Native;
use crate::Root;
use crate::ShortcutManager;
use crate::Widget;
use crate::Window;
use glib::object::Cast;
use glib::object::IsA;
use glib::object::ObjectType as ObjectType_;
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! {
    /// The application selection widgets should be
    ///   implemented according to the design of each platform and/or
    ///   application requiring them.
    /// [`AppChooserDialog`][crate::AppChooserDialog] shows a [`AppChooserWidget`][crate::AppChooserWidget] inside a [`Dialog`][crate::Dialog].
    ///
    /// ![An example GtkAppChooserDialog](appchooserdialog.png)
    ///
    /// Note that [`AppChooserDialog`][crate::AppChooserDialog] does not have any interesting methods
    /// of its own. Instead, you should get the embedded [`AppChooserWidget`][crate::AppChooserWidget]
    /// using [`widget()`][Self::widget()] and call its methods if
    /// the generic [`AppChooser`][crate::AppChooser] interface is not sufficient for
    /// your needs.
    ///
    /// To set the heading that is shown above the [`AppChooserWidget`][crate::AppChooserWidget],
    /// use [`set_heading()`][Self::set_heading()].
    ///
    /// # Implements
    ///
    /// [`DialogExt`][trait@crate::prelude::DialogExt], [`GtkWindowExt`][trait@crate::prelude::GtkWindowExt], [`WidgetExt`][trait@crate::prelude::WidgetExt], [`trait@glib::ObjectExt`], [`AccessibleExt`][trait@crate::prelude::AccessibleExt], [`BuildableExt`][trait@crate::prelude::BuildableExt], [`ConstraintTargetExt`][trait@crate::prelude::ConstraintTargetExt], [`NativeExt`][trait@crate::prelude::NativeExt], [`RootExt`][trait@crate::prelude::RootExt], [`ShortcutManagerExt`][trait@crate::prelude::ShortcutManagerExt], [`AppChooserExt`][trait@crate::prelude::AppChooserExt], [`DialogExtManual`][trait@crate::prelude::DialogExtManual], [`WidgetExtManual`][trait@crate::prelude::WidgetExtManual], [`AccessibleExtManual`][trait@crate::prelude::AccessibleExtManual]
    #[doc(alias = "GtkAppChooserDialog")]
    pub struct AppChooserDialog(Object<ffi::GtkAppChooserDialog>) @extends Dialog, Window, Widget, @implements Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager, AppChooser;

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

impl AppChooserDialog {
    /// Creates a new [`AppChooserDialog`][crate::AppChooserDialog] for the provided `GFile`.
    ///
    /// The dialog will show applications that can open the file.
    ///
    /// # Deprecated since 4.10
    ///
    /// This widget will be removed in GTK 5
    /// ## `parent`
    /// a [`Window`][crate::Window]
    /// ## `flags`
    /// flags for this dialog
    /// ## `file`
    /// a `GFile`
    ///
    /// # Returns
    ///
    /// a newly created [`AppChooserDialog`][crate::AppChooserDialog]
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[doc(alias = "gtk_app_chooser_dialog_new")]
    pub fn new(
        parent: Option<&impl IsA<Window>>,
        flags: DialogFlags,
        file: &impl IsA<gio::File>,
    ) -> AppChooserDialog {
        assert_initialized_main_thread!();
        unsafe {
            Widget::from_glib_none(ffi::gtk_app_chooser_dialog_new(
                parent.map(|p| p.as_ref()).to_glib_none().0,
                flags.into_glib(),
                file.as_ref().to_glib_none().0,
            ))
            .unsafe_cast()
        }
    }

    /// Creates a new [`AppChooserDialog`][crate::AppChooserDialog] for the provided content type.
    ///
    /// The dialog will show applications that can open the content type.
    ///
    /// # Deprecated since 4.10
    ///
    /// This widget will be removed in GTK 5
    /// ## `parent`
    /// a [`Window`][crate::Window]
    /// ## `flags`
    /// flags for this dialog
    /// ## `content_type`
    /// a content type string
    ///
    /// # Returns
    ///
    /// a newly created [`AppChooserDialog`][crate::AppChooserDialog]
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[doc(alias = "gtk_app_chooser_dialog_new_for_content_type")]
    #[doc(alias = "new_for_content_type")]
    pub fn for_content_type(
        parent: Option<&impl IsA<Window>>,
        flags: DialogFlags,
        content_type: &str,
    ) -> AppChooserDialog {
        assert_initialized_main_thread!();
        unsafe {
            Widget::from_glib_none(ffi::gtk_app_chooser_dialog_new_for_content_type(
                parent.map(|p| p.as_ref()).to_glib_none().0,
                flags.into_glib(),
                content_type.to_glib_none().0,
            ))
            .unsafe_cast()
        }
    }

    /// Returns the text to display at the top of the dialog.
    ///
    /// # Deprecated since 4.10
    ///
    /// This widget will be removed in GTK 5
    ///
    /// # Returns
    ///
    /// the text to display at the top of the dialog,
    ///   or [`None`], in which case a default text is displayed
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[doc(alias = "gtk_app_chooser_dialog_get_heading")]
    #[doc(alias = "get_heading")]
    pub fn heading(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::gtk_app_chooser_dialog_get_heading(
                self.to_glib_none().0,
            ))
        }
    }

    /// Returns the [`AppChooserWidget`][crate::AppChooserWidget] of this dialog.
    ///
    /// # Deprecated since 4.10
    ///
    /// This widget will be removed in GTK 5
    ///
    /// # Returns
    ///
    /// the [`AppChooserWidget`][crate::AppChooserWidget] of @self
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[doc(alias = "gtk_app_chooser_dialog_get_widget")]
    #[doc(alias = "get_widget")]
    pub fn widget(&self) -> Widget {
        unsafe {
            from_glib_none(ffi::gtk_app_chooser_dialog_get_widget(
                self.to_glib_none().0,
            ))
        }
    }

    /// Sets the text to display at the top of the dialog.
    ///
    /// If the heading is not set, the dialog displays a default text.
    ///
    /// # Deprecated since 4.10
    ///
    /// This widget will be removed in GTK 5
    /// ## `heading`
    /// a string containing Pango markup
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[doc(alias = "gtk_app_chooser_dialog_set_heading")]
    pub fn set_heading(&self, heading: &str) {
        unsafe {
            ffi::gtk_app_chooser_dialog_set_heading(
                self.to_glib_none().0,
                heading.to_glib_none().0,
            );
        }
    }

    /// The GFile used by the [`AppChooserDialog`][crate::AppChooserDialog].
    ///
    /// The dialog's [`AppChooserWidget`][crate::AppChooserWidget] content type will
    /// be guessed from the file, if present.
    pub fn gfile(&self) -> Option<gio::File> {
        glib::ObjectExt::property(self, "gfile")
    }

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

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