<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ -->
<title>dist/build/Graphics/UI/Gtk/General/General.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>-- GENERATED by C->Haskell Compiler, version 0.13.4 (gtk2hs branch) "Bin IO", 13 Nov 2004 (Haskell)</span>
<a name="line-2"></a><span class='hs-comment'>-- Edit the ORIGNAL .chs file instead!</span>
<a name="line-3"></a>
<a name="line-4"></a>
<a name="line-5"></a><span class='hs-comment'>{-# LINE 1 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-6"></a><span class='hs-comment'>-- -*-haskell-*-</span>
<a name="line-7"></a><span class='hs-comment'>-- GIMP Toolkit (GTK) General</span>
<a name="line-8"></a><span class='hs-comment'>--</span>
<a name="line-9"></a><span class='hs-comment'>-- Author : Axel Simon, Manuel M. T. Chakravarty</span>
<a name="line-10"></a><span class='hs-comment'>--</span>
<a name="line-11"></a><span class='hs-comment'>-- Created: 8 December 1998</span>
<a name="line-12"></a><span class='hs-comment'>--</span>
<a name="line-13"></a><span class='hs-comment'>-- Copyright (C) 2000..2005 Axel Simon, Manuel M. T. Chakravarty</span>
<a name="line-14"></a><span class='hs-comment'>--</span>
<a name="line-15"></a><span class='hs-comment'>-- This library is free software; you can redistribute it and/or</span>
<a name="line-16"></a><span class='hs-comment'>-- modify it under the terms of the GNU Lesser General Public</span>
<a name="line-17"></a><span class='hs-comment'>-- License as published by the Free Software Foundation; either</span>
<a name="line-18"></a><span class='hs-comment'>-- version 2.1 of the License, or (at your option) any later version.</span>
<a name="line-19"></a><span class='hs-comment'>--</span>
<a name="line-20"></a><span class='hs-comment'>-- This library is distributed in the hope that it will be useful,</span>
<a name="line-21"></a><span class='hs-comment'>-- but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="line-22"></a><span class='hs-comment'>-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="line-23"></a><span class='hs-comment'>-- Lesser General Public License for more details.</span>
<a name="line-24"></a><span class='hs-comment'>--</span>
<a name="line-25"></a><span class='hs-comment'>-- TODO</span>
<a name="line-26"></a><span class='hs-comment'>--</span>
<a name="line-27"></a><span class='hs-comment'>-- quitAddDestroy, quitAdd, quitRemove</span>
<a name="line-28"></a><span class='hs-comment'>--</span>
<a name="line-29"></a><span class='hs-comment'>-- |</span>
<a name="line-30"></a><span class='hs-comment'>-- Maintainer : gtk2hs-users@lists.sourceforge.net</span>
<a name="line-31"></a><span class='hs-comment'>-- Stability : provisional</span>
<a name="line-32"></a><span class='hs-comment'>-- Portability : portable (depends on GHC)</span>
<a name="line-33"></a><span class='hs-comment'>--</span>
<a name="line-34"></a><span class='hs-comment'>-- library initialization, main event loop, and events</span>
<a name="line-35"></a><span class='hs-comment'>--</span>
<a name="line-36"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>General</span><span class='hs-varop'>.</span><span class='hs-conid'>General</span> <span class='hs-layout'>(</span>
<a name="line-37"></a><span class='hs-comment'>-- getDefaultLanguage,</span>
<a name="line-38"></a> <span class='hs-comment'>-- * Initialisation</span>
<a name="line-39"></a> <span class='hs-varid'>initGUI</span><span class='hs-layout'>,</span>
<a name="line-40"></a>
<a name="line-41"></a> <span class='hs-comment'>-- ** Support for OS threads</span>
<a name="line-42"></a> <span class='hs-varid'>unsafeInitGUIForThreadedRTS</span><span class='hs-layout'>,</span>
<a name="line-43"></a> <span class='hs-varid'>postGUISync</span><span class='hs-layout'>,</span>
<a name="line-44"></a> <span class='hs-varid'>postGUIAsync</span><span class='hs-layout'>,</span>
<a name="line-45"></a> <span class='hs-varid'>threadsEnter</span><span class='hs-layout'>,</span>
<a name="line-46"></a> <span class='hs-varid'>threadsLeave</span><span class='hs-layout'>,</span>
<a name="line-47"></a>
<a name="line-48"></a> <span class='hs-comment'>-- * Main event loop</span>
<a name="line-49"></a> <span class='hs-varid'>mainGUI</span><span class='hs-layout'>,</span>
<a name="line-50"></a> <span class='hs-varid'>mainQuit</span><span class='hs-layout'>,</span>
<a name="line-51"></a>
<a name="line-52"></a> <span class='hs-comment'>-- ** Less commonly used event loop functions</span>
<a name="line-53"></a> <span class='hs-varid'>eventsPending</span><span class='hs-layout'>,</span>
<a name="line-54"></a> <span class='hs-varid'>mainLevel</span><span class='hs-layout'>,</span>
<a name="line-55"></a> <span class='hs-varid'>mainIteration</span><span class='hs-layout'>,</span>
<a name="line-56"></a> <span class='hs-varid'>mainIterationDo</span><span class='hs-layout'>,</span>
<a name="line-57"></a> <span class='hs-varid'>mainDoEvent</span><span class='hs-layout'>,</span>
<a name="line-58"></a>
<a name="line-59"></a> <span class='hs-comment'>-- * Grab widgets</span>
<a name="line-60"></a> <span class='hs-varid'>grabAdd</span><span class='hs-layout'>,</span>
<a name="line-61"></a> <span class='hs-varid'>grabGetCurrent</span><span class='hs-layout'>,</span>
<a name="line-62"></a> <span class='hs-varid'>grabRemove</span><span class='hs-layout'>,</span>
<a name="line-63"></a>
<a name="line-64"></a> <span class='hs-comment'>-- * Timeout and idle callbacks</span>
<a name="line-65"></a> <span class='hs-conid'>Priority</span><span class='hs-layout'>,</span>
<a name="line-66"></a> <span class='hs-varid'>priorityLow</span><span class='hs-layout'>,</span>
<a name="line-67"></a> <span class='hs-varid'>priorityDefaultIdle</span><span class='hs-layout'>,</span>
<a name="line-68"></a> <span class='hs-varid'>priorityHighIdle</span><span class='hs-layout'>,</span>
<a name="line-69"></a> <span class='hs-varid'>priorityDefault</span><span class='hs-layout'>,</span>
<a name="line-70"></a> <span class='hs-varid'>priorityHigh</span><span class='hs-layout'>,</span>
<a name="line-71"></a> <span class='hs-varid'>timeoutAdd</span><span class='hs-layout'>,</span>
<a name="line-72"></a> <span class='hs-varid'>timeoutAddFull</span><span class='hs-layout'>,</span>
<a name="line-73"></a> <span class='hs-varid'>timeoutRemove</span><span class='hs-layout'>,</span>
<a name="line-74"></a> <span class='hs-varid'>idleAdd</span><span class='hs-layout'>,</span>
<a name="line-75"></a> <span class='hs-varid'>idleRemove</span><span class='hs-layout'>,</span>
<a name="line-76"></a> <span class='hs-varid'>inputAdd</span><span class='hs-layout'>,</span>
<a name="line-77"></a> <span class='hs-varid'>inputRemove</span><span class='hs-layout'>,</span>
<a name="line-78"></a> <span class='hs-conid'>IOCondition</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span>
<a name="line-79"></a> <span class='hs-conid'>HandlerId</span><span class='hs-layout'>,</span>
<a name="line-80"></a> <span class='hs-conid'>FD</span>
<a name="line-81"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-82"></a>
<a name="line-83"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Environment</span> <span class='hs-layout'>(</span><span class='hs-varid'>getProgName</span><span class='hs-layout'>,</span> <span class='hs-varid'>getArgs</span><span class='hs-layout'>)</span>
<a name="line-84"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span> <span class='hs-layout'>(</span><span class='hs-varid'>liftM</span><span class='hs-layout'>,</span> <span class='hs-varid'>mapM</span><span class='hs-layout'>,</span> <span class='hs-varid'>when</span><span class='hs-layout'>)</span>
<a name="line-85"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Concurrent</span> <span class='hs-layout'>(</span><span class='hs-varid'>rtsSupportsBoundThreads</span><span class='hs-layout'>,</span> <span class='hs-varid'>newEmptyMVar</span><span class='hs-layout'>,</span>
<a name="line-86"></a> <span class='hs-varid'>putMVar</span><span class='hs-layout'>,</span> <span class='hs-varid'>takeMVar</span><span class='hs-layout'>)</span>
<a name="line-87"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>IORef</span> <span class='hs-layout'>(</span><span class='hs-conid'>IORef</span><span class='hs-layout'>,</span> <span class='hs-varid'>newIORef</span><span class='hs-layout'>,</span> <span class='hs-varid'>readIORef</span><span class='hs-layout'>,</span> <span class='hs-varid'>writeIORef</span><span class='hs-layout'>)</span>
<a name="line-88"></a>
<a name="line-89"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>FFI</span>
<a name="line-90"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>UTFString</span>
<a name="line-91"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>MainLoop</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>ML</span>
<a name="line-92"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>MainLoop</span> <span class='hs-layout'>(</span> <span class='hs-conid'>Priority</span><span class='hs-layout'>,</span> <span class='hs-varid'>priorityLow</span><span class='hs-layout'>,</span> <span class='hs-varid'>priorityDefaultIdle</span><span class='hs-layout'>,</span>
<a name="line-93"></a> <span class='hs-varid'>priorityHighIdle</span><span class='hs-layout'>,</span> <span class='hs-varid'>priorityDefault</span><span class='hs-layout'>,</span> <span class='hs-varid'>priorityHigh</span><span class='hs-layout'>,</span> <span class='hs-varid'>timeoutRemove</span><span class='hs-layout'>,</span> <span class='hs-varid'>idleRemove</span><span class='hs-layout'>,</span>
<a name="line-94"></a> <span class='hs-varid'>inputRemove</span><span class='hs-layout'>,</span> <span class='hs-conid'>IOCondition</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>HandlerId</span> <span class='hs-layout'>)</span>
<a name="line-95"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>Abstract</span><span class='hs-varop'>.</span><span class='hs-conid'>Object</span> <span class='hs-layout'>(</span><span class='hs-varid'>makeNewObject</span><span class='hs-layout'>)</span>
<a name="line-96"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>Gdk</span><span class='hs-varop'>.</span><span class='hs-conid'>EventM</span> <span class='hs-layout'>(</span><span class='hs-conid'>EventM</span><span class='hs-layout'>)</span>
<a name="line-97"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Reader</span> <span class='hs-layout'>(</span><span class='hs-varid'>ask</span><span class='hs-layout'>)</span>
<a name="line-98"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Trans</span> <span class='hs-layout'>(</span><span class='hs-varid'>liftIO</span><span class='hs-layout'>)</span>
<a name="line-99"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>UI</span><span class='hs-varop'>.</span><span class='hs-conid'>Gtk</span><span class='hs-varop'>.</span><span class='hs-conid'>Types</span>
<a name="line-100"></a><span class='hs-comment'>{-# LINE 94 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-101"></a>
<a name="line-102"></a>
<a name="line-103"></a><span class='hs-comment'>{-# LINE 96 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-104"></a>
<a name="line-105"></a><span class='hs-comment'>{-
<a name="line-106"></a>-- | Retreive the current language.
<a name="line-107"></a>-- * This function returns a String which's pointer can be used later on for
<a name="line-108"></a>-- comarisions.
<a name="line-109"></a>--
<a name="line-110"></a>--getDefaultLanguage :: IO String
<a name="line-111"></a>--getDefaultLanguage = do
<a name="line-112"></a>-- strPtr <- {#call unsafe get_default_language#}
<a name="line-113"></a>-- str <- peekUTFString strPtr
<a name="line-114"></a>-- destruct strPtr
<a name="line-115"></a>-- return str
<a name="line-116"></a>-}</span>
<a name="line-117"></a>
<a name="line-118"></a><a name="unsafeInitGUIForThreadedRTS"></a><span class='hs-definition'>unsafeInitGUIForThreadedRTS</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>initGUI</span>
<a name="line-119"></a>
<a name="line-120"></a><a name="initGUI"></a><span class='hs-comment'>-- We compile this module using -#includ"gtk/wingtk.h" to bypass the win32 abi</span>
<a name="line-121"></a><span class='hs-comment'>-- check however we do not compile users programs with this header so if</span>
<a name="line-122"></a><span class='hs-comment'>-- initGUI was ever inlined in a users program, then that program would not</span>
<a name="line-123"></a><span class='hs-comment'>-- bypass the abi check and would fail on startup. So to stop that we must</span>
<a name="line-124"></a><span class='hs-comment'>-- prevent initGUI from being inlined.</span>
<a name="line-125"></a><span class='hs-comment'>{-# NOINLINE initGUI #-}</span>
<a name="line-126"></a><span class='hs-comment'>-- | Initialize the GUI.</span>
<a name="line-127"></a><span class='hs-comment'>--</span>
<a name="line-128"></a><span class='hs-comment'>-- This must be called before any other function in the Gtk2Hs library.</span>
<a name="line-129"></a><span class='hs-comment'>--</span>
<a name="line-130"></a><span class='hs-comment'>-- This function initializes the GUI toolkit and parses all Gtk</span>
<a name="line-131"></a><span class='hs-comment'>-- specific arguments. The remaining arguments are returned. If the</span>
<a name="line-132"></a><span class='hs-comment'>-- initialization of the toolkit fails for whatever reason, an exception</span>
<a name="line-133"></a><span class='hs-comment'>-- is thrown.</span>
<a name="line-134"></a><span class='hs-comment'>--</span>
<a name="line-135"></a><span class='hs-comment'>-- * Throws: @error \"Cannot initialize GUI.\"@</span>
<a name="line-136"></a><span class='hs-comment'>--</span>
<a name="line-137"></a><span class='hs-comment'>--</span>
<a name="line-138"></a><span class='hs-comment'>-- * If you want to use Gtk2Hs and in a multi-threaded application then it is your obligation</span>
<a name="line-139"></a><span class='hs-comment'>-- to ensure that all calls to Gtk+ happen in a single OS thread.</span>
<a name="line-140"></a><span class='hs-comment'>-- If you want to make calls to Gtk2Hs functions from a Haskell thread other</span>
<a name="line-141"></a><span class='hs-comment'>-- than the one that calls this functions and 'mainGUI' then you will have to</span>
<a name="line-142"></a><span class='hs-comment'>-- \'post\' your GUI actions to the main GUI thread. You can do this using</span>
<a name="line-143"></a><span class='hs-comment'>-- 'postGUISync' or 'postGUIAsync'. See also 'threadsEnter'.</span>
<a name="line-144"></a><span class='hs-comment'>--</span>
<a name="line-145"></a><span class='hs-definition'>initGUI</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>String</span><span class='hs-keyglyph'>]</span>
<a name="line-146"></a><span class='hs-definition'>initGUI</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-147"></a> <span class='hs-varid'>when</span> <span class='hs-varid'>rtsSupportsBoundThreads</span> <span class='hs-varid'>initialiseGThreads</span>
<a name="line-148"></a> <span class='hs-comment'>-- note: initizliseGThreads calls 'threadsEnter'</span>
<a name="line-149"></a> <span class='hs-varid'>prog</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getProgName</span>
<a name="line-150"></a> <span class='hs-varid'>args</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getArgs</span>
<a name="line-151"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>allArgs</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>prog</span><span class='hs-conop'>:</span><span class='hs-varid'>args</span><span class='hs-layout'>)</span>
<a name="line-152"></a> <span class='hs-varid'>withMany</span> <span class='hs-varid'>withUTFString</span> <span class='hs-varid'>allArgs</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>addrs</span> <span class='hs-keyglyph'>-></span>
<a name="line-153"></a> <span class='hs-varid'>withArrayLen</span> <span class='hs-varid'>addrs</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>argc</span> <span class='hs-varid'>argv</span> <span class='hs-keyglyph'>-></span>
<a name="line-154"></a> <span class='hs-varid'>with</span> <span class='hs-varid'>argv</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>argvp</span> <span class='hs-keyglyph'>-></span>
<a name="line-155"></a> <span class='hs-varid'>with</span> <span class='hs-varid'>argc</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>argcp</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-156"></a> <span class='hs-varid'>res</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>gtk_init_check</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>argcp</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>argvp</span><span class='hs-layout'>)</span>
<a name="line-157"></a> <span class='hs-keyword'>if</span> <span class='hs-layout'>(</span><span class='hs-varid'>toBool</span> <span class='hs-varid'>res</span><span class='hs-layout'>)</span> <span class='hs-keyword'>then</span> <span class='hs-keyword'>do</span>
<a name="line-158"></a> <span class='hs-varid'>argc'</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>argcp</span>
<a name="line-159"></a> <span class='hs-varid'>argv'</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peek</span> <span class='hs-varid'>argvp</span>
<a name="line-160"></a> <span class='hs-keyword'>_</span><span class='hs-conop'>:</span><span class='hs-varid'>addrs'</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>peekArray</span> <span class='hs-varid'>argc'</span> <span class='hs-varid'>argv'</span> <span class='hs-comment'>-- drop the program name</span>
<a name="line-161"></a> <span class='hs-varid'>mapM</span> <span class='hs-varid'>peekUTFString</span> <span class='hs-varid'>addrs'</span>
<a name="line-162"></a> <span class='hs-keyword'>else</span> <span class='hs-varid'>error</span> <span class='hs-str'>"Cannot initialize GUI."</span>
<a name="line-163"></a>
<a name="line-164"></a><span class='hs-comment'>-- g_thread_init aborts the whole program if it's called more than once so</span>
<a name="line-165"></a><span class='hs-comment'>-- we've got to keep track of whether or not we've called it already. Sigh.</span>
<a name="line-166"></a><span class='hs-comment'>--</span>
<a name="line-167"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-str'>"hsgthread.h gtk2hs_threads_initialise"</span>
<a name="line-168"></a> <span class='hs-varid'>initialiseGThreads</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-169"></a>
<a name="line-170"></a><a name="postGUISync"></a><span class='hs-comment'>-- | Post an action to be run in the main GUI thread.</span>
<a name="line-171"></a><span class='hs-comment'>--</span>
<a name="line-172"></a><span class='hs-comment'>-- The current thread blocks until the action completes and the result is</span>
<a name="line-173"></a><span class='hs-comment'>-- returned.</span>
<a name="line-174"></a><span class='hs-comment'>--</span>
<a name="line-175"></a><span class='hs-definition'>postGUISync</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-varid'>a</span>
<a name="line-176"></a><span class='hs-definition'>postGUISync</span> <span class='hs-varid'>action</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-177"></a> <span class='hs-varid'>resultVar</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>newEmptyMVar</span>
<a name="line-178"></a> <span class='hs-varid'>idleAdd</span> <span class='hs-layout'>(</span><span class='hs-varid'>action</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>putMVar</span> <span class='hs-varid'>resultVar</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-conid'>False</span><span class='hs-layout'>)</span> <span class='hs-varid'>priorityDefault</span>
<a name="line-179"></a> <span class='hs-varid'>takeMVar</span> <span class='hs-varid'>resultVar</span>
<a name="line-180"></a>
<a name="line-181"></a><a name="postGUIAsync"></a><span class='hs-comment'>-- | Post an action to be run in the main GUI thread.</span>
<a name="line-182"></a><span class='hs-comment'>--</span>
<a name="line-183"></a><span class='hs-comment'>-- The current thread continues and does not wait for the result of the</span>
<a name="line-184"></a><span class='hs-comment'>-- action.</span>
<a name="line-185"></a><span class='hs-comment'>--</span>
<a name="line-186"></a><span class='hs-definition'>postGUIAsync</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-187"></a><span class='hs-definition'>postGUIAsync</span> <span class='hs-varid'>action</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-188"></a> <span class='hs-varid'>idleAdd</span> <span class='hs-layout'>(</span><span class='hs-varid'>action</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-conid'>False</span><span class='hs-layout'>)</span> <span class='hs-varid'>priorityDefault</span>
<a name="line-189"></a> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-190"></a>
<a name="line-191"></a><a name="threadsEnter"></a><span class='hs-comment'>-- | Acquire the global Gtk lock.</span>
<a name="line-192"></a><span class='hs-comment'>--</span>
<a name="line-193"></a><span class='hs-comment'>-- * During normal operation, this lock is held by the thread from which all</span>
<a name="line-194"></a><span class='hs-comment'>-- interaction with Gtk is performed. When calling 'mainGUI', the thread will</span>
<a name="line-195"></a><span class='hs-comment'>-- release this global lock before it waits for user interaction. During this</span>
<a name="line-196"></a><span class='hs-comment'>-- time it is, in principle, possible to use a different OS thread (any other</span>
<a name="line-197"></a><span class='hs-comment'>-- Haskell thread that is bound to the Gtk OS thread will be blocked anyway)</span>
<a name="line-198"></a><span class='hs-comment'>-- to interact with Gtk by explicitly acquiring the lock, calling Gtk functions</span>
<a name="line-199"></a><span class='hs-comment'>-- and releasing the lock. However, the Gtk functions that are called from this</span>
<a name="line-200"></a><span class='hs-comment'>-- different thread may not trigger any calls to the OS since this will</span>
<a name="line-201"></a><span class='hs-comment'>-- lead to a crash on Windows (the Win32 API can only be used from a single</span>
<a name="line-202"></a><span class='hs-comment'>-- thread). Since it is very hard to tell which function only interacts on</span>
<a name="line-203"></a><span class='hs-comment'>-- Gtk data structures and which function call actual OS functions, it</span>
<a name="line-204"></a><span class='hs-comment'>-- is best not to use this feature at all. A better way to perform updates</span>
<a name="line-205"></a><span class='hs-comment'>-- in the background is to spawn a Haskell thread and to perform the update</span>
<a name="line-206"></a><span class='hs-comment'>-- to Gtk widgets using 'postGUIAsync' or 'postGUISync'. These will execute</span>
<a name="line-207"></a><span class='hs-comment'>-- their arguments from the main loop, that is, from the OS thread of Gtk,</span>
<a name="line-208"></a><span class='hs-comment'>-- thereby ensuring that any Gtk and OS function can be called.</span>
<a name="line-209"></a><span class='hs-comment'>--</span>
<a name="line-210"></a><span class='hs-definition'>threadsEnter</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-211"></a><span class='hs-definition'>threadsEnter</span> <span class='hs-keyglyph'>=</span>
<a name="line-212"></a> <span class='hs-varid'>threadsEnter'_</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>res</span> <span class='hs-keyglyph'>-></span>
<a name="line-213"></a> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-214"></a><span class='hs-comment'>{-# LINE 203 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-215"></a>
<a name="line-216"></a><a name="threadsLeave"></a><span class='hs-comment'>-- | Release the global Gtk lock.</span>
<a name="line-217"></a><span class='hs-comment'>--</span>
<a name="line-218"></a><span class='hs-comment'>-- * The use of this function is not recommended. See 'threadsEnter'.</span>
<a name="line-219"></a><span class='hs-comment'>--</span>
<a name="line-220"></a><span class='hs-definition'>threadsLeave</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-221"></a><span class='hs-definition'>threadsLeave</span> <span class='hs-keyglyph'>=</span>
<a name="line-222"></a> <span class='hs-varid'>threadsLeave'_</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>res</span> <span class='hs-keyglyph'>-></span>
<a name="line-223"></a> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span>
<a name="line-224"></a><span class='hs-comment'>{-# LINE 209 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-225"></a>
<a name="line-226"></a><a name="eventsPending"></a><span class='hs-comment'>-- | Inquire the number of events pending on the event queue</span>
<a name="line-227"></a><span class='hs-comment'>--</span>
<a name="line-228"></a><span class='hs-definition'>eventsPending</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Int</span>
<a name="line-229"></a><span class='hs-definition'>eventsPending</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftM</span> <span class='hs-varid'>fromIntegral</span> <span class='hs-varid'>gtk_events_pending</span>
<a name="line-230"></a><span class='hs-comment'>{-# LINE 214 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-231"></a>
<a name="line-232"></a><a name="mainGUI"></a><span class='hs-comment'>-- | Run the Gtk+ main event loop.</span>
<a name="line-233"></a><span class='hs-comment'>--</span>
<a name="line-234"></a><span class='hs-definition'>mainGUI</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-235"></a><span class='hs-definition'>mainGUI</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>gtk_main</span>
<a name="line-236"></a><span class='hs-comment'>{-# LINE 219 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-237"></a>
<a name="line-238"></a><a name="mainLevel"></a><span class='hs-comment'>-- | Inquire the main loop level.</span>
<a name="line-239"></a><span class='hs-comment'>--</span>
<a name="line-240"></a><span class='hs-comment'>-- * Callbacks that take more time to process can call 'mainIteration' to keep</span>
<a name="line-241"></a><span class='hs-comment'>-- the GUI responsive. Each time the main loop is restarted this way, the main</span>
<a name="line-242"></a><span class='hs-comment'>-- loop counter is increased. This function returns this counter.</span>
<a name="line-243"></a><span class='hs-comment'>--</span>
<a name="line-244"></a><span class='hs-definition'>mainLevel</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Int</span>
<a name="line-245"></a><span class='hs-definition'>mainLevel</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftM</span> <span class='hs-layout'>(</span><span class='hs-varid'>toEnum</span><span class='hs-varop'>.</span><span class='hs-varid'>fromEnum</span><span class='hs-layout'>)</span> <span class='hs-varid'>gtk_main_level</span>
<a name="line-246"></a><span class='hs-comment'>{-# LINE 228 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-247"></a>
<a name="line-248"></a><a name="mainQuit"></a><span class='hs-comment'>-- | Exit the main event loop.</span>
<a name="line-249"></a><span class='hs-comment'>--</span>
<a name="line-250"></a><span class='hs-definition'>mainQuit</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-251"></a><span class='hs-definition'>mainQuit</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>gtk_main_quit</span>
<a name="line-252"></a><span class='hs-comment'>{-# LINE 233 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-253"></a>
<a name="line-254"></a><a name="mainIteration"></a><span class='hs-comment'>-- | Process an event, block if necessary.</span>
<a name="line-255"></a><span class='hs-comment'>--</span>
<a name="line-256"></a><span class='hs-comment'>-- * Returns @True@ if 'mainQuit' was called while processing the event.</span>
<a name="line-257"></a><span class='hs-comment'>--</span>
<a name="line-258"></a><span class='hs-definition'>mainIteration</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Bool</span>
<a name="line-259"></a><span class='hs-definition'>mainIteration</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>liftM</span> <span class='hs-varid'>toBool</span> <span class='hs-varid'>gtk_main_iteration</span>
<a name="line-260"></a><span class='hs-comment'>{-# LINE 240 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-261"></a>
<a name="line-262"></a><a name="mainIterationDo"></a><span class='hs-comment'>-- | Process a single event.</span>
<a name="line-263"></a><span class='hs-comment'>--</span>
<a name="line-264"></a><span class='hs-comment'>-- * Called with @True@, this function behaves as 'mainIteration' in that it</span>
<a name="line-265"></a><span class='hs-comment'>-- waits until an event is available for processing. It will return</span>
<a name="line-266"></a><span class='hs-comment'>-- immediately, if passed @False@.</span>
<a name="line-267"></a><span class='hs-comment'>--</span>
<a name="line-268"></a><span class='hs-comment'>-- * Returns @True@ if the 'mainQuit' was called while processing the event.</span>
<a name="line-269"></a><span class='hs-comment'>--</span>
<a name="line-270"></a><span class='hs-definition'>mainIterationDo</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Bool</span>
<a name="line-271"></a><span class='hs-definition'>mainIterationDo</span> <span class='hs-varid'>blocking</span> <span class='hs-keyglyph'>=</span>
<a name="line-272"></a> <span class='hs-varid'>liftM</span> <span class='hs-varid'>toBool</span> <span class='hs-varop'>$</span> <span class='hs-varid'>gtk_main_iteration_do</span> <span class='hs-layout'>(</span><span class='hs-varid'>fromBool</span> <span class='hs-varid'>blocking</span><span class='hs-layout'>)</span>
<a name="line-273"></a>
<a name="line-274"></a><a name="mainDoEvent"></a><span class='hs-comment'>-- | Processes a single GDK event. This is public only to allow filtering of events between GDK and</span>
<a name="line-275"></a><span class='hs-comment'>-- GTK+. You will not usually need to call this function directly.</span>
<a name="line-276"></a><span class='hs-comment'>-- </span>
<a name="line-277"></a><span class='hs-comment'>-- While you should not call this function directly, you might want to know how exactly events are</span>
<a name="line-278"></a><span class='hs-comment'>-- handled. So here is what this function does with the event:</span>
<a name="line-279"></a><span class='hs-comment'>-- </span>
<a name="line-280"></a><span class='hs-comment'>-- 1. Compress enter/leave notify events. If the event passed build an enter/leave pair together with</span>
<a name="line-281"></a><span class='hs-comment'>-- the next event (peeked from GDK) both events are thrown away. This is to avoid a backlog of</span>
<a name="line-282"></a><span class='hs-comment'>-- (de-)highlighting widgets crossed by the pointer.</span>
<a name="line-283"></a><span class='hs-comment'>-- </span>
<a name="line-284"></a><span class='hs-comment'>-- 2. Find the widget which got the event. If the widget can't be determined the event is thrown away</span>
<a name="line-285"></a><span class='hs-comment'>-- unless it belongs to a INCR transaction. In that case it is passed to</span>
<a name="line-286"></a><span class='hs-comment'>-- 'selectionIncrEvent'.</span>
<a name="line-287"></a><span class='hs-comment'>-- </span>
<a name="line-288"></a><span class='hs-comment'>-- 3. Then the event is passed on a stack so you can query the currently handled event with</span>
<a name="line-289"></a><span class='hs-comment'>-- 'getCurrentEvent'.</span>
<a name="line-290"></a><span class='hs-comment'>-- </span>
<a name="line-291"></a><span class='hs-comment'>-- 4. The event is sent to a widget. If a grab is active all events for widgets that are not in the</span>
<a name="line-292"></a><span class='hs-comment'>-- contained in the grab widget are sent to the latter with a few exceptions:</span>
<a name="line-293"></a><span class='hs-comment'>-- </span>
<a name="line-294"></a><span class='hs-comment'>-- * Deletion and destruction events are still sent to the event widget for obvious reasons.</span>
<a name="line-295"></a><span class='hs-comment'>-- </span>
<a name="line-296"></a><span class='hs-comment'>-- * Events which directly relate to the visual representation of the event widget.</span>
<a name="line-297"></a><span class='hs-comment'>-- </span>
<a name="line-298"></a><span class='hs-comment'>-- * Leave events are delivered to the event widget if there was an enter event delivered to it</span>
<a name="line-299"></a><span class='hs-comment'>-- before without the paired leave event.</span>
<a name="line-300"></a><span class='hs-comment'>-- </span>
<a name="line-301"></a><span class='hs-comment'>-- * Drag events are not redirected because it is unclear what the semantics of that would be.</span>
<a name="line-302"></a><span class='hs-comment'>-- </span>
<a name="line-303"></a><span class='hs-comment'>-- Another point of interest might be that all key events are first passed through the key snooper</span>
<a name="line-304"></a><span class='hs-comment'>-- functions if there are any. Read the description of 'keySnooperInstall' if you need this</span>
<a name="line-305"></a><span class='hs-comment'>-- feature.</span>
<a name="line-306"></a><span class='hs-comment'>-- </span>
<a name="line-307"></a><span class='hs-comment'>-- 5. After finishing the delivery the event is popped from the event stack.</span>
<a name="line-308"></a><span class='hs-definition'>mainDoEvent</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>EventM</span> <span class='hs-varid'>t</span> <span class='hs-conid'>()</span>
<a name="line-309"></a><span class='hs-definition'>mainDoEvent</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-310"></a> <span class='hs-varid'>ptr</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>ask</span>
<a name="line-311"></a> <span class='hs-varid'>liftIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>gtk_main_do_event</span> <span class='hs-layout'>(</span><span class='hs-varid'>castPtr</span> <span class='hs-varid'>ptr</span><span class='hs-layout'>)</span>
<a name="line-312"></a>
<a name="line-313"></a><a name="grabAdd"></a><span class='hs-comment'>-- | add a grab widget</span>
<a name="line-314"></a><span class='hs-comment'>--</span>
<a name="line-315"></a><span class='hs-definition'>grabAdd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>WidgetClass</span> <span class='hs-varid'>wd</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>wd</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-316"></a><span class='hs-definition'>grabAdd</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-layout'>(</span><span class='hs-conid'>Widget</span> <span class='hs-varid'>arg1</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>arg1</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>argPtr1</span> <span class='hs-keyglyph'>-></span><span class='hs-varid'>gtk_grab_add</span> <span class='hs-varid'>argPtr1</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>toWidget</span>
<a name="line-317"></a>
<a name="line-318"></a><a name="grabGetCurrent"></a><span class='hs-comment'>-- | inquire current grab widget</span>
<a name="line-319"></a><span class='hs-comment'>--</span>
<a name="line-320"></a><span class='hs-definition'>grabGetCurrent</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-conid'>Widget</span><span class='hs-layout'>)</span>
<a name="line-321"></a><span class='hs-definition'>grabGetCurrent</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-322"></a> <span class='hs-varid'>wPtr</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>gtk_grab_get_current</span>
<a name="line-323"></a><span class='hs-comment'>{-# LINE 302 "./Graphics/UI/Gtk/General/General.chs" #-}</span>
<a name="line-324"></a> <span class='hs-keyword'>if</span> <span class='hs-layout'>(</span><span class='hs-varid'>wPtr</span><span class='hs-varop'>==</span><span class='hs-varid'>nullPtr</span><span class='hs-layout'>)</span> <span class='hs-keyword'>then</span> <span class='hs-varid'>return</span> <span class='hs-conid'>Nothing</span> <span class='hs-keyword'>else</span>
<a name="line-325"></a> <span class='hs-varid'>liftM</span> <span class='hs-conid'>Just</span> <span class='hs-varop'>$</span> <span class='hs-varid'>makeNewObject</span> <span class='hs-varid'>mkWidget</span> <span class='hs-layout'>(</span><span class='hs-varid'>return</span> <span class='hs-varid'>wPtr</span><span class='hs-layout'>)</span>
<a name="line-326"></a>
<a name="line-327"></a><a name="grabRemove"></a><span class='hs-comment'>-- | remove a grab widget</span>
<a name="line-328"></a><span class='hs-comment'>--</span>
<a name="line-329"></a><span class='hs-definition'>grabRemove</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>WidgetClass</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-330"></a><span class='hs-definition'>grabRemove</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>\</span><span class='hs-layout'>(</span><span class='hs-conid'>Widget</span> <span class='hs-varid'>arg1</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>withForeignPtr</span> <span class='hs-varid'>arg1</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>argPtr1</span> <span class='hs-keyglyph'>-></span><span class='hs-varid'>gtk_grab_remove</span> <span class='hs-varid'>argPtr1</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>toWidget</span>
<a name="line-331"></a>
<a name="line-332"></a><a name="timeoutAdd"></a><span class='hs-comment'>-- | Sets a function to be called at regular intervals, with the default</span>
<a name="line-333"></a><span class='hs-comment'>-- priority 'priorityDefault'. The function is called repeatedly until it</span>
<a name="line-334"></a><span class='hs-comment'>-- returns @False@, after which point the timeout function will not be called</span>
<a name="line-335"></a><span class='hs-comment'>-- again. The first call to the function will be at the end of the first interval.</span>
<a name="line-336"></a><span class='hs-comment'>--</span>
<a name="line-337"></a><span class='hs-comment'>-- Note that timeout functions may be delayed, due to the processing of other</span>
<a name="line-338"></a><span class='hs-comment'>-- event sources. Thus they should not be relied on for precise timing. After</span>
<a name="line-339"></a><span class='hs-comment'>-- each call to the timeout function, the time of the next timeout is</span>
<a name="line-340"></a><span class='hs-comment'>-- recalculated based on the current time and the given interval (it does not</span>
<a name="line-341"></a><span class='hs-comment'>-- try to 'catch up' time lost in delays).</span>
<a name="line-342"></a><span class='hs-comment'>--</span>
<a name="line-343"></a><span class='hs-comment'>-- This function differs from 'ML.timeoutAdd' in that the action will</span>
<a name="line-344"></a><span class='hs-comment'>-- be executed within the global Gtk+ lock. It is therefore possible to</span>
<a name="line-345"></a><span class='hs-comment'>-- call Gtk+ functions from the action.</span>
<a name="line-346"></a><span class='hs-comment'>--</span>
<a name="line-347"></a><span class='hs-definition'>timeoutAdd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>HandlerId</span>
<a name="line-348"></a><span class='hs-definition'>timeoutAdd</span> <span class='hs-varid'>fun</span> <span class='hs-varid'>msec</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>timeoutAddFull</span> <span class='hs-varid'>fun</span> <span class='hs-varid'>priorityDefault</span> <span class='hs-varid'>msec</span>
<a name="line-349"></a>
<a name="line-350"></a><a name="timeoutAddFull"></a><span class='hs-comment'>-- | Sets a function to be called at regular intervals, with the given</span>
<a name="line-351"></a><span class='hs-comment'>-- priority. The function is called repeatedly until it returns @False@, after</span>
<a name="line-352"></a><span class='hs-comment'>-- which point the timeout function will not be called again. The first call</span>
<a name="line-353"></a><span class='hs-comment'>-- to the function will be at the end of the first interval.</span>
<a name="line-354"></a><span class='hs-comment'>--</span>
<a name="line-355"></a><span class='hs-comment'>-- Note that timeout functions may be delayed, due to the processing of other</span>
<a name="line-356"></a><span class='hs-comment'>-- event sources. Thus they should not be relied on for precise timing. After</span>
<a name="line-357"></a><span class='hs-comment'>-- each call to the timeout function, the time of the next timeout is</span>
<a name="line-358"></a><span class='hs-comment'>-- recalculated based on the current time and the given interval (it does not</span>
<a name="line-359"></a><span class='hs-comment'>-- try to 'catch up' time lost in delays).</span>
<a name="line-360"></a><span class='hs-comment'>--</span>
<a name="line-361"></a><span class='hs-comment'>-- This function differs from 'ML.timeoutAddFull' in that the action will</span>
<a name="line-362"></a><span class='hs-comment'>-- be executed within the global Gtk+ lock. It is therefore possible to</span>
<a name="line-363"></a><span class='hs-comment'>-- call Gtk+ functions from the action.</span>
<a name="line-364"></a><span class='hs-comment'>--</span>
<a name="line-365"></a><span class='hs-definition'>timeoutAddFull</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Priority</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>HandlerId</span>
<a name="line-366"></a><span class='hs-definition'>timeoutAddFull</span> <span class='hs-varid'>fun</span> <span class='hs-varid'>pri</span> <span class='hs-varid'>msec</span> <span class='hs-keyglyph'>=</span>
<a name="line-367"></a> <span class='hs-conid'>ML</span><span class='hs-varop'>.</span><span class='hs-varid'>timeoutAddFull</span> <span class='hs-layout'>(</span><span class='hs-varid'>threadsEnter</span> <span class='hs-varop'>>></span> <span class='hs-varid'>fun</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>r</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>threadsLeave</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span>
<a name="line-368"></a> <span class='hs-varid'>pri</span> <span class='hs-varid'>msec</span>
<a name="line-369"></a>
<a name="line-370"></a><a name="idleAdd"></a><span class='hs-comment'>-- | Add a callback that is called whenever the system is idle.</span>
<a name="line-371"></a><span class='hs-comment'>--</span>
<a name="line-372"></a><span class='hs-comment'>-- * A priority can be specified via an integer. This should usually be</span>
<a name="line-373"></a><span class='hs-comment'>-- 'priorityDefaultIdle'.</span>
<a name="line-374"></a><span class='hs-comment'>--</span>
<a name="line-375"></a><span class='hs-comment'>-- * If the function returns @False@ it will be removed.</span>
<a name="line-376"></a><span class='hs-comment'>--</span>
<a name="line-377"></a><span class='hs-comment'>-- This function differs from 'ML.idleAdd' in that the action will</span>
<a name="line-378"></a><span class='hs-comment'>-- be executed within the global Gtk+ lock. It is therefore possible to</span>
<a name="line-379"></a><span class='hs-comment'>-- call Gtk+ functions from the action.</span>
<a name="line-380"></a><span class='hs-comment'>--</span>
<a name="line-381"></a><span class='hs-definition'>idleAdd</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Bool</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Priority</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>HandlerId</span>
<a name="line-382"></a><span class='hs-definition'>idleAdd</span> <span class='hs-varid'>fun</span> <span class='hs-varid'>pri</span> <span class='hs-keyglyph'>=</span>
<a name="line-383"></a> <span class='hs-conid'>ML</span><span class='hs-varop'>.</span><span class='hs-varid'>idleAdd</span> <span class='hs-layout'>(</span><span class='hs-varid'>threadsEnter</span> <span class='hs-varop'>>></span> <span class='hs-varid'>fun</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>r</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>threadsLeave</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span> <span class='hs-varid'>pri</span>
<a name="line-384"></a>
<a name="line-385"></a><a name="FD"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>FD</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Int</span>
<a name="line-386"></a>
<a name="line-387"></a><a name="inputAdd"></a><span class='hs-comment'>-- | Adds the file descriptor into the main event loop with the given priority.</span>
<a name="line-388"></a><span class='hs-comment'>--</span>
<a name="line-389"></a><span class='hs-comment'>-- This function differs from 'ML.inputAdd' in that the action will</span>
<a name="line-390"></a><span class='hs-comment'>-- be executed within the global Gtk+ lock. It is therefore possible to</span>
<a name="line-391"></a><span class='hs-comment'>-- call Gtk+ functions from the action.</span>
<a name="line-392"></a><span class='hs-comment'>--</span>
<a name="line-393"></a><span class='hs-definition'>inputAdd</span> <span class='hs-keyglyph'>::</span>
<a name="line-394"></a> <span class='hs-conid'>FD</span> <span class='hs-comment'>-- ^ a file descriptor</span>
<a name="line-395"></a> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>IOCondition</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ the condition to watch for</span>
<a name="line-396"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Priority</span> <span class='hs-comment'>-- ^ the priority of the event source</span>
<a name="line-397"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>Bool</span> <span class='hs-comment'>-- ^ the function to call when the condition is satisfied.</span>
<a name="line-398"></a> <span class='hs-comment'>-- The function should return False if the event source</span>
<a name="line-399"></a> <span class='hs-comment'>-- should be removed.</span>
<a name="line-400"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>HandlerId</span> <span class='hs-comment'>-- ^ the event source id</span>
<a name="line-401"></a><span class='hs-definition'>inputAdd</span> <span class='hs-varid'>fd</span> <span class='hs-varid'>conds</span> <span class='hs-varid'>pri</span> <span class='hs-varid'>fun</span> <span class='hs-keyglyph'>=</span>
<a name="line-402"></a> <span class='hs-conid'>ML</span><span class='hs-varop'>.</span><span class='hs-varid'>inputAdd</span> <span class='hs-varid'>fd</span> <span class='hs-varid'>conds</span> <span class='hs-varid'>pri</span> <span class='hs-layout'>(</span><span class='hs-varid'>threadsEnter</span> <span class='hs-varop'>>></span> <span class='hs-varid'>fun</span> <span class='hs-varop'>>>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>r</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>threadsLeave</span> <span class='hs-varop'>>></span> <span class='hs-varid'>return</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span>
<a name="line-403"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"gtk_init_check"</span>
<a name="line-404"></a> <span class='hs-varid'>gtk_init_check</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>CInt</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>CChar</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>CInt</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-405"></a>
<a name="line-406"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"gdk_threads_enter"</span>
<a name="line-407"></a> <span class='hs-varid'>threadsEnter'_</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span>
<a name="line-408"></a>
<a name="line-409"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"gdk_threads_leave"</span>
<a name="line-410"></a> <span class='hs-varid'>threadsLeave'_</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span>
<a name="line-411"></a>
<a name="line-412"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"gtk_events_pending"</span>
<a name="line-413"></a> <span class='hs-varid'>gtk_events_pending</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>CInt</span><span class='hs-layout'>)</span>
<a name="line-414"></a>
<a name="line-415"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_main"</span>
<a name="line-416"></a> <span class='hs-varid'>gtk_main</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span>
<a name="line-417"></a>
<a name="line-418"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"gtk_main_level"</span>
<a name="line-419"></a> <span class='hs-varid'>gtk_main_level</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>CUInt</span><span class='hs-layout'>)</span>
<a name="line-420"></a>
<a name="line-421"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_main_quit"</span>
<a name="line-422"></a> <span class='hs-varid'>gtk_main_quit</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span>
<a name="line-423"></a>
<a name="line-424"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_main_iteration"</span>
<a name="line-425"></a> <span class='hs-varid'>gtk_main_iteration</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>CInt</span><span class='hs-layout'>)</span>
<a name="line-426"></a>
<a name="line-427"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_main_iteration_do"</span>
<a name="line-428"></a> <span class='hs-varid'>gtk_main_iteration_do</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>CInt</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>CInt</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-429"></a>
<a name="line-430"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_main_do_event"</span>
<a name="line-431"></a> <span class='hs-varid'>gtk_main_do_event</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-432"></a>
<a name="line-433"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_grab_add"</span>
<a name="line-434"></a> <span class='hs-varid'>gtk_grab_add</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>Widget</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-435"></a>
<a name="line-436"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_grab_get_current"</span>
<a name="line-437"></a> <span class='hs-varid'>gtk_grab_get_current</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>Widget</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-438"></a>
<a name="line-439"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>safe</span> <span class='hs-str'>"gtk_grab_remove"</span>
<a name="line-440"></a> <span class='hs-varid'>gtk_grab_remove</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>Widget</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
</pre></body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
677c1b5134368504c2e447757584d19e
>
files
>
1022
