Data.GI.Base.Signals

Routines for connecting GObjects to signals.

Documentation

on :: forall object info m. (GObject object, MonadIO m, SignalInfo info) => object -> SignalProxy object info -> HaskellCallbackType info -> m SignalHandlerId

Same as connectSignal, specifying from the beginning that the handler is to be run before the default handler.

on = connectSignal SignalConnectBefore

after :: forall object info m. (GObject object, MonadIO m, SignalInfo info) => object -> SignalProxy object info -> HaskellCallbackType info -> m SignalHandlerId

Connect a signal to a handler, running the handler after the default one.

after = connectSignal SignalConnectAfter

data SignalProxy object info where

Support for overloaded signal connectors.

Constructors

SignalProxy :: SignalProxy o info

PropertyNotify :: (info ~ ResolveAttribute propName o, AttrInfo info, pl ~ AttrLabel info) => AttrLabelProxy propName -> SignalProxy o (GObjectNotifySignalInfo pl)

Instances

(HasSignal slot object, (~) * info (ResolveSignal slot object)) => IsLabelProxy slot (SignalProxy object info)

Support for overloaded labels.

data SignalConnectMode

Whether to connect a handler to a signal with connectSignal so that it runs before/after the default handler for the given signal.

Constructors

SignalConnectBefore

Run before the default handler.

SignalConnectAfter

Run after the default handler.

connectSignalFunPtr :: GObject o => o -> String -> FunPtr a -> SignalConnectMode -> IO SignalHandlerId

Connect a signal to a handler, given as a FunPtr.

type SignalHandlerId = CULong

Type of a GObject signal handler id.

class SignalInfo info where

Information about an overloaded signal.

Associated Types

type HaskellCallbackType info

Methods

connectSignal :: GObject o => SignalProxy o info -> o -> HaskellCallbackType info -> SignalConnectMode -> IO SignalHandlerId

Connect a Haskell function to a signal of the given GObject, specifying whether the handler will be called before or after the default handler.

Instances

KnownSymbol propName => SignalInfo (GObjectNotifySignalInfo propName)

data GObjectNotifySignalInfo propName

Connection information for a "notify" signal indicating that a specific property changed (see PropertyNotify for the relevant constructor).

Instances

KnownSymbol propName => SignalInfo (GObjectNotifySignalInfo propName)

type HaskellCallbackType (GObjectNotifySignalInfo propName)