|Portability||portable (depends on GHC)|
The base object type for all glib objects
- newtype GObject = GObject (ForeignPtr GObject)
- class GObjectClass o where
- mkGObject :: (ForeignPtr GObject -> GObject, FinalizerPtr a)
- unGObject :: GObject -> ForeignPtr GObject
- castToGObject :: GObjectClass obj => obj -> obj
- objectUnref :: FinalizerPtr a
- objectNew :: GType -> [(String, GValue)] -> IO (Ptr GObject)
- objectRef :: GObjectClass obj => Ptr obj -> IO ()
- objectRefSink :: GObjectClass obj => Ptr obj -> IO ()
- makeNewGObject :: GObjectClass obj => (ForeignPtr obj -> obj, FinalizerPtr obj) -> IO (Ptr obj) -> IO obj
- constructNewGObject :: GObjectClass obj => (ForeignPtr obj -> obj, FinalizerPtr obj) -> IO (Ptr obj) -> IO obj
- wrapNewGObject :: GObjectClass obj => (ForeignPtr obj -> obj, FinalizerPtr obj) -> IO (Ptr obj) -> IO obj
- gTypeGObject :: GType
- isA :: GObjectClass o => o -> GType -> Bool
- type DestroyNotify = FunPtr (Ptr () -> IO ())
- destroyFunPtr :: DestroyNotify
- destroyStablePtr :: DestroyNotify
- type Quark = CUInt
- quarkFromString :: String -> IO Quark
- objectCreateAttribute :: GObjectClass o => IO (Attr o (Maybe a))
- objectSetAttribute :: GObjectClass o => Quark -> o -> Maybe a -> IO ()
- objectGetAttributeUnsafe :: GObjectClass o => Quark -> o -> IO (Maybe a)
Low level binding functions
All these functions are internal and are only interesting to people writing bindings to GObject-style C libraries.
Construct a new object (should rairly be used directly)
|:: GObjectClass obj|
|=> (ForeignPtr obj -> obj, FinalizerPtr obj)|
constructor for the Haskell object and finalizer C function
|-> IO (Ptr obj)|
action which yields a pointer to the C object
|-> IO obj|
This function wraps any object that does not derive from Object.
It should be used whenever a function returns a pointer to an existing
GObject (as opposed to a function that constructs a new object).
- The first argument is the contructor of the specific object.
This function wraps any newly created objects that derives from GInitiallyUnowned also known as objects with "floating-references". The object will be refSink (for glib versions >= 2.10). On non-floating objects, this function behaves exactly the same as makeNewGObject.
This function wraps any newly created object that does not derived
from GInitiallyUnowned (that is a GObject with no floating
reference). Since newly created
GObjects have a reference count of
one, they don't need ref'ing.
Determine if this is an instance of a particular GTK type
Many methods in classes derived from GObject take a callback function and a destructor function which is called to free that callback function when it is no longer required. This constants is an address of a functions in C land that will free a function pointer.
Set the value of an association.