GI.Gtk.Objects.RecentAction

A RecentAction represents a list of recently used files, which can be shown by widgets such as RecentChooserDialog or RecentChooserMenu.

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

Exported types

newtype RecentAction

Memory-managed wrapper type.

Constructors

RecentAction (ManagedPtr RecentAction)

Instances

Eq RecentAction

Defined in GI.Gtk.Objects.RecentAction

Methods

(==) :: RecentAction -> RecentAction -> Bool

(/=) :: RecentAction -> RecentAction -> Bool

GObject RecentAction

Defined in GI.Gtk.Objects.RecentAction

ManagedPtrNewtype RecentAction

Defined in GI.Gtk.Objects.RecentAction

Methods

toManagedPtr :: RecentAction -> ManagedPtr RecentAction

TypedObject RecentAction

Defined in GI.Gtk.Objects.RecentAction

Methods

glibType :: IO GType

HasParentTypes RecentAction

Defined in GI.Gtk.Objects.RecentAction

IsGValue (Maybe RecentAction)

Convert RecentAction to and from GValue. See toGValue and fromGValue.

Defined in GI.Gtk.Objects.RecentAction

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe RecentAction -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe RecentAction)

type ParentTypes RecentAction

Defined in GI.Gtk.Objects.RecentAction

type ParentTypes RecentAction = '[Action, Object, Buildable, RecentChooser]

class (GObject o, IsDescendantOf RecentAction o) => IsRecentAction o

Type class for types which can be safely cast to RecentAction, for instance with toRecentAction.

Instances

(GObject o, IsDescendantOf RecentAction o) => IsRecentAction o

Defined in GI.Gtk.Objects.RecentAction

toRecentAction :: (MonadIO m, IsRecentAction o) => o -> m RecentAction

Cast to RecentAction, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

activate, addChild, addFilter, bindProperty, bindPropertyFull, blockActivate, connectAccelerator, constructChild, createIcon, createMenu, createMenuItem, createToolItem, customFinished, customTagEnd, customTagStart, disconnectAccelerator, forceFloating, freezeNotify, getv, isFloating, isSensitive, isVisible, listFilters, notify, notifyByPspec, parserFinished, ref, refSink, removeFilter, runDispose, selectAll, selectUri, stealData, stealQdata, thawNotify, unblockActivate, unref, unselectAll, unselectUri, watchClosure.

Getters

getAccelClosure, getAccelPath, getAlwaysShowImage, getCurrentItem, getCurrentUri, getData, getFilter, getGicon, getIconName, getInternalChild, getIsImportant, getItems, getLabel, getLimit, getLocalOnly, getName, getProperty, getProxies, getQdata, getSelectMultiple, getSensitive, getShortLabel, getShowIcons, getShowNotFound, getShowNumbers, getShowPrivate, getShowTips, getSortType, getStockId, getTooltip, getUris, getVisible, getVisibleHorizontal, getVisibleVertical.

Setters

setAccelGroup, setAccelPath, setAlwaysShowImage, setBuildableProperty, setCurrentUri, setData, setDataFull, setFilter, setGicon, setIconName, setIsImportant, setLabel, setLimit, setLocalOnly, setName, setProperty, setSelectMultiple, setSensitive, setShortLabel, setShowIcons, setShowNotFound, setShowNumbers, setShowPrivate, setShowTips, setSortFunc, setSortType, setStockId, setTooltip, setVisible, setVisibleHorizontal, setVisibleVertical.

getShowNumbers

recentActionGetShowNumbers

Arguments

:: (HasCallStack, MonadIO m, IsRecentAction a)

=> a

action: a RecentAction

-> m Bool

Returns: True if numbers should be shown.

Deprecated: (Since version 3.10)

Returns the value set by recentChooserMenuSetShowNumbers.

Since: 2.12

new

recentActionNew

Arguments

:: (HasCallStack, MonadIO m)

=> Text

name: a unique name for the action

-> Maybe Text

label: the label displayed in menu items and on buttons, or Nothing

-> Maybe Text

tooltip: a tooltip for the action, or Nothing

-> Maybe Text

stockId: the stock icon to display in widgets representing the action, or Nothing

-> m RecentAction

Returns: the newly created RecentAction.

Deprecated: (Since version 3.10)

Creates a new RecentAction object. To add the action to a ActionGroup and set the accelerator for the action, call actionGroupAddActionWithAccel.

Since: 2.12

newForManager

recentActionNewForManager

Arguments

:: (HasCallStack, MonadIO m, IsRecentManager a)

=> Text

name: a unique name for the action

-> Maybe Text

label: the label displayed in menu items and on buttons, or Nothing

-> Maybe Text

tooltip: a tooltip for the action, or Nothing

-> Maybe Text

stockId: the stock icon to display in widgets representing the action, or Nothing

-> Maybe a

manager: a RecentManager, or Nothing for using the default RecentManager

-> m RecentAction

Returns: the newly created RecentAction

Deprecated: (Since version 3.10)

Creates a new RecentAction object. To add the action to a ActionGroup and set the accelerator for the action, call actionGroupAddActionWithAccel.

Since: 2.12

setShowNumbers

recentActionSetShowNumbers

Arguments

:: (HasCallStack, MonadIO m, IsRecentAction a)

=> a

action: a RecentAction

-> Bool

showNumbers: True if the shown items should be numbered

-> m ()

Deprecated: (Since version 3.10)

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.

Since: 2.12

Properties

showNumbers

Whether the items should be displayed with a number.

constructRecentActionShowNumbers :: (IsRecentAction o, MonadIO m) => Bool -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “show-numbers” property. This is rarely needed directly, but it is used by new.

getRecentActionShowNumbers :: (MonadIO m, IsRecentAction o) => o -> m Bool

Get the value of the “show-numbers” property. When overloading is enabled, this is equivalent to

get recentAction #showNumbers

setRecentActionShowNumbers :: (MonadIO m, IsRecentAction o) => o -> Bool -> m ()

Set the value of the “show-numbers” property. When overloading is enabled, this is equivalent to

set recentAction [ #showNumbers := value ]