Package: gtk

Function gtk-propagate-event

Lambda List

gtk-propagate-event (widget event)

Arguments

widget -- a gtk-widget object
event -- a gdk-event instance

Details

Sends an event to a widget, propagating the event to parent widgets if the event remains unhandled.

Events received by GTK from GDK normally begin in the function gtk-main-do-event. Depending on the type of event, existence of modal dialogs, grabs, etc., the event may be propagated; if so, this function is used.

gtk-propagate-event calls the function gtk-widget-event on each widget it decides to send the event to. So the function gtk-widget-event is the lowest level function; it simply emits the event and possibly an event specific signal on a widget. The function gtk-propagate-event is a bit higher-level, and the function gtk-main-do-event is the highest level.

All that said, you most likely do not want to use any of these functions; synthesizing events is rarely needed. There are almost certainly better ways to achieve your goals. For example, use the functions gdk-window-invalidate-rect or gtk-widget-queue-draw instead of making up expose events.
 

See also

2020-8-22