GI.Gtk.Objects.ShortcutAction

ShortcutAction is the object used to describe what a Shortcut should do when triggered. To activate a ShortcutAction manually, shortcutActionActivate can be called.

GtkShortcutActions contain functions that allow easy presentation to end users as well as being printed for debugging.

All GtkShortcutActions are immutable, you can only specify their properties during construction. If you want to change a action, you have to replace it with a new one. If you need to pass arguments to an action, these are specified by the higher-level Shortcut object.

GTK provides various actions:

• MnemonicAction: a shortcut action that calls widgetMnemonicActivate
• CallbackAction: a shortcut action that invokes a given callback
• SignalAction: a shortcut action that emits a given signal
• ActivateAction: a shortcut action that calls widgetActivate
• NamedAction: a shortcut action that calls gtk_widget_activate_action()
• NothingAction: a shortcut action that does nothing

GtkShortcutAction as GtkBuildable

GtkShortcut

Exported types

newtype ShortcutAction

Memory-managed wrapper type.

Constructors

ShortcutAction (ManagedPtr ShortcutAction)

Instances

Eq ShortcutAction

Defined in GI.Gtk.Objects.ShortcutAction

Methods

(==) :: ShortcutAction -> ShortcutAction -> Bool

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

IsGValue ShortcutAction

Convert ShortcutAction to and from GValue with toGValue and fromGValue.

Defined in GI.Gtk.Objects.ShortcutAction

Methods

toGValue :: ShortcutAction -> IO GValue

fromGValue :: GValue -> IO ShortcutAction

ManagedPtrNewtype ShortcutAction

Defined in GI.Gtk.Objects.ShortcutAction

Methods

toManagedPtr :: ShortcutAction -> ManagedPtr ShortcutAction

TypedObject ShortcutAction

Defined in GI.Gtk.Objects.ShortcutAction

Methods

glibType :: IO GType

GObject ShortcutAction

Defined in GI.Gtk.Objects.ShortcutAction

HasParentTypes ShortcutAction

Defined in GI.Gtk.Objects.ShortcutAction

type ParentTypes ShortcutAction

Defined in GI.Gtk.Objects.ShortcutAction

type ParentTypes ShortcutAction = '[Object]

class (GObject o, IsDescendantOf ShortcutAction o) => IsShortcutAction o

Type class for types which can be safely cast to ShortcutAction, for instance with toShortcutAction.

Instances

(GObject o, IsDescendantOf ShortcutAction o) => IsShortcutAction o

Defined in GI.Gtk.Objects.ShortcutAction

toShortcutAction :: (MonadIO m, IsShortcutAction o) => o -> m ShortcutAction

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

Methods

Overloaded methods

activate

shortcutActionActivate

Arguments

:: (HasCallStack, MonadIO m, IsShortcutAction a, IsWidget b)

=> a

self: a ShortcutAction

-> [ShortcutActionFlags]

flags: flags to activate with

-> b

widget: Target of the activation

-> Maybe GVariant

args: arguments to pass

-> m Bool

Returns: True if this action was activated successfully

Activates the action on the widget with the given args.

Note that some actions ignore the passed in flags, widget or args.

Activation of an action can fail for various reasons. If the action is not supported by the widget, if the args don't match the action or if the activation otherwise had no effect, False will be returned.

parseString

shortcutActionParseString

Arguments

:: (HasCallStack, MonadIO m)

=> Text

string: the string to parse

-> m (Maybe ShortcutAction)

Returns: a new ShortcutAction or Nothing on error

Tries to parse the given string into an action. On success, the parsed action is returned. When parsing failed, Nothing is returned.

The accepted strings are:

• nothing, for NothingAction
• activate, for ActivateAction
• mnemonic-activate, for MnemonicAction
• action(NAME), for a NamedAction for the action named NAME
• signal(NAME), for a SignalAction for the signal NAME

print

shortcutActionPrint

Arguments

:: (HasCallStack, MonadIO m, IsShortcutAction a)

=> a

self: a ShortcutAction

-> String

string: a String to print into

-> m ()

Prints the given action into a string for the developer. This is meant for debugging and logging.

The form of the representation may change at any time and is not guaranteed to stay identical.

toString

shortcutActionToString

Arguments

:: (HasCallStack, MonadIO m, IsShortcutAction a)

=> a

self: a ShortcutAction

-> m Text

Returns: a new string

Prints the given action into a human-readable string. This is a small wrapper around shortcutActionPrint to help when debugging.