X Version 11 (Release 6.1)

XFilterEvent(X3xlib)

XFilterEvent -- filter X events for an input method

Synopsis

   Bool XFilterEvent(event, w)
         XEvent *event;
         Window w;

Arguments

event: Specifies the event to filter.
w: Specifies the window for which the filter is to be applied.

Description

If the window argument is None, XFilterEvent applies the filter to the window specified in the XEvent structure. The window argument is provided so that layers above Xlib that do event redirection can indicate to which window an event has been redirected.

If XFilterEvent returns True, then some input method has filtered the event, and the client should discard the event. If XFilterEvent returns False, then the client should continue processing the event.

If a grab has occurred in the client and XFilterEvent returns True, the client should ungrab the keyboard.

References

XNextEvent(X3xlib)
Xlib - C Language X Interface