Struct gtk::RecentChooserDialog

#[repr(transparent)]
pub struct RecentChooserDialog { /* private fields */ }

RecentChooserDialog is a dialog box suitable for displaying the recently used documents. This widgets works by putting a RecentChooserWidget inside a Dialog. It exposes the GtkRecentChooserIface interface, so you can use all the RecentChooser functions on the recent chooser dialog as well as those for Dialog.

Note that RecentChooserDialog does not have any methods of its own. Instead, you should use the functions that work on a RecentChooser.

Typical usage ## {gtkrecentchooser-typical-usage}

In the simplest of cases, you can use the following code to use a RecentChooserDialog to select a recently used file:

⚠️ The following code is in C ⚠️

GtkWidget *dialog;
gint res;

dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
                                        parent_window,
                                        _("_Cancel"),
                                        GTK_RESPONSE_CANCEL,
                                        _("_Open"),
                                        GTK_RESPONSE_ACCEPT,
                                        NULL);

res = gtk_dialog_run (GTK_DIALOG (dialog));
if (res == GTK_RESPONSE_ACCEPT)
  {
    GtkRecentInfo *info;
    GtkRecentChooser *chooser = GTK_RECENT_CHOOSER (dialog);

    info = gtk_recent_chooser_get_current_item (chooser);
    open_file (gtk_recent_info_get_uri (info));
    gtk_recent_info_unref (info);
  }

gtk_widget_destroy (dialog);

Recently used files are supported since GTK+ 2.10.

Implements

DialogExt, GtkWindowExt, BinExt, ContainerExt, WidgetExt, glib::ObjectExt, BuildableExt, RecentChooserExt, DialogExtManual, [GtkWindowExtManual][trait@crate::prelude::GtkWindowExtManual], ContainerExtManual, WidgetExtManual, BuildableExtManual

Implementations

impl RecentChooserDialog

pub const NONE: Option<&'static RecentChooserDialog> = None

pub fn builder() -> RecentChooserDialogBuilder

Creates a new builder-pattern struct instance to construct RecentChooserDialog objects.

This method returns an instance of RecentChooserDialogBuilder which can be used to create RecentChooserDialog objects.

impl RecentChooserDialog

pub fn new<T: IsA<Window>>(
    title: Option<&str>,
    parent: Option<&T>
) -> RecentChooserDialog

Creates a new RecentChooserDialog. This function is analogous to gtk_dialog_new_with_buttons().

title

Title of the dialog, or None

parent

Transient parent of the dialog, or None,

first_button_text

stock ID or text to go in the first button, or None

Returns

a new RecentChooserDialog

pub fn for_manager<T: IsA<Window>>(
    title: Option<&str>,
    parent: Option<&T>,
    manager: &RecentManager
) -> RecentChooserDialog

Creates a new RecentChooserDialog with a specified recent manager.

This is useful if you have implemented your own recent manager, or if you have a customized instance of a RecentManager object.

title

Title of the dialog, or None

parent

Transient parent of the dialog, or None,

manager

a RecentManager

first_button_text

stock ID or text to go in the first button, or None

Returns

a new RecentChooserDialog

Trait Implementations

impl Clone for RecentChooserDialog

fn clone(&self) -> Self

Returns a copy of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RecentChooserDialog

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RecentChooserDialog

fn default() -> Self

Returns the “default value” for a type.

impl Display for RecentChooserDialog

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for RecentChooserDialog

fn hash<H>(&self, state: &mut H)where
    H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,

Feeds a slice of this type into the given Hasher.

impl Ord for RecentChooserDialog

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

const fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

const fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

const fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for RecentChooserDialog

type Parent = Dialog

impl<OT: ObjectType> PartialEq<OT> for RecentChooserDialog

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for RecentChooserDialog

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

const fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

const fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

const fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

const fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for RecentChooserDialog

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for RecentChooserDialog

impl IsA<Bin> for RecentChooserDialog

impl IsA<Buildable> for RecentChooserDialog

impl IsA<Container> for RecentChooserDialog

impl IsA<Dialog> for RecentChooserDialog

impl IsA<RecentChooser> for RecentChooserDialog

impl IsA<Widget> for RecentChooserDialog

impl IsA<Window> for RecentChooserDialog