Class ShortcutAction

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtk.ShortcutAction

All Implemented Interfaces:

Proxy

Direct Known Subclasses:

ActivateAction, CallbackAction, MnemonicAction, NamedAction, NothingAction, ShortcutAction.ShortcutAction$Impl, SignalAction

@Generated("org.javagi.JavaGI")
public abstract class ShortcutAction
extends GObject

Encodes an action that can be triggered by a keyboard shortcut.

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 GtkShortcut object.

To activate a GtkShortcutAction manually, activate(Set, Widget, Variant) can be called.

GTK provides various actions:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ShortcutAction.Builder<B extends ShortcutAction.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static class	ShortcutAction.ShortcutAction$Impl	The ShortcutAction$Impl type represents a native instance of the abstract ShortcutAction class.
static class	ShortcutAction.ShortcutActionClass

Nested classes/interfaces inherited from class GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
ShortcutAction()	Create a new ShortcutAction.
ShortcutAction(MemorySegment address)	Create a ShortcutAction instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
boolean	activate(Set<ShortcutActionFlags> flags, Widget widget, @Nullable Variant args)	Activates the action on the widget with the given args.
boolean	activate(ShortcutActionFlags flags, Widget widget, @Nullable Variant args)	Activates the action on the widget with the given args.
protected ShortcutAction	asParent()	Return this instance as if it were its parent type.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
static @Nullable Type	getType()	Get the GType of the ShortcutAction class.
static @Nullable ShortcutAction	parseString(String string)	Tries to parse the given string into an action.
void	print(String string)	Prints the given action into a string for the developer.
String	toString()	Prints the given action into a human-readable string.

Methods inherited from class GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, builder, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class ProxyInstance

equals, handle, hashCode

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

ShortcutAction

public ShortcutAction(MemorySegment address)

Create a ShortcutAction instance for the provided memory address.

Parameters:

address - the memory address of the native object

ShortcutAction

public ShortcutAction()

Create a new ShortcutAction.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the ShortcutAction class.

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected ShortcutAction asParent()

Return this instance as if it were its parent type. Comparable to the Java super keyword, but ensures the parent typeclass is also used in native code.

Overrides:

asParent in class GObject

Returns:

the instance as if it were its parent type

parseString

public static @Nullable ShortcutAction parseString(String string)

Tries to parse the given string into an action.

On success, the parsed action is returned. When parsing failed, null is returned.

The accepted strings are:

• nothing, for GtkNothingAction
• activate, for GtkActivateAction
• mnemonic-activate, for GtkMnemonicAction
• action(NAME), for a GtkNamedAction for the action named NAME
• signal(NAME), for a GtkSignalAction for the signal NAME

Parameters:

string - the string to parse

Returns:

a new GtkShortcutAction

activate

public boolean activate(Set<ShortcutActionFlags> flags,
 Widget widget,
 @Nullable Variant args)

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.

Parameters:

flags - flags to activate with

widget - Target of the activation

args - arguments to pass

Returns:

true if this action was activated successfully

activate

public boolean activate(ShortcutActionFlags flags,
 Widget widget,
 @Nullable Variant args)

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.

Parameters:

flags - flags to activate with

widget - Target of the activation

args - arguments to pass

Returns:

true if this action was activated successfully

print

public void print(String string)

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.

Parameters:

string - a GString to print into

toString

public String toString()

Prints the given action into a human-readable string.

This is a small wrapper around print(String) to help when debugging.

Overrides:

toString in class Object

Returns:

a new string