ShortcutProtocol
public protocol ShortcutProtocol : ObjectProtocol
A GtkShortcut
describes a keyboard shortcut.
It contains a description of how to trigger the shortcut via a
[classGtk.ShortcutTrigger
] and a way to activate the shortcut
on a widget via a [classGtk.ShortcutAction
].
The actual work is usually done via [classGtk.ShortcutController
],
which decides if and when to activate a shortcut. Using that controller
directly however is rarely necessary as various higher level
convenience APIs exist on GtkWidget
s that make it easier to use
shortcuts in GTK.
GtkShortcut
does provide functionality to make it easy for users
to work with shortcuts, either by providing informational strings
for display purposes or by allowing shortcuts to be configured.
The ShortcutProtocol
protocol exposes the methods and properties of an underlying GtkShortcut
instance.
The default implementation of these can be found in the protocol extension below.
For a concrete class that implements these methods and properties, see Shortcut
.
Alternatively, use ShortcutRef
as a lighweight, unowned
reference if you already have an instance you just want to use.
-
Untyped pointer to the underlying
GtkShortcut
instance.Declaration
Swift
var ptr: UnsafeMutableRawPointer! { get }
-
shortcut_ptr
Default implementationTyped pointer to the underlying
GtkShortcut
instance.Default Implementation
Return the stored, untyped pointer as a typed pointer to the
GtkShortcut
instance.Declaration
Swift
var shortcut_ptr: UnsafeMutablePointer<GtkShortcut>! { get }
-
Required Initialiser for types conforming to
ShortcutProtocol
Declaration
Swift
init(raw: UnsafeMutableRawPointer)
-
bind(property:
Extension methodto: _: flags: transformFrom: transformTo: ) Bind a
ShortcutPropertyName
source property to a given target object.Declaration
Swift
@discardableResult @inlinable func bind<Q, T>(property source_property: ShortcutPropertyName, to target: T, _ target_property: Q, flags f: BindingFlags = .default, transformFrom transform_from: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }, transformTo transform_to: @escaping GLibObject.ValueTransformer = { $0.transform(destValue: $1) }) -> BindingRef! where Q : PropertyNameProtocol, T : ObjectProtocol
Parameters
source_property
the source property to bind
target
the target object to bind to
target_property
the target property to bind to
flags
the flags to pass to the
Binding
transform_from
ValueTransformer
to use for forward transformationtransform_to
ValueTransformer
to use for backwards transformationReturn Value
binding reference or
nil
in case of an error -
get(property:
Extension method) Get the value of a Shortcut property
Declaration
Swift
@inlinable func get(property: ShortcutPropertyName) -> GLibObject.Value
Parameters
property
the property to get the value for
Return Value
the value of the named property
-
set(property:
Extension methodvalue: ) Set the value of a Shortcut property. Note that this will only have an effect on properties that are writable and not construct-only!
Declaration
Swift
@inlinable func set(property: ShortcutPropertyName, value v: GLibObject.Value)
Parameters
property
the property to get the value for
Return Value
the value of the named property
-
getAction()
Extension methodGets the action that is activated by this shortcut.
Declaration
Swift
@inlinable func getAction() -> ShortcutActionRef!
-
getArguments()
Extension methodGets the arguments that are passed when activating the shortcut.
Declaration
Swift
@inlinable func getArguments() -> GLib.VariantRef!
-
getTrigger()
Extension methodGets the trigger used to trigger
self
.Declaration
Swift
@inlinable func getTrigger() -> ShortcutTriggerRef!
-
set(action:
Extension method) Sets the new action for
self
to beaction
.Declaration
Swift
@inlinable func set(action: ShortcutActionRef? = nil)
-
set(action:
Extension method) Sets the new action for
self
to beaction
.Declaration
Swift
@inlinable func set<ShortcutActionT>(action: ShortcutActionT?) where ShortcutActionT : ShortcutActionProtocol
-
setArguments(args:
Extension method) Sets the arguments to pass when activating the shortcut.
Declaration
Swift
@inlinable func setArguments(args: GLib.VariantRef? = nil)
-
setArguments(args:
Extension method) Sets the arguments to pass when activating the shortcut.
Declaration
Swift
@inlinable func setArguments<VariantT>(args: VariantT?) where VariantT : VariantProtocol
-
set(trigger:
Extension method) Sets the new trigger for
self
to betrigger
.Declaration
Swift
@inlinable func set(trigger: ShortcutTriggerRef? = nil)
-
set(trigger:
Extension method) Sets the new trigger for
self
to betrigger
.Declaration
Swift
@inlinable func set<ShortcutTriggerT>(trigger: ShortcutTriggerT?) where ShortcutTriggerT : ShortcutTriggerProtocol
-
action
Extension methodThe action that gets activated by this shortcut.
Declaration
Swift
@inlinable var action: ShortcutActionRef! { get nonmutating set }
-
arguments
Extension methodArguments passed to activation.
Declaration
Swift
@inlinable var arguments: GLib.VariantRef! { get nonmutating set }
-
trigger
Extension methodThe trigger that triggers this shortcut.
Declaration
Swift
@inlinable var trigger: ShortcutTriggerRef! { get nonmutating set }