1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
// Take a look at the license at the top of the repository in the LICENSE file.

use crate::Widget;
use gio::AppInfo;
use glib::object::IsA;
use glib::translate::*;

glib::wrapper! {
    /// [`AppChooser`][crate::AppChooser] is an interface that can be implemented by widgets which
    /// allow the user to choose an application (typically for the purpose of
    /// opening a file). The main objects that implement this interface are
    /// [`AppChooserWidget`][crate::AppChooserWidget], [`AppChooserDialog`][crate::AppChooserDialog] and [`AppChooserButton`][crate::AppChooserButton].
    ///
    /// Applications are represented by GIO [`gio::AppInfo`][crate::gio::AppInfo] objects here.
    /// GIO has a concept of recommended and fallback applications for a
    /// given content type. Recommended applications are those that claim
    /// to handle the content type itself, while fallback also includes
    /// applications that handle a more generic content type. GIO also
    /// knows the default and last-used application for a given content
    /// type. The [`AppChooserWidget`][crate::AppChooserWidget] provides detailed control over
    /// whether the shown list of applications should include default,
    /// recommended or fallback applications.
    ///
    /// To obtain the application that has been selected in a [`AppChooser`][crate::AppChooser],
    /// use [`AppChooserExtManual::app_info()`][crate::prelude::AppChooserExtManual::app_info()].
    ///
    /// # Implements
    ///
    /// [`AppChooserExt`][trait@crate::prelude::AppChooserExt], [`WidgetExt`][trait@crate::prelude::WidgetExt], [`trait@glib::ObjectExt`], [`BuildableExt`][trait@crate::prelude::BuildableExt], [`WidgetExtManual`][trait@crate::prelude::WidgetExtManual], [`BuildableExtManual`][trait@crate::prelude::BuildableExtManual]
    pub struct AppChooser(Interface<ffi::GtkAppChooser>) @requires Widget;

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

/// Trait containing all [`struct@AppChooser`] methods.
///
/// # Implementors
///
/// [`AppChooserButton`][struct@crate::AppChooserButton], [`AppChooserDialog`][struct@crate::AppChooserDialog], [`AppChooserWidget`][struct@crate::AppChooserWidget], [`AppChooser`][struct@crate::AppChooser]
pub trait AppChooserExt: 'static {
    /// Returns the currently selected application.
    ///
    /// # Returns
    ///
    /// a [`gio::AppInfo`][crate::gio::AppInfo] for the currently selected
    ///  application, or [`None`] if none is selected. Free with `g_object_unref()`
    #[doc(alias = "gtk_app_chooser_get_app_info")]
    #[doc(alias = "get_app_info")]
    fn app_info(&self) -> Option<AppInfo>;

    /// Returns the current value of the `property::AppChooser::content-type` property.
    ///
    /// # Returns
    ///
    /// the content type of `self`. Free with `g_free()`
    #[doc(alias = "gtk_app_chooser_get_content_type")]
    #[doc(alias = "get_content_type")]
    fn content_type(&self) -> Option<String>;

    /// Reloads the list of applications.
    #[doc(alias = "gtk_app_chooser_refresh")]
    fn refresh(&self);
}

impl<O: IsA<AppChooser>> AppChooserExt for O {
    fn app_info(&self) -> Option<AppInfo> {
        unsafe {
            from_glib_full(ffi::gtk_app_chooser_get_app_info(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn content_type(&self) -> Option<String> {
        unsafe {
            from_glib_full(ffi::gtk_app_chooser_get_content_type(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    fn refresh(&self) {
        unsafe { ffi::gtk_app_chooser_refresh(self.as_ref().to_glib_none().0) }
    }
}