GI.Gtk.Objects.EventControllerFocus

EventControllerFocus is an event controller meant for situations where you need to know where the focus is.

Exported types

newtype EventControllerFocus

Memory-managed wrapper type.

Constructors

EventControllerFocus (ManagedPtr EventControllerFocus)

Instances

Eq EventControllerFocus

Defined in GI.Gtk.Objects.EventControllerFocus

Methods

(==) :: EventControllerFocus -> EventControllerFocus -> Bool

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

GObject EventControllerFocus

Defined in GI.Gtk.Objects.EventControllerFocus

ManagedPtrNewtype EventControllerFocus

Defined in GI.Gtk.Objects.EventControllerFocus

Methods

toManagedPtr :: EventControllerFocus -> ManagedPtr EventControllerFocus

TypedObject EventControllerFocus

Defined in GI.Gtk.Objects.EventControllerFocus

Methods

glibType :: IO GType

HasParentTypes EventControllerFocus

Defined in GI.Gtk.Objects.EventControllerFocus

IsGValue (Maybe EventControllerFocus)

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

Defined in GI.Gtk.Objects.EventControllerFocus

Methods

gvalueGType_ :: IO GType

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

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

type ParentTypes EventControllerFocus

Defined in GI.Gtk.Objects.EventControllerFocus

type ParentTypes EventControllerFocus = '[EventController, Object]

class (GObject o, IsDescendantOf EventControllerFocus o) => IsEventControllerFocus o

Type class for types which can be safely cast to EventControllerFocus, for instance with toEventControllerFocus.

Instances

(GObject o, IsDescendantOf EventControllerFocus o) => IsEventControllerFocus o

Defined in GI.Gtk.Objects.EventControllerFocus

toEventControllerFocus :: (MonadIO m, IsEventControllerFocus o) => o -> m EventControllerFocus

Cast to EventControllerFocus, 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

bindProperty, bindPropertyFull, containsFocus, forceFloating, freezeNotify, getv, isFloating, isFocus, notify, notifyByPspec, ref, refSink, reset, runDispose, stealData, stealQdata, thawNotify, unref, watchClosure.

Getters

getCurrentEvent, getCurrentEventDevice, getCurrentEventState, getCurrentEventTime, getData, getName, getPropagationLimit, getPropagationPhase, getProperty, getQdata, getWidget.

Setters

setData, setDataFull, setName, setPropagationLimit, setPropagationPhase, setProperty.

containsFocus

eventControllerFocusContainsFocus

Arguments

:: (HasCallStack, MonadIO m, IsEventControllerFocus a)

=> a

self: a EventControllerFocus

-> m Bool

Returns: True if focus is within self or one of its children

Returns the value of the GtkEventControllerFocus:contains-focus property.

isFocus

eventControllerFocusIsFocus

Arguments

:: (HasCallStack, MonadIO m, IsEventControllerFocus a)

=> a

self: a EventControllerFocus

-> m Bool

Returns: True if focus is within self but not one of its children

Returns the value of the GtkEventControllerFocus:is-focus property.

new

eventControllerFocusNew

Arguments

:: (HasCallStack, MonadIO m)

=> m EventControllerFocus

Returns: a new EventControllerFocus

Creates a new event controller that will handle focus events.

Properties

containsFocus

Whether focus is contain in the controllers widget. See See EventControllerFocus:is-focus for whether the focus is in the widget itself or inside a descendent.

When handling focus events, this property is updated before enter or leave are emitted.

getEventControllerFocusContainsFocus :: (MonadIO m, IsEventControllerFocus o) => o -> m Bool

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

get eventControllerFocus #containsFocus

isFocus

Whether focus is in the controllers widget itself, opposed to in a descendent widget. See also EventControllerFocus:contains-focus.

When handling focus events, this property is updated before enter or leave are emitted.

getEventControllerFocusIsFocus :: (MonadIO m, IsEventControllerFocus o) => o -> m Bool

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

get eventControllerFocus #isFocus

Signals

enter

type C_EventControllerFocusEnterCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type EventControllerFocusEnterCallback = IO ()

This signal is emitted whenever the focus enters into the widget or one of its descendents.

Note that this means you may not get an enter signal even though the widget becomes the focus location, in certain cases (such as when the focus moves from a descendent of the widget to the widget itself). If you are interested in these cases, you can monitor the EventControllerFocus:is-focus property for changes.

afterEventControllerFocusEnter :: (IsEventControllerFocus a, MonadIO m) => a -> EventControllerFocusEnterCallback -> m SignalHandlerId

Connect a signal handler for the enter signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after eventControllerFocus #enter callback

genClosure_EventControllerFocusEnter :: MonadIO m => EventControllerFocusEnterCallback -> m (GClosure C_EventControllerFocusEnterCallback)

Wrap the callback into a GClosure.

mk_EventControllerFocusEnterCallback :: C_EventControllerFocusEnterCallback -> IO (FunPtr C_EventControllerFocusEnterCallback)

Generate a function pointer callable from C code, from a C_EventControllerFocusEnterCallback.

noEventControllerFocusEnterCallback :: Maybe EventControllerFocusEnterCallback

A convenience synonym for Nothing :: Maybe EventControllerFocusEnterCallback.

onEventControllerFocusEnter :: (IsEventControllerFocus a, MonadIO m) => a -> EventControllerFocusEnterCallback -> m SignalHandlerId

Connect a signal handler for the enter signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on eventControllerFocus #enter callback

wrap_EventControllerFocusEnterCallback :: EventControllerFocusEnterCallback -> C_EventControllerFocusEnterCallback

Wrap a EventControllerFocusEnterCallback into a C_EventControllerFocusEnterCallback.

leave

type C_EventControllerFocusLeaveCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type EventControllerFocusLeaveCallback = IO ()

This signal is emitted whenever the focus leaves the widget hierarchy that is rooted at the widget that the controller is attached to.

Note that this means you may not get a leave signal even though the focus moves away from the widget, in certain cases (such as when the focus moves from the widget to a descendent). If you are interested in these cases, you can monitor the EventControllerFocus:is-focus property for changes.

afterEventControllerFocusLeave :: (IsEventControllerFocus a, MonadIO m) => a -> EventControllerFocusLeaveCallback -> m SignalHandlerId

Connect a signal handler for the leave signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after eventControllerFocus #leave callback

genClosure_EventControllerFocusLeave :: MonadIO m => EventControllerFocusLeaveCallback -> m (GClosure C_EventControllerFocusLeaveCallback)

Wrap the callback into a GClosure.

mk_EventControllerFocusLeaveCallback :: C_EventControllerFocusLeaveCallback -> IO (FunPtr C_EventControllerFocusLeaveCallback)

Generate a function pointer callable from C code, from a C_EventControllerFocusLeaveCallback.

noEventControllerFocusLeaveCallback :: Maybe EventControllerFocusLeaveCallback

A convenience synonym for Nothing :: Maybe EventControllerFocusLeaveCallback.

onEventControllerFocusLeave :: (IsEventControllerFocus a, MonadIO m) => a -> EventControllerFocusLeaveCallback -> m SignalHandlerId

Connect a signal handler for the leave signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on eventControllerFocus #leave callback

wrap_EventControllerFocusLeaveCallback :: EventControllerFocusLeaveCallback -> C_EventControllerFocusLeaveCallback

Wrap a EventControllerFocusLeaveCallback into a C_EventControllerFocusLeaveCallback.