Class

GtkRecentAction

Description [src]

class Gtk.RecentAction : Gtk.Action
  implements Gtk.Buildable, Gtk.RecentChooser {
  /* No available fields */
}

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

Ancestors

Implements

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().

deprecated: 3.10 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().

deprecated: 3.10 since: 2.12

Instance methods

gtk_recent_action_get_show_numbers

Returns the value set by gtk_recent_chooser_menu_set_show_numbers().

deprecated: 3.10 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.

deprecated: 3.10 since: 2.12

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.

since: 2.12

gtk_buildable_construct_child

Constructs a child of buildable with the name name.

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.

since: 2.12

gtk_buildable_custom_tag_end

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

since: 2.12

gtk_buildable_custom_tag_start

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

since: 2.12

gtk_buildable_get_internal_child

Get the internal child called childname of the buildable object.

since: 2.12

gtk_buildable_get_name

Gets the name of the buildable object.

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.

since: 2.12

gtk_buildable_set_buildable_property

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

since: 2.12

gtk_buildable_set_name

Sets the name of the buildable object.

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: 3.10

Properties inherited from GtkAction (16)

Gtk.Action:action-group

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

deprecated: 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.

deprecated: 3.10 since: 2.20

Gtk.Action:gicon

The GIcon displayed in the GtkAction.

deprecated: 3.10 since: 2.16

Gtk.Action:hide-if-empty

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

deprecated: 3.10

Gtk.Action:icon-name

The name of the icon from the icon theme.

deprecated: 3.10 since: 2.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: 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: 3.10

Gtk.Action:name

A unique name for the action.

deprecated: 3.10

Gtk.Action:sensitive

Whether the action is enabled.

deprecated: 3.10

Gtk.Action:short-label

A shorter label that may be used on toolbar buttons.

deprecated: 3.10

Gtk.Action:stock-id

The stock icon displayed in widgets representing this action.

deprecated: 3.10

Gtk.Action:tooltip

A tooltip for this action.

deprecated: 3.10

Gtk.Action:visible

Whether the action is visible.

deprecated: 3.10

Gtk.Action:visible-horizontal

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

deprecated: 3.10

Gtk.Action:visible-overflown

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

deprecated: 3.10 since: 2.6

Gtk.Action:visible-vertical

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

deprecated: 3.10

Properties inherited from GtkRecentChooser (10)

GtkRecentChooser:filter

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

since: 2.10

GtkRecentChooser:limit

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

since: 2.10

GtkRecentChooser:local-only

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

since: 2.10

GtkRecentChooser:recent-manager

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

since: 2.10

GtkRecentChooser:select-multiple

Allow the user to select multiple resources.

since: 2.10

GtkRecentChooser:show-icons

Whether this GtkRecentChooser should display an icon near the item.

since: 2.10

GtkRecentChooser: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).

since: 2.10

GtkRecentChooser:show-private

No description available.

GtkRecentChooser:show-tips

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

since: 2.10

GtkRecentChooser:sort-type

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

since: 2.10

Signals

Signals inherited from GtkAction (1)

GtkAction::activate

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

deprecated: 3.10 since: 2.4

Signals inherited from GObject (1)

GObject::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)

GtkRecentChooser::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.

since: 2.10

GtkRecentChooser::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.

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.