gtk/auto/

recent_chooser_menu.rs

// 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::{
    AccelGroup, Align, Buildable, Container, Menu, MenuShell, RecentChooser, RecentFilter,
    RecentManager, RecentSortType, ResizeMode, Widget,
};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::{boxed::Box as Box_, fmt, mem::transmute};

glib::wrapper! {
    /// [`RecentChooserMenu`][crate::RecentChooserMenu] is a widget suitable for displaying recently used files
    /// inside a menu. It can be used to set a sub-menu of a [`MenuItem`][crate::MenuItem] using
    /// [`GtkMenuItemExt::set_submenu()`][crate::prelude::GtkMenuItemExt::set_submenu()], or as the menu of a [`MenuToolButton`][crate::MenuToolButton].
    ///
    /// Note that [`RecentChooserMenu`][crate::RecentChooserMenu] does not have any methods of its own. Instead,
    /// you should use the functions that work on a [`RecentChooser`][crate::RecentChooser].
    ///
    /// Note also that [`RecentChooserMenu`][crate::RecentChooserMenu] does not support multiple filters, as it
    /// has no way to let the user choose between them as the [`RecentChooserWidget`][crate::RecentChooserWidget]
    /// and [`RecentChooserDialog`][crate::RecentChooserDialog] widgets do. Thus using [`RecentChooserExt::add_filter()`][crate::prelude::RecentChooserExt::add_filter()]
    /// on a [`RecentChooserMenu`][crate::RecentChooserMenu] widget will yield the same effects as using
    /// [`RecentChooserExt::set_filter()`][crate::prelude::RecentChooserExt::set_filter()], replacing any currently set filter
    /// with the supplied filter; [`RecentChooserExt::remove_filter()`][crate::prelude::RecentChooserExt::remove_filter()] will remove
    /// any currently set [`RecentFilter`][crate::RecentFilter] object and will unset the current filter;
    /// [`RecentChooserExt::list_filters()`][crate::prelude::RecentChooserExt::list_filters()] will return a list containing a single
    /// [`RecentFilter`][crate::RecentFilter] object.
    ///
    /// Recently used files are supported since GTK+ 2.10.
    ///
    /// ## Properties
    ///
    ///
    /// #### `show-numbers`
    ///  Whether the first ten items in the menu should be prepended by
    /// a number acting as a unique mnemonic.
    ///
    /// Readable | Writeable
    /// <details><summary><h4>Menu</h4></summary>
    ///
    ///
    /// #### `accel-group`
    ///  The accel group holding accelerators for the menu.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `accel-path`
    ///  An accel path used to conveniently construct accel paths of child items.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `active`
    ///  The index of the currently selected menu item, or -1 if no
    /// menu item is selected.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `anchor-hints`
    ///  Positioning hints for aligning the menu relative to a rectangle.
    ///
    /// These hints determine how the menu should be positioned in the case that
    /// the menu would fall off-screen if placed in its ideal position.
    ///
    /// ![](popup-flip.png)
    ///
    /// For example, [`gdk::AnchorHints::FLIP_Y`][crate::gdk::AnchorHints::FLIP_Y] will replace [`gdk::Gravity::NorthWest`][crate::gdk::Gravity::NorthWest] with
    /// [`gdk::Gravity::SouthWest`][crate::gdk::Gravity::SouthWest] and vice versa if the menu extends beyond the
    /// bottom edge of the monitor.
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`rect-anchor-dx`][struct@crate::Menu#rect-anchor-dx],
    /// [`rect-anchor-dy`][struct@crate::Menu#rect-anchor-dy], [`menu-type-hint`][struct@crate::Menu#menu-type-hint], and [`popped-up`][struct@crate::Menu#popped-up].
    ///
    /// Readable | Writeable | Construct
    ///
    ///
    /// #### `attach-widget`
    ///  The widget the menu is attached to. Setting this property attaches
    /// the menu without a `GtkMenuDetachFunc`. If you need to use a detacher,
    /// use `gtk_menu_attach_to_widget()` directly.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `menu-type-hint`
    ///  The [`gdk::WindowTypeHint`][crate::gdk::WindowTypeHint] to use for the menu's [`gdk::Window`][crate::gdk::Window].
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::Menu#anchor-hints],
    /// [`rect-anchor-dx`][struct@crate::Menu#rect-anchor-dx], [`rect-anchor-dy`][struct@crate::Menu#rect-anchor-dy], and [`popped-up`][struct@crate::Menu#popped-up].
    ///
    /// Readable | Writeable | Construct
    ///
    ///
    /// #### `monitor`
    ///  The monitor the menu will be popped up on.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `rect-anchor-dx`
    ///  Horizontal offset to apply to the menu, i.e. the rectangle or widget
    /// anchor.
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::Menu#anchor-hints],
    /// [`rect-anchor-dy`][struct@crate::Menu#rect-anchor-dy], [`menu-type-hint`][struct@crate::Menu#menu-type-hint], and [`popped-up`][struct@crate::Menu#popped-up].
    ///
    /// Readable | Writeable | Construct
    ///
    ///
    /// #### `rect-anchor-dy`
    ///  Vertical offset to apply to the menu, i.e. the rectangle or widget anchor.
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::Menu#anchor-hints],
    /// [`rect-anchor-dx`][struct@crate::Menu#rect-anchor-dx], [`menu-type-hint`][struct@crate::Menu#menu-type-hint], and [`popped-up`][struct@crate::Menu#popped-up].
    ///
    /// Readable | Writeable | Construct
    ///
    ///
    /// #### `reserve-toggle-size`
    ///  A boolean that indicates whether the menu reserves space for
    /// toggles and icons, regardless of their actual presence.
    ///
    /// This property should only be changed from its default value
    /// for special-purposes such as tabular menus. Regular menus that
    /// are connected to a menu bar or context menus should reserve
    /// toggle space for consistency.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tearoff-state`
    ///  A boolean that indicates whether the menu is torn-off.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tearoff-title`
    ///  A title that may be displayed by the window manager when this
    /// menu is torn-off.
    ///
    /// Readable | Writeable
    /// </details>
    /// <details><summary><h4>MenuShell</h4></summary>
    ///
    ///
    /// #### `take-focus`
    ///  A boolean that determines whether the menu and its submenus grab the
    /// keyboard focus. See [`MenuShellExt::set_take_focus()`][crate::prelude::MenuShellExt::set_take_focus()] and
    /// [`MenuShellExt::takes_focus()`][crate::prelude::MenuShellExt::takes_focus()].
    ///
    /// Readable | Writeable
    /// </details>
    /// <details><summary><h4>Container</h4></summary>
    ///
    ///
    /// #### `border-width`
    ///  Readable | Writeable
    ///
    ///
    /// #### `child`
    ///  Writeable
    ///
    ///
    /// #### `resize-mode`
    ///  Readable | Writeable
    /// </details>
    /// <details><summary><h4>Widget</h4></summary>
    ///
    ///
    /// #### `app-paintable`
    ///  Readable | Writeable
    ///
    ///
    /// #### `can-default`
    ///  Readable | Writeable
    ///
    ///
    /// #### `can-focus`
    ///  Readable | Writeable
    ///
    ///
    /// #### `composite-child`
    ///  Readable
    ///
    ///
    /// #### `double-buffered`
    ///  Whether the widget is double buffered.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `events`
    ///  Readable | Writeable
    ///
    ///
    /// #### `expand`
    ///  Whether to expand in both directions. Setting this sets both [`hexpand`][struct@crate::Widget#hexpand] and [`vexpand`][struct@crate::Widget#vexpand]
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `focus-on-click`
    ///  Whether the widget should grab focus when it is clicked with the mouse.
    ///
    /// This property is only relevant for widgets that can take focus.
    ///
    /// Before 3.20, several widgets (GtkButton, GtkFileChooserButton,
    /// GtkComboBox) implemented this property individually.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `halign`
    ///  How to distribute horizontal space if widget gets extra space, see [`Align`][crate::Align]
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `has-default`
    ///  Readable | Writeable
    ///
    ///
    /// #### `has-focus`
    ///  Readable | Writeable
    ///
    ///
    /// #### `has-tooltip`
    ///  Enables or disables the emission of [`query-tooltip`][struct@crate::Widget#query-tooltip] on `widget`.
    /// A value of [`true`] indicates that `widget` can have a tooltip, in this case
    /// the widget will be queried using [`query-tooltip`][struct@crate::Widget#query-tooltip] to determine
    /// whether it will provide a tooltip or not.
    ///
    /// Note that setting this property to [`true`] for the first time will change
    /// the event masks of the GdkWindows of this widget to include leave-notify
    /// and motion-notify events. This cannot and will not be undone when the
    /// property is set to [`false`] again.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `height-request`
    ///  Readable | Writeable
    ///
    ///
    /// #### `hexpand`
    ///  Whether to expand horizontally. See [`WidgetExt::set_hexpand()`][crate::prelude::WidgetExt::set_hexpand()].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `hexpand-set`
    ///  Whether to use the [`hexpand`][struct@crate::Widget#hexpand] property. See [`WidgetExt::is_hexpand_set()`][crate::prelude::WidgetExt::is_hexpand_set()].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `is-focus`
    ///  Readable | Writeable
    ///
    ///
    /// #### `margin`
    ///  Sets all four sides' margin at once. If read, returns max
    /// margin on any side.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-bottom`
    ///  Margin on bottom side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-end`
    ///  Margin on end of widget, horizontally. This property supports
    /// left-to-right and right-to-left text directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-left`
    ///  Margin on left side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-right`
    ///  Margin on right side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-start`
    ///  Margin on start of widget, horizontally. This property supports
    /// left-to-right and right-to-left text directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-top`
    ///  Margin on top side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `name`
    ///  Readable | Writeable
    ///
    ///
    /// #### `no-show-all`
    ///  Readable | Writeable
    ///
    ///
    /// #### `opacity`
    ///  The requested opacity of the widget. See [`WidgetExt::set_opacity()`][crate::prelude::WidgetExt::set_opacity()] for
    /// more details about window opacity.
    ///
    /// Before 3.8 this was only available in GtkWindow
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `parent`
    ///  Readable | Writeable
    ///
    ///
    /// #### `receives-default`
    ///  Readable | Writeable
    ///
    ///
    /// #### `scale-factor`
    ///  The scale factor of the widget. See [`WidgetExt::scale_factor()`][crate::prelude::WidgetExt::scale_factor()] for
    /// more details about widget scaling.
    ///
    /// Readable
    ///
    ///
    /// #### `sensitive`
    ///  Readable | Writeable
    ///
    ///
    /// #### `style`
    ///  The style of the widget, which contains information about how it will look (colors, etc).
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tooltip-markup`
    ///  Sets the text of tooltip to be the given string, which is marked up
    /// with the [Pango text markup language][PangoMarkupFormat].
    /// Also see [`Tooltip::set_markup()`][crate::Tooltip::set_markup()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not [`None`]: [`has-tooltip`][struct@crate::Widget#has-tooltip]
    /// will automatically be set to [`true`] and there will be taken care of
    /// [`query-tooltip`][struct@crate::Widget#query-tooltip] in the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and [`tooltip-markup`][struct@crate::Widget#tooltip-markup]
    /// are set, the last one wins.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tooltip-text`
    ///  Sets the text of tooltip to be the given string.
    ///
    /// Also see [`Tooltip::set_text()`][crate::Tooltip::set_text()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not [`None`]: [`has-tooltip`][struct@crate::Widget#has-tooltip]
    /// will automatically be set to [`true`] and there will be taken care of
    /// [`query-tooltip`][struct@crate::Widget#query-tooltip] in the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and [`tooltip-markup`][struct@crate::Widget#tooltip-markup]
    /// are set, the last one wins.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `valign`
    ///  How to distribute vertical space if widget gets extra space, see [`Align`][crate::Align]
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `vexpand`
    ///  Whether to expand vertically. See [`WidgetExt::set_vexpand()`][crate::prelude::WidgetExt::set_vexpand()].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `vexpand-set`
    ///  Whether to use the [`vexpand`][struct@crate::Widget#vexpand] property. See [`WidgetExt::is_vexpand_set()`][crate::prelude::WidgetExt::is_vexpand_set()].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `visible`
    ///  Readable | Writeable
    ///
    ///
    /// #### `width-request`
    ///  Readable | Writeable
    ///
    ///
    /// #### `window`
    ///  The widget's window if it is realized, [`None`] otherwise.
    ///
    /// Readable
    /// </details>
    /// <details><summary><h4>Activatable</h4></summary>
    ///
    ///
    /// #### `related-action`
    ///  The action that this activatable will activate and receive
    /// updates from for various states and possibly appearance.
    ///
    /// > `GtkActivatable` implementors need to handle the this property and
    /// > call `gtk_activatable_do_set_related_action()` when it changes.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `use-action-appearance`
    ///  Whether this activatable should reset its layout
    /// and appearance when setting the related action or when
    /// the action changes appearance.
    ///
    /// See the `GtkAction` documentation directly to find which properties
    /// should be ignored by the `GtkActivatable` when this property is [`false`].
    ///
    /// > `GtkActivatable` implementors need to handle this property
    /// > and call `gtk_activatable_sync_action_properties()` on the activatable
    /// > widget when it changes.
    ///
    /// Readable | Writeable
    /// </details>
    /// <details><summary><h4>RecentChooser</h4></summary>
    ///
    ///
    /// #### `filter`
    ///  The [`RecentFilter`][crate::RecentFilter] object to be used when displaying
    /// the recently used resources.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `limit`
    ///  The maximum number of recently used resources to be displayed,
    /// or -1 to display all items.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `local-only`
    ///  Whether this [`RecentChooser`][crate::RecentChooser] should display only local (file:)
    /// resources.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `recent-manager`
    ///  The [`RecentManager`][crate::RecentManager] instance used by the [`RecentChooser`][crate::RecentChooser] to
    /// display the list of recently used resources.
    ///
    /// Writeable | Construct Only
    ///
    ///
    /// #### `select-multiple`
    ///  Allow the user to select multiple resources.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `show-icons`
    ///  Whether this [`RecentChooser`][crate::RecentChooser] should display an icon near the item.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `show-not-found`
    ///  Whether this [`RecentChooser`][crate::RecentChooser] should display the recently used resources
    /// even if not present anymore. Setting this to [`false`] will perform a
    /// potentially expensive check on every local resource (every remote
    /// resource will always be displayed).
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `show-private`
    ///  Readable | Writeable
    ///
    ///
    /// #### `show-tips`
    ///  Whether this [`RecentChooser`][crate::RecentChooser] should display a tooltip containing the
    /// full path of the recently used resources.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `sort-type`
    ///  Sorting order to be used when displaying the recently used resources.
    ///
    /// Readable | Writeable
    /// </details>
    ///
    /// # Implements
    ///
    /// [`RecentChooserMenuExt`][trait@crate::prelude::RecentChooserMenuExt], [`GtkMenuExt`][trait@crate::prelude::GtkMenuExt], [`MenuShellExt`][trait@crate::prelude::MenuShellExt], [`ContainerExt`][trait@crate::prelude::ContainerExt], [`WidgetExt`][trait@crate::prelude::WidgetExt], [`trait@glib::ObjectExt`], [`BuildableExt`][trait@crate::prelude::BuildableExt], [`RecentChooserExt`][trait@crate::prelude::RecentChooserExt], [`GtkMenuExtManual`][trait@crate::prelude::GtkMenuExtManual], [`ContainerExtManual`][trait@crate::prelude::ContainerExtManual], [`WidgetExtManual`][trait@crate::prelude::WidgetExtManual], [`BuildableExtManual`][trait@crate::prelude::BuildableExtManual]
    #[doc(alias = "GtkRecentChooserMenu")]
    pub struct RecentChooserMenu(Object<ffi::GtkRecentChooserMenu, ffi::GtkRecentChooserMenuClass>) @extends Menu, MenuShell, Container, Widget, @implements Buildable, RecentChooser;

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

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

    /// Creates a new [`RecentChooserMenu`][crate::RecentChooserMenu] widget.
    ///
    /// This kind of widget shows the list of recently used resources as
    /// a menu, each item as a menu item. Each item inside the menu might
    /// have an icon, representing its MIME type, and a number, for mnemonic
    /// access.
    ///
    /// This widget implements the [`RecentChooser`][crate::RecentChooser] interface.
    ///
    /// This widget creates its own [`RecentManager`][crate::RecentManager] object. See the
    /// [`for_manager()`][Self::for_manager()] function to know how to create
    /// a [`RecentChooserMenu`][crate::RecentChooserMenu] widget bound to another [`RecentManager`][crate::RecentManager] object.
    ///
    /// # Returns
    ///
    /// a new [`RecentChooserMenu`][crate::RecentChooserMenu]
    #[doc(alias = "gtk_recent_chooser_menu_new")]
    pub fn new() -> RecentChooserMenu {
        assert_initialized_main_thread!();
        unsafe { Widget::from_glib_none(ffi::gtk_recent_chooser_menu_new()).unsafe_cast() }
    }

    /// Creates a new [`RecentChooserMenu`][crate::RecentChooserMenu] widget using `manager` as
    /// the underlying recently used resources manager.
    ///
    /// This is useful if you have implemented your own recent manager,
    /// or if you have a customized instance of a [`RecentManager`][crate::RecentManager]
    /// object or if you wish to share a common [`RecentManager`][crate::RecentManager] object
    /// among multiple [`RecentChooser`][crate::RecentChooser] widgets.
    /// ## `manager`
    /// a [`RecentManager`][crate::RecentManager]
    ///
    /// # Returns
    ///
    /// a new [`RecentChooserMenu`][crate::RecentChooserMenu], bound to `manager`.
    #[doc(alias = "gtk_recent_chooser_menu_new_for_manager")]
    #[doc(alias = "new_for_manager")]
    pub fn for_manager(manager: &impl IsA<RecentManager>) -> RecentChooserMenu {
        skip_assert_initialized!();
        unsafe {
            Widget::from_glib_none(ffi::gtk_recent_chooser_menu_new_for_manager(
                manager.as_ref().to_glib_none().0,
            ))
            .unsafe_cast()
        }
    }

    // rustdoc-stripper-ignore-next
    /// Creates a new builder-pattern struct instance to construct [`RecentChooserMenu`] objects.
    ///
    /// This method returns an instance of [`RecentChooserMenuBuilder`](crate::builders::RecentChooserMenuBuilder) which can be used to create [`RecentChooserMenu`] objects.
    pub fn builder() -> RecentChooserMenuBuilder {
        RecentChooserMenuBuilder::new()
    }
}

impl Default for RecentChooserMenu {
    fn default() -> Self {
        Self::new()
    }
}

// rustdoc-stripper-ignore-next
/// A [builder-pattern] type to construct [`RecentChooserMenu`] objects.
///
/// [builder-pattern]: https://doc.rust-lang.org/1.0.0/style/ownership/builders.html
#[must_use = "The builder must be built to be used"]
pub struct RecentChooserMenuBuilder {
    builder: glib::object::ObjectBuilder<'static, RecentChooserMenu>,
}

impl RecentChooserMenuBuilder {
    fn new() -> Self {
        Self {
            builder: glib::object::Object::builder(),
        }
    }

    /// Whether the first ten items in the menu should be prepended by
    /// a number acting as a unique mnemonic.
    pub fn show_numbers(self, show_numbers: bool) -> Self {
        Self {
            builder: self.builder.property("show-numbers", show_numbers),
        }
    }

    /// The accel group holding accelerators for the menu.
    pub fn accel_group(self, accel_group: &impl IsA<AccelGroup>) -> Self {
        Self {
            builder: self
                .builder
                .property("accel-group", accel_group.clone().upcast()),
        }
    }

    /// An accel path used to conveniently construct accel paths of child items.
    pub fn accel_path(self, accel_path: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("accel-path", accel_path.into()),
        }
    }

    /// The index of the currently selected menu item, or -1 if no
    /// menu item is selected.
    pub fn active(self, active: i32) -> Self {
        Self {
            builder: self.builder.property("active", active),
        }
    }

    /// Positioning hints for aligning the menu relative to a rectangle.
    ///
    /// These hints determine how the menu should be positioned in the case that
    /// the menu would fall off-screen if placed in its ideal position.
    ///
    /// ![](popup-flip.png)
    ///
    /// For example, [`gdk::AnchorHints::FLIP_Y`][crate::gdk::AnchorHints::FLIP_Y] will replace [`gdk::Gravity::NorthWest`][crate::gdk::Gravity::NorthWest] with
    /// [`gdk::Gravity::SouthWest`][crate::gdk::Gravity::SouthWest] and vice versa if the menu extends beyond the
    /// bottom edge of the monitor.
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`rect-anchor-dx`][struct@crate::Menu#rect-anchor-dx],
    /// [`rect-anchor-dy`][struct@crate::Menu#rect-anchor-dy], [`menu-type-hint`][struct@crate::Menu#menu-type-hint], and [`popped-up`][struct@crate::Menu#popped-up].
    pub fn anchor_hints(self, anchor_hints: gdk::AnchorHints) -> Self {
        Self {
            builder: self.builder.property("anchor-hints", anchor_hints),
        }
    }

    /// The widget the menu is attached to. Setting this property attaches
    /// the menu without a `GtkMenuDetachFunc`. If you need to use a detacher,
    /// use `gtk_menu_attach_to_widget()` directly.
    pub fn attach_widget(self, attach_widget: &impl IsA<Widget>) -> Self {
        Self {
            builder: self
                .builder
                .property("attach-widget", attach_widget.clone().upcast()),
        }
    }

    /// The [`gdk::WindowTypeHint`][crate::gdk::WindowTypeHint] to use for the menu's [`gdk::Window`][crate::gdk::Window].
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::Menu#anchor-hints],
    /// [`rect-anchor-dx`][struct@crate::Menu#rect-anchor-dx], [`rect-anchor-dy`][struct@crate::Menu#rect-anchor-dy], and [`popped-up`][struct@crate::Menu#popped-up].
    pub fn menu_type_hint(self, menu_type_hint: gdk::WindowTypeHint) -> Self {
        Self {
            builder: self.builder.property("menu-type-hint", menu_type_hint),
        }
    }

    /// The monitor the menu will be popped up on.
    pub fn monitor(self, monitor: i32) -> Self {
        Self {
            builder: self.builder.property("monitor", monitor),
        }
    }

    /// Horizontal offset to apply to the menu, i.e. the rectangle or widget
    /// anchor.
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::Menu#anchor-hints],
    /// [`rect-anchor-dy`][struct@crate::Menu#rect-anchor-dy], [`menu-type-hint`][struct@crate::Menu#menu-type-hint], and [`popped-up`][struct@crate::Menu#popped-up].
    pub fn rect_anchor_dx(self, rect_anchor_dx: i32) -> Self {
        Self {
            builder: self.builder.property("rect-anchor-dx", rect_anchor_dx),
        }
    }

    /// Vertical offset to apply to the menu, i.e. the rectangle or widget anchor.
    ///
    /// See gtk_menu_popup_at_rect (), gtk_menu_popup_at_widget (),
    /// gtk_menu_popup_at_pointer (), [`anchor-hints`][struct@crate::Menu#anchor-hints],
    /// [`rect-anchor-dx`][struct@crate::Menu#rect-anchor-dx], [`menu-type-hint`][struct@crate::Menu#menu-type-hint], and [`popped-up`][struct@crate::Menu#popped-up].
    pub fn rect_anchor_dy(self, rect_anchor_dy: i32) -> Self {
        Self {
            builder: self.builder.property("rect-anchor-dy", rect_anchor_dy),
        }
    }

    /// A boolean that indicates whether the menu reserves space for
    /// toggles and icons, regardless of their actual presence.
    ///
    /// This property should only be changed from its default value
    /// for special-purposes such as tabular menus. Regular menus that
    /// are connected to a menu bar or context menus should reserve
    /// toggle space for consistency.
    pub fn reserve_toggle_size(self, reserve_toggle_size: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("reserve-toggle-size", reserve_toggle_size),
        }
    }

    /// A boolean that determines whether the menu and its submenus grab the
    /// keyboard focus. See [`MenuShellExt::set_take_focus()`][crate::prelude::MenuShellExt::set_take_focus()] and
    /// [`MenuShellExt::takes_focus()`][crate::prelude::MenuShellExt::takes_focus()].
    pub fn take_focus(self, take_focus: bool) -> Self {
        Self {
            builder: self.builder.property("take-focus", take_focus),
        }
    }

    pub fn border_width(self, border_width: u32) -> Self {
        Self {
            builder: self.builder.property("border-width", border_width),
        }
    }

    pub fn child(self, child: &impl IsA<Widget>) -> Self {
        Self {
            builder: self.builder.property("child", child.clone().upcast()),
        }
    }

    pub fn resize_mode(self, resize_mode: ResizeMode) -> Self {
        Self {
            builder: self.builder.property("resize-mode", resize_mode),
        }
    }

    pub fn app_paintable(self, app_paintable: bool) -> Self {
        Self {
            builder: self.builder.property("app-paintable", app_paintable),
        }
    }

    pub fn can_default(self, can_default: bool) -> Self {
        Self {
            builder: self.builder.property("can-default", can_default),
        }
    }

    pub fn can_focus(self, can_focus: bool) -> Self {
        Self {
            builder: self.builder.property("can-focus", can_focus),
        }
    }

    pub fn events(self, events: gdk::EventMask) -> Self {
        Self {
            builder: self.builder.property("events", events),
        }
    }

    /// Whether to expand in both directions. Setting this sets both [`hexpand`][struct@crate::Widget#hexpand] and [`vexpand`][struct@crate::Widget#vexpand]
    pub fn expand(self, expand: bool) -> Self {
        Self {
            builder: self.builder.property("expand", expand),
        }
    }

    /// Whether the widget should grab focus when it is clicked with the mouse.
    ///
    /// This property is only relevant for widgets that can take focus.
    ///
    /// Before 3.20, several widgets (GtkButton, GtkFileChooserButton,
    /// GtkComboBox) implemented this property individually.
    pub fn focus_on_click(self, focus_on_click: bool) -> Self {
        Self {
            builder: self.builder.property("focus-on-click", focus_on_click),
        }
    }

    /// How to distribute horizontal space if widget gets extra space, see [`Align`][crate::Align]
    pub fn halign(self, halign: Align) -> Self {
        Self {
            builder: self.builder.property("halign", halign),
        }
    }

    pub fn has_default(self, has_default: bool) -> Self {
        Self {
            builder: self.builder.property("has-default", has_default),
        }
    }

    pub fn has_focus(self, has_focus: bool) -> Self {
        Self {
            builder: self.builder.property("has-focus", has_focus),
        }
    }

    /// Enables or disables the emission of [`query-tooltip`][struct@crate::Widget#query-tooltip] on `widget`.
    /// A value of [`true`] indicates that `widget` can have a tooltip, in this case
    /// the widget will be queried using [`query-tooltip`][struct@crate::Widget#query-tooltip] to determine
    /// whether it will provide a tooltip or not.
    ///
    /// Note that setting this property to [`true`] for the first time will change
    /// the event masks of the GdkWindows of this widget to include leave-notify
    /// and motion-notify events. This cannot and will not be undone when the
    /// property is set to [`false`] again.
    pub fn has_tooltip(self, has_tooltip: bool) -> Self {
        Self {
            builder: self.builder.property("has-tooltip", has_tooltip),
        }
    }

    pub fn height_request(self, height_request: i32) -> Self {
        Self {
            builder: self.builder.property("height-request", height_request),
        }
    }

    /// Whether to expand horizontally. See [`WidgetExt::set_hexpand()`][crate::prelude::WidgetExt::set_hexpand()].
    pub fn hexpand(self, hexpand: bool) -> Self {
        Self {
            builder: self.builder.property("hexpand", hexpand),
        }
    }

    /// Whether to use the [`hexpand`][struct@crate::Widget#hexpand] property. See [`WidgetExt::is_hexpand_set()`][crate::prelude::WidgetExt::is_hexpand_set()].
    pub fn hexpand_set(self, hexpand_set: bool) -> Self {
        Self {
            builder: self.builder.property("hexpand-set", hexpand_set),
        }
    }

    pub fn is_focus(self, is_focus: bool) -> Self {
        Self {
            builder: self.builder.property("is-focus", is_focus),
        }
    }

    /// Sets all four sides' margin at once. If read, returns max
    /// margin on any side.
    pub fn margin(self, margin: i32) -> Self {
        Self {
            builder: self.builder.property("margin", margin),
        }
    }

    /// Margin on bottom side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_bottom(self, margin_bottom: i32) -> Self {
        Self {
            builder: self.builder.property("margin-bottom", margin_bottom),
        }
    }

    /// Margin on end of widget, horizontally. This property supports
    /// left-to-right and right-to-left text directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_end(self, margin_end: i32) -> Self {
        Self {
            builder: self.builder.property("margin-end", margin_end),
        }
    }

    /// Margin on start of widget, horizontally. This property supports
    /// left-to-right and right-to-left text directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_start(self, margin_start: i32) -> Self {
        Self {
            builder: self.builder.property("margin-start", margin_start),
        }
    }

    /// Margin on top side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_top(self, margin_top: i32) -> Self {
        Self {
            builder: self.builder.property("margin-top", margin_top),
        }
    }

    pub fn name(self, name: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("name", name.into()),
        }
    }

    pub fn no_show_all(self, no_show_all: bool) -> Self {
        Self {
            builder: self.builder.property("no-show-all", no_show_all),
        }
    }

    /// The requested opacity of the widget. See [`WidgetExt::set_opacity()`][crate::prelude::WidgetExt::set_opacity()] for
    /// more details about window opacity.
    ///
    /// Before 3.8 this was only available in GtkWindow
    pub fn opacity(self, opacity: f64) -> Self {
        Self {
            builder: self.builder.property("opacity", opacity),
        }
    }

    pub fn parent(self, parent: &impl IsA<Container>) -> Self {
        Self {
            builder: self.builder.property("parent", parent.clone().upcast()),
        }
    }

    pub fn receives_default(self, receives_default: bool) -> Self {
        Self {
            builder: self.builder.property("receives-default", receives_default),
        }
    }

    pub fn sensitive(self, sensitive: bool) -> Self {
        Self {
            builder: self.builder.property("sensitive", sensitive),
        }
    }

    /// Sets the text of tooltip to be the given string, which is marked up
    /// with the [Pango text markup language][PangoMarkupFormat].
    /// Also see [`Tooltip::set_markup()`][crate::Tooltip::set_markup()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not [`None`]: [`has-tooltip`][struct@crate::Widget#has-tooltip]
    /// will automatically be set to [`true`] and there will be taken care of
    /// [`query-tooltip`][struct@crate::Widget#query-tooltip] in the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and [`tooltip-markup`][struct@crate::Widget#tooltip-markup]
    /// are set, the last one wins.
    pub fn tooltip_markup(self, tooltip_markup: impl Into<glib::GString>) -> Self {
        Self {
            builder: self
                .builder
                .property("tooltip-markup", tooltip_markup.into()),
        }
    }

    /// Sets the text of tooltip to be the given string.
    ///
    /// Also see [`Tooltip::set_text()`][crate::Tooltip::set_text()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not [`None`]: [`has-tooltip`][struct@crate::Widget#has-tooltip]
    /// will automatically be set to [`true`] and there will be taken care of
    /// [`query-tooltip`][struct@crate::Widget#query-tooltip] in the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and [`tooltip-markup`][struct@crate::Widget#tooltip-markup]
    /// are set, the last one wins.
    pub fn tooltip_text(self, tooltip_text: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("tooltip-text", tooltip_text.into()),
        }
    }

    /// How to distribute vertical space if widget gets extra space, see [`Align`][crate::Align]
    pub fn valign(self, valign: Align) -> Self {
        Self {
            builder: self.builder.property("valign", valign),
        }
    }

    /// Whether to expand vertically. See [`WidgetExt::set_vexpand()`][crate::prelude::WidgetExt::set_vexpand()].
    pub fn vexpand(self, vexpand: bool) -> Self {
        Self {
            builder: self.builder.property("vexpand", vexpand),
        }
    }

    /// Whether to use the [`vexpand`][struct@crate::Widget#vexpand] property. See [`WidgetExt::is_vexpand_set()`][crate::prelude::WidgetExt::is_vexpand_set()].
    pub fn vexpand_set(self, vexpand_set: bool) -> Self {
        Self {
            builder: self.builder.property("vexpand-set", vexpand_set),
        }
    }

    pub fn visible(self, visible: bool) -> Self {
        Self {
            builder: self.builder.property("visible", visible),
        }
    }

    pub fn width_request(self, width_request: i32) -> Self {
        Self {
            builder: self.builder.property("width-request", width_request),
        }
    }

    /// The [`RecentFilter`][crate::RecentFilter] object to be used when displaying
    /// the recently used resources.
    pub fn filter(self, filter: &RecentFilter) -> Self {
        Self {
            builder: self.builder.property("filter", filter.clone()),
        }
    }

    /// The maximum number of recently used resources to be displayed,
    /// or -1 to display all items.
    pub fn limit(self, limit: i32) -> Self {
        Self {
            builder: self.builder.property("limit", limit),
        }
    }

    /// Whether this [`RecentChooser`][crate::RecentChooser] should display only local (file:)
    /// resources.
    pub fn local_only(self, local_only: bool) -> Self {
        Self {
            builder: self.builder.property("local-only", local_only),
        }
    }

    /// The [`RecentManager`][crate::RecentManager] instance used by the [`RecentChooser`][crate::RecentChooser] to
    /// display the list of recently used resources.
    pub fn recent_manager(self, recent_manager: &impl IsA<RecentManager>) -> Self {
        Self {
            builder: self
                .builder
                .property("recent-manager", recent_manager.clone().upcast()),
        }
    }

    /// Allow the user to select multiple resources.
    pub fn select_multiple(self, select_multiple: bool) -> Self {
        Self {
            builder: self.builder.property("select-multiple", select_multiple),
        }
    }

    /// Whether this [`RecentChooser`][crate::RecentChooser] should display an icon near the item.
    pub fn show_icons(self, show_icons: bool) -> Self {
        Self {
            builder: self.builder.property("show-icons", show_icons),
        }
    }

    /// Whether this [`RecentChooser`][crate::RecentChooser] should display the recently used resources
    /// even if not present anymore. Setting this to [`false`] will perform a
    /// potentially expensive check on every local resource (every remote
    /// resource will always be displayed).
    pub fn show_not_found(self, show_not_found: bool) -> Self {
        Self {
            builder: self.builder.property("show-not-found", show_not_found),
        }
    }

    pub fn show_private(self, show_private: bool) -> Self {
        Self {
            builder: self.builder.property("show-private", show_private),
        }
    }

    /// Whether this [`RecentChooser`][crate::RecentChooser] should display a tooltip containing the
    /// full path of the recently used resources.
    pub fn show_tips(self, show_tips: bool) -> Self {
        Self {
            builder: self.builder.property("show-tips", show_tips),
        }
    }

    /// Sorting order to be used when displaying the recently used resources.
    pub fn sort_type(self, sort_type: RecentSortType) -> Self {
        Self {
            builder: self.builder.property("sort-type", sort_type),
        }
    }

    // rustdoc-stripper-ignore-next
    /// Build the [`RecentChooserMenu`].
    #[must_use = "Building the object from the builder is usually expensive and is not expected to have side effects"]
    pub fn build(self) -> RecentChooserMenu {
        self.builder.build()
    }
}

mod sealed {
    pub trait Sealed {}
    impl<T: super::IsA<super::RecentChooserMenu>> Sealed for T {}
}

/// Trait containing all [`struct@RecentChooserMenu`] methods.
///
/// # Implementors
///
/// [`RecentChooserMenu`][struct@crate::RecentChooserMenu]
pub trait RecentChooserMenuExt: IsA<RecentChooserMenu> + sealed::Sealed + 'static {
    /// Returns the value set by [`set_show_numbers()`][Self::set_show_numbers()].
    ///
    /// # Returns
    ///
    /// [`true`] if numbers should be shown.
    #[doc(alias = "gtk_recent_chooser_menu_get_show_numbers")]
    #[doc(alias = "get_show_numbers")]
    fn shows_numbers(&self) -> bool {
        unsafe {
            from_glib(ffi::gtk_recent_chooser_menu_get_show_numbers(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Sets whether a number should be added to the items of `self`. The
    /// numbers are shown to provide a unique character for a mnemonic to
    /// be used inside ten menu item’s label. Only the first the items
    /// get a number to avoid clashes.
    /// ## `show_numbers`
    /// whether to show numbers
    #[doc(alias = "gtk_recent_chooser_menu_set_show_numbers")]
    fn set_show_numbers(&self, show_numbers: bool) {
        unsafe {
            ffi::gtk_recent_chooser_menu_set_show_numbers(
                self.as_ref().to_glib_none().0,
                show_numbers.into_glib(),
            );
        }
    }

    #[doc(alias = "show-numbers")]
    fn connect_show_numbers_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_show_numbers_trampoline<
            P: IsA<RecentChooserMenu>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GtkRecentChooserMenu,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(RecentChooserMenu::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::show-numbers\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_show_numbers_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<RecentChooserMenu>> RecentChooserMenuExt for O {}

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