fltkhs 0.5.1.3 → 0.5.1.4

raw patch · 2 files changed

+13/−8 lines, 2 filesPVP ok

version bump matches the API change (PVP)

API changes (from Hackage documentation)

Files

• fltkhs.cabal +1/−1
• src/Graphics/UI/FLTK/LowLevel/FLTKHS.hs +12/−7

@@ -1,5 +1,5 @@ name : fltkhs-version : 0.5.1.3+version : 0.5.1.4 synopsis : FLTK bindings description:     Low level bindings for the FLTK GUI toolkit. For installation and quick start instruction please scroll all the way down to the README.

@@ -844,15 +844,19 @@ -- -- === Overriding C++ methods ----- The binding API provides a /very/ limited form of inheritance by allowing the--- user to provide Haskell implementations of certain key methods on a small set--- of classes. Which methods and which classes were determined by original--- author of this library based on a casual look at FLTK code in the wild and--- what was required for porting the demoes. If there is a pressing need for--- more methods or classes, please contact the maintainer.+-- The binding API allows a limited but powerful form of "inheritance" allowing users to+-- override certain key FLTK methods with Haskell functions. All GUI elements+-- that derive from the C++ base class <http://www.fltk.org/doc-1.3/classFl__Widget.html Fl_Widget>+-- and the Haskell analog <https://hackage.haskell.org/package/fltkhs-0.5.1.3/docs/Graphics-UI-FLTK-LowLevel-Widget.html Widget>+-- now allow Haskell <https://hackage.haskell.org/package/fltkhs-0.5.1.3/docs/Graphics-UI-FLTK-LowLevel-Widget.html#g:2 functions> to be passed at+-- widget construction time that give Haskell complete control on <https://hackage.haskell.org/package/fltkhs-0.5.1.3/docs/Graphics-UI-FLTK-LowLevel-Widget.html#v:widgetCustom drawing>,+-- <https://hackage.haskell.org/package/fltkhs-0.5.1.3/docs/Graphics-UI-FLTK-LowLevel-Widget.html#t:CustomWidgetFuncs handling, resizing and other key functions>. This means that the Haskell user has+-- complete control of look-and-feel and the event loop. The <https://github.com/deech/fltkhs-demos/blob/master/src/Examples/table-as-container.hs#L105 table> demos are+-- an example of drawing in Haskell. An example of taking over the event loop is an FLTKHS <https://github.com/deech/fltkhs-reflex-host proof-of-concept> that <https://github.com/deech/fltkhs-reflex-host/blob/master/src/reflex-host.hs#L33 overrides> the FLTKHS event loop with the <https://hackage.haskell.org/package/reflex Reflex FRP> allowing+-- native functional reactive programming. The sky is the limit! -- -- When providing custom methods the object constructor is no longer--- `<widgetName>New` but `<widgetName>Custom`, which, in addition the parameters+-- `<widgetName>New` but `<widgetName>Custom`, which, in addition to the parameters -- taken by `<widgetName>New` also takes records of Haskell functions which are -- then passed to the C++ side. --@@ -899,6 +903,7 @@ -- function name suffixed with \"Super\". For instance, the user can provide a -- custom implementation of /handle/ on "Graphics.UI.FLTK.LowLevel.Window" via -- the constructor and every call to /handle/ invokes that implementation, but+ -- the user can also call /handleSuper/ to get at the default C++ -- implementation. This comes in handy when the custom function is just setting -- up variables or logging and wants underlying implementation to take over at