Monomer.Main.Handlers

Handlers for WidgetRequests. Functions in this module handle focus, clipboard, overlays and all SystemEvent related operations and updates.

Documentation

type HandlerStep s e = (WidgetEnv s e, WidgetNode s e, Seq (WidgetRequest s e))

Tuple representing the current widget environment, widget root and accumulated WidgetRequests. These requests have already been processed, they are collected for unit testing purposes.

handleSystemEvents

Arguments

:: MonomerM s e m

=> WidgetEnv s e

The initial widget environment.

-> WidgetNode s e

The initial widget root.

-> [SystemEvent]

The starting list of events.

-> m (HandlerStep s e)

The resulting "HandlerStep."

Processes a list of SystemEvents dispatching each of the to the corresponding widget based on the current root. At each step the root may change, new events may be generated (which will be processed interleaved with the list of events) and this is handled before returning the latest HandlerStep.

handleResourcesInit :: MonomerM s e m => m ()

Initializes system resources (currently only icons).

handleWidgetInit :: MonomerM s e m => WidgetEnv s e -> WidgetNode s e -> m (HandlerStep s e)

Initializes a widget (in general, this is called for root).

handleWidgetDispose :: MonomerM s e m => WidgetEnv s e -> WidgetNode s e -> m (HandlerStep s e)

Disposes a widget (in general, this is called for root).

handleWidgetResult :: MonomerM s e m => WidgetEnv s e -> Bool -> WidgetResult s e -> m (HandlerStep s e)

Handles a WidgetResult instance, processing events and requests, and returning an updated HandlerStep.

handleRequests

Arguments

:: MonomerM s e m

=> Seq (WidgetRequest s e)

Requests to process.

-> HandlerStep s e

Initial state/HandlerStep.

-> m (HandlerStep s e)

Updated HandlerStep,

Processes a Seq of WidgetRequest, returning the latest HandlerStep.

handleResizeWidgets

Arguments

:: MonomerM s e m

=> HandlerStep s e

Current state/HandlerStep.

-> m (HandlerStep s e)

Updated state/HandlerStep.

Resizes the current root, and marks the render and resized flags.