XFilterEvent(3) XLIB FUNCTIONS XFilterEvent(3)

# [NAME](#NAME)

XFilterEvent - filter X events for an input method

# [SYNTAX](#SYNTAX)

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

# [ARGUMENTS](#ARGUMENTS)

[*event*](#event)

Specifies the event to filter.

[*w*](#w)

Specifies the window for which the filter is to be applied.

# [DESCRIPTION](#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.

# [SEE ALSO](#SEE_ALSO)

[**XNextEvent**(3)](/man/os/libx11/XNextEvent.3)  
*Xlib - C Language X Interface*

libX11 1.8.14 X Version 11

---

Document: XFilterEvent(3) from libx11 1.8.14-r2 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libx11.git