Graphics.UI.Sifflet.Callback

Documentation

type CBMgr = CBMgrCmd -> IO ()

The CBMgr (Callback manager) encapsulates (in an enclosure, no less!) an IORef VPUI. It is used *solely* to set up callbacks and similar stuff in Gtk, where the callback needs access to the IORef. By passing a CBMgr to a function, we can avoid passing the IORef directly, and all the harm and confusion that could result.

We only need *one* CBMgr for the application; however, two CBMgrs with the same IORef are logically equivalent, so there would be no harm in having two as long as they share one IORef.

type CBMgrAction = IORef VPUI -> IO ()

data CBMgrCmd

Commands for the CBMgr

Constructors

OnWindowConfigure Window (IORef VPUI -> EventM EConfigure Bool)

OnWindowDestroy Window CBMgrAction

AfterWindowKeyPress Window (IORef VPUI -> EventM EKey Bool)

OnLayoutExpose Layout (IORef VPUI -> EventM EExpose Bool)

OnLayoutMouseMove Layout (IORef VPUI -> EventM EMotion Bool)

OnLayoutButtonPress Layout (IORef VPUI -> EventM EButton Bool)

OnLayoutButtonRelease Layout (IORef VPUI -> EventM EButton Bool)

OnMenuItemActivateLeaf MenuItem (VPUI -> IO VPUI)

OnEntryActivate Entry CBMgrAction

AfterButtonClicked Button CBMgrAction

WithUIRef CBMgrAction

UMTest

mkCBMgr :: IORef VPUI -> CBMgr

Create the CBMgr

data MenuSpec

Constructors

MenuSpec String [MenuItemSpec]

data MenuItemSpec

Constructors

MenuItem String MenuItemAction

SubMenu MenuSpec

type MenuItemAction = VPUI -> IO VPUI

createMenuBar :: [MenuSpec] -> CBMgr -> IO MenuBar

addMenu :: MenuBar -> CBMgr -> MenuSpec -> IO ()

createMenu :: MenuSpec -> CBMgr -> IO Menu

createMenuItem :: Menu -> CBMgr -> MenuItemSpec -> IO ()

modifyIORefIO :: (a -> IO a) -> IORef a -> IO ()

Read an IORef, update with IO, and write the updated value. This is like (flip modifyIORef), but the type of the first argument is (a -> IO a) instead of (a -> a). Note that if a = VPUI, then updateIO :: VPUI -> IO VPUI and consequently modifyIORefIO updateIO :: CBMgrAction.