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) }
}
}