Class

GtkRecentAction

Description [src]

class Gtk.RecentAction : Gtk.Action {
  parent_instance: GtkAction
}

A GtkRecentAction represents a list of recently used files, which can be shown by widgets such as GtkRecentChooserDialog or GtkRecentChooserMenu.

To construct a submenu showing recently used files, use a GtkRecentAction as the action for a <menuitem>. To construct a menu toolbutton showing the recently used files in the popup menu, use a GtkRecentAction as the action for a <toolitem> element.

Hierarchy

hierarchy this GtkRecentAction implements_0 GtkBuildable this--implements_0 implements_1 GtkRecentChooser this--implements_1 ancestor_0 GtkAction ancestor_0--this ancestor_1 GObject ancestor_1--ancestor_0

Ancestors

Constructors

gtk_recent_action_new

Creates a new GtkRecentAction object. To add the action to a GtkActionGroup and set the accelerator for the action, call gtk_action_group_add_action_with_accel().

Available since: 2.12

Deprecated since: 3.10

gtk_recent_action_new_for_manager

Creates a new GtkRecentAction object. To add the action to a GtkActionGroup and set the accelerator for the action, call gtk_action_group_add_action_with_accel().

Available since: 2.12

Deprecated since: 3.10

Instance methods

gtk_recent_action_get_show_numbers

Returns the value set by gtk_recent_chooser_menu_set_show_numbers().

Available since: 2.12

Deprecated since: 3.10

gtk_recent_action_set_show_numbers

Sets whether a number should be added to the items shown by the widgets representing action. The numbers are shown to provide a unique character for a mnemonic to be used inside the menu item’s label. Only the first ten items get a number to avoid clashes.

Available since: 2.12

Deprecated since: 3.10

Methods inherited from GtkAction (41)

Please see GtkAction for a full list of methods.

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Methods inherited from GtkBuildable (10)
gtk_buildable_add_child

Adds a child to buildable. type is an optional string describing how the child should be added.

Available since: 2.12

gtk_buildable_construct_child

Constructs a child of buildable with the name name.

Available since: 2.12

gtk_buildable_custom_finished

This is similar to gtk_buildable_parser_finished() but is called once for each custom tag handled by the buildable.

Available since: 2.12

gtk_buildable_custom_tag_end

This is called at the end of each custom element handled by the buildable.

Available since: 2.12

gtk_buildable_custom_tag_start

This is called for each unknown element under <child>.

Available since: 2.12

gtk_buildable_get_internal_child

Get the internal child called childname of the buildable object.

Available since: 2.12

gtk_buildable_get_name

Gets the name of the buildable object.

Available since: 2.12

gtk_buildable_parser_finished

Called when the builder finishes the parsing of a [GtkBuilder UI definition][BUILDER-UI]. Note that this will be called once for each time gtk_builder_add_from_file() or gtk_builder_add_from_string() is called on a builder.

Available since: 2.12

gtk_buildable_set_buildable_property

Sets the property name name to value on the buildable object.

Available since: 2.12

gtk_buildable_set_name

Sets the name of the buildable object.

Available since: 2.12

Methods inherited from GtkRecentChooser (31)

Please see GtkRecentChooser for a full list of methods.

Properties

Gtk.RecentAction:show-numbers

Whether the items should be displayed with a number.

Deprecated since: 3.10

Properties inherited from GtkAction (16)
Gtk.Action:action-group

The GtkActionGroup this GtkAction is associated with, or NULL (for internal use).

Deprecated since: 3.10

Gtk.Action:always-show-image

If TRUE, the action’s menu item proxies will ignore the GtkSettings:gtk-menu-images setting and always show their image, if available.

Available since: 2.20

Deprecated since: 3.10

Gtk.Action:gicon

The GIcon displayed in the GtkAction.

Available since: 2.16

Deprecated since: 3.10

Gtk.Action:hide-if-empty

When TRUE, empty menu proxies for this action are hidden.

Deprecated since: 3.10

Gtk.Action:icon-name

The name of the icon from the icon theme.

Available since: 2.10

Deprecated since: 3.10

Gtk.Action:is-important

Whether the action is considered important. When TRUE, toolitem proxies for this action show text in GTK_TOOLBAR_BOTH_HORIZ mode.

Deprecated since: 3.10

Gtk.Action:label

The label used for menu items and buttons that activate this action. If the label is NULL, GTK+ uses the stock label specified via the stock-id property.

Deprecated since: 3.10

Gtk.Action:name

A unique name for the action.

Deprecated since: 3.10

Gtk.Action:sensitive

Whether the action is enabled.

Deprecated since: 3.10

Gtk.Action:short-label

A shorter label that may be used on toolbar buttons.

Deprecated since: 3.10

Gtk.Action:stock-id

The stock icon displayed in widgets representing this action.

Deprecated since: 3.10

Gtk.Action:tooltip

A tooltip for this action.

Deprecated since: 3.10

Gtk.Action:visible

Whether the action is visible.

Deprecated since: 3.10

Gtk.Action:visible-horizontal

Whether the toolbar item is visible when the toolbar is in a horizontal orientation.

Deprecated since: 3.10

Gtk.Action:visible-overflown

When TRUE, toolitem proxies for this action are represented in the toolbar overflow menu.

Available since: 2.6

Deprecated since: 3.10

Gtk.Action:visible-vertical

Whether the toolbar item is visible when the toolbar is in a vertical orientation.

Deprecated since: 3.10

Properties inherited from GtkRecentChooser (10)
Gtk.RecentChooser:filter

The GtkRecentFilter object to be used when displaying the recently used resources.

Available since: 2.10

Gtk.RecentChooser:limit

The maximum number of recently used resources to be displayed, or -1 to display all items.

Available since: 2.10

Gtk.RecentChooser:local-only

Whether this GtkRecentChooser should display only local (file:) resources.

Available since: 2.10

Gtk.RecentChooser:recent-manager

The GtkRecentManager instance used by the GtkRecentChooser to display the list of recently used resources.

Available since: 2.10

Gtk.RecentChooser:select-multiple

Allow the user to select multiple resources.

Available since: 2.10

Gtk.RecentChooser:show-icons

Whether this GtkRecentChooser should display an icon near the item.

Available since: 2.10

Gtk.RecentChooser:show-not-found

Whether this GtkRecentChooser 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).

Available since: 2.10

Gtk.RecentChooser:show-private
No description available.
Gtk.RecentChooser:show-tips

Whether this GtkRecentChooser should display a tooltip containing the full path of the recently used resources.

Available since: 2.10

Gtk.RecentChooser:sort-type

Sorting order to be used when displaying the recently used resources.

Available since: 2.10

Signals

Signals inherited from GtkAction (1)
Gtk.Action::activate

The “activate” signal is emitted when the action is activated.

Available since: 2.4

Deprecated since: 3.10

Signals inherited from GObject (1)
GObject.Object::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Signals inherited from GtkRecentChooser (2)
Gtk.RecentChooser::item-activated

This signal is emitted when the user “activates” a recent item in the recent chooser. This can happen by double-clicking on an item in the recently used resources list, or by pressing Enter.

Available since: 2.10

Gtk.RecentChooser::selection-changed

This signal is emitted when there is a change in the set of selected recently used resources. This can happen when a user modifies the selection with the mouse or the keyboard, or when explicitly calling functions to change the selection.

Available since: 2.10

Class structure

struct GtkRecentActionClass {
  GtkActionClass parent_class;
  void (* _gtk_reserved1) (
void
  );
  void (* _gtk_reserved2) (
void
  );
  void (* _gtk_reserved3) (
void
  );
  void (* _gtk_reserved4) (
void
  );
  
}
No description available.
Class members
parent_class
GtkActionClass
  No description available.
_gtk_reserved1
void (* _gtk_reserved1) (
void
  )
  No description available.
_gtk_reserved2
void (* _gtk_reserved2) (
void
  )
  No description available.
_gtk_reserved3
void (* _gtk_reserved3) (
void
  )
  No description available.
_gtk_reserved4
void (* _gtk_reserved4) (
void
  )
  No description available.