Data.GI.Gtk.Threading

Utility functions for threading

Documentation

Utility functions to run IO actions on the GUI thread. You must call setGUIThread or setCurrentThreadAsGUIThread before using the synchronous options, or you risk deadlocking.

Note that the notion of Thread used by this module corresponds to operating system threads, not Haskell threads. A single operating system thread may run multiple Haskell threads, and a Haskell thread may migrate between operating system threads. In order for this nothing of Thread to make sense to a Haskell program, we must be working in a bound Haskell thread, which is tied to a single operating system thread. Haskell's main function is automatically bound, and the postGUI functions will create a new bound thread if nessasary.

setGUIThread :: Thread -> IO ()

Inform gi-gtk-hs what thread is running the gtk main loop.

getGUIThread :: IO (Maybe Thread)

Get the Thread that is running the Gtk main loop, if it has been set.

setCurrentThreadAsGUIThread :: IO ()

Inform gi-gtk-hs that the current thread is, or will be, running the gtk main loop.

Equivalent to threadSelf >>= setGUIThread

postGUISyncWithPriority :: Int32 -> IO a -> IO a

Queue an action to be run in the GTK event loop. If called from the same process as the event loop, this runs the action directly. Otherwise, this queues it in GTK's event loop and blocks until the action is complete

You must call setGUIThread or setCurrentThreadAsGUIThread before this.

Priority is typically between PRIORITY_HIGH_IDLE (100) and PRIORITY_DEFAULT_IDLE (200)

postGUISync :: IO a -> IO a

Queue an action to be run in the GTK event loop. If called from the same process as the event loop, this runs the action directly. Otherwise, this queues it in GTK's event loop and blocks until the action is complete

You must call setGUIThread or setCurrentThreadAsGUIThread before this.

Equivalent to postGUISyncWithPriority PRIORITY_DEFAULT_IDLE

postGUIASyncWithPriority :: Int32 -> IO () -> IO ()

Queue an action to be run in the GTK event loop. This function queues the event regardless of what process it is called from, and returns immidietly.

Priority is typically between PRIORITY_HIGH_IDLE (100) and PRIORITY_DEFAULT_IDLE (200)

postGUIASync :: IO () -> IO ()

Queue an action to be run in the GTK event loop. This function queues the event regardless of what process it is called from, and returns immidietly.

Equivalent to postGUIASyncWithPriority PRIORITY_DEFAULT_IDLE

compareThreads :: Thread -> Thread -> IO Bool

Test if two Threads refer to the same OS thread. A Thread can be gotten from threadSelf. Note that threadSelf only makes sense from a bound thread.

isGUIThread :: IO Bool

Check if the current thread is the Gtk gui thread.

You must call setGUIThread or setCurrentThreadAsGUIThread before this. This only makes sense when called from a bound thread.

threadSelf :: (HasCallStack, MonadIO m) => m Thread

newtype Thread

Constructors

Thread (ManagedPtr Thread)

Instances

BoxedObject Thread

Defined in GI.GLib.Structs.Thread

Methods

boxedType :: Thread -> IO GType

(info ~ ResolveThreadMethod t Thread, MethodInfo info Thread p) => IsLabel t (Thread -> p)

Defined in GI.GLib.Structs.Thread

Methods

fromLabel :: Thread -> p

(info ~ ResolveThreadMethod t Thread, MethodInfo info Thread p) => IsLabelProxy t (Thread -> p)

Defined in GI.GLib.Structs.Thread

Methods

fromLabelProxy :: Proxy t -> Thread -> p

HasAttributeList Thread

Defined in GI.GLib.Structs.Thread

(signature ~ m (Ptr ()), MonadIO m) => MethodInfo ThreadJoinMethodInfo Thread signature

Defined in GI.GLib.Structs.Thread

Methods

overloadedMethod :: MethodProxy ThreadJoinMethodInfo -> Thread -> signature

(signature ~ m Thread, MonadIO m) => MethodInfo ThreadRefMethodInfo Thread signature

Defined in GI.GLib.Structs.Thread

Methods

overloadedMethod :: MethodProxy ThreadRefMethodInfo -> Thread -> signature

(signature ~ m (), MonadIO m) => MethodInfo ThreadUnrefMethodInfo Thread signature

Defined in GI.GLib.Structs.Thread

Methods

overloadedMethod :: MethodProxy ThreadUnrefMethodInfo -> Thread -> signature

type AttributeList Thread

Defined in GI.GLib.Structs.Thread

type AttributeList Thread = ThreadAttributeList