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 object signal handler = liftIO $ connectSignal signal object handler 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 object signal handler = liftIO $ connectSignal signal object handler 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

info ~ ResolveSignal slot object => IsLabel slot (SignalProxy object info)

Defined in Data.GI.Base.Signals

Methods

fromLabel :: SignalProxy object info

info ~ ResolveSignal slot object => IsLabelProxy slot (SignalProxy object info)

Support for overloaded labels.

Defined in Data.GI.Base.Signals

Methods

fromLabelProxy :: Proxy slot -> SignalProxy object info

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)

Defined in Data.GI.Base.Signals

Associated Types

type HaskellCallbackType (GObjectNotifySignalInfo propName) :: Type

Methods

connectSignal :: GObject o => SignalProxy o (GObjectNotifySignalInfo propName) -> o -> HaskellCallbackType (GObjectNotifySignalInfo propName) -> SignalConnectMode -> IO SignalHandlerId

data GObjectNotifySignalInfo (propName :: Symbol)

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

Instances

KnownSymbol propName => SignalInfo (GObjectNotifySignalInfo propName)

Defined in Data.GI.Base.Signals

Associated Types

type HaskellCallbackType (GObjectNotifySignalInfo propName) :: Type

Methods

connectSignal :: GObject o => SignalProxy o (GObjectNotifySignalInfo propName) -> o -> HaskellCallbackType (GObjectNotifySignalInfo propName) -> SignalConnectMode -> IO SignalHandlerId

type HaskellCallbackType (GObjectNotifySignalInfo propName)

Defined in Data.GI.Base.Signals

type HaskellCallbackType (GObjectNotifySignalInfo propName)