EventControllerKeyProtocol
public protocol EventControllerKeyProtocol : EventControllerProtocol
GtkEventControllerKey
is an event controller meant for situations
where you need access to key events.
This object was added in 3.24.
The EventControllerKeyProtocol
protocol exposes the methods and properties of an underlying GtkEventControllerKey
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 EventControllerKey
.
Alternatively, use EventControllerKeyRef
as a lighweight, unowned
reference if you already have an instance you just want to use.
-
Untyped pointer to the underlying
GtkEventControllerKey
instance.Declaration
Swift
var ptr: UnsafeMutableRawPointer! { get }
-
event_controller_key_ptr
Default implementationTyped pointer to the underlying
GtkEventControllerKey
instance.Default Implementation
Return the stored, untyped pointer as a typed pointer to the
GtkEventControllerKey
instance.Declaration
Swift
var event_controller_key_ptr: UnsafeMutablePointer<GtkEventControllerKey>! { get }
-
Required Initialiser for types conforming to
EventControllerKeyProtocol
Declaration
Swift
init(raw: UnsafeMutableRawPointer)
-
bind(property:
Extension methodto: _: flags: transformFrom: transformTo: ) Bind a
EventControllerKeyPropertyName
source property to a given target object.Declaration
Swift
@discardableResult @inlinable func bind<Q, T>(property source_property: EventControllerKeyPropertyName, 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 EventControllerKey property
Declaration
Swift
@inlinable func get(property: EventControllerKeyPropertyName) -> 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 EventControllerKey property. Note that this will only have an effect on properties that are writable and not construct-only!
Declaration
Swift
@inlinable func set(property: EventControllerKeyPropertyName, value v: GLibObject.Value)
Parameters
property
the property to get the value for
Return Value
the value of the named property
-
connect(signal:
Extension methodflags: handler: ) Connect a Swift signal handler to the given, typed
EventControllerKeySignalName
signalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: EventControllerKeySignalName, flags f: ConnectFlags = ConnectFlags(0), handler h: @escaping SignalHandler) -> Int
Parameters
signal
The signal to connect
flags
The connection flags to use
data
A pointer to user data to provide to the callback
destroyData
A
GClosureNotify
C function to destroy the data pointed to byuserData
handler
The Swift signal handler (function or callback) to invoke on the given signal
Return Value
The signal handler ID (always greater than 0 for successful connections)
-
connect(signal:
Extension methodflags: data: destroyData: signalHandler: ) Connect a C signal handler to the given, typed
EventControllerKeySignalName
signalDeclaration
Swift
@discardableResult @inlinable func connect(signal s: EventControllerKeySignalName, flags f: ConnectFlags = ConnectFlags(0), data userData: gpointer!, destroyData destructor: GClosureNotify? = nil, signalHandler h: @escaping GCallback) -> Int
Parameters
signal
The signal to connect
flags
The connection flags to use
data
A pointer to user data to provide to the callback
destroyData
A
GClosureNotify
C function to destroy the data pointed to byuserData
signalHandler
The C function to be called on the given signal
Return Value
The signal handler ID (always greater than 0 for successful connections)
-
onFocusIn(flags:
Extension methodhandler: ) Note
This represents the underlyingfocus-in
signalDeclaration
Swift
@discardableResult @inlinable func onFocusIn(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EventControllerKeyRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
focusIn
signal is emitted -
focusInSignal
Extension methodTyped
focus-in
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var focusInSignal: EventControllerKeySignalName { get }
-
onFocusOut(flags:
Extension methodhandler: ) Note
This represents the underlyingfocus-out
signalDeclaration
Swift
@discardableResult @inlinable func onFocusOut(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EventControllerKeyRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
focusOut
signal is emitted -
focusOutSignal
Extension methodTyped
focus-out
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var focusOutSignal: EventControllerKeySignalName { get }
-
onImUpdate(flags:
Extension methodhandler: ) Note
This represents the underlyingim-update
signalDeclaration
Swift
@discardableResult @inlinable func onImUpdate(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EventControllerKeyRef) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
handler
The signal handler to call Run the given callback whenever the
imUpdate
signal is emitted -
imUpdateSignal
Extension methodTyped
im-update
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var imUpdateSignal: EventControllerKeySignalName { get }
-
onKeyPressed(flags:
Extension methodhandler: ) This signal is emitted whenever a key is pressed.
Note
This represents the underlyingkey-pressed
signalDeclaration
Swift
@discardableResult @inlinable func onKeyPressed(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EventControllerKeyRef, _ keyval: UInt, _ keycode: UInt, _ state: Gdk.ModifierType) -> Bool) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
keyval
the pressed key.
keycode
the raw code of the pressed key.
state
the bitmask, representing the state of modifier keys and pointer buttons. See
GdkModifierType
.handler
true
if the key press was handled,false
otherwise. Run the given callback whenever thekeyPressed
signal is emitted -
keyPressedSignal
Extension methodTyped
key-pressed
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var keyPressedSignal: EventControllerKeySignalName { get }
-
onKeyReleased(flags:
Extension methodhandler: ) This signal is emitted whenever a key is released.
Note
This represents the underlyingkey-released
signalDeclaration
Swift
@discardableResult @inlinable func onKeyReleased(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EventControllerKeyRef, _ keyval: UInt, _ keycode: UInt, _ state: Gdk.ModifierType) -> Void) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
keyval
the released key.
keycode
the raw code of the released key.
state
the bitmask, representing the state of modifier keys and pointer buttons. See
GdkModifierType
.handler
The signal handler to call Run the given callback whenever the
keyReleased
signal is emitted -
keyReleasedSignal
Extension methodTyped
key-released
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var keyReleasedSignal: EventControllerKeySignalName { get }
-
onModifiers(flags:
Extension methodhandler: ) Note
This represents the underlyingmodifiers
signalDeclaration
Swift
@discardableResult @inlinable func onModifiers(flags: ConnectFlags = ConnectFlags(0), handler: @escaping (_ unownedSelf: EventControllerKeyRef, _ object: Gdk.ModifierType) -> Bool) -> Int
Parameters
flags
Flags
unownedSelf
Reference to instance of self
object
none
handler
The signal handler to call Run the given callback whenever the
modifiers
signal is emitted -
modifiersSignal
Extension methodTyped
modifiers
signal for using theconnect(signal:)
methodsDeclaration
Swift
static var modifiersSignal: EventControllerKeySignalName { get }
-
forward(widget:
Extension method) Undocumented
Declaration
Swift
@inlinable func forward<WidgetT>(widget: WidgetT) -> Bool where WidgetT : WidgetProtocol
-
getGroup()
Extension methodUndocumented
Declaration
Swift
@inlinable func getGroup() -> Int
-
getImContext()
Extension methodGets the IM context of a key controller.
Declaration
Swift
@inlinable func getImContext() -> IMContextRef!
-
set(imContext:
Extension method) Undocumented
Declaration
Swift
@inlinable func set<IMContextT>(imContext: IMContextT) where IMContextT : IMContextProtocol
-
group
Extension methodUndocumented
Declaration
Swift
@inlinable var group: Int { get }
-
imContext
Extension methodGets the IM context of a key controller.
Declaration
Swift
@inlinable var imContext: IMContextRef! { get nonmutating set }