{-# LINE 1 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LANGUAGE ScopedTypeVariables #-} {-# LINE 2 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- -*-haskell-*- {-# LINE 5 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 6 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- GIMP Toolkit (GTK) GDK Event information in a Monad -- -- Author : Axel Simon -- -- Created 12 October 2008 -- -- Copyright (C) 2008 Axel Simon -- -- This library is free software; you can redistribute it and/or -- modify it under the terms of the GNU Lesser General Public -- License as published by the Free Software Foundation; either -- version 2.1 of the License, or (at your option) any later version. -- -- This library is distributed in the hope that it will be useful, -- but WITHOUT ANY WARRANTY; without even the implied warranty of -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -- Lesser General Public License for more details. -- -- #prune -- | -- Maintainer : gtk2hs-users\@lists.sourceforge.net -- Stability : provisional -- Portability : portable (depends on GHC) -- -- Types and accessors to examine information in events. -- module Graphics.UI.Gtk.Gdk.EventM ( -- * Detail -- -- | This modules provides a monad that encapsulates the information in an -- event. -- -- The events a widget can receive are defined in -- "Graphics.UI.Gtk.Abstract.Widget#7". Every event carries additional -- information which is accessible through functions in the 'EventM' monad. -- For instance, every event is associated with a -- 'Graphics.UI.Gtk.Gdk.DrawWindow.DrawWindow' which is accessed using the -- 'eventWindow' accessor function. Other information is only available in -- one specific event. For example, the -- area that has to be redrawn, accessed by 'eventArea' is only available in -- the 'Graphics.UI.Gtk.Abstract.Widget.exposeEvent'. Indeed, you can only -- call 'eventArea' if the first type parameter of 'EventM' is the phantom -- type 'EExpose'. (A phantom type is a type for which no values exist and -- which is only used to enforce certain constraints on the usage of -- functions such as 'eventArea'.) Some information is available in several -- but not all events. In order to express these constraints the module -- defines type classes whose names start with @Has...@ but which are not -- exported, implying that no new instance can be created. (They could be -- called phantom type classes.) For instance, the mouse pointer coordinates -- can be retrieved using the function 'eventCoordinates' which requires -- that the first type parameter of 'EventM' is in the class -- 'HasCoordinates'. The module supplies instance of class 'HasCoordinates' -- for the types 'EButton', 'ECrossing', 'EMotion' and 'EScroll'. Thus for -- all events that require an 'EventM' action with one of the types above, -- the accessor function 'eventCoordinates' may be used. -- -- Note that an event handler must always returns @True@ if the event -- was handled or @False@ if the event should be dealt with by another -- event handler. For instance, a handler for a key press should return -- @False@ if the pressed key is not one of those that the widget reacts -- to. In this case the event is passed to the parent widgets. This -- ensures that pressing, say, @Alt-F@ opens the file menu even if the -- current input focus is in a text entry widget. In order to facilitate -- writing handlers that may abort handling an event, this module provides -- the function 'tryEvent'. This function catches pattern match exceptions -- and returns @False@. If the signal successfully runs to its end, it -- returns @True@. A typical use is as follows: -- -- > widget `on` keyPressEvent $ tryEvent $ do -- > [Control] <- eventModifier -- > "Return" <- eventKeyName -- > liftIO $ putStrLn "Ctrl-Return pressed" -- -- The rationale is that the action will throw an exception if the -- two event functions 'eventModifier' and 'eventKeyName' return something -- else than what is stated in -- the pattern. When no exception is thrown, execution continues to -- the last statement where the event is processed, here we merely -- print a message. Note that the return -- value of this statement must be @()@ since 'tryEvent' always -- assumes that the -- function handeled the event if no exception is thrown. A handler -- wrapped by 'tryEvent' can also indicate that it cannot handle the -- given event by calling 'stopEvent'. -- -- Finally, not that the 'EventM' monad wraps the @IO@ monad. As such -- you can (and usually have to) use @liftIO@ to execute @IO@ functions. -- -- * Event monad and type tags EventM, EAny, EKey, EButton, EScroll, EMotion, EExpose, EVisibility, ECrossing, EFocus, EConfigure, EProperty, EProximity, EWindowState, {-# LINE 113 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} EOwnerChange, {-# LINE 115 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 116 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} EGrabBroken, {-# LINE 118 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- * Accessor functions for event information eventWindow, eventSent, eventCoordinates, eventRootCoordinates, eventModifier, eventModifierAll, eventTime, eventKeyVal, eventKeyName, eventHardwareKeycode, eventKeyboardGroup, MouseButton(..), eventButton, Click(..), eventClick, ScrollDirection(..), eventScrollDirection, eventIsHint, {-# LINE 139 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} eventRequestMotions, {-# LINE 141 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} eventArea, eventRegion, VisibilityState(..), eventVisibilityState, CrossingMode(..), eventCrossingMode, NotifyType(..), eventNotifyType, eventCrossingFocus, eventFocusIn, eventPosition, eventSize, eventProperty, WindowState(..), eventWindowStateChanged, eventWindowState, {-# LINE 158 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} OwnerChange(..), eventChangeReason, eventSelection, eventSelectionTime, {-# LINE 163 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 164 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} eventKeyboardGrab, eventImplicit, eventGrabWindow, {-# LINE 168 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- * Auxilliary Definitions Modifier(..), -- a mask of control keys TimeStamp, currentTime, tryEvent, stopEvent, ) where import Prelude hiding (catch) import System.Glib.FFI import System.Glib.Flags import System.Glib.GObject ( makeNewGObject ) import Graphics.UI.Gtk.Gdk.Keys (KeyVal, KeyCode, keyName) import Graphics.UI.Gtk.Gdk.Region (Region, makeNewRegion) import Graphics.UI.Gtk.Gdk.Enums (Modifier(..), VisibilityState(..), CrossingMode(..), NotifyType(..), WindowState(..), ScrollDirection(..), {-# LINE 186 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} OwnerChange(..) {-# LINE 188 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} ) import Graphics.UI.Gtk.General.Enums (MouseButton(..), Click(..)) import Graphics.UI.Gtk.General.Structs (Rectangle(..)) import Graphics.UI.Gtk.General.DNDTypes (Atom(..), SelectionTag) import Graphics.UI.Gtk.Types ( DrawWindow, mkDrawWindow ) import Data.Bits ((.|.), (.&.), testBit, shiftL, shiftR) import Data.Maybe (catMaybes) import Data.List (isPrefixOf) import Control.Monad.Reader ( ReaderT, ask, runReaderT ) import Control.Monad.Trans ( liftIO ) import Control.Monad ( liftM ) {-# LINE 201 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} import Control.Exception ( Handler(..) , PatternMatchFail(..) , catches, throw ) import System.IO.Error (isUserError, ioeGetErrorString) {-# LINE 209 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | A monad providing access to data in an event. -- type EventM t a = ReaderT (Ptr t) IO a -- | A tag for events that do not carry any event-specific information. data EAny = EAny -- | A tag for /key/ events. data EKey = EKey -- | A tag for /Button/ events. data EButton = EButton -- | A tag for /Scroll/ events. data EScroll = EScroll -- | A tag for /Motion/ events. data EMotion = EMotion -- | A tag for /Expose/ events. data EExpose = EExpose -- | A tag for /Visibility/ events. data EVisibility = EVisibility -- | A tag for /Crossing/ events. data ECrossing = ECrossing -- | A tag for /Focus/ events. data EFocus = EFocus -- | A tag for /Configure/ events. data EConfigure = EConfigure -- | A tag for /Property/ events. data EProperty = EProperty -- | A tag for /Proximity/ events. data EProximity = EProximity -- | A tag for /WindowState/ event. data EWindowState = EWindowState {-# LINE 255 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | A tag for /OwnerChange/ events. data EOwnerChange = EOwnerChange {-# LINE 258 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 261 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | A tag for /GrabBroken/ events. data EGrabBroken = EGrabBroken {-# LINE 264 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Retrieve the 'Graphics.UI.Gtk.Gdk.DrawWindow.DrawWindow' that this -- event relates to. eventWindow :: EventM any DrawWindow eventWindow = do ptr <- ask liftIO $ makeNewGObject mkDrawWindow ((\hsc_ptr -> peekByteOff hsc_ptr 4) ptr) {-# LINE 271 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query if this event was sent sent explicitly by the application -- (rather than being generated by human interaction). eventSent :: EventM any Bool eventSent = do ptr <- ask liftIO $ (\hsc_ptr -> peekByteOff hsc_ptr 8) ptr {-# LINE 278 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} class HasCoordinates a instance HasCoordinates EButton instance HasCoordinates EScroll instance HasCoordinates EMotion instance HasCoordinates ECrossing -- | Retrieve the @(x,y)@ coordinates of the mouse. eventCoordinates :: HasCoordinates t => EventM t (Double, Double) eventCoordinates = do ptr <- ask liftIO $ do (ty :: Int32) <- peek (castPtr ptr) {-# LINE 291 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} if ty `elem` [ 4, {-# LINE 292 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 5, {-# LINE 293 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 6, {-# LINE 294 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 7] then do {-# LINE 295 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 16) ptr {-# LINE 296 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 24) ptr {-# LINE 297 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else if ty `elem` [ 31 ] then do {-# LINE 299 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 16) ptr {-# LINE 300 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 24) ptr {-# LINE 301 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else if ty `elem` [ 3 ] then do {-# LINE 303 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 16) ptr {-# LINE 304 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 24) ptr {-# LINE 305 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else if ty `elem` [ 10, {-# LINE 307 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 11] then do {-# LINE 308 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 20) ptr {-# LINE 309 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 28) ptr {-# LINE 310 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else error ("eventCoordinates: none for event type "++show ty) class HasRootCoordinates a instance HasRootCoordinates EButton instance HasRootCoordinates EScroll instance HasRootCoordinates EMotion instance HasRootCoordinates ECrossing -- | Retrieve the @(x,y)@ coordinates of the mouse relative to the -- root (origin) of the screen. eventRootCoordinates :: HasRootCoordinates t => EventM t (Double, Double) eventRootCoordinates = do ptr <- ask liftIO $ do (ty :: Int32) <- peek (castPtr ptr) {-# LINE 326 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} if ty `elem` [ 4, {-# LINE 327 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 5, {-# LINE 328 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 6, {-# LINE 329 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 7] then do {-# LINE 330 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 48) ptr {-# LINE 331 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 56) ptr {-# LINE 332 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else if ty `elem` [ 31 ] then do {-# LINE 334 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 44) ptr {-# LINE 335 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 52) ptr {-# LINE 336 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else if ty `elem` [ 3 ] then do {-# LINE 338 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 48) ptr {-# LINE 339 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 56) ptr {-# LINE 340 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else if ty `elem` [ 10, {-# LINE 342 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 11] then do {-# LINE 343 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (x :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 36) ptr {-# LINE 344 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Double) <- (\hsc_ptr -> peekByteOff hsc_ptr 44) ptr {-# LINE 345 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (realToFrac x, realToFrac y) else error ("eventRootCoordinates: none for event type "++show ty) class HasModifier a instance HasModifier EKey instance HasModifier EButton instance HasModifier EScroll instance HasModifier EMotion instance HasModifier ECrossing -- | Query the modifier keys that were depressed when the event happened. -- Sticky modifiers such as CapsLock are omitted in the return value. -- Use 'eventModifierAll' your application requires all modifiers. -- eventModifier :: HasModifier t => EventM t [Modifier] eventModifier = eM False -- | Query the modifier keys that were depressed when the event happened. -- The result includes sticky modifiers such as CapsLock. Normally, -- 'eventModifier' is more appropriate in applications. -- eventModifierAll :: HasModifier t => EventM t [Modifier] eventModifierAll = eM True foreign import ccall safe "gtk_accelerator_get_default_mod_mask" defModMask :: Word32 {-# LINE 371 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} eM allModifs = do let mask | allModifs = -1 | otherwise = defModMask ptr <- ask liftIO $ do (ty :: Int32) <- peek (castPtr ptr) {-# LINE 378 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} if ty `elem` [ 8, {-# LINE 379 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 9] then do {-# LINE 380 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (modif ::Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 16) ptr {-# LINE 381 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (toFlags (fromIntegral (modif .&. mask))) else if ty `elem` [ 4, {-# LINE 383 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 5, {-# LINE 384 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 6, {-# LINE 385 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 7] then do {-# LINE 386 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (modif ::Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 36) ptr {-# LINE 387 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (toFlags (fromIntegral (modif .&. mask))) else if ty `elem` [ 31 ] then do {-# LINE 389 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (modif ::Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 32) ptr {-# LINE 390 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (toFlags (fromIntegral (modif .&. mask))) else if ty `elem` [ 3 ] then do {-# LINE 392 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (modif ::Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 36) ptr {-# LINE 393 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (toFlags (fromIntegral (modif .&. mask))) else if ty `elem` [ 10, {-# LINE 395 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 11] then do {-# LINE 396 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (modif ::Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 64) ptr {-# LINE 397 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (toFlags (fromIntegral (modif .&. mask))) else error ("eventModifiers: none for event type "++show ty) class HasTime a instance HasTime EKey instance HasTime EButton instance HasTime EScroll instance HasTime EMotion instance HasTime ECrossing instance HasTime EProperty instance HasTime EProximity {-# LINE 409 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} instance HasTime EOwnerChange {-# LINE 411 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | The time (in milliseconds) when an event happened. This is used mostly -- for ordering events and responses to events. -- type TimeStamp = Word32 -- TODO: make this a newtype -- | Represents the current time, and can be used anywhere a time is expected. currentTime :: TimeStamp currentTime = 0 {-# LINE 421 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query the time when the event occurred. eventTime :: HasTime t => EventM t TimeStamp eventTime = do ptr <- ask liftIO $ do (ty :: Int32) <- peek (castPtr ptr) {-# LINE 428 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} if ty `elem` [ 8, {-# LINE 429 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 9] then do {-# LINE 430 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 12) ptr {-# LINE 431 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) else if ty `elem` [ 4, {-# LINE 433 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 5, {-# LINE 434 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 6, {-# LINE 435 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 7] then do {-# LINE 436 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 12) ptr {-# LINE 437 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) else if ty `elem` [ 31 ] then do {-# LINE 439 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 12) ptr {-# LINE 440 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) else if ty `elem` [ 3 ] then do {-# LINE 442 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 12) ptr {-# LINE 443 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) else if ty `elem` [ 10, {-# LINE 445 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 11] then do {-# LINE 446 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 16) ptr {-# LINE 447 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) else if ty `elem` [ 16 ] then do {-# LINE 449 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 16) ptr {-# LINE 450 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) else if ty `elem` [ 20, {-# LINE 452 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 21] then do {-# LINE 453 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 12) ptr {-# LINE 454 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) {-# LINE 456 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} else if ty `elem` [ 34 ] then do {-# LINE 457 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (time :: Word32) <- (\hsc_ptr -> peekByteOff hsc_ptr 24) ptr {-# LINE 458 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral time) {-# LINE 460 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} else error ("eventModifiers: none for event type "++show ty) -- | The key value. See 'Graphics.UI.Gtk.Gdk.Keys.KeyVal'. eventKeyVal :: EventM EKey KeyVal eventKeyVal = ask >>= \ptr -> liftIO $ liftM fromIntegral ((\hsc_ptr -> peekByteOff hsc_ptr 20) ptr :: IO Word32) {-# LINE 466 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | The key value as a string. See 'Graphics.UI.Gtk.Gdk.Keys.KeyVal'. eventKeyName :: EventM EKey String eventKeyName = liftM keyName $ eventKeyVal -- | The hardware key code. eventHardwareKeycode :: EventM EKey KeyCode eventHardwareKeycode = ask >>= \ptr -> liftIO $ liftM fromIntegral ((\hsc_ptr -> peekByteOff hsc_ptr 32) ptr :: IO Word16) {-# LINE 475 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | The keyboard group. eventKeyboardGroup :: EventM EKey Word8 eventKeyboardGroup = ask >>= \ptr -> liftIO $ liftM fromIntegral ((\hsc_ptr -> peekByteOff hsc_ptr 34) ptr :: IO Word8) {-# LINE 480 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query the mouse buttons. eventButton :: EventM EButton MouseButton eventButton = ask >>= \ptr -> liftIO $ liftM (toEnum . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 40) ptr :: IO Word32) {-# LINE 485 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} --- | Query the mouse click. eventClick :: EventM EButton Click eventClick = do ptr <- ask liftIO $ do (ty :: Int32) <- peek (castPtr ptr) {-# LINE 492 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} case ty of 4 -> return SingleClick {-# LINE 494 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 5 -> return DoubleClick {-# LINE 495 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 6 -> return TripleClick {-# LINE 496 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} 7 -> return ReleaseClick {-# LINE 497 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} _ -> error ("eventClick: non for event type "++show ty) -- | Query the direction of scrolling. eventScrollDirection :: EventM EScroll ScrollDirection eventScrollDirection = ask >>= \ptr -> liftIO $ liftM (toEnum . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 36) ptr :: IO Word32) {-# LINE 503 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Check if the motion event is only a hint rather than the full mouse -- movement information. eventIsHint :: EventM EMotion Bool eventIsHint = ask >>= \ptr -> liftIO $ liftM toBool ((\hsc_ptr -> peekByteOff hsc_ptr 40) ptr :: IO Int16) {-# LINE 509 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 511 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Request more motion notifies if this event is a motion notify hint event. -- -- This action should be used instead of 'drawWindowGetPointer' to request -- further motion notifies, because it also works for extension events where -- motion notifies are provided for devices other than the core pointer. -- -- Coordinate extraction, processing and requesting more motion events from a -- 'motionNotifyEvent' usually works like this: -- -- > on widget motionNotifyEvent $ do -- > (x, y) <- eventCoordinates -- > -- handle the x,y motion: -- > ... -- > -- finally, notify that we are ready to get more motion events: -- > eventRequestMotions -- eventRequestMotions :: EventM EMotion () eventRequestMotions = ask >>= \ptr -> liftIO $ gdk_event_request_motions ptr foreign import ccall "gdk_event_request_motions" gdk_event_request_motions :: Ptr EMotion -> IO () {-# LINE 534 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query a bounding box of the region that needs to be updated. eventArea :: EventM EExpose Rectangle eventArea = ask >>= \ptr -> liftIO $ ((\hsc_ptr -> peekByteOff hsc_ptr 12) ptr :: IO Rectangle) {-# LINE 539 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query the region that needs to be updated. eventRegion :: EventM EExpose Region eventRegion = ask >>= \ptr -> liftIO $ do (reg_ :: Ptr Region) <- (\hsc_ptr -> peekByteOff hsc_ptr 28) ptr {-# LINE 544 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} reg_ <- gdk_region_copy reg_ makeNewRegion reg_ foreign import ccall "gdk_region_copy" gdk_region_copy :: Ptr Region -> IO (Ptr Region) -- | Get the visibility status of a window. eventVisibilityState :: EventM EVisibility VisibilityState eventVisibilityState = ask >>= \ptr -> liftIO $ liftM (toEnum . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 12) ptr :: IO Word32) {-# LINE 554 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Get the mode of the mouse cursor crossing a window. eventCrossingMode :: EventM ECrossing CrossingMode eventCrossingMode = ask >>= \ptr -> liftIO $ liftM (toEnum . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 52) ptr :: IO Word32) {-# LINE 559 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Get the notify type of the mouse cursor crossing a window. eventNotifyType :: EventM ECrossing NotifyType eventNotifyType = ask >>= \ptr -> liftIO $ liftM (toEnum . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 56) ptr :: IO Word32) {-# LINE 564 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query if the window has the focus or is an inferior window. eventCrossingFocus :: EventM ECrossing Bool eventCrossingFocus = ask >>= \ptr -> liftIO $ liftM toBool ((\hsc_ptr -> peekByteOff hsc_ptr 60) ptr :: IO Int32) {-# LINE 569 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query if a window gained focus (@True@) or lost the focus (@False@). eventFocusIn :: EventM EFocus Bool eventFocusIn = ask >>= \ptr -> liftIO $ liftM toBool ((\hsc_ptr -> peekByteOff hsc_ptr 10) ptr :: IO Int16) {-# LINE 574 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Get the @(x,y)@ position of the window within the parent window. eventPosition :: EventM EConfigure (Int,Int) eventPosition = ask >>= \ptr -> liftIO $ do (x :: Int32) <- (\hsc_ptr -> peekByteOff hsc_ptr 12) ptr {-# LINE 579 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Int32) <- (\hsc_ptr -> peekByteOff hsc_ptr 16) ptr {-# LINE 580 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral x, fromIntegral y) -- | Get the new size of the window as @(width,height)@. eventSize :: EventM EConfigure (Int,Int) eventSize = ask >>= \ptr -> liftIO $ do (x :: Int32) <- (\hsc_ptr -> peekByteOff hsc_ptr 20) ptr {-# LINE 586 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} (y :: Int32) <- (\hsc_ptr -> peekByteOff hsc_ptr 24) ptr {-# LINE 587 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} return (fromIntegral x, fromIntegral y) eventProperty :: EventM EProperty Atom eventProperty = ask >>= \ptr -> liftIO $ liftM Atom ((\hsc_ptr -> peekByteOff hsc_ptr 12) ptr :: IO (Ptr ())) {-# LINE 592 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query which window state bits have changed. eventWindowStateChanged :: EventM EWindowState [WindowState] eventWindowStateChanged = ask >>= \ptr -> liftIO $ liftM (toFlags . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 12) ptr :: IO Word32) {-# LINE 597 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query the new window state. eventWindowState :: EventM EWindowState [WindowState] eventWindowState = ask >>= \ptr -> liftIO $ liftM (toFlags . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 16) ptr :: IO Word32) {-# LINE 602 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 604 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query why a seleciton changed its owner. eventChangeReason :: EventM EOwnerChange OwnerChange eventChangeReason = ask >>= \ptr -> liftIO $ liftM (toEnum . fromIntegral) ((\hsc_ptr -> peekByteOff hsc_ptr 16) ptr :: IO Word32) {-# LINE 608 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query what selection changed its owner. eventSelection :: EventM EOwnerChange SelectionTag eventSelection = ask >>= \ptr -> liftIO $ liftM Atom ((\hsc_ptr -> peekByteOff hsc_ptr 20) ptr :: IO (Ptr ())) {-# LINE 613 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Query the time when the selection was taken over. eventSelectionTime :: EventM EOwnerChange TimeStamp eventSelectionTime = ask >>= \ptr -> liftIO $ liftM fromIntegral ((\hsc_ptr -> peekByteOff hsc_ptr 28) ptr :: IO (Word32)) {-# LINE 618 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 619 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 621 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Check if a keyboard (@True@) or a mouse pointer grap (@False@) was -- broken. eventKeyboardGrab :: EventM EGrabBroken Bool eventKeyboardGrab = ask >>= \ptr -> liftIO $ liftM toBool ((\hsc_ptr -> peekByteOff hsc_ptr 12) ptr :: IO Int32) {-# LINE 626 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Check if a grab was broken implicitly. eventImplicit :: EventM EGrabBroken Bool eventImplicit = ask >>= \ptr -> liftIO $ liftM toBool ((\hsc_ptr -> peekByteOff hsc_ptr 16) ptr :: IO Int32) {-# LINE 631 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Get the new window that owns the grab or @Nothing@ if the window -- is not part of this application. eventGrabWindow :: EventM EGrabBroken (Maybe DrawWindow) eventGrabWindow = do ptr <- ask liftIO $ maybeNull (makeNewGObject mkDrawWindow) ((\hsc_ptr -> peekByteOff hsc_ptr 4) ptr) {-# LINE 638 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} {-# LINE 639 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Execute an event handler and assume it handled the event unless it -- threw a pattern match exception or calls mzero (e.g. via guard). tryEvent :: EventM any () -> EventM any Bool tryEvent act = do ptr <- ask liftIO $ (runReaderT (act >> return True) ptr) {-# LINE 648 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} `catches` [ Handler (\ (PatternMatchFail _) -> return False) , Handler (\ e -> if isUserError e && ("Pattern" `isPrefixOf` ioeGetErrorString e || "mzero" == ioeGetErrorString e) then return False else throw e) ] {-# LINE 664 "Graphics/UI/Gtk/Gdk/EventM.hsc" #-} -- | Explicitly stop the handling of an event. This function should only be -- called inside a handler that is wrapped with 'tryEvent'. (It merely -- throws a bogus pattern matching error which 'tryEvent' interprets as if -- the handler does not handle the event.) stopEvent :: EventM any () stopEvent = liftIO $ throw (PatternMatchFail "EventM.stopEvent called explicitly")