Function

Gtkget_current_event

Declaration [src]

GdkEvent*
gtk_get_current_event (
  void
)

Description [src]

Obtains a copy of the event currently being processed by GTK+.

For example, if you are handling a GtkButton::clicked signal, the current event will be the GdkEventButton that triggered the ::clicked signal.

Return value

Returns: GdkEvent
 

A copy of the current event, or NULL if there is no current event. The returned event must be freed with gdk_event_free().

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The return value can be NULL.