DClosure

DClosure is a wrapper around the gobject library's GClosure with special handling for marshalling D delegates and function pointers as callbacks.

Closures are central to the concept of asynchronous signal delivery which is widely used throughout GTK+ and GNOME applications. A closure is an abstraction, a generic representation of a callback.

Constructors

this
this(GClosure* gClosure, bool ownedRef)

Sets our main struct and passes it to the parent class.

this
this(T callback, bool swap)

Create a new Closure that will call callback when it's invoked.

Members

Functions

getDClosureStruct
GClosure* getDClosureStruct(bool transferOwnership)

Get the main Gtk struct

Inherited Members

From Closure

gClosure
GClosure* gClosure;

the main Gtk struct

getClosureStruct
GClosure* getClosureStruct(bool transferOwnership)

Get the main Gtk struct

getStruct
void* getStruct()

the main Gtk struct as a void*

getType
GType getType()
addFinalizeNotifier
void addFinalizeNotifier(void* notifyData, GClosureNotify notifyFunc)

Registers a finalization notifier which will be called when the reference count of closure goes down to 0. Multiple finalization notifiers on a single closure are invoked in unspecified order. If a single call to Closure.unref results in the closure being both invalidated and finalized, then the invalidate notifiers will be run before the finalize notifiers.

addInvalidateNotifier
void addInvalidateNotifier(void* notifyData, GClosureNotify notifyFunc)

Registers an invalidation notifier which will be called when the closure is invalidated with Closure.invalidate. Invalidation notifiers are invoked before finalization notifiers, in an unspecified order.

addMarshalGuards
void addMarshalGuards(void* preMarshalData, GClosureNotify preMarshalNotify, void* postMarshalData, GClosureNotify postMarshalNotify)

Adds a pair of notifiers which get invoked before and after the closure callback, respectively. This is typically used to protect the extra arguments for the duration of the callback. See g_object_watch_closure() for an example of marshal guards.

invalidate
void invalidate()

Sets a flag on the closure to indicate that its calling environment has become invalid, and thus causes any future invocations of Closure.invoke on this closure to be ignored. Also, invalidation notifiers installed on the closure will be called at this point. Note that unless you are holding a reference to the closure yourself, the invalidation notifiers may unref the closure and cause it to be destroyed, so if you need to access the closure after calling Closure.invalidate, make sure that you've previously called Closure.ref.

invoke
void invoke(Value returnValue, Value[] paramValues, void* invocationHint)

Invokes the closure, i.e. executes the callback represented by the closure.

ref_
Closure ref_()

Increments the reference count on a closure to force it staying alive while the caller holds a pointer to it.

removeFinalizeNotifier
void removeFinalizeNotifier(void* notifyData, GClosureNotify notifyFunc)

Removes a finalization notifier.

removeInvalidateNotifier
void removeInvalidateNotifier(void* notifyData, GClosureNotify notifyFunc)

Removes an invalidation notifier.

setMarshal
void setMarshal(GClosureMarshal marshal)

Sets the marshaller of closure. The marshal_data of marshal provides a way for a meta marshaller to provide additional information to the marshaller. (See Closure.setMetaMarshal.) For GObject's C predefined marshallers (the g_cclosure_marshal_*() functions), what it provides is a callback function to use instead of closure->callback.

setMetaMarshal
void setMetaMarshal(void* marshalData, GClosureMarshal metaMarshal)

Sets the meta marshaller of closure. A meta marshaller wraps closure->marshal and modifies the way it is called in some fashion. The most common use of this facility is for C callbacks. The same marshallers (generated by [glib-genmarshal][glib-genmarshal]), are used everywhere, but the way that we get the callback function differs. In most cases we want to use closure->callback, but in other cases we want to use some different technique to retrieve the callback function.

sink
void sink()

Takes over the initial ownership of a closure. Each closure is initially created in a "floating" state, which means that the initial reference count is not owned by any caller. Closure.sink checks to see if the object is still floating, and if so, unsets the floating state and decreases the reference count. If the closure is not floating, Closure.sink does nothing. The reason for the existence of the floating state is to prevent cumbersome code sequences like:

unref
void unref()

Decrements the reference count of a closure after it was previously incremented by the same caller. If no other callers are using the closure, then the closure will be destroyed and freed.

sourceSetClosure
void sourceSetClosure(Source source, Closure closure)

Set the callback for a source as a gobject.Closure

sourceSetDummyCallback
void sourceSetDummyCallback(Source source)

Sets a dummy callback for source. The callback will do nothing, and if the source expects a gboolean return value, it will return TRUE. (If the source expects any other type of return value, it will return a 0/NULL value; whatever Value.init initializes a gobject.Value to for that type.)