gdk-window-pass-through (window)

window -- a gdk-window object
pass-through -- a boolean

The function gdk-window-pass-through returns whether input to the window is passed through to the window below. The function (setf gdk-window-pass-through) sets whether input to the window is passed through to the window below.

The default value of this is false, which means that pointer events that happen inside the window are send first to the window, but if the event is not selected by the event mask then the event is sent to the parent window, and so on up the hierarchy.

If pass-through is true then such pointer events happen as if the window was not there at all, and thus will be sent first to any windows below window. This is useful if the window is used in a transparent fashion. In the terminology of the web this would be called "pointer-events: none".

Note that a window with pass-through true can still have a subwindow without pass through, so you can get events on a subset of a window. And in that cases you would get the in-between related events such as the pointer enter/leave events on its way to the destination window.

Since 3.18