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

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

Instance methods

gtk_recent_action_get_show_numbers

Returns the value set by gtk_recent_chooser_menu_set_show_numbers().

Available since: 2.12

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

Methods inherited from GtkAction (41)
gtk_action_activate

Emits the “activate” signal on the specified action, if it isn’t insensitive. This gets called by the proxy widgets when they get activated.

Available since: 2.4

Deprecated since: 3.10

gtk_action_block_activate

Disable activation signals from the action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_connect_accelerator

Installs the accelerator for action if action has an accel path and group. See gtk_action_set_accel_path() and gtk_action_set_accel_group()

Available since: 2.4

Deprecated since: 3.10

gtk_action_create_icon

This function is intended for use by action implementations to create icons displayed in the proxy widgets.

Available since: 2.4

Deprecated since: 3.10

gtk_action_create_menu

If action provides a GtkMenu widget as a submenu for the menu item or the toolbar item it creates, this function returns an instance of that menu.

Available since: 2.12

Deprecated since: 3.10

gtk_action_create_menu_item

Creates a menu item widget that proxies for the given action.

Available since: 2.4

Deprecated since: 3.10

gtk_action_create_tool_item

Creates a toolbar item widget that proxies for the given action.

Available since: 2.4

Deprecated since: 3.10

gtk_action_disconnect_accelerator

Undoes the effect of one call to gtk_action_connect_accelerator().

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_accel_closure

Returns the accel closure for this action.

Available since: 2.8

Deprecated since: 3.10

gtk_action_get_accel_path

Returns the accel path for this action.

Available since: 2.6

Deprecated since: 3.10

gtk_action_get_always_show_image

Returns whether actions menu item proxies will always show their image, if available.

Available since: 2.20

Deprecated since: 3.10

gtk_action_get_gicon

Gets the gicon of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_icon_name

Gets the icon name of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_is_important

Checks whether action is important or not.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_label

Gets the label text of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_name

Returns the name of the action.

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_proxies

Returns the proxy widgets for an action. See also gtk_activatable_get_related_action().

Available since: 2.4

gtk_action_get_sensitive

Returns whether the action itself is sensitive. Note that this doesn’t necessarily mean effective sensitivity. See gtk_action_is_sensitive() for that.

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_short_label

Gets the short label text of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_stock_id

Gets the stock id of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_tooltip

Gets the tooltip text of action.

Available since: 2.16

Deprecated since: 3.10

gtk_action_get_visible

Returns whether the action itself is visible. Note that this doesn’t necessarily mean effective visibility. See gtk_action_is_sensitive() for that.

Available since: 2.4

Deprecated since: 3.10

gtk_action_get_visible_horizontal

Checks whether action is visible when horizontal.

Available since: 2.16

Deprecated since: 3.10

Methods inherited from GObject (42)
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)
gtk_recent_chooser_add_filter

Adds filter to the list of GtkRecentFilter objects held by chooser.

Available since: 2.10

gtk_recent_chooser_get_current_item

Gets the GtkRecentInfo currently selected by chooser.

Available since: 2.10

gtk_recent_chooser_get_current_uri

Gets the URI currently selected by chooser.

Available since: 2.10

gtk_recent_chooser_get_filter

Gets the GtkRecentFilter object currently used by chooser to affect the display of the recently used resources.

Available since: 2.10

gtk_recent_chooser_get_items

Gets the list of recently used resources in form of GtkRecentInfo objects.

Available since: 2.10

gtk_recent_chooser_get_limit

Gets the number of items returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris().

Available since: 2.10

gtk_recent_chooser_get_local_only

Gets whether only local resources should be shown in the recently used resources selector. See gtk_recent_chooser_set_local_only()

Available since: 2.10

gtk_recent_chooser_get_select_multiple

Gets whether chooser can select multiple items.

Available since: 2.10

gtk_recent_chooser_get_show_icons

Retrieves whether chooser should show an icon near the resource.

Available since: 2.10

gtk_recent_chooser_get_show_not_found

Retrieves whether chooser should show the recently used resources that were not found.

Available since: 2.10

gtk_recent_chooser_get_show_private

Returns whether chooser should display recently used resources registered as private.

Available since: 2.10

gtk_recent_chooser_get_show_tips

Gets whether chooser should display tooltips containing the full path of a recently user resource.

Available since: 2.10

gtk_recent_chooser_get_sort_type

Gets the value set by gtk_recent_chooser_set_sort_type().

Available since: 2.10

gtk_recent_chooser_get_uris

Gets the URI of the recently used resources.

Available since: 2.10

gtk_recent_chooser_list_filters

Gets the GtkRecentFilter objects held by chooser.

Available since: 2.10

gtk_recent_chooser_remove_filter

Removes filter from the list of GtkRecentFilter objects held by chooser.

Available since: 2.10

gtk_recent_chooser_select_all

Selects all the items inside chooser, if the chooser supports multiple selection.

Available since: 2.10

gtk_recent_chooser_select_uri

Selects uri inside chooser.

Available since: 2.10

gtk_recent_chooser_set_current_uri

Sets uri as the current URI for chooser.

Available since: 2.10

gtk_recent_chooser_set_filter

Sets filter as the current GtkRecentFilter object used by chooser to affect the displayed recently used resources.

Available since: 2.10

gtk_recent_chooser_set_limit

Sets the number of items that should be returned by gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris().

Available since: 2.10

gtk_recent_chooser_set_local_only

Sets whether only local resources, that is resources using the file:// URI scheme, should be shown in the recently used resources selector. If local_only is TRUE (the default) then the shown resources are guaranteed to be accessible through the operating system native file system.

Available since: 2.10

gtk_recent_chooser_set_select_multiple

Sets whether chooser can select multiple items.

Available since: 2.10

Properties

Gtk.RecentAction:show-numbers

Whether the items should be displayed with a number.

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