>
GdomeEventListenerGdome2 Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
struct GdomeEventListener; GdomeEventListener* gdome_evntl_mkref (void (*callback) (GdomeEventListener *self,GdomeEvent *event,GdomeException *exc), gpointer priv); void gdome_evntl_ref (GdomeEventListener *self, GdomeException *exc); void gdome_evntl_unref (GdomeEventListener *self, GdomeException *exc); gpointer gdome_evntl_query_interface (GdomeEventListener *self, const char *interface, GdomeException *exc); void gdome_evntl_handleEvent (GdomeEventListener *self, GdomeEvent *evt, GdomeException *exc); gpointer gdome_evntl_get_priv (GdomeEventListener *self); |
The GdomeEventListener interface is the primary method for handling events. Users implement the GdomeEventListener interface and register their listener on an GdomeEventTarget using the gdome_n_AddEventListener() method. The users should also remove their GdomeEventListener from its GdomeEventTarget after they have completed using the listener.
When a GdomeNode is copied using the gdome_n_cloneNode() method the GdomeEventListeners attached to the source GdomeNode are not attached to the copied GdomeNode. If the user wishes the same GdomeEventListeners to be added to the newly created copy the user must add them manually.
GdomeEventListener* gdome_evntl_mkref (void (*callback) (GdomeEventListener *self,GdomeEvent *event,GdomeException *exc), gpointer priv); |
callback : | the callback function that is to be called when gdome_evntl_handleEvent() is called. |
priv : | private data |
Returns : | a new allocated GdomeEventListener. |
void gdome_evntl_ref (GdomeEventListener *self, GdomeException *exc); |
Increase the reference count of the specified EventListener.
void gdome_evntl_unref (GdomeEventListener *self, GdomeException *exc); |
Decrease the reference count of the specified EventListener. Free the EventListener structure if the EventListener will have zero reference.
gpointer gdome_evntl_query_interface (GdomeEventListener *self, const char *interface, GdomeException *exc); |
void gdome_evntl_handleEvent (GdomeEventListener *self, GdomeEvent *evt, GdomeException *exc); |
This method is called whenever an event occurs of the type for which the EventListener interface was registered.